# Openrouter Register

> OpenRouter 全链路自动化 — Outlook 注册 → OpenRouter 注册 → API Key 创建 → 邮件通知 → Web 管理

- **Type:** Skill
- **Install:** `agentstack add skill-tght1211-autorouterkey-openrouter-register`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Tght1211](https://agentstack.voostack.com/s/tght1211)
- **Installs:** 0
- **Category:** [Web & Browser](https://agentstack.voostack.com/c/web-and-browser)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Tght1211](https://github.com/Tght1211)
- **Source:** https://github.com/Tght1211/AutoRouterKey/tree/main/.cursor/skills/openrouter-register

## Install

```sh
agentstack add skill-tght1211-autorouterkey-openrouter-register
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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：检查环境

```bash
python main.py check
```

确认 Python、Chrome、网络均正常。

### 步骤 2：确认配置

检查 `config/app.json` 是否存在，如不存在则：

```bash
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` 字段

## 安装（首次使用）

```bash
# 克隆项目
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`

## 配置参考

```json
{
    "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](https://github.com/Tght1211)
- **Source:** [Tght1211/AutoRouterKey](https://github.com/Tght1211/AutoRouterKey)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-tght1211-autorouterkey-openrouter-register
- Seller: https://agentstack.voostack.com/s/tght1211
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.