クラウドフレアのターニースタイルを解決する方法: CapSolverとn8nを使用して

Cloudflare Turnstileは、現代のウェブサイトにとってのCAPTCHAの代替として急速に広がっています。従来のCAPTCHAがユーザーに画像パズルを解かせるのとは異なり、Turnstileはバックグラウンドで静かに動作します。これにより、標準的なオートメーションツールでは検出およびバイパスがより困難になります。

では、独自のTurnstileソルビングAPIを構築できるとしたらどうでしょうか？チャレンジを受信し、有効なトークンを返すAPIを、従来のコードを1行も書かずに構築できます。

このガイドでは、n8n（視覚的なワークフロー自動化ツール）と**CapSolver**（AI駆動のキャプチャソルビングサービス）を組み合わせて、Cloudflare Turnstileチャレンジをオンデマンドで解決する強力なAPIエンドポイントを作成する方法を学びます。

構築するもの:

• Cloudflare TurnstileソルバーAPI
• Turnstileを解決し、トークンをウェブサイトに送信し、保護されたデータを抽出するスクレイピングの例

Cloudflare Turnstileとは？

Cloudflare Turnstileは、従来のチャレンジの煩わしさなしにユーザーを検証するためのスマートなCAPTCHAの代替です。ユーザーにチェックボックスをクリックしたり、画像内のオブジェクトを識別したりする代わりに、Turnstileはブラウザのシグナルと行動分析を使用して訪問者を自動的に検証します。

ウィジェットモード

Turnstileは、ウェブサイトが選べる3つのウィジェットモードがあります。

ソルビングの観点から見ると、モードはCapSolverの構成方法を変えることはありません。常に同じパラメータが必要です: websiteURL と websiteKey。

TurnstileとCloudflareチャレンジ（同じではありません）

TurnstileをCloudflareのフルページセキュリティチャレンジ（サイトにアクセスする前に「セキュリティ検証を実行しています」の表示とロードバーが表示されるもの）と混同しないでください。これはCloudflareチャレンジ（JSチャレンジまたはマネージドチャレンジとも呼ばれる）であり、Turnstileではありません。

フルページの「セキュリティ検証を実行しています」画面が表示されている場合は、Turnstileではありません。これはCloudflareチャレンジであり、別のアプローチが必要です。より多くの違いを確認してください。

前提条件

開始する前に、以下のものを確認してください:

1. n8nのインスタンス — セルフホスト または n8n Cloud
2. CapSolverアカウント — ここから登録し、APIキーを取得してください
3. CapSolverのn8nノード — 既にn8nのオフィシャルノードとして利用可能（インストール不要）

重要: CapSolverアカウントに十分な残高があることを確認してください。Turnstileソルビングタスクは使用量に応じてクレジットを消費します。

n8nでのCapSolverの設定

CapSolverはn8nのオフィシャル統合として利用可能で、コミュニティノードのインストールは必要ありません。ワークフローを作成する際、ノードパネルで直接見つけることができます。

オフィシャル統合であるため、CapSolverノードがアカウントと認証するためにはクレデンシャルを作成する必要があります。

ステップ1: クレデンシャルページを開く

n8nインスタンスにアクセスし、設定 → クレデンシャルに移動してください。ここですべての設定済みクレデンシャルが表示されます。

ステップ2: CapSolverクレデンシャルを作成

1. クレデンシャルを作成（右上）をクリック
2. "CapSolver" を検索し、CapSolver API を選択
3. APIキーを入力 — CapSolverダッシュボードから直接コピー
4. 許可されたHTTPリクエストドメインを All（デフォルト）に設定
5. 保存をクリック

n8nは自動的に接続をテストします。有効なAPIキーであることを確認するため、緑色の**「接続は正常にテストされました」**のバナーが表示されます。

重要: ワークフロー内のすべてのCapSolverノードはこのクレデンシャルを参照します。一度作成すれば、すべてのソルバーのワークフローで共有されます。

