OpenAI Agents SDKでのreCAPTCHA v3の解決方法

reCAPTCHA v3は非表示で動作し、チェックボックスや画像グリッドは表示されません。ユーザーのインタラクションをバックグラウンドでスコアリングします。OpenAI Agents SDKのエージェントがv3保護されたAPIやページにアクセスする場合、低スコアが発生し、ブロックや2次チャレンジがトリガーされます。CapSolverはAIサービスを通じて高スコアのreCAPTCHA v3トークン(0.7-0.9)を生成し、OpenAI Agents SDKの@function_toolを介して統合することで、エージェントが視覚的な操作なしに非表示の検証をクリアできるようにします。

TL;DR

• reCAPTCHA v3は非表示でスコアベースのもので、スコアが低すぎる場合、エージェントは静かに失敗します
• CapSolverはreCaptchaV3タスクタイプを通じて3〜8秒で高スコアトークン(0.7-0.9)を生成します
• website_url、website_key、page_actionパラメータ(例: "login"や"submit"などのアクション名)が必要です
• 統合にはOpenAI Agents SDKの@function_toolとCapSolverの非同期execute_tool()を使用します
• ブラウザは必要ありません — トークンモードはすべてのreCAPTCHA v3実装で動作します

reCAPTCHA v3がv2と異なる理由

reCAPTCHA v3は常に非表示で動作します。代わりに、ユーザーのセッションを0.0(おそらくボット)から1.0(おそらく人間)までのスコアリングをバックグラウンドで実行するJavaScriptが動作します。サイトオーナーはしきい値を設定し、通常は0.5〜0.7でそれ以下のリクエストをブロックまたはチャレンジします。

OpenAIエージェントの場合、これは静かな失敗モードを生み出します。エージェントはCAPTCHAウィジェットを見ることはありません。代わりに、APIコールは403エラーを返し、フォーム送信は静かに失敗するか、エラーページにリダイレクトされます。reCAPTCHA v3がブロックしていることを理解しなければ、エージェントは回復できません。

GoogleのreCAPTCHA v3ドキュメンテーションでは、スコアが「サイトとのインタラクション」に基づいていると説明されています。マウス移動やスクロールのない自動ブラウザや、素早くナビゲートするブラウザは一貫して0.3未満のスコアになり、ブロックされます。

CapSolverは0.7〜0.9のスコアを持つトークンを生成し、ほぼすべてのサイトのしきい値を通過させます。エージェントはこのトークンをリクエストとともに送信し、サイトはそれを高信頼性の人間のインタラクションとして受け入れます。

開始前に必要なもの

pip install git+https://github.com/capsolver-ai/capsolver-core.git
pip install git+https://github.com/capsolver-ai/capsolver-agent.git
pip install openai-agents

export CAPSOLVER_API_KEY="your-capsolver-api-key"
export OPENAI_API_KEY="your-openai-api-key"

ターゲットサイトのreCAPTCHA v3 page_actionを特定する必要があります。一般的なアクション: login、submit、homepage、register、checkout。grecaptcha.execute(sitekey, {action: '...'})でページソースを検索してください。

ステップ1 — reCAPTCHA v3の解決を関数ツールとして登録する

from agents import Agent, Runner, function_tool
from capsolver_agent.schema import execute_tool

@function_tool
async def solve_recaptcha_v3(
    website_url: str,
    website_key: str,
    page_action: str = "verify",
    min_score: float = 0.7
) -> str:
    """非表示のreCAPTCHA v3チャレンジを解決し、高スコアトークンを返します。
    
    サイトがreCAPTCHA v3(非表示、スコアベース)を使用している場合に使用します。
    トークンはリクエストとともに'g-recaptcha-response'として送信する必要があります。
    
    引数:
        website_url: ページの完全なURL
        website_key: reCAPTCHA v3のサイトキー
        page_action: アクション名(例: 'login', 'submit', 'verify')
        min_score: 最低許容スコア(デフォルト0.7、範囲0.1-0.9)
    """
    result = await execute_tool("solve_captcha", {
        "captcha_type": "reCaptchaV3",
        "website_url": website_url,
        "website_key": website_key,
        "page_action": page_action,
        "min_score": min_score
    }, api_key="YOUR_CAPSOLVER_API_KEY")
    
    if result["success"]:
        return f"reCAPTCHA v3を解決しました (スコア ≥{min_score}). トークン: {result['solution']['token']}"
    return f"失敗: {result['error']}"

