🎉新着AI エージェント向け CapSolver-MCP、エージェントツール、SDK 統合
Sora Fujimoto
AI Solutions Architect
発行済み Oct 26, 2026
更新されました Oct 26, 2026 · 最小読み取り
ERROR_TASK_NOT_SUPPORTED は、送信した CAPTCHA タイプが誤っているか、そのサービスでサポートされていないことを意味します。task.type を確認してください。CAPTCHA 連携は、認識処理が始まる前に失敗することがあります。API はリクエストを受け取り、そのタスクタイプを調べ、サポートしていない操作であれば拒否します。この状況では、サイトの公開キーを変更したり、待機時間やリトライ回数を増やしたりしても、本当の問題が解決されない可能性があります。
CapSolver は、ERROR_TASK_NOT_SUPPORTED を無効なタスクデータや認識失敗とは別に定義しています。効果的なトラブルシューティングの手順は、実際にアプリケーションが送信しているリクエスト内容を、自分が利用しているサービスとインテグレーション面の契約仕様と比較することです。
ERROR_TASK_NOT_SUPPORTED はタスクタイプの互換性の問題を示します。CAPTCHA 画像が難しかったとか、返されたトークンが期限切れになったことを示すものではありません。
公式エラーコードリファレンス では、この状態を「CAPTCHA タイプが誤っている、またはサポートされていない」と定義しています。失敗を確認する際は、errorCode と errorDescription の両方を保持してください。「ソルバーが失敗しました」といった汎用的なアプリケーションメッセージでは、修正内容を選ぶのに必要な区別が失われます。
まず次の 3 点を特定します。どのエンドポイントがリクエストを受け取ったか、正確にはどのタイプ文字列を受け取ったか、ページにはどの CAPTCHA ファミリが存在していたか。この 3 つが、実装とドキュメントを比較するために最低限必要な情報です。
API パラメータ はサービス契約の一部です。「それらしい名前」であっても、サポートされる名前とは限りません。大文字・小文字、スペル、接尾辞、ファミリごとのバリアントは、他プロバイダから推測した命名パターンではなく、必ず公式リファレンスに従ってください。
SDK、設定レイヤー、ミドルウェアによる変換後の送信リクエストを確認してください。
設定画面には「reCAPTCHA v2」と表示されていても、最終的な JSON には別の文字列が入っていることがあります。環境変数に、退役済みの値が残っていることもあります。ラッパーが分かりやすい名前を、既に利用しているサービスと合わなくなったタスク識別子へマッピングしている場合もあります。初期設定がそのまま API に届いていると決めつけず、実際に送信されている値を読み取ってください。
ブラウザベースのクライアントであれば、Chrome の Network パネル でリクエストとレスポンスの確認方法が説明されています。サーバーサイドのコードでは、機密情報を除いた範囲の限定的な診断ログを利用してください。API キー、セッションクッキー、完全なトークン、無関係なフォームデータなどはログに残さないようにします。
メソッド、送信先ホストとパス、タスクタイプ、フィールド名、レスポンスのコードと説明を記録してください。サービスが実際にタスク ID を返した場合のみ、それを含めてください。タスク作成の時点で失敗した場合、有効な ID が存在せずポーリングできないことがあります。
JSON の構文が正しいことは、そのタスクがサポートされていることの証明にはなりません。JSON 仕様 はデータ形式を定義しているだけであり、API リファレンスこそがフィールドの意味と許容される値を定義しています。
この区別は、「バリデータ上はリクエストが正しいのに、API は拒否してくる」ときに役立ちます。構文的に正しい文字列でも、サポートされていない操作名を指定している可能性があります。逆に、形式が壊れているデータは、このエラーとは別に診断されるべきであり、同じエラーとして扱うべきではありません。
置き換えるタスクタイプを選ぶ前に、現在の CAPTCHA ファミリとバリアントを正しく対応付けてください。
タスクタイプ概要 を使って正しいファミリを特定し、そのファミリの詳細リファレンスを開きます。たとえば reCAPTCHA v2 タスクリファレンス には、受け付けられる v2 タスク名とそのフィールドが記載されています。該当エントリから識別子をコピーし、記憶や推測から組み立てないようにしてください。
アプリケーション側で最近 CAPTCHA 連携を変更した場合は、実際のページも改めて確認してください。古い設定が、以前のプロバイダや別バリアントを示していることがあります。ウィジェットの見た目だけでは、過去のタスクタイプが今も適用できるかどうかを証明できません。
また、トークンタスクと認識タスクとの境界も確認してください。あるタスクはアプリケーションフローのためのトークンを返し、別のタスクは画像認識の結果を返します。どちらも CAPTCHA に関連しているからといって、同じものとして扱うと、誤ったリクエスト契約につながります。
受け付けられるまでランダムにタスク名を試すのは避けてください。こうした方法は元々の失敗原因を分かりにくくし、アプリケーションが本来必要としているものとは別の操作を引き起こす場合があります。
CapSolver ボーナスコードを利用しよう
自動化予算を今すぐ増やしましょう！
チャージ時にボーナスコード CAP26 を入力すると、すべての入金額に対して 5% の追加ボーナス が無制限で付与されます。
今すぐ CapSolver ダッシュボード で引き換えてください。
各インテグレーション面で定義された名前は、そのインターフェース固有のものとして扱ってください。
REST リクエストはタスクオブジェクトを送信します。SDK はメソッドや正規化された検出値を公開することがあります。MCP クライアントは、独自の入力スキーマを持つツールを名前で呼び出します。あるレイヤーから返された名前が、そのまま別レイヤーで有効な task.type になるとは限りません。
たとえば、Core SDK リファレンス はブラウザおよびソルビングメソッドについて説明しています。その SDK を使用する場合は、記載されているパラメータに従ってください。REST リクエストを直接構築する場合は、REST 用タスクリファレンスを利用します。MCP を利用する場合は、ツール名を REST の task フィールドに入れず、そのツールのスキーマを確認してください。
これはマイグレーション時に特に重要です。パッケージの置き換えや API ホストの変更によって、古い設定値がそのまま残ることがあります。レスポンス形式が似ているサービスであっても、対応する task identifier やオプションフィールドは異なることがあります。送信元と送信先の契約を、明示的に比較してください。
サポートされていない機能は、プロバイダがサポートルートを公式に文書化するまで、サポートされないままにしておくべきです。バリデーションを通すためだけに、別のチャレンジファミリへ密かに差し替えてはいけません。
同じ設定がすべてのワーカーに流れ込む前に、まず修正済みリクエスト 1 件を検証してください。
最初に、明らかに不整合なリクエストの自動再送を止めます。そのうえで特定したミスマッチ部分を修正し、範囲を絞ったチェックを実行してください。広いワークフローを再開する前に、返されたステータスとフィールドを確認します。
HTTP における非冪等リクエストのリトライに関するガイダンス は、ネットワーク障害で操作の結果が不明なままになった場合に参考になります。新規のタスク作成リクエストが、既存タスクの結果取得と同一であるとみなしてはいけません。互換性エラーと伝送の不確実性とは、別々に扱う必要があります。
修正後のリクエストが受け付けられたら、そのタスクに関して文書化されているレスポンスフローに従って処理を続けてください。結果を直ちに返す操作もあれば、結果取得が別途必要な操作もあります。以前の連携がそうだったからといって、タスク ID をでっち上げたり、ポーリングを開始したりしてはいけません。
繰り返しリクエストをかけることで圧力がかかるような問題については、別の CAPTCHA API トラブルシューティングリファレンス を使って、実際に返された状態を特定してください。未サポートタイプ、レートリミット、アカウントエラーは、同じ失敗に対する異なるラベルではありません。
契約が合っていないように見える状況を、コンパクトでマスク済みの再現例として送ってください。
利用したドキュメントの URL、正確な task type、エンドポイント、関わっている SDK やラッパーのバージョン、そして完全なエラーコードと説明を含めます。リクエスト時刻（タイムゾーン付き）と、可能であればタスク ID も追加してください。
何が変わったのか（パッケージのアップグレード、プロバイダの移行、新しい CAPTCHA ファミリ、デプロイ設定の変更など）を説明してください。アプリケーション全体のログよりも、サポート側が調査を始める範囲を絞り込むことができます。
アカウントのシークレットや、完全な認証済みブラウザキャプチャを、最初から送信しないでください。必要なのは、サポートされていない操作と、それに関連するリクエスト形式を示すことです。さらなる証拠が必要な場合は、適切なサポート手順に従って提供してください。
既存の unsolvable-error ガイド は、別のステージを対象としています。これは「認識までは行われたが、その試行では解答が得られなかったタスク」のためのガイドです。そのエラーを受け取った場合にのみ使用してください。
まずタスク契約を修復し、修正済みリクエストを限定的にテストして結果を確認してください。CapSolver の最新タスクリファレンスは、受け付けられる名前と必須フィールドを確認するための情報源です。名前を明示的に管理しておくことで、マイグレーションやサポート調査を容易にレビューできます。
Q: リトライすれば ERROR_TASK_NOT_SUPPORTED は解消しますか？
タスクタイプが誤っている、またはサポートされていないままでは、リトライしても状況は変わりません。再送前に契約内容と実際のリクエストを確認してください。
Q: これは ERROR_CAPTCHA_UNSOLVABLE と同じですか？
いいえ。未サポートタスクのエラーは要求したタイプに関する問題であり、unsolvable エラーは CAPTCHA の認識試行が解決に至らなかったことを示します。修正策を選ぶ前に、返却されたレスポンスを正確に確認してください。
Q: SDK の検出名を task.type として使えますか？
REST リファレンスにその値が明示的に記載されている場合のみ可能です。検出ラベル、SDK メソッド名、MCP ツール名は、別々のインターフェース概念です。
Q: プロバイダを変更した後にエラーが出始めたのはなぜですか？
プロバイダを変更しても、以前のサービス向けのタスク識別子やマッピングが残っている場合があります。最終的にシリアライズされたリクエストを、新しいプロバイダ側の最新リファレンスと比較してください。
Q: まず sitekey を変更すべきですか？
自動的にそうすべきではありません。まずタスクタイプがサポートされているか確認してください。そのうえで、ページ URL や sitekey を含むファミリ固有のフィールドを、ドキュメント化された契約と照合してください。
Sora Fujimoto
AI Solutions Architect
Connecting agents, browsers, and APIs into one workflow.
著者について
ERROR_IP_BANNED を解決するには、CAPTCHA API への誤ったリクエストを繰り返し送信するのをやめ、最初のエラーを特定し、関連するコードを確認したうえで、制御されたテストで処理を再開してください。
CAPTCHA画像認識とトークン解決を比較し、それぞれの入力と出力を理解したうえで、あなたの認可された自動化に最適なAPIワークフローを選択してください。
