reCAPTCHA 追加パラメータの識別および提出方法 (v2/v3/Enterprise) | CapSolver ガイド

複雑なアンチボットおよびCAPTCHAチャレンジ、特にGoogleのreCAPTCHAに対処する際には、単にsitekeyとpageurlを提供するだけでは、有効なg-recaptcha-responseを取得することがしばしば困難です。多くのウェブサイトは追加パラメータを使用してセキュリティを強化し、自動化ソリューションがこの隠しデータを正確に識別し提出する必要があります。

この記事では、reCAPTCHAで一般的に使用される追加パラメータについて詳しく説明し、CapSolverなどのプロフェッショナルツールを使ってそれらを特定する方法、および完全なAPI送信例を紹介します。

1. コアコンセプト: reCAPTCHAの追加パラメータの理解

これらのパラメータは、通常のユーザーと自動化されたプログラムを区別するためにウェブサイトが設定するものです。その存在は、特定のサイト構成や使用しているreCAPTCHAのバージョンに依存します。

1.1. reCAPTCHAバージョンの違い

reCAPTCHAにはいくつかの主要なタイプがあり、それぞれ異なるパラメータの要件を持っています:

1.2. キーとなる追加パラメータの説明

重要な注意: これらのパラメータを送信する際には、その正確な目的を理解し、検出ツールを使用して存在を確認した場合にのみ含めてください。パラメータを無闇に追加すると、検証に失敗する可能性があります。

2. reCAPTCHAの追加パラメータを正確に特定する方法

これらの隠しパラメータを特定する最も良い方法は、専門のCAPTCHA解決サービスが提供するブラウザ拡張機能を使用することです。たとえば、CapSolverのCaptcha Solver Auto Solve拡張機能が挙げられます。

ステップ1: CapSolver拡張機能をインストール

1. Chromeユーザー向け: Captcha Solver Auto Solve拡張機能をインストールしてください。
2. Firefoxユーザー向け: Captcha Solver Auto Solve拡張機能をインストールしてください。

ステップ2: デベロッパー・ツールを使用した検出

1. reCAPTCHAを解決する必要があるウェブサイトにアクセスしてください。
2. ページ上でF12キーを押すか、右クリックして「検証」を選択してデベロッパー・ツールを開きます。
3. CapSolver Captcha Detectorタブに切り替えてください。
   
4. CapSolverパネルを開いたままにして、ページでreCAPTCHAをトリガーしてください（例: ログインボタンをクリックする、ページを更新する）。
5. 拡張機能は自動的に必要なすべてのパラメータをキャプチャし、解析します。

ステップ3: JSON送信データを取得

パラメータが正常にキャプチャされると、CapSolver拡張機能のパネルはすぐにJSON形式で必要な情報を表示します。このJSONはAPIリクエストに直接使用でき、タスク送信が完全かつ正確になります。

検出可能なパラメータ一覧:

• ウェブサイトURL
• サイトキー
• isInvisible
• pageAction
• isEnterprise
• isSRequired（s-data/enterprisePayloadが必要かを示す）
• isReCaptchaV3
• APIドメイン
• Anchor
• Reload

3. API送信例: 追加パラメータを含む

CapSolverのAPIは、検出されたすべてのパラメータを統一されたインターフェースを通じて送信できるように設計されています。以下は、enterprisePayloadやapiDomainなどの追加パラメータを含むreCAPTCHAエンタープライズタスクを送信するPythonの例です。

import requests
import time

# あなたのCapSolver APIキー
API_KEY = "YOUR_CAPSOLVER_API_KEY"

# APIエンドポイント
CREATE_TASK_URL = "https://api.capsolver.com/createTask"
GET_TASK_RESULT_URL = "https://api.capsolver.com/getTaskResult"

# CapSolver拡張機能で検出されたパラメータ
site_key = "6Lc_a_xxxxxxxxxxxxxxxxxxxxxxx"
page_url = "https://example.com/login"
enterprise_payload = "拡張機能から取得したs-dataペイロード"

