Skip to content
CaptchaSonic

AI エージェント & MCP

ホスト型 MCP サーバー mcp.captchasonic.com、ローカルの npx サーバー、または SDK を直接使って、Claude Code、Cursor、Windsurf、Antigravity、n8n など任意の AI エージェントから CaptchaSonic を利用できます。

CaptchaSonic は エージェントネイティブ です。任意の AI エージェントが MCP サーバー を通じて CAPTCHA を解決できます。利用方法は 2 つあります。

  • ホスト型: API キーをベアラートークンとして使う https://mcp.captchasonic.com。インストールは不要です。推奨です。
  • ローカル: ローカルサーバーしか対応していないクライアント向けに、stdio 経由で npx -y @captchasonic/mcp-server を実行します。

どちらでも同じ 5 つのツールを利用できます: solve_token_captcha、solve_image_captcha、get_task_result、get_balance、list_captcha_types。すべてのクライアント共通の手順は MCP はじめに をご覧ください。クライアントごとの補足は以下にあります。エージェントが MCP を話せない場合は、代わりに SDK の直接利用 を呼び出してください。

エージェント向けゴールデンパス

任意のエージェントに以下を渡すと、1 回のやり取りで CAPTCHA を解決できます。

# Claude Code (or any MCP client): add the hosted server once
claude mcp add --transport http captchasonic https://mcp.captchasonic.com --header "Authorization: Bearer sonic_xxx"
# Or, with no MCP — the same lifecycle via curl (replace TASK_ID after createTask):
curl -s https://api.captchasonic.com/createTask -H 'content-type: application/json' -d '{"apiKey":"sonic_xxx","task":{"type":"AntiTurnstileTaskProxyLess","websiteURL":"https://example.com","websiteKey":"0x4AAAAAAA..."}}'
curl -s https://api.captchasonic.com/getTaskResult -H 'content-type: application/json' -d '{"apiKey":"sonic_xxx","taskId":"TASK_ID"}'

TIP

エージェントを AI エージェント向け MCP に向けてください。サイトキーの見つけ方、適切なツールの選び方、トークンの送信方法が説明されているため、追加の指示がなくてもエージェントは作業できます。


Claude Code

ホスト型サーバーを追加します。

claude mcp add --transport http captchasonic https://mcp.captchasonic.com --header "Authorization: Bearer sonic_xxx"

ローカルで実行したい場合は、claude mcp add captchasonic --env SONIC_API_KEY=sonic_xxx -- npx -y @captchasonic/mcp-server を使うと、stdio 経由で同じツールを利用できます。

ガイド付きのワークフローを使う場合は、公式の CaptchaSonic スキルプラグイン をインストールしてください。3 つの Claude スキルがまとめられており、SONIC_API_KEY 環境変数を使ってホスト型 MCP サーバーに接続します。キーを export してから Claude Code を起動し、次を実行してください。

/plugin marketplace add Captcha-Sonic/Agent-skills
/plugin install captchasonic

これで 3 つのスキルが、よくあるワークフローをエージェントに案内します。

  • captchasonic-setup — 初回の MCP セットアップと動作確認です。
  • captchasonic-solve — どの CAPTCHA 種別でも、手順に沿って解決を案内します。
  • captchasonic-balance — アカウント残高とクレジット状況を確認します。

TIP

一括で解決を行う前に get_balance(または captchasonic-balance スキル)で残高を確認しておくと、クレジットが少なくなったときにエージェントが早めに停止できます。


Antigravity

Antigravity の MCP 設定に、ローカルの stdio サーバーとして CaptchaSonic を登録します。

{
  "mcpServers": {
    "captchasonic": {
      "command": "npx",
      "args": ["-y", "@captchasonic/mcp-server"],
      "env": { "SONIC_API_KEY": "sonic_xxx" }
    }
  }
}

Antigravity の MCP サーバーを再読み込みすると、CaptchaSonic のツールがエージェントのツール一覧に表示されます。


Cursor

Settings → MCP を開く(または ~/.cursor/mcp.json を編集する)と、ホスト型サーバーを追加できます。

{
  "mcpServers": {
    "captchasonic": {
      "url": "https://mcp.captchasonic.com",
      "headers": { "Authorization": "Bearer sonic_xxx" }
    }
  }
}

Windsurf

Settings → Cascade → MCP Servers を開く(または ~/.codeium/windsurf/mcp_config.json を編集する):

{
  "mcpServers": {
    "captchasonic": {
      "serverUrl": "https://mcp.captchasonic.com",
      "headers": { "Authorization": "Bearer sonic_xxx" }
    }
  }
}

汎用 MCP

リモートサーバーに対応した任意の MCP クライアントでは、Streamable HTTP トランスポートと Authorization: Bearer sonic_xxx ヘッダーを使って https://mcp.captchasonic.com を指定してください。VS Code、Codex、Gemini CLI の設定は はじめにガイド にあります。

ローカルサーバーのみ実行できるクライアントは、標準の stdio ブロックを使ってください(ローカルで実行 を参照)。

{
  "mcpServers": {
    "captchasonic": {
      "command": "npx",
      "args": ["-y", "@captchasonic/mcp-server"],
      "env": { "SONIC_API_KEY": "sonic_xxx" }
    }
  }
}

n8n

CaptchaSonic には、20 種類以上の CAPTCHA をドラッグ&ドロップのワークフローノードにまとめた 認証済みの n8n コミュニティノード(n8n.io の掲載ページ)があります。単独のノードとしても、n8n の AI Agent ノードのツールとしても使えます。

→ n8n 連携の完全ガイド — インストール手順、認証情報の設定、4 つのワークフロー例、CAPTCHA 種別ごとの設定、エラー処理のパターン、トラブルシューティングを順に説明しています。

クイックインストール: Settings → Community Nodes → n8n-nodes-captchasonic をインストール → API キーを入力して CaptchaSonic の認証情報を作成 → 完了です。


MCP を使わない場合(SDK を直接利用)

エージェントが MCP を使えない場合は、SDK を直接呼び出してください。トークン型の CAPTCHA は 1 回の関数呼び出しで済みます。

result = solver.solve_turnstile(
    website_url="https://example.com",
    website_key="0x4AAAAAAA...",
    proxy="http://user:pass@host:port",  # optional
)
token = result["token"]

メソッドの一覧は Python SDK と Node.js SDK のページ、生の 3 段階の流れは REST API リファレンス をご覧ください。