janice20435/cf-turnstile-token
一、一句话定位
一个命令行工具，无需浏览器即可自动获取 Cloudflare Turnstile 验证令牌（token），通过调用 Peak API 实现秒级求解。
二、核心技术/架构亮点
1. 零浏览器依赖：单文件纯 Python 标准库，可在无头 CI 或服务器上运行。
2. 自动 sitekey 发现：通过 `--page` 参数自动提取页面的 `data-sitekey`，支持批量处理。
3. 结构化输出与重试：支持文本/JSON 输出、自动退避重试、代理注入，适配各类流水线。
4. 付费 API 后台：求解由 Peak 服务端维护，免去自行维护浏览器农场和适配 Cloudflare 更新的成本。
5. 完整的 Python API：提供 `extract_sitekey`、`solve`、`solve_many` 等函数，便于嵌入自动化脚本。
三、适用场景与目标用户
- 场景：自动化提交表单、爬虫绕过 Turnstile、CI/CD 中完成需验证的流程、批量站点验证。
- 目标用户：需要高频或稳定处理 Cloudflare 验证的开发/运维人员，希望节省自行维护求解器的时间。
四、可动手动作
1. Clone 并安装：`git clone` 后 `pip install .`（无第三方依赖）。
2. 获取 API Key：在 peak.fo 注册领取 1000 次免费调用。
3. 运行测试：
```bash
export PEAK_API_KEY=pk_your_key
cf-turnstile-token --page https://example.com/protected --url https://example.com/
```
4. 借鉴思路：如需自建类似工具，可参考其 sitekey 提取逻辑、API 调用封装及批量处理模式，但求解环节需替换为其他服务或方案。
五、学习优先级
P1（排期）
理由：该工具实用性强（一行代码解决 Turnstile 难题），但依赖付费 API；若当前项目有对应需求，P0 试用；若无紧急需求，P1 排期了解并预留使用。⌂