CAPTCHA APIとブラウザー拡張機能：自動化に適しているのは？
コードで解決結果を受け取り、対象サイトに送信する必要がある場合は API を選んでください。必要な対話型ブラウザーフローをプロバイダーが明示的にサポートしている場合は、拡張機能を検討してください。ブラウザー自動化ではどちらの方法も利用できます。ブラウザーを実行するからといって、拡張機能のほうが適しているとは限りません。
solvethree が提供するのは REST タスク API であり、ネイティブのブラウザー拡張機能ではありません。返された解決結果の適用と対象サイトの応答の確認は、引き続きアプリケーション側で行う必要があります。
このページの内容
必要なワークフローに合わせて選ぶ
| ワークフロー | 選ぶ方法 | 引き続き必要な作業 |
|---|---|---|
| サーバー側のワーカーが対象サイトに直接リクエストを送信する。 | API。 | タスクを作成し、解決結果を取得して、対象サイトへのリクエストに適切な出力を含める。 |
| 既存の自動化処理がブラウザーを制御している。 | 明示的に制御するなら API。拡張機能は、そのブラウザーフローがプロバイダーのドキュメントに記載されている場合のみ。 | API を使う場合、ブラウザー自動化側で結果を適用して送信する必要があります。拡張機能を使う場合は、どの手順を処理するのか正確に確認してください。 |
| ユーザーが対話型のブラウザーセッションで操作する。 | 対象サイトとブラウザーへの対応がドキュメントに記載された拡張機能を検討する。 | インストール要件、権限、認証情報の扱い、意図したブラウザーセッションで動作するかを確認する。 |
API の応答は、汎用的なブラウザー操作コマンドではありません。「ブラウザー操作を処理するものをインストールする」ことが要件なら、solvethree の API だけでは満たせません。
採用前に権限と保守を比較する
- 認証情報： solvethree の API キーはページ内のスクリプトではなく、サーバーに保管してください。拡張機能の場合は、インストール前にプロバイダーの認証情報の取り扱い手順と要求される権限を確認してください。
- セッションの管理主体： ブラウザープロファイル、プロキシ、対象サイトのセッションをどのコンポーネントが管理し、どのコンポーネントが解決結果を送信するのかを明確にしてください。拡張機能をインストールすれば既存の API 連携につながるとは考えないでください。
- 保守： API の場合、ブラウザー固有の手順も含め、タスク処理と対象サイトへの送信は自分のコードで管理します。拡張機能の場合は、対応ブラウザー、更新手順、失敗の通知方法を確認してください。対象サイトのフロー変更はテストが必要なものとして扱い、拡張機能が必ず吸収してくれるとは考えないでください。
実際に利用する連携方法のドキュメントを参照してください。CapSolver は API とブラウザー拡張機能の連携を別々に説明しています。API の例だけでは、拡張機能が何をするかは判断できません。
solvethree の位置づけ
連携方法だけでなく、まず製品を確認してください。solvethree は、トークンを返す reCAPTCHA v3 Enterprise と標準の v3、ヘッダーを返す Kasada、生の Cookie 値を返す Ticketmaster TMPT に対応しています。これらの出力は、それぞれ異なる送信処理を必要とします。reCAPTCHA v2、hCaptcha、Turnstile には対応していません。
アプリケーションコードでは、REST API、Node.js 向けの公式 JavaScript SDK、または Python SDK を使用してください。両 SDK は、タスクを 1 件作成して結果をポーリングする solve メソッドを提供しています。どちらもブラウザーや対象サイトへの解決結果の適用は行いません。
MCP ホスト向けには、公式のローカル stdio サーバーがタスク用ツールを公開しています。ブラウザーの操作やフォームへの入力は行わないため、拡張機能の代わりにはなりません。
この受け渡しの実装には、API ドキュメントを参照してください。既存のプロバイダーから切り替える場合は、リクエストに互換性があると考えず、CapSolver 移行ガイドまたは 2Captcha 移行ガイドに従ってください。
参照元とAPIリファレンス
最初のタスクを実行しましょう。
$5のワークスペースクレジットで始められます。