| 1 | # API Key Generator - Multi-Service Edition |
| 2 | |
| 3 | [English Guide](./README_EN.md) |
| 4 | |
| 5 | 这是一个多服务注册器与聚合 API 上游工具,聚焦三件事: |
| 6 | |
| 7 | - 注册 `Tavily(暂时无法注册)` / `Firecrawl` / `Exa` key |
| 8 | - 验证 key 是否真实可用,并把可用 key 提供给统一搜索层 |
| 9 | |
| 10 | ## 当前状态 |
| 11 | |
| 12 | - `Firecrawl`:可用 |
| 13 | - `Exa`:可用 |
| 14 | - `Tavily`:按当前项目这轮本地测试,官网已关闭邮件注册入口,暂不可用 |
| 15 | |
| 16 | 它不是 `MySearch` 的正式产品仓库。 |
| 17 | 如果你要部署公开可用的统一搜索控制台、MCP、Skill 和 Social / X |
| 18 | 接入,请直接使用独立项目: |
| 19 | |
| 20 | - [MySearch-Proxy](https://github.com/skernelx/MySearch-Proxy) |
| 21 | |
| 22 | ## 这个仓库负责什么 |
| 23 | |
| 24 | - 本地真实浏览器注册 |
| 25 | - 本地 Turnstile Solver |
| 26 | - 邮箱 API 自动收验证码 / 验证链接 |
| 27 | - 提取到 API Key 后立刻做真实调用验证 |
| 28 | - 可选自动上传到统一代理池 |
| 29 | - 可作为 `MySearch` / `MySearch-Proxy` 的 provider 上游之一 |
| 30 | |
| 31 | ## Features |
| 32 | |
| 33 | - 多服务启动台:启动时可选择 Tavily / Firecrawl / Exa |
| 34 | - 自动环境准备:自动检查 `venv`、依赖和浏览器 |
| 35 | - 邮箱链路统一:支持 Cloudflare Mail API 和 DuckMail |
| 36 | - 多域名可选:启动时选择本轮注册用的域名 |
| 37 | - 并发注册:支持批量和并发执行 |
| 38 | - 后台浏览器模式:默认 headless,必要时可切前台排查 |
| 39 | - 真实可用性验证:拿到 key 后马上调用官方接口 |
| 40 | - 自动上传到代理池:上传时会带上服务标记,服务端能自动识别 Firecrawl / Exa / Tavily 并写入对应池子 |
| 41 | - 适合作为统一搜索网关的上游:给 `MySearch-Proxy` 提供稳定的 key 来源 |
| 42 | - 跨平台启动:Windows / macOS / Linux 都能直接跑 |
| 43 | |
| 44 | ## 配套工作台预览 |
| 45 | |
| 46 | ### MySearch Proxy 首屏 |
| 47 | |
| 48 |  |
| 49 | |
| 50 | ### MySearch Proxy 工作台 |
| 51 | |
| 52 |  |
| 53 | |
| 54 | ## Quick Start |
| 55 | |
| 56 | ### 1. Clone |
| 57 | |
| 58 | ```bash |
| 59 | git clone https://github.com/skernelx/tavily-key-generator.git |
| 60 | cd tavily-key-generator |
| 61 | ``` |
| 62 | |
| 63 | ### 2. Configure |
| 64 | |
| 65 | ```bash |
| 66 | cp .env.example .env |
| 67 | ``` |
| 68 | |
| 69 | 编辑 `.env`,填好邮箱配置和可选上传配置。 |
| 70 | |
| 71 | 如果已经配置了 `SERVER_URL` 和 `SERVER_ADMIN_PASSWORD`,注册成功后可以自动上传。 |
| 72 | |
| 73 | ### 3. Run |
| 74 | |
| 75 | macOS / Linux: |
| 76 | |
| 77 | ```bash |
| 78 | python3 run.py |
| 79 | ``` |
| 80 | |
| 81 | 或者: |
| 82 | |
| 83 | ```bash |
| 84 | ./start_auto.sh |
| 85 | ``` |
| 86 | |
| 87 | Windows: |
| 88 | |
| 89 | ```bat |
| 90 | start_auto.bat |
| 91 | ``` |
| 92 | |
| 93 | 启动后当前可选: |
| 94 | |
| 95 | ```text |
| 96 | 1. Tavily |
| 97 | 2. Firecrawl |
| 98 | 3. Exa |
| 99 | ``` |
| 100 | |
| 101 | 补充说明: |
| 102 | |
| 103 | - `Exa` 注册成功后会保存到 `exa_accounts.txt` |
| 104 | - `Exa` 的格式是 `email,EMAIL_OTP_ONLY,api_key` |
| 105 | - `Tavily` 选项目前仍保留在启动台里,但当前状态暂不可用 |
| 106 | |
| 107 | ## 推荐搭配方式 |
| 108 | |
| 109 | 如果你希望把注册出来的 key 接成公开可用的统一搜索服务,推荐直接搭配: |
| 110 | |
| 111 | - [MySearch-Proxy](https://github.com/skernelx/MySearch-Proxy) |
| 112 | |
| 113 | 它负责: |
| 114 | |
| 115 | - 统一控制台 |
| 116 | - Tavily / Firecrawl / Social / X 统一接线 |
| 117 | - MCP + Skill 安装说明 |
| 118 | - 官方接口与 compatible 网关双接入 |
| 119 | - 面向 Codex / Claude Code 的最终接入方式 |
| 120 | |
| 121 | 当前仓库则继续专注于: |
| 122 | |
| 123 | - 注册可用 key |
| 124 | - 做真实可用性验证 |
| 125 | - 提供聚合 API 上游能力 |
| 126 | |
| 127 | `proxy/` 目录现在只保留一份迁移说明 README,不再包含本地可运行实现。 |
| 128 | |
| 129 | ## MySearch 的关系 |
| 130 | |
| 131 | 这里的 `tavily-key-generator` 只负责: |
| 132 | |
| 133 | - 注册 Firecrawl / Exa key |
| 134 | - 验证 key 是否真实可用 |
| 135 | - 提供可选聚合 API,供 `MySearch` / `MySearch-Proxy` 调用 |
| 136 | |
| 137 | `MySearch` 自己的安装、MCP 工具、统一控制台、social gateway、Codex / |
| 138 | Claude Code 接入说明,统一放在: |
| 139 | |
| 140 | - [MySearch-Proxy](https://github.com/skernelx/MySearch-Proxy) |