def solve_recaptcha():
    # 1. タスクを作成
    task_payload = {
        "clientKey": API_KEY,
        "task": {
            "type": "ReCaptchaV2EnterpriseTask",
            "websiteURL": page_url,
            "websiteKey": site_key,
            "enterprisePayload": {
                "s": enterprise_payload
            },
            "apiDomain": "www.recaptcha.net"
        }
    }

    try:
        response = requests.post(CREATE_TASK_URL, json=task_payload)
        response.raise_for_status()
        task_data = response.json()

        if task_data.get("errorId") == 0:
            task_id = task_data.get("taskId")
            print(f"タスクが正常に作成されました。タスクID: {task_id}")

            # 2. 結果をポーリング
            while True:
                result_payload = {
                    "clientKey": API_KEY,
                    "taskId": task_id
                }
                result_response = requests.post(GET_TASK_RESULT_URL, json=result_payload)
                result_response.raise_for_status()
                result_data = result_response.json()

                if result_data.get("errorId") == 0:
                    status = result_data.get("status")
                    if status == "ready":
                        # 成功！トークンを取得
                        token = result_data["solution"]["gRecaptchaResponse"]
                        print(f"CAPTCHAが解決されました。トークン: {token[:30]}...")
                        return token
                    elif status == "processing":
                        print("タスクはまだ処理中です。待機中...")
                        time.sleep(5)  # 5秒待機して再度確認
                    else:
                        print(f"タスクに失敗しました。ステータス: {status}")
                        return None
                else:
                    print(f"結果の取得中にエラーが発生しました: {result_data.get('errorDescription')}")
                    return None
        else:
            print(f"タスクの作成中にエラーが発生しました: {task_data.get('errorDescription')}")
            return None

    except requests.exceptions.RequestException as e:
        print(f"APIリクエスト中にエラーが発生しました: {e}")
        return None

if __name__ == '__main__':
    solve_recaptcha()

よくある質問（FAQ）

Q1: なぜ追加パラメータを提出する必要がありますか？

A: いくつかのウェブサイトは、reCAPTCHAのエンタープライズ版やv3の行動分析などの高度な機能を使用してセキュリティを強化しています。これらの機能は、enterprisePayloadやpageActionなどのクライアント側のコンテキストデータを必要とします。これらのパラメータが欠けていると、reCAPTCHAサービスはリクエストを適切に評価できず、タスクが失敗します。

Q2: パラメータが存在するかどうか分からない場合、提出しても良いですか？

A: 推奨されません。 ツール（例: CapSolver拡張機能）を使用して存在を確認し、有効な値を取得した場合のみパラメータを送信してください。不要なまたは誤ったパラメータを送信すると、APIリクエストが失敗したり、無効なトークンが返される可能性があります。

Q3: AnchorとReloadパラメータとは何ですか？自分でパースする必要がありますか？

A: AnchorとReloadは、特定のシナリオでCapSolver拡張機能によって検出される補助的なデータポイントです。これらを手動でパースする必要はありません。CapSolver拡張機能の価値は、これらのパラメータを自動的に検出し、使用可能なJSON形式で提供することです。拡張機能から提供される完全なパラメータセットをCapSolver APIに送信するだけで良いです。

Q4: reCAPTCHA v3のpageActionとv2のsitekeyの違いは何ですか？

A:

• sitekey (v2/v3): サイトを識別し、すべてのreCAPTCHAバージョンで必須の基本的なパラメータです。
• pageAction (v3): ユーザーが現在のページで実行する特定のアクション（例: login, checkout）を識別します。reCAPTCHA v3はこのアクションとユーザーの行動を組み合わせてリスクスコアを返します。このパラメータはv2では使用されません。

結論とさらなるリソース

reCAPTCHAの追加パラメータを識別し、送信するスキルは、自動化の成功にとって不可欠です。CapSolverなどのプロフェッショナルなツールやAPIを活用することで、最も複雑なCAPTCHAチャレンジにも自信を持って対処できます。

おすすめのリソース:

• CapSolver APIドキュメンテーション - reCAPTCHAタスクタイプとそのパラメータについて詳しく学びます。
• reCAPTCHA v3の解決方法 - v3のスコアメカニズムと解決方法について詳しく学びます。
• CapSolver拡張機能チュートリアル - 拡張機能の機能を最大限に活用する方法を学びます。

CapSolverのボーナスコードを取得

操作をさらに最適化する機会を逃さないでください！CapSolverアカウントにチャージする際、ボーナスコードCAPNを使用して、毎回チャージに5%のボーナスを獲得できます。CapSolverにアクセスして、今すぐボーナスを取得してください！