これで、Turnstileソルバーのワークフローを作成する準備ができました！

Turnstileパラメータの特定方法

Turnstileチャレンジを解決する前に、そのパラメータ — 特に websiteURL と websiteKey（サイトキーとも呼ばれる）を知る必要があります。

Turnstileは2つのパラメータのみが必要なので、見つけるのは簡単です。

ウェブサイトURL

これは、Turnstileウィジェットが表示されているページの完全なURLです。ブラウザのアドレスバーからコピーしてください。

ウェブサイトキー（サイトキー）

サイトキーはページのHTMLに埋め込まれています。見つける方法はいくつかあります:

1. ページソースで data-sitekey を検索

ページを右クリック → ページのソースを表示（または Ctrl+U）し、data-sitekey を検索:

<div class="cf-turnstile" data-sitekey="0x4AAAAAAADV8V8V8V8V8V"></div>

2. JavaScriptで turnstile.render() を検索

一部のサイトではJavaScriptでTurnstileがレンダリングされます。ページソースで turnstile.render を検索:

turnstile.render('#widget', {
  sitekey: '0x4AAAAAAADV8V8V8V8V8V8V',
});

3. DevToolsのネットワークタブを確認

DevToolsを開く（F12）→ ネットワークタブ → turnstile または challenges.cloudflare.com でフィルタリング。サイトキーはリクエストURLやレスポンスデータに頻繁に表示されます。

4. HTMLで challenges.cloudflare.com を検索

TurnstileはCloudflareからスクリプトをロードします。ページソースでこのドメインを検索 — サイトキーは通常近くにあります:

<script src="https://challenges.cloudflare.com/turnstile/v0/api.js" async defer></script>

ヒント:

• サイトキーは常に 0x で始まり、長いアルファベットと数字の文字列です
• サイトがCloudflareのマネージドチャレンジ（サイトにアクセスする前のフルページチャレンジ）を使用している場合、Turnstileウィジェットはページソースにない場合があります — Cloudflareのチャレンジページから提供されます

ワークフロー: Cloudflare TurnstileソルバーAPI

このワークフローは、Turnstileパラメータを受け取り、解決されたトークンを返すPOST APIエンドポイントを作成します。

動作方法

このワークフローは3つのノードで構成されています:

1. Webhook — Turnstileパラメータを含むイングレスPOSTリクエストを受け取ります
2. Cloudflare Turnstile — チャレンジをCapSolverに送信し、解決を待機します
3. Webhookに応答 — 解決結果をJSONレスポンスとして返します

ノードの構成

1. Webhookノード

これにより、エンドポイントが作成されます: https://your-n8n-instance.com/webhook/solver-turnstile

2. CapSolver Cloudflare Turnstileノード

一部のサイトではmetadata.actionと/またはmetadata.cdataも必要です — これらはノードのオプションセクションで追加できます。また、このノードでCapSolverクレデンシャルを選択してください。

3. Webhookに応答ノード

これは、解決されたTurnstileトークンを含む完全なCapSolverの応答を返します。

テスト

WebhookエンドポイントにPOSTリクエストを送信してください:

curl -X POST https://your-n8n-instance.com/webhook/solver-turnstile \
  -H "Content-Type: application/json" \
  -d '{
    "websiteURL": "https://example.com/login",
    "websiteKey": "0x4AAAAAAADV8V8V8V8V8V8V"
  }'

期待される応答:

{
  "taskId": "abc123...",
  "solution": {
    "token": "0.XXXXXXXXXXXXXXXX..."
  },
  "status": "ready"
}

このワークフローをインポート

以下のJSONをコピーし、メニュー → JSONからインポートでn8nにインポートしてください:

