Openrouter Register

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//status | 更新账号状态 | | PUT | /api/accounts//openrouter | 更新 OpenRouter 注册状态 | | GET | /api/keys/daily | 按日期分组的 Key 历史 | | GET | /api/keys/today | 今日新增 Key |

参考文档

详细的流程时序、代码片段和问题排查 → [reference.md](./reference.md)

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Tght1211
• Source: Tght1211/AutoRouterKey
• License: MIT

Install and usage instructions live in the source repository linked above.