CDP API

Scrapeless Scraping Browserは、標準的なCDP（Chrome DevTools Protocol）機能を拡張し、ブラウザの自動化機能を強化するための強力なカスタム関数を一連追加しています。このドキュメントでは、主にCAPTCHA処理に関連するCDP関数を扱います。

CAPTCHAソルバー機能

機能概要

Scraping Browserには、Webページ上で遭遇する一般的なCAPTCHAタイプを自動的に処理できる、高度なCAPTCHA解決機能が含まれています。

サポートされているCAPTCHAタイプ

reCaptcha
Cloudflare Turnstile
Cloudflare 5s Challenge
AWS WAF

イベント監視メカニズム

コアイベント

Scraping Browserは、CAPTCHA解決プロセスを監視するための3つのコアイベントを提供します。

イベント名	説明
`Captcha.detected`	CAPTCHA検出
`Captcha.solveFinished`	CAPTCHA解決完了
`Captcha.solveFailed`	CAPTCHA解決失敗

イベントレスポンスデータ構造

フィールド	タイプ	説明
`type`	string	CAPTCHAタイプ: `recaptcha` `turnstile`
`success`	boolean	解決結果
`message`	string	ステータスメッセージ: `"NOT_DETECTED"` `"SOLVE_FINISHED"` `"SOLVE_FAILED"` `"INVALID"`
`token?`	string	成功時に返されるトークン（オプション）

実装例

// CAPTCHA解決イベントをリッスンします
const client = await page.createCDPSession();
 
client.on('Captcha.detected', (result) => {
  console.log('Captcha detected:', result);
});
 
await new Promise((resolve, reject) => {
  client.on('Captcha.solveFinished', (result) => {
    if (result.success) resolve();
  });
  client.on('Captcha.solveFailed', () =>
    reject(new Error('Captcha solve failed'))
  );
  setTimeout(() =>
      reject(new Error('Captcha solve timeout')),
    5 * 60 * 1000
  );
});

高度な設定API

Scraping Browserは、CAPTCHAソルバーの動作を細かく制御するための高度なAPIを提供します。以下のAPIがサポートされています。

API名	説明
`Captcha.setAutoSolve`	自動CAPTCHA解決動作を制御します
`Captcha.setToken`	CAPTCHAサービスの認証トークンを設定します
`Captcha.setConfig`	すべてのCAPTCHAソルバーパラメーターを設定します
`Captcha.solve`	CAPTCHA解決プロセスを手動でトリガーします

詳細なAPIの説明

1. `Captcha.setAutoSolve`

自動CAPTCHA解決動作を制御するための設定インターフェース。

const client = await page.createCDPSession();
await client.send('Captcha.setAutoSolve', {
    autoSolve: false,
    options: [{
        type: 'recaptcha',  // オプション: recaptcha | turnstile
        disabled: false,
    }]
});

2. `Captcha.setToken`

CAPTCHA解決サービスの認証トークンを設定します。

await client.send('Captcha.setToken', {
    apiKey: 'your-token'
});

3. `Captcha.setConfig`

CAPTCHAソルバーのすべてのパラメーターを設定します。

await client.send('Captcha.setConfig', {
    config: JSON.stringify(
        {
            apiKey: "your-token",
            autoSolve: true,
            enabledForRecaptcha: true,
            enabledForRecaptchaV3: true,
            enabledForTurnstile: true
        }
    )
});

4. `Captcha.solve`

CAPTCHA解決プロセスを手動でトリガーします。

const result = await client.send('Captcha.solve', {
    detectTimeout: 10 * 1000,
    options: JSON.stringify([{
        type: 'rcaptcha',
        disabled: true,  // rCaptchaの解決を無効化します
    }])
});
console.log(result);  // { type: 'recaptcha', success: true, message: 'solve_finished', token: 'xxx' }

カスタムフィンガープリントキャプチャ解決