1. 非表示スクリプト
サイトキー付きで読み込まれたスクリプトは、それを使うすべてのページでバックグラウンド実行されます。訪問者にチェックボックスは表示されず、操作も不要です。
サイトキー付きで読み込まれたスクリプトは、それを使うすべてのページでバックグラウンド実行されます。訪問者にチェックボックスは表示されず、操作も不要です。
収集した行動データに基づき、Google は訪問者が人間である可能性を示すスコアを付けます。しきい値はサイト所有者が決めます。
サイトはスコアを自前のしきい値と比較します。下回った場合、追加の確認を求めるかリクエストをブロックできます。
grecaptcha.execute を呼び出します。success が true であること、スコアがしきい値を満たすこと、action が一致することを確認します。スコアが低い有効なトークンでも拒否されることがあります。reCAPTCHA v3 のスコアは 0.0(ボットの可能性)から 1.0(人間の可能性)です。Google はしきい値 0.5 を推奨します。適用・調整の前に実トラフィックを観察してください。
Google は 11 段階のスコアをサポートします。無料の Essentials は 0.1、0.3、0.7、0.9 を返します。課金を有効にすると全段階と reason code が利用できます。ステージングや導入初週のスコアは本番と異なることがあります。
CapMonster Cloud の minScore(0.1–0.9)はトークンの最低スコアを設定します。サイトのしきい値に合わせ、0.9 のような高い値は失敗を増やします。
pageAction は grecaptcha.execute の action と一致させる必要があります。英数字、スラッシュ、アンダースコアのみ使用できます。不一致は拒否されることがあります。minScore と pageAction の両方を渡してください。
スコアテストにはバックエンドが必要です。スコアは siteverify レスポンスで返ります。
1. テストページでサイトキーを使い、action 付きで grecaptcha.execute を呼び出します。
2. バックエンドからトークンとシークレットキーを https://www.google.com/recaptcha/api/siteverify に送信します。
3. 返された score をしきい値と比較し、action を確認します。
テストページを自作せず、reCAPTCHA v3 デモページをお試しください。
表は、4つの reCAPTCHA v3 解決サービスの価格、API 応答時間、成功率を示します。
| パラメータ | CapMonster Cloud | 2Captcha | CapSolver | DeathByCaptcha |
|---|---|---|---|---|
1000 解決あたりの価格(〜から) | $ 0.90 | $1.45 | $1.00 | $2.89 |
API 応答時間 | ≤ 2 秒 | ≤ 2 秒 | < 3 秒 | ≤ 3 秒 |
解決成功率 | 最大 99% | ~77–92% | ~95–98% | ~64–90% |
免責事項: 2Captcha、CapSolver、DeathByCaptcha は各所有者の商標です。CapMonster Cloud はこれらの団体と提携していません。パフォーマンス指標と価格比較は、公開データおよび 27.09.2026 に実施した内部ベンチマークに基づきます。
$0.10
新規ユーザーには CapMonster Cloud を試せる $0.10 のテスト残高が付与されます。
1. CapMonster Cloud に登録します。
2. アカウントに紐づくメールアドレスを添えて、ライブチャットまたは support@capmonster.cloud からサポートに連絡します。
CapMonster Cloud は CAPTCHA パラメータを受け取り、サーバーで処理して利用可能なトークンを返します。このトークンをフォームに挿入すれば、ユーザー操作なしでチェックを通過できます。 RecaptchaV3TaskProxyless タスクは CapMonster Cloud 自前のプロキシサーバーで実行されるため、プロキシパラメータは渡しません。
この段階では、API キー、CAPTCHA の種類、およびそのパラメータを送信します。サービスは後で結果を取得するための一意の taskId を返します。
reCAPTCHA v3 を解くリクエストには、次のパラメーターを指定する必要があります。
| パラメータ | 説明 |
|---|---|
typestring必須 | RecaptchaV3TaskProxyless |
websiteURLstring必須 | キャプチャを解決するページのアドレス |
websiteKeystring必須 | あなたのサイトのキャプチャが設置されているページに記載されているキー識別子(sitekey) https://www.google.com/recaptcha/api.js?render=SITE_KEY6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob |
isEnterpriseboolean任意 | reCAPTCHA v3 Enterprise では RecaptchaV3TaskProxyless に isEnterprise: true(true/false または 1/0)を設定します。CapMonster Cloud は RecaptchaV3EnterpriseTask と同様に処理します。 |
minScoredouble任意 | 0.1 から 0.9 までの値を取ることができます |
pageActionstring任意 | Google の ReCaptcha ウィジェットから渡される action パラメーターの値。既定値: verify grecaptcha.execute('site_key', {action: 'login_test'}) |
https://api.capmonster.cloud/createTask{
"clientKey": "API_KEY",
"task": {
"type": "RecaptchaV3TaskProxyless",
"websiteURL": "https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta",
"websiteKey": "6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob",
"minScore": 0.3,
"pageAction": "myverify"
}
}
{
"errorId":0,
"taskId":407533072
}
https://api.capmonster.cloud/getTaskResult{
"clientKey":"API_KEY",
"taskId": 407533072
}
{
"errorId": 0,
"status": "ready",
"solution": {
"gRecaptchaResponse": "3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKv…hKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
}
}
{
"errorId": 0,
"status": "ready",
"solution": {
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36",
"gRecaptchaResponse": "0cAFcWeA5Y3...hF8UWA",
"cookies": {
"nocookies": "true"
}
}
}userAgent も含まれます。ブラウザーやスクリプトのものと異なる場合でも、トークンの送信や対象ページでの解決の確認には、この UserAgent を使用してください。userAgent も含まれます。ブラウザーやスクリプトのものと異なる場合でも、トークンの送信や対象ページでの解決の確認には、この UserAgent を使用してください。reCAPTCHA v3 タスクにはサイトキー(websiteKey)とアクション名(pageAction)が必要です。
1. ページを右クリックして Inspect を選択します。
2. Elements または Network で api.js?render=SITE_KEY を探します。render= の後の値が websiteKey です。reCAPTCHA Enterprise は enterprise.js?render=SITE_KEY を使います。
3. grecaptcha.execute('SITE_KEY', {action: 'ACTION'}) を探します。ACTION が pageAction です。Enterprise は grecaptcha.enterprise.execute を使います。省略時はタスクのデフォルトが verify です。
4. 両方の値を取得するには、Playwright などのヘッドレスブラウザで grecaptcha.execute を捕捉します。JavaScript、Python、C# の例は CapMonster Cloud ドキュメントを参照してください。
import asyncio
from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import RecaptchaV3ProxylessRequest
client_options = ClientOptions(api_key="YOUR_API_KEY") # CapMonster Cloud の API キーを指定してください
cap_monster_client = CapMonsterClient(options=client_options)
# 必要に応じて残高(バランス)を確認できます
balance = asyncio.run(cap_monster_client.get_balance())
print("Balance:", balance)
recaptcha_v3_request = RecaptchaV3ProxylessRequest(
websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta", # CAPTCHA が設置されているページの URL
websiteKey="6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob", # 正しい値に置き換えてください
minScore=0.7, # 信頼スコアの最小閾値
pageAction="myverify" # ページ上のアクション
)
async def solve_captcha():
return await cap_monster_client.solve_captcha(recaptcha_v3_request)
responses = asyncio.run(solve_captcha())
print(responses)所有またはテスト許可のあるページで、Playwright、Puppeteer、Selenium を使い CI/CD で登録・チェックアウト・フォームフローを実行します。
リリースやしきい値変更後も、保護されたフォームとエンドポイントが動作し続けるか確認します。
スコアベースのチェックがある公開ページから公開データを収集します。
不可視のボットチェックに依存するサイトで、自動アシストワークフローを支援します。
ワークフローが CAPTCHA に達したとき、エージェントは MCP 経由でトークンを要求できます。
CapMonster Cloud は公開データ、および所有またはテスト許可のあるサイト向けに使ってください。許可なくログインやペイウォールの向こうの第三者データを収集することは禁止です。
reCAPTCHA Enterprise はスコアベースのチェックを使います。Essentials は 4 段階のスコアを返します。
Premium と Enterprise は 11 段階のスコアを返し、それぞれ基本および高度な説明情報を提供します。
reCAPTCHA v3 Enterprise では RecaptchaV3TaskProxyless に isEnterprise: true(true/false または 1/0)を設定します。CapMonster Cloud は RecaptchaV3EnterpriseTask と同様に処理します。
POST https://www.google.com/recaptcha/api/siteverify secret=YOUR_SECRET_KEY response=TOKEN
自サイトでは secret と response を https://www.google.com/recaptcha/api/siteverify に送信します。トークンは 2 分で期限切れになり、1 回のみ有効です。success、score、action を確認し、Google はしきい値 0.5 を推奨します。
Node.js / Python の例、エラー処理、スコアに基づくアクションは Captcha API (Google reCAPTCHA v3) を参照してください。
secretSecret keymissing-input-secretsecret パラメータがありません
secretSecret keyinvalid-input-secretsecret パラメータが無効または不正な形式です
responseTokenmissing-input-responseトークンがありません
responseTokeninvalid-input-responseトークンが無効または不正な形式です
requestRequestbad-requestリクエストが無効または不正な形式です
responseトークンの有効期限timeout-or-duplicateトークンが古すぎるか、すでに使用されています
minScore パラメータは 0.1 から 0.9 の値を受け付け、返されるトークンが持つべき最小の trust score を CapMonster Cloud に伝えます。0.3 は妥当な出発点です。高すぎる値(例:0.9)は解決失敗の可能性を高め、低すぎる値はサーバー側のしきい値で拒否されるスコアのトークンを返す可能性があります。テスト環境での実際の拒否率に合わせて値を調整してください。
ページを開き、開発者ツールで api.js?render=SITE_KEY を探します。render= の後の値が sitekey です。action は grecaptcha.execute(siteKey, {action: "..."}) の呼び出しに含まれます。Playwright で自動取得することもできます。読み込みごとに変わる値もあるため、取得後すぐにタスクを作成してください。詳しい手順はこちら。
1.0 は正当な操作である可能性が非常に高く、0.0 はボットである可能性が非常に高いことを示します。Google は既定のしきい値として 0.5 を推奨しています。適切な値は対象サイトのしきい値によって異なります。それに合わせて minScore を設定し、実際のトラフィックに応じて調整してください。スコアの確認方法はこちら。
reCAPTCHA v3 から受け取ったトークンは約 2 分間有効です。自動化パイプラインはこの時間内にトークンをサーバーに送信する必要があります。期限切れ後、Google の siteverify エンドポイントは success: false を返します。解決ステップをフォーム送信にできるだけ近づけ、リクエスト間でトークンをキャッシュしないでください。
トークンは一度しか検証できません。期限切れまたは使用済みの場合は timeout-or-duplicate が返ります。送信ごとに新しいトークンを取得してください。
reCAPTCHA v3 トークンを注入するには、非表示のレスポンスフィールド(通常は ID g-recaptcha-response の textarea または input)を見つけ、CAPTCHA ソルバーサービスから取得したトークンを挿入します。3 つの自動化フレームワークでの方法は以下のとおりです。
Playwright / Puppeteer(Node.js)
const token = "YOUR_TOKEN";
await page.evaluate((t) => {
document.getElementById('g-recaptcha-response').value = t;
}, token);
await page.click('#submit-btn');Selenium(Python)
token = "YOUR_TOKEN"
driver.execute_script(f"document.getElementById('g-recaptcha-response').value = '{token}';")
driver.find_element("id", "submit-btn").click()一部のサイトはトークン検証にコールバック関数を使用します。フォームが送信されない場合、コンソール(___grecaptcha_cfg.clients)で関数名を見つけて手動で呼び出してください:
await page.evaluate((t) => {
window.onSuccessCallback(t);
}, token);Google からの success: true レスポンスは、トークンが有効であることのみを意味します。トークンスコアが設定したしきい値を下回る場合、バックエンドはリクエストを拒否する可能性があります。
もう一つの一般的な問題は action の不一致です。トークンはタスク作成時に使用した action 値と同じ値で検証する必要があります。
問題の診断:
success が true の場合、error-codes 配列は通常空なので、主に確認すべきフィールドは score と action です。
はい。reCAPTCHA v3 タスクに isEnterprise: true を指定してください(true/false または 1/0)。RecaptchaV3EnterpriseTask と同様に処理されます。上のセクションと API ドキュメントをご覧ください。
進化する保護機能に対して 100% の成功率を保証できるツールはありませんが、CapMonster Cloud は reCAPTCHA v3 の解決で高い成功率を提供します。これは CapMonster Cloud チームによる毎月の社内ベンチマークに基づきます。実際の API 応答時間と成功率は、対象サイト、サーバー負荷、ネットワーク状況によって異なります。
reCAPTCHA は Google LLC の商標です。CapMonster Cloud は Google と提携しておらず、Google の承認も受けていません。本サービスは、公開データ、自身が所有するかテストの許可を得たウェブサイト、画像認識、アクセシビリティを対象としています。許可なくログインや有料アクセスで保護された第三者のデータを収集することは禁止されています。自身のアカウントはこの制限の対象外です。作業開始前にデータの法的な取り扱いを確認してください。