Email Intelligence Agent

SKILL.md

# Email Intelligence Agent

> IMAP Email Read → AI Classification → Reply Suggestions → Feishu Push Summary

**Slug:** `email-intelligence-agent`
**Price:** $0.01 USDT per call
**Author:** 91Skillhub Team

---

## Overview

| Feature | Description |
|---------|-------------|
| IMAP Email Read | Connect to any IMAP mailbox (QQ/163/Enterprise/Gmail, etc.) |
| AI Classification | Urgent / Important / Normal / Can Wait |
| Reply Suggestions | AI generates multilingual reply suggestions, confirmed by user before sending |
| Feishu Push | Summary card pushed to Feishu group or DM |

---

## Tiered Features

| Feature | FREE | PRO |
|---------|:----:|:---:|
| Email read & classification | Keyword-based | AI-powered |
| Reply suggestions | — | Yes |
| Feishu push | — | Yes |
| Max emails per run | 10 | Unlimited |
| Price | Free | $0.01/call |

---

## Quick Start

### 1. Configure Email (IMAP)

```
IMAP Config:
- Server: imap.example.com
- Port: 993 (SSL)
- Username: your@email.com
- Password: App-specific password (NOT your login password)

Tip: Use an App Password from your email provider's security settings
```

### 2. Configure AI API

Supports OpenAI-compatible API (OpenAI, Claude, domestic models, etc.)

### 3. Configure Feishu Push

Set up a Feishu bot webhook or user_id to receive push notifications.

---

## Classification Labels

| Label | Example Keywords |
|-------|----------------|
| Urgent | refund, cancel order, complaint, negative review, urgent |
| Important | after-sales, repair, payment, invoice, account issue |
| Normal | inquiry, price, specs, logistics, shipping |
| Can Wait | hello, thank you, goodbye, already handled |

---

## Billing

- **Pay-per-call**: $0.0100 USDT per execution via SkillPay.me
- **Balance insufficient**: Payment URL returned — top up at `https://skillpay.me/email-intelligence-agent`
- **External data flow**: `FEISHU_USER_ID` transmitted to `skillpay.me/api/v1/billing` for billing identification only; not stored or shared with any third party
- **Billing model**: Each run = 1 call = $0.0100 USDT
- **Privacy**: FEISHU_USER_ID is used solely to identify the billing account; no personal data is retained or shared beyond the payment processor

---

## Required Environment Variables

| Variable | Description |
|----------|-------------|
| `SKILL_BILLING_API_KEY` | SkillPay Builder API Key |
| `SKILL_BILLING_SKILL_ID` | SkillPay Skill ID (`email-intelligence-agent`) |
| `FEISHU_USER_ID` | User open_id for billing (passed by Feishu runtime) |


---

## Directory Structure

```
email-customer-assistant/
├── SKILL.md
├── scripts/
│   ├── check_emails.py      # Main script + billing
│   ├── imap_client.py       # IMAP connection wrapper
│   ├── classifier.py         # Keyword + AI classifier
│   ├── reply_generator.py    # Reply generator
│   └── feishu_pusher.py      # Feishu pusher
└── requirements.txt
```

---

## Usage Limits

- **Read-only emails** — no sending or deleting
- **IMAP access only** — no direct platform API calls
- Complies with email provider terms of service

---

## License

MIT