ステップ2 — エージェントを構築する

v3_agent = Agent(
    name="APIアクセスエージェント",
    instructions="""APIやreCAPTCHA v3(非表示)で保護されたページにアクセスします。
    
    reCAPTCHA v3を使用しているページの特徴:
    - スクリプトタグ: <script src="...recaptcha/api.js?render=SITE_KEY">
    - ページに表示されるCAPTCHAウィジェットがない
    - APIが403エラーを返すか、静かに失敗する
    
    v3トークンが必要な場合:
    1. スクリプトのrenderパラメータからサイトキーを特定する
    2. grecaptcha.execute呼び出しの{action: '...'}からpage_actionを特定する
    3. これらのパラメータでsolve_recaptcha_v3を呼び出す
    4. トークンをリクエストとともにg-recaptcha-responseとして送信する""",
    tools=[solve_recaptcha_v3]
)

async def main():
    result = await Runner.run(
        v3_agent,
        "https://example.com/api/dataのAPIにアクセスしてください。reCAPTCHA v3を使用しており、サイトキーは6LdKlZEpAAAAAN...で、アクションは'getData'です。有効なトークンを取得してください。"
    )
    print(result.final_output)

import asyncio
asyncio.run(main())

ステップ3 — reCAPTCHA v3パラメータを特定する

reCAPTCHA v3パラメータはページのJavaScriptにあります:

// スクリプトタグ内のサイトキー
<script src="https://www.google.com/recaptcha/api.js?render=6LdKlZEpAAAAAN..."></script>

// execute呼び出しのアクション
grecaptcha.execute('6LdKlZEpAAAAAN...', {action: 'submit'}).then(function(token) {
    document.getElementById('g-recaptcha-response').value = token;
});

reCAPTCHA v3の識別ガイドでは、これらの値の抽出方法が説明されています。CapSolver拡張機能は、どのページでもv3パラメータを自動検出します。

ボーナーコードを取得してください: CapSolverダッシュボードでコードWEBSを使用して、すべての充電で追加の5%ボーナスを取得してください。

結論

OpenAI Agents SDKでreCAPTCHA v3を解決するには、サイトキーとpage_actionを特定し、@function_toolを介してCapSolverのreCaptchaV3タスクタイプを呼び出す必要があります。v2とは異なり、表示されるウィジェットはありません。エージェントは静かな失敗を認識し、積極的に高スコアトークンを生成する必要があります。CapSolverは3〜8秒で0.7〜0.9のスコアを持つトークンを生成し、ブラウザ操作なしに非表示の検証をクリアします。

FAQ

CapSolverはreCAPTCHA v3に対してどのスコアを生成しますか？

CapSolverは0.7〜0.9のスコアを持つトークンを生成し、ほぼすべてのサイトのしきい値を通過させます。多くのサイトではしきい値が0.5〜0.7に設定されているため、CapSolverのトークンは常に検証を通過します。

reCAPTCHA v3の解決にはブラウザが必要ですか？

いいえ。トークンモードはブラウザなしで動作します。サイトキー、URL、アクションを提供するだけで、トークンを取得できます。これにより、ほとんどの場合でv2よりもv3の解決が速く簡単になります。

page_actionが分からない場合はどうすればいいですか？

一般的なアクションを試してください: verify、submit、login、homepage。どれも動作しない場合は、ページソースを検査してgrecaptcha.execute呼び出しを探してください。アクションパラメータはクライアントサイドJavaScriptに常に表示されます。

reCAPTCHA v3 Enterpriseは異なりますか？

はい。Enterprise v3にはenterprise: trueフラグが必要な場合があり、おそらくsトークンが必要です。CapSolverはEnterpriseバージョンを処理します。標準的な方法が動作しない場合は、パラメータにenterprise: trueを追加してください。