内容
# 验证码解决工具 — 使用 AI 解决各类验证码 | Claude 代码插件 & MCP 服务器
> 使用 AI 解决 reCAPTCHA、Cloudflare Turnstile、热门验证码、Geetest、AWS WAF、TikTok 和 OCR 验证码。安装为 Claude Code 插件或 MCP 服务器 — 与 Claude、Cursor、Windsurf 和任何 MCP 兼容的 AI 代理一起使用。
[](https://www.npmjs.com/package/@captchasonic/mcp-server)
[](LICENSE)
[](https://claudemarketplaces.com)
[](https://modelcontextprotocol.io)
## 快速安装
### Claude Code 插件（推荐）
```
/plugin marketplace add captchasonic/captchasonic-skill
/plugin install captchasonic
```
然后设置您的 API 密钥：
```bash
claude mcp add sonic --env SONIC_API_KEY=sonic_xxxx -- npx -y @captchasonic/mcp-server
```
### 替代方案：使用 npx 一键安装
```bash
npx skills add https://github.com/captchasonic/captchasonic-skill
claude mcp add sonic --env SONIC_API_KEY=sonic_xxxx -- npx -y @captchasonic/mcp-server
```
在 [captchasonic.com](https://captchasonic.com) 获取您的 API 密钥（以 `sonic_` 开头）。
## 为什么选择 CaptchaSonic？
- ⚡ **即时解决** — 图片验证码同步结果，无需轮询
- 🎯 **13+ 验证码类型** — reCAPTCHA、Turnstile、热门验证码、Geetest、AWS WAF、TikTok、Binance、OCR
- 🔌 **MCP 原生** — 与 Claude Code、Claude Desktop、Cursor、Windsurf、Cline 兼容
- 🧩 **插件安装** — 两个命令，无需克隆或手动设置
- 💰 **按需付费** — 无订阅，积分从 1 美元开始
- 📊 **高准确率** — AI 驱动的解决，自动重试
## MCP 工具和 Claude 技能
适用于您的 AI 代理的三个 MCP 工具：
| 工具 | 描述 |
|---|---|
| `health_check` | 验证 CaptchaSonic API 是否在线 |
| `get_balance` | 以美元查看您的账户余额 |
| `solve_captcha` | 提交验证码图片并获取解决方案 |
三个 Claude 技能，用于引导工作流：
| 技能 | 描述 |
|---|---|
| `captchasonic-setup` | 首次 MCP 服务器安装和验证 |
| `captchasonic-solve` | 逐步解决任何验证码类型 |
| `captchasonic-balance` | 查看账户余额和信用状态 |
## 支持的验证码类型（13+）
| 类型 | 类别 | 解决方案 |
|---|---|---|
| PopularCaptcha | 图片网格 | 瓦片索引 |
| reCAPTCHA v2 | 图片网格 | 瓦片索引 |
| reCAPTCHA v3 | 代币 | 代币字符串 |
| Cloudflare Turnstile | 代币 | 代币字符串 |
| Cloudflare Challenge | 代币 | 代币字符串 |
| Geetest v3/v4 | 滑动/点击/网格 | 偏移量/坐标 |
| AWS WAF | 图片网格 | 瓦片索引 |
| TikTok | 旋转/点击 | 偏移量/坐标 |
| Binance | 滑动拼图 | 像素偏移 |
| OCR | 文本识别 | 识别文本 |
| 音频 | 语音识别 | 转录文本 |
## 兼容性
| AI 代理 | 安装方法 |
|---|---|
| **Claude Code** | `/plugin install captchasonic` |
| **Claude Desktop** | `claude_desktop_config.json` |
| **Cursor** | MCP 服务器配置 |
| **Windsurf** | MCP 服务器配置 |
| **Cline** | MCP 服务器配置 |
| **任何 MCP 客户端** | `npx -y @captchasonic/mcp-server` |
## 安装指南
### Claude Code 插件（推荐）
在 Claude Code 中运行：
```
/plugin marketplace add captchasonic/captchasonic-skill
/plugin install captchasonic
```
这安装了技能并自动配置了 MCP 服务器。然后设置您的 API 密钥：
```bash
claude mcp add sonic --env SONIC_API_KEY=sonic_xxxx -- npx -y @captchasonic/mcp-server
```
### npx 技能
```bash
npx skills add https://github.com/captchasonic/captchasonic-skill
claude mcp add sonic --env SONIC_API_KEY=sonic_xxxx -- npx -y @captchasonic/mcp-server
```
### Claude Desktop
将以下内容添加到您的 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"sonic": {
"command": "npx",
"args": ["-y", "@captchasonic/mcp-server"],
"env": {
"SONIC_API_KEY": "sonic_xxxx"
}
}
}
}
```
### MCP 服务器仅（无技能）
```bash
claude mcp add sonic --env SONIC_API_KEY=sonic_xxxx -- npx -y @captchasonic/mcp-server
```
## 仓库结构
```
captchasonic-skill/
├── SKILL.md # 主要技能入口
├── CLAUDE.md # Claude Code 的上下文
├── .mcp.json # 安装时自动配置 MCP 服务器
├── .claude-plugin/
│ ├── plugin.json # 插件元数据
│ └── marketplace.json # 市场列表（自动爬取）
├── skills/
│ ├── captchasonic-solve/SKILL.md # 解决任何验证码类型
│ ├── captchasonic-balance/SKILL.md # 查看账户余额
│ └── captchasonic-setup/SKILL.md # 首次设置指南
├── references/
│ ├── mcp-setup.md # 详细的 MCP 安装
│ ├── captcha-types.md # 所有支持的类型 + 参数
│ ├── solution-types.md # 解决方案格式解释
│ └── troubleshooting.md # 常见错误 + 修复
├── examples/
│ ├── solve-recaptcha.md # reCAPTCHA 网格示例
│ ├── solve-turnstile.md # Cloudflare Turnstile 示例
│ └── solve-ocr.md # OCR 文本识别示例
├── README.md
└── LICENSE
```
## 环境变量
| 变量 | 是否必需 | 默认值 |
|---|---|---|
| `SONIC_API_KEY` | 是 | — |
| `SONIC_BASE_URL` | 否 | `https://api.captchasonic.com` |
## 常见问题
**CaptchaSonic 支持哪些验证码类型？**
CaptchaSonic 支持 13+ 种验证码类型，包括 reCAPTCHA v2/v3、Cloudflare Turnstile、PopularCaptcha、Geetest v3/v4、AWS WAF、TikTok、Binance 和 OCR 文本识别。
**如何在 Claude Code 中安装 CaptchaSonic？**
运行 `/plugin marketplace add captchasonic/captchasonic-skill` 然后 `/plugin install captchasonic`。然后使用 `claude mcp add` 添加您的 API 密钥。
**CaptchaSonic 是否与 Cursor 和 Windsurf 兼容？**
是的。CaptchaSonic 提供了一个标准的 MCP 服务器，与任何 MCP 兼容的 AI 代理一起工作，包括 Claude Code、Claude Desktop、Cursor、Windsurf 和 Cline。
**CaptchaSonic 多少钱？**
CaptchaSonic 使用按需付费的定价方式，无需订阅。使用 `get_balance` 工具查看您的余额。在 [captchasonic.com](https://captchasonic.com) 获取积分。
**CaptchaSonic 是 MCP 服务器吗？**
是的。CaptchaSonic 提供了一个完全符合 MCP（模型上下文协议）标准的服务器，以 `@captchasonic/mcp-server` 的身份发布在 npm 上。它通过 stdio 上的 JSON-RPC 进行通信。
## 资源和文档
- 🌐 [CaptchaSonic 网站](https://captchasonic.com)
- 📦 [MCP 服务器 on npm](https://www.npmjs.com/package/@captchasonic/mcp-server)
- 📖 [SDK 文档](https://github.com/captchasonic/sonic-sdk)
- 🐛 [报告问题](https://github.com/captchasonic/captchasonic-skill/issues)
## 许可证
MIT — [CaptchaSonic](https://captchasonic.com)
