openrouter-register

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": "[e-mail]",
        "email_pass": "your_smtp_auth_code",
        "notify_to": "[e-mail]"
    }
}

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