MCP Email Service

# ⚡ n8n 快速设置指南

使用你的 n8n API Key 自动设置邮件监控工作流。

## 🚀 3 步完成设置

### 方法 A: 使用 .env 文件 (推荐)

#### 1. 创建 .env 文件
```bash
./scripts/create_env.sh
```

交互式设置会引导你输入：
- N8N_API_KEY (必需)
- OPENAI_API_KEY (可选)

#### 2. 测试连接
```bash
uv run python scripts/test_n8n_api.py
```

### 方法 B: 使用环境变量

#### 1. 设置 N8N_API_KEY
```bash
export N8N_API_KEY="your_n8n_api_key_here"
```

#### 2. 测试连接
```bash
uv run python scripts/test_n8n_api.py
```

**期望输出**:
```
🚀 n8n API 连接测试

🔍 测试 n8n API 连接...
   URL: https://n8n.ifoodme.com
   API Key: ********************abcd1234

✅ n8n API 连接成功!
   当前工作流数量: 3

📋 现有工作流:
   🟢 激活 My Workflow 1 (ID: 1)
   ⚪ 未激活 My Workflow 2 (ID: 2)

✨ 可以开始导入工作流了!
   运行: ./setup_n8n.sh
```

### 3. 自动导入工作流

```bash
./setup_n8n.sh
```

脚本会自动：
- ✅ 读取工作流配置
- ✅ 更新脚本路径
- ✅ 导入到 n8n
- ✅ 提供激活选项

## 🎯 配置信息

脚本会自动使用以下配置：

| 配置项 | 值 |
|--------|-----|
| n8n URL | `https://n8n.ifoodme.com` |
| 飞书 Webhook | `https://open.larksuite.com/open-apis/bot/v2/hook/a56c9638-cb65-4f95-bb11-9eb19e09692a` |
| 脚本路径 | `/Users/leo/github.com/mcp-email-service` |
| Python 路径 | 自动添加到 PYTHONPATH |

## 🔧 可选配置

### 使用 OpenAI AI 过滤

```bash
export OPENAI_API_KEY="your_openai_api_key"
```

没有 OpenAI API Key 也能运行，系统会自动回退到关键词过滤。

### 自定义 n8n URL

```bash
export N8N_URL="https://your-n8n-instance.com"
```

### 自定义飞书 Webhook

```bash
export FEISHU_WEBHOOK="your_custom_webhook_url"
```

## 📝 详细步骤说明

### 测试脚本输出

```bash
$ uv run python scripts/test_n8n_api.py

🚀 n8n API 连接测试

🔍 测试 n8n API 连接...
   URL: https://n8n.ifoodme.com
   API Key: ********************abcd1234

✅ n8n API 连接成功!
   当前工作流数量: 5

📋 现有工作流:
   🟢 激活 Email Monitor (ID: 123)
   ⚪ 未激活 Backup Workflow (ID: 124)

✨ 可以开始导入工作流了!
   运行: ./setup_n8n.sh
```

### 设置脚本输出

```bash
$ ./setup_n8n.sh

🚀 n8n 工作流自动设置

⚙️  配置信息:
   n8n URL: https://n8n.ifoodme.com
   飞书 Webhook: https://open.larksuite.com/open-apis/bot/v2/hook...
   脚本路径: /Users/leo/github.com/mcp-email-service

🔍 测试 n8n API 连接...
✅ n8n API 连接成功: https://n8n.ifoodme.com
📋 当前工作流数量: 5

📦 开始导入工作流...

📁 读取工作流文件: n8n/email_monitoring_workflow.json
   工作流名称: 智能邮件监控与通知

📤 正在创建工作流: 智能邮件监控与通知
✅ 工作流创建成功!
   工作流 ID: 126
   名称: 智能邮件监控与通知

✅ 工作流设置完成!
   ID: 126
   名称: 智能邮件监控与通知
   URL: https://n8n.ifoodme.com/workflow/126

💡 提示:
   1. 请在 n8n 界面中检查工作流配置
   2. 确认环境变量设置正确:
      - FEISHU_WEBHOOK
      - OPENAI_API_KEY (可选)
      - PYTHONPATH
   3. 测试工作流执行

是否立即激活工作流? (y/N): y

✅ 工作流已激活！系统将每5分钟自动运行。

🔗 访问工作流: https://n8n.ifoodme.com/workflow/126

✅ 设置完成！

📝 下一步:
   1. 访问 https://n8n.ifoodme.com
   2. 检查工作流配置
   3. 设置 OPENAI_API_KEY (可选)
   4. 激活工作流
```

## ❌ 常见问题

### 1. API Key 错误

**问题**: `❌ 认证失败 (HTTP 401)`

**解决**:
```bash
# 重新设置 API Key
export N8N_API_KEY="correct_api_key"

# 再次测试
uv run python scripts/test_n8n_api.py
```

### 2. 连接失败

**问题**: `❌ 连接失败: 无法连接到 https://n8n.ifoodme.com`

**解决**:
- 检查网络连接
- 确认 n8n URL 是否正确
- 验证 n8n 服务是否运行

### 3. 权限不足

**问题**: `❌ 权限不足 (HTTP 403)`

**解决**:
- 确认 API Key 有工作流管理权限
- 在 n8n 中重新生成 API Key

### 4. 工作流已存在

脚本会自动检测并询问是否更新现有工作流。

## 🎉 完成后

访问你的 n8n 实例查看工作流：
- **URL**: https://n8n.ifoodme.com/
- **工作流名称**: 智能邮件监控与通知
- **运行频率**: 每 5 分钟

系统会自动：
1. ⏰ 每 5 分钟检查新邮件
2. 🤖 AI 判断邮件重要性
3. 📱 发送飞书通知
4. 🔄 避免重复通知

## 📚 更多信息

- **详细设置**: [N8N_API_SETUP_GUIDE.md](N8N_API_SETUP_GUIDE.md)
- **完整文档**: [N8N_EMAIL_MONITORING_GUIDE.md](N8N_EMAIL_MONITORING_GUIDE.md)
- **生产部署**: [PRODUCTION_DEPLOYMENT_GUIDE.md](PRODUCTION_DEPLOYMENT_GUIDE.md)

---

**现在就开始吧！只需要 3 个命令 🚀**