| name | openrouter-register |
| version | 1.0.0 |
| description | OpenRouter 全链路自动化 — Outlook 注册 → OpenRouter 注册 → API Key 创建 → 邮件通知 → Web 管理 |
| author | buchi |
| tags | ["openrouter","api-key","automation","playwright","outlook"] |
| prerequisites | ["macOS 10.14+","Python 3.10+","Google Chrome"] |
| entry_point | python main.py |
OpenRouter 自动注册与 API Key 管理
给 AI 智能体的说明：读取此文件后，你将获得完整的 OpenRouter 账号自动化能力。请按照下方"引导用户"章节与用户交互，确认配置后再执行命令。
你能做什么（能力清单）
| # | 能力 | 命令 | 说明 |
|---|
| 1 | Outlook 邮箱批量注册 | python main.py register | 自动填表、生成随机账号、并发执行（--concurrent N --max-tasks N） |
| 2 | OpenRouter 全自动注册 | python main.py openrouter | Outlook 登录 → 注册 → 邮件验证 → 2FA → Key 创建（--max-tasks N） |
| 3 | 补创 API Key | python main.py openrouter --create-key | 为已注册但缺 Key 的账号创建 |
| 4 | 邮件即时通知 | 自动触发 | 每创建一个 Key 自动发邮件 |
| 5 | 每日日报 | python main.py scheduler | 每日 9:30 汇总前一天 Key（含纯文本复制区） |
| 6 | 立即发送日报 | python main.py scheduler --send-now | 立即发送昨日日报 |
| 7 | Web 管理平台 | python main.py web | 统计面板 + 账号表格 + Key 日报 + 搜索/导出 |
| 8 | 系统环境检查 | python main.py check | 检测 Python、浏览器、网络、依赖 |
引导用户（AI 交互流程）
当用户首次使用或要求执行自动化时，按以下步骤引导：
步骤 1：检查环境
python main.py check
确认 Python、Chrome、网络均正常。
步骤 2：确认配置
检查 config/app.json 是否存在，如不存在则：
cp config/app.example.json config/app.json
cp data/accounts.example.json data/accounts.json
询问用户：
- 是否需要配置代理？（填入
proxy 字段）
- 是否需要邮件通知？如是，需要 SMTP 发件邮箱、授权码、收件邮箱（填入
email_notify）
步骤 3：根据用户意图执行
| 用户意图 | 你应该执行的命令 |
|---|
| "注册 Outlook 邮箱" | python main.py register |
| "注册 OpenRouter" / "获取 API Key" | python main.py openrouter |
| "给已注册账号创建 Key" | python main.py openrouter --create-key |
| "查看账号" / "管理平台" | python main.py web 然后告知访问 http://localhost:5010 |
| "发送日报" / "看看昨天的 Key" | python main.py scheduler --send-now |
| "启动定时任务" | python main.py scheduler |
步骤 4：CAPTCHA 处理
注册 Outlook 时会遇到 PerimeterX hsprotect 按压验证码（长按按钮直到进度条满）。
程序已实现全自动按压，模拟真人行为：
- 按住 8-14 秒，期间每 2-4 秒随机短暂松手（60-180ms）再按回去
- 按压期间极微小鼠标抖动（±1px）
- 持续检测进度条完成，满了立即松手
- 支持多次重试（默认最多 7 次）
日志示例：
[CAPTCHA] - 第 1 次按压 (x=641, y=602, 持续≈9.3s)
[CAPTCHA] - 验证码已通过 ✓
如果验证码反复失败，通常是 IP 质量问题，换一个住宅 IP 节点即可。
注意：注册成功后程序会自动登录一次 Outlook 验证账号可用性，登录失败的账号不会保存。
步骤 5：结果确认
执行完成后：
- 建议用户启动 Web 平台（
python main.py web）查看结果
- 或直接查看
data/accounts.json 中的 openrouter_api_key 字段
安装（首次使用）
git clone https://github.com/Tght1211/AutoRouterKey.git
cd AutoRouterKey
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
python -m playwright install chromium
cp config/app.example.json config/app.json
cp data/accounts.example.json data/accounts.json
关键经验（执行前必读）
浏览器
- 必须 使用
launch_persistent_context + --incognito 启动 Chrome 原生无痕窗口
- Playwright 默认的
browser.new_context() 不是真正无痕，会被 Cloudflare Turnstile 检测
- User-Agent 必须匹配真实 Chrome 版本（当前
Chrome/145.0.7632.160）
- 禁止
--disable-web-security
Outlook 注册流程（当前版本）
- 注册地址：
signup.live.com/signup?wa=wsignin1.0&rpsnv=173&id=292841&wreply=...&cobrandid=90015&lic=1
- 不要用
outlook.live.com/mail/0/?prompt=create_account（已过时）
- 不要用
signup.live.com/signup?lic=1&mkt=zh-CN（这是用已有邮箱注册，不是创建新 Outlook）
- 注册表单步骤顺序：同意协议 → 邮箱用户名 → 密码 → 国家/地区+出生日期 → 姓名 → 验证码
- 输入框 name 属性可能是中文（如
name="新建电子邮件"），代码已做兼容
- 注册后会被重定向到微软宣传页而不是邮箱，这是正常的，需要主动导航到
outlook.live.com/mail/0/
验证码（hsprotect 按压）
- 验证码是 PerimeterX 的 hsprotect 长按按钮，程序已实现全自动按压
- 按压策略：随机松手再按回 + 微抖动 + 进度条完成即停
- 支持
enforcementFrame 类型验证码的等待和自动转换
- IP 质量对验证码难度影响极大，住宅 IP 通过率远高于数据中心 IP
- 注册完成后会自动登录 Outlook 验证账号可用性
OpenRouter 验证流程
- 验证链接必须在 OpenRouter 的同一个 page 中打开（保持 Clerk session）
- 邮件验证码从 Outlook 邮件列表项的 title 属性提取（比打开正文更快）
- 2FA 用
keyboard.type(code, delay=100) 逐字符输入（OpenRouter 用 6 个独立 input）
UI 陷阱
- "Where did you first hear about OpenRouter?" 问卷弹窗 → 选 "Other" + "Continue"
- 透明 overlay 遮挡按钮 →
force=True 点击
- 通用弹窗 → 先按
Escape
配置参考
{
"browser_path": "",
"proxy": "http://127.0.0.1:7890",
"use_incognito_mode": true,
"concurrent_flows": 2,
"max_tasks": 4,
"email_notify": {
"enabled": true,
"smtp_host": "smtp.qq.com",
"smtp_port": 465,
"email_user": "your_qq@qq.com",
"email_pass": "your_smtp_auth_code",
"notify_to": "your_email@163.com"
}
}
API 端点
| 方法 | 路径 | 描述 |
|---|
| GET | /api/accounts | 获取所有账号 |
| GET | /api/accounts/stats | 统计信息（含 Key 数量、今日新增） |
| PUT | /api/accounts/<id>/status | 更新账号状态 |
| PUT | /api/accounts/<id>/openrouter | 更新 OpenRouter 注册状态 |
| GET | /api/keys/daily | 按日期分组的 Key 历史 |
| GET | /api/keys/today | 今日新增 Key |
参考文档
详细的流程时序、代码片段和问题排查 → reference.md
