**機能マトリクス** は「CaptchaSonic は何を解決でき、どのように呼び出すのか」に対する正式な答えです。各行は、CAPTCHA ごとに Python メソッド、Node.js メソッド、REST の `task.type`、そして回答が入っている正確なフィールドを対応付けています。ドキュメント、SDK、外部の **AI エージェント / MCP クライアント** はすべてこの唯一の情報源を参照しています。

> [!TIP]
> エージェント、自動化、独自のダッシュボードで使えるように、マトリクスを JSON でダウンロードできます: <a href="/capabilities.json" download>capabilities.json</a>。JSON の内容は `src/data/capabilities.ts` とフィールド単位で一致しています。

---

## 読み方

- **ファミリー** — `token` は文字列トークンを返します（非表示のフォームフィールドに入れて使います）。`image` は指定した画像から座標やテキストを返します。`interactive` はクリックのインデックスやドラッグの移動量など、構造化されたアクションを返します。
- **Python SDK / Node.js SDK** — メソッド名と、レスポンスオブジェクト内で回答が入っているドット区切りのパスです。`not in SDK` は、その CAPTCHA が現時点では REST API 経由でのみ利用できることを示します。
- **REST taskType** — `POST /createTask` に `task.type` として渡す正確な文字列です。API が提供している場合は、別の `proxyless` バリアントも表示されます（例: `TurnstileTaskProxyless`）。
- **注記** — 固定された注意事項です（必須の引数、プロキシの要件、サブタイプの意味など）。

---

## マトリクス

<CapabilityMatrix />

---

## 件数

- 全体で **{CAPABILITY_COUNTS.total}** 行です。文書化された CAPTCHA 1 種類につき 1 行です。
- Python SDK メソッドは **{CAPABILITY_COUNTS.pythonCovered}** 件、Node.js SDK メソッドは **{CAPABILITY_COUNTS.nodeCovered}** 件です（いずれも CAPTCHA ごとに 1 つ）。
- token ファミリーが **{CAPABILITY_COUNTS.byFamily.token}** 件、image ファミリーが **{CAPABILITY_COUNTS.byFamily.image}** 件、interactive ファミリーが **{CAPABILITY_COUNTS.byFamily.interactive}** 件です。

これらの件数は生成された `capabilities.ts` から直接読み込まれるため、SDK と常に一致し、マトリクスとずれることはありません。

---

## 互換性の保証

- **行の追加** は非破壊的変更です。新しい CAPTCHA は `src/data/capabilities.ts` の `CAPABILITIES` の末尾に追加されます。
- **`slug` の削除または改名** は、そのスラッグに固定しているエージェントにとって破壊的変更です。これを黙って行うことはありません。
- **メソッド名と戻り値フィールド** は SDK ドキュメントと一字一句同じです。メソッド名が変わる場合は、同じリリースでこのマトリクスも更新されます。

REST の生の契約については [REST API リファレンス](/docs/api) をご覧ください。インストールとクイックスタートについては、[Python SDK](/docs/clients-sdks/python) と [Node.js SDK](/docs/clients-sdks/nodejs) のページをご覧ください。

---

## エラーコード

上のマトリクスは、各 CAPTCHA とそのメソッド・戻り値フィールドの対応を示します。以下の表は、タスクが失敗したときにすべての SDK と REST API が返す、数値の `errorId` コードの一覧です。

<ErrorIdTable />
