Util::ReCaptcha3 - Google ReCaptcha v3の認識
スクレイパーの概要
このスクレイパーは、Google ReCaptcha v3を解決する必要がある他のスクレイパーのプラグインコンポーネントとして使用するように設計されています。
このスクレイパーの動作原理は、リキャプチャデータ（リキャプチャが取得されたページのsitekeyとURL）を解決サービスに送信し、応答として数字と文字で構成されるトークンを受け取ることです。解決の正確さは解決サービスのみに依存しますが、通常、サービスはほとんどの場合リキャプチャを正しく解決します。
機能
- 以下のサービスに対応しています: AntiCaptcha, RuCaptcha, 2captcha, XEvil, CapMonster, CapMonster.cloud, CapSolver, captchas.io, NextCaptcha
- 応答待ち時間とステータス確認の遅延を設定可能
ユースケース
- 結果を取得するためにオプションまたは必須でキャプチャを解決する必要がある組み込みスクレイパーでのGoogle ReCaptcha v3の認識
- 自作のJSスクレイパーでのGoogle ReCaptcha v3の認識
クエリ
スクレイパーは以下の形式のクエリを受け付けます:
sitekeyurl
パラメータはスペースで区切られ、以下の意味を持ちます:
sitekey- リキャプチャのsitekeyです。一部のサービスではwebsitekeyと呼ばれます。通常、sitekeyはページコードから取得する必要があり、一般的には読み込まれるスクリプトのURLに含まれています:
https://www.google.com/recaptcha/api.js?render=SITEKEY
また、ページコード内で関数の引数として指定されている場合もあります:
grecaptcha.execute(SITEKEY, {action:'verify'}).
url- リキャプチャが配置されているページ
結果の出力例
$resp- リキャプチャの応答$error- エラーが発生した場合、その説明
リキャプチャトークンの出力
結果の形式:
$resp
結果の例:
03AGdBq24qfVWiRMofkMHuxaaW024vkt2Oc4Nnt4WXs3PdV0fJlpDystp444u_rG8HvuJUgN3n-upnHJXeQODxHjn_X9JdRlKEzhDnatYyehxN00WDWN_37LKwdHOgER2TrdB7XBKqrz5rko_CGWea6R1Lfe3eKmkoOeHkTyn8H3ZI90wcSvZR8gSztvq5EZWpGdNgLq15w84F92-PR8S051gUH2Ls82An0N4iiAIcTFrOTQZizqfIjgVzCzqHhSaigIPGy6j8-3nt1sac7q6Xn26fKLsQzd4hZDmrlem5rNoK-IQHEb_AUJ6r4UxQZQ-z4hk9wPpzdeiCi81sxWEX5YI-cn4cWYFsoWutv_DYvZy87Iog7u1VELGWvjT3XwkY3MyDZzpUfauyCGSd5oouLDhV5YnRPfMm-gWQUSRpt28z5xbVbwGSAfmMLEpFboCgKZdUhb-IdAiKHGA4oSXB3RhOA9TQZR-ETVqyUG8A4wJEXdCvEHU7Uhw
可能な設定
使用するサービスを選択するには、Providerパラメータを使用します。
オンラインサービス（AntiCaptcha, RuCaptcha, 2captcha, CapMonster.cloud, CapSolver, captchas.io）の場合、必ずClient keyパラメータを設定する必要があります。
| パラメータ | デフォルト値 | 説明 |
|---|---|---|
| Client key | オンライン解決サービス用のクライアントキー | |
| Provider url | プロバイダーのURL。ドメインを上書きできます。カンマ区切りで複数指定でき、スクレイパーはそれらをランダムに使用します。空にすることもでき、その場合スクレイパーは選択された解決サービスに応じて適切なものを自動的に使用します | |
| Provider | AntiCaptcha | 解決サービス |
| Wait between get status | 5 | ステータス取得間の遅延 |
| Max wait time | 300 | 解決の最大待ち時間 |
| minScore | 0.3 | 結果に対する最小信頼度。サイトごとに実験的に調整されます。解決サービスに依頼する際、必要な最小スコアを持つワーカーを選択するフィルタを定義します |
| pageAction | Googleに送信され、サイト所有者がトークンを確認する際に表示されるactionパラメータの値。通常、関数の引数として指定されます: grecaptcha.execute('sitekey', {action:'ACTIONの値'}) | |
| isEnterprise | ☐ | このリキャプチャをRecaptcha Enterprise V3として解決するよう解決サービスに指示します。すべての解決サービスで動作するわけではありません |