{
  "name": "Turnstile solver",
  "nodes": [
    {
      "parameters": {
        "httpMethod": "POST",
        "path": "solver-turnstile",
        "responseMode": "responseNode",
        "options": {}
      },
      "type": "n8n-nodes-base.webhook",
      "typeVersion": 2,
      "position": [-208, 0],
      "id": "137be4f0-1762-4f0c-b993-c512d27e35de",
      "name": "Webhook",
      "webhookId": "3d32ad61-d925-4a09-8fe5-7226e6664a98"
    },
    {
      "parameters": {
        "operation": "Cloudflare Turnstile",
        "websiteURL": "={{ $json.body.websiteURL }}",
        "websiteKey": "={{ $json.body.websiteKey }}",
        "optional": {}
      },
      "type": "n8n-nodes-capsolver.capSolver",
      "typeVersion": 1,
      "position": [192, 80],
      "id": "954ff1f0-d5de-4468-b0d1-fbce03676676",
      "name": "Cloudflare Turnstile",
      "credentials": {
        "capSolverApi": {
          "id": "sLg2YDZd7WtYJJJ4",
          "name": "CapSolver account"
        }
      }
    },
    {
      "parameters": {
        "options": {}
      },
      "type": "n8n-nodes-base.respondToWebhook",
      "typeVersion": 1.1,
      "position": [400, 0],
      "id": "db264e2b-48ce-4887-9b2b-2b8077993c30",
      "name": "Respond to Webhook"
    }
  ],
  "connections": {
    "Webhook": {
      "main": [
        [
          {
            "node": "Cloudflare Turnstile",
            "type": "main",
            "index": 0
          }
        ]
      ]
    },
    "Cloudflare Turnstile": {
      "main": [
        [
          {
            "node": "Respond to Webhook",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "active": true,
  "settings": {
    "executionOrder": "v1"
  }
}

APIパラメータリファレンス

TurnstileソルバーAPIエンドポイントは次のパラメータを受け付けます:

ヒント: websiteURL と websiteKey はページソースを検査することで特定できます — Turnstileパラメータの特定方法を参照してください。

reCAPTCHAと比較して、Turnstileはシンプルです — 必要なパラメータは2つだけです。一部のサイトでは、オプションの metadata.action または metadata.cdata フィールドも必要になる場合があります — タイクンが受け入れられなければ、ノードのオプションセクションに追加してください。

実際の例: Turnstileトークンをウェブサイトに送信する

上記のAPIワークフローでは、解決されたTurnstileトークンを取得する方法を紹介しています。しかし、実際に何をしますか？

現実的なオートメーションでは、チャレンジを解決するのは半分だけです。ターゲットウェブサイトにトークンを送信する必要があります — ブラウザが行うのと同じように、Turnstile保護の裏にあるデータやアクションを解除します。

一般的なパターンは次の通りです:

1. チャレンジを解決 → CapSolverからトークンを取得
2. トークンを送信 → cf-turnstile-responseフォームフィールドとしてターゲットウェブサイトに送信
3. 応答を確認 → ウェブサイトがトークンを受け入れたかを確認
4. 結果を処理 → 必要なデータを抽出

例: Turnstileの解決と送信

例: https://example.com/ — Turnstile保護されたウェブサイト

ワークフローのフロー

マニュアルトリガー → CapSolver Turnstile → HTTP POSTリクエスト → IF（成功を確認）→ フィールド編集（データを抽出）

動作方法

1. マニュアルトリガー — ワークフローを手動で開始します（「ワークフローを実行」をクリック）。これはWebhook、スケジュール、アプリイベントなどに置き換えることができます。
2. CapSolver Cloudflare Turnstile — Turnstileチャレンジを解決します:
   • オペレーション: Cloudflare Turnstile
   • ウェブサイトURL: https://example.com/login
   • ウェブサイトキー: 0x4AAAAAAA...（ページソースを検査して見つけてください — Turnstileパラメータの特定方法を参照）
3. HTTP POSTリクエスト — 解決されたトークンをターゲットウェブサイトに送信します:
   • トークンは cf-turnstile-response フォームフィールドとして送信されます
   • サイトが期待する他のフォームフィールド（例: username, password）も含めてください
   • これは、Turnstileが検証された後、フォームを送信するブラウザが行う動作です
4. IFノード — 応答が成功を示しているかを確認します（リダイレクト、成功メッセージ、または特定のJSONフィールドなど）
5. フィールドの編集 — 必要なデータを応答から抽出します。現実的なシナリオでは、この段階でHTMLノードを使用してHTMLを解析し、特定の要素（例: ユーザーのデータ、製品一覧、ダッシュボードの内容）を抽出し、出力フィールドにマッピングします。

重要なコンセプト: すべてのウェブサイトでトークンの送信方法が異なります。この例では、POSTでcf-turnstile-responseフォームフィールドにトークンを送信しますが、他のサイトでは別のフィールド名、JSONボディ、ヘッダー、または完全に別のエンドポイントを期待する場合があります。常にサイトの実際のフォーム送信（DevToolsのネットワークタブを使用）を確認して、トークンがどのように送信されるべきかを確認してください。

任意のTurnstile保護サイトにこのパターンを適用する方法

1. Turnstileパラメータを特定する — ページソースを検査してwebsiteURLとwebsiteKeyを見つける
2. フォーム送信を検査する — ブラウザのDevToolsのネットワークタブを使用して、フォームが送信されたときに送信するリクエスト（URL、メソッド、ヘッダー、ボディフィールド）を確認する
3. n8nでリクエストを再現する — HTTPリクエストノードをフォーム送信に正確に一致させるように構成し、正しいフィールド（通常はcf-turnstile-response）に解決されたトークンを挿入する（実際にフォームを確認してください）
4. 検証を追加する — IFノードを使用して応答をチェックし、データがアンロックされたことを確認する
5. データを抽出する — サイトがトークンを受け入れたら、応答を解析して必要なデータを抽出します。HTML応答にはHTMLノードを使用し、JSON応答にはフィールドの編集を使用します

注意: この例ではシンプルにするためにマニュアルトリガーを使用していますが、他のトリガーノードに置き換えることができます。Webhook（APIを構築するため）、スケジュール（毎時間実行）、アプリイベント（Telegramメッセージに反応するため）、または他の任意のノードです。すべてのオプションについてはワークフローをトリガーする方法を参照してください。

ワークフローをトリガーする方法

このガイドの例ではマニュアルトリガー（スクレイピングワークフロー用）とWebhook（APIワークフロー用）を使用していますが、n8nはワークフローを開始するための多くの方法を提供しています。トリガーノードをあなたの使用ケースに合わせて置き換えることができます：

例えば、スクレイピングワークフローを毎時間実行したい場合は、マニュアルトリガーをスケジュールトリガーノードに置き換えて、インターバルを1時間に設定するだけで済みます。ワークフローの他の部分はまったく同じです。

スクレイプされたデータの保存とエクスポート

ワークフローがTurnstileチャレンジを解決し、ターゲットウェブサイトからデータを取得した後、データを保存またはエクスポートしたいでしょう。n8nはデータ変換および出力ノードを組み込みで提供しています。

データ変換

保存する前に、n8nの組み込みノードを使用してスクレイプされたデータを変換できます：

出力先

IFノードが応答を検証した後、次のノードのいずれかを追加してデータを保存できます：

ヒント: 複数の出力を組み合わせることができます。たとえば、Googleスプレッドシートに保存し、Telegram通知を同時に送信するには、両方のノードをIFノードの「true」出力に接続します。

問題解決

"ERROR_KEY_DOES_NOT_EXIST" または無効なAPIキー

"ERROR_ZERO_BALANCE"

間違ったまたは期限切れのトークン

ウェブサイトがトークンを受信しない

タイムアウトまたは遅い応答

最適な実践方法

1. トークンをすぐに使用する — Turnstileトークンはすぐに期限切れになります。ソルバーAPIから受け取ったトークンをターゲットウェブサイトに即座に送信してください。

2. 構成する前にパラメータを確認する — ワークフローを構成する前に、ページソースを検査して正しいwebsiteKeyを確認してください。

3. APIキーを安全に保つ — あなたのCapSolver APIキーをクライアントサイドコードに公開しないでください。これらのn8nワークフローはキーをサーバーサイドに保ち、推奨されるアプローチです。

4. 残高を監視する — CapSolverダッシュボードで残高アラームを設定して、クレジット不足による予期しないワークフローの失敗を回避してください。

5. エラー処理を追加する — 製品ワークフローでは、CapSolverノードの後にIFノードを追加してエラーをチェックし、適切に対処してください（例: リトライ、通知、または失敗を記録）。

結論

Cloudflare TurnstileソルバーAPIとn8nとCapSolverを使用したスクレイピングワークフローの構築方法を学びました — 伝統的なコーディングは必要ありません。

このガイドでは、以下の内容をカバーしました:

• Webhookベースのワークフローを使用したCloudflare TurnstileのAPIソルバーのエンドポイント
• ターゲットウェブサイトに解決されたトークンを送信し、保護されたデータを抽出する現実的なスクレイピングパターン
• ページソースを検査してTurnstileパラメータを特定する方法
• トークン処理、エラーマネジメント、製品使用のための最適な実践方法

重要なポイント: Turnstileチャレンジを解決することは仕事の半分に過ぎません — あなたはトークンをターゲットウェブサイトに送信する必要もあります。保護されたデータをアンロックするためです。

準備ができましたか？ CapSolverに登録して、初回チャージで追加の8%ボーナスを受けるためにボーナスコードn8nを使用してください！

よくある質問

Cloudflare Turnstileとは何ですか？

Cloudflare Turnstileは、訪問者がパズルを解くことを求めないCAPTCHAの代替です。ブラウザのシグナルと行動分析を使用して、訪問者が人間であるかどうかをバックグラウンドで確認します。

n8nでCapSolverはどのCAPTCHAタイプをサポートしていますか？

CapSolverのn8nノードはCloudflare Turnstile、reCAPTCHA v2、reCAPTCHA v2 Invisible、reCAPTCHA v3などをサポートしています。詳細は n8n CapSolver統合ページをご覧ください。

Turnstileチャレンジを解決するにはどのくらいの費用がかかりますか？

使用量によって料金は異なります。現在のTurnstile料金についてはCapSolver料金ページをご確認ください。

Turnstileチャレンジを解決するにはどのくらい時間がかかりますか？

Turnstileチャレンジは通常数秒で解決されます。画像チャレンジが含まれていないためです。

n8n Cloudでこのワークフローを使用できますか？

はい！このワークフローは、セルフホストされたn8nとn8n Cloudの両方で動作します。CapSolverノードは既に公式の統合として利用可能です — ただAPI資格情報を追加するだけでOKです。

ウェブサイトのTurnstileサイトキーを見つける方法は？

HTMLでdata-sitekeyを検索するか、JavaScriptでturnstile.render()を探してください。DevTools（F12）→ ネットワークタブを開き、turnstileでフィルターをかけてリクエストでサイトキーを見つけることもできます。詳細はTurnstileパラメータの特定方法を参照してください。

TurnstileとreCAPTCHAの違いは何ですか？

Turnstileはプライバシーとユーザー体験に焦点を当てたCloudflareのCAPTCHAの代替で、目に見えるチャレンジをほとんど表示しません。reCAPTCHAはGoogleのボット検出システムで、画像パズル（v2）を解決するか、行動スコアを割り当てます（v3）。どちらもn8nでCapSolverで解決できます。

CapSolverがTurnstileチャレンジを解決できなかった場合どうなりますか？

CapSolverノードはエラーを返します。製品ワークフローでは、エラー処理（例: エラーをチェックするIFノードとリトライメカニズムまたは通知）を追加することを推奨します。