# 驗證碼解決方案

### **驗證碼解決方案**

\
在使用我們的採集瀏覽器時，難免會遇到需要解決的風險控制驗證碼。這些驗證碼可能會影響您的自動化任務。但請放心，我們將協助您解決這一問題。

### **自訂CDP功能**

\
若遇到風險控制驗證碼，您需要透過CDP命令通知我們。收到指令後，我們將協助完成驗證碼破解。您只需發送CDP命令：`Captchas.automaticSolver` 並附上需要破解的驗證碼類型即可。

### **自動驗證碼破解功能**

\
您只需在可能出現驗證碼的程式碼部分加入以下程式碼片段，透過CDP命令告知我們需要破解的驗證碼類型，我們將立即協助處理。

{% tabs %}
{% tab title="Puppeteer" %}

```sh
const page = await page.newPage();  
await page.goto('https://example.com');  
```

{% endtab %}

{% tab title="Selenium" %}

```python
res = driver.execute_cdp_cmd("Captchas.automaticSolver", {
        "timeout": 120000,   # Please allow sufficient time, and 2 minutes is recommended.
        "solverType": "cloudflare"
    })
    print(f"Captchas solver result: {res}")
```

{% endtab %}
{% endtabs %}

### **範例說明**

{% tabs %}
{% tab title="JavaScript" %}

```sh
const puppeteer = require('puppeteer-core');

const Target_URL = "https://example.com";

const wsUrl = 'wss://{AUTH}@ws-browser.thordata.com';  //Your credentials
async function run(){

  // connect browser
  const browser = await puppeteer.connect({
	  browserWSEndpoint: wsUrl,
  });
  try{
	  console.log("Connected to browser...");
	
	  // Create a new page
	  const page = await browser.newPage();

	  // Go to target site
	  await page.goto(Target_URL, { waitUntil: "networkidle0" });

	  // Obtain the CDP client and send a custom CDP protocol
	  const client = await page.createCDPSession();
	  try {
		  const res = await client.send('Captchas.automaticSolver',{
			"timeout": 120000,  // Please allow sufficient time, and 2 minutes is recommended.
			"solverType": "cloudflare"   // Use the corresponding type.
		  });
		  
		  // {message: 'Solver meaages', success: true, timestamp: 170000000}
		  console.log("res=", res) 
	  } catch(e) {
		  console.error("err=", e)
	  }
	
	  // Verification
	  await page.screenshot({ path: 'solver_cf.png'});  
	  const title = await page.title();
	  console.log("title=", title);

  } catch (error) {
	  console.error(error);
  }
  finally{
	  console.info("browser closed")
	  await browser.close();
  }
 
}
run();
```

{% endtab %}

{% tab title="Python" %}

```python
import time

from selenium.webdriver.chromium.remote_connection import ChromiumRemoteConnection
from selenium.webdriver import Remote, ChromeOptions

scbr_connection =ChromiumRemoteConnection("https://{AUTH}@hs-browser.thordata.com", 'goog', 'chrome')

with Remote(sbr_connection, options=ChromeOptions()) as driver:
    print('Connected!')

    driver.get('https://example.com')
	
    # Send a custom CDP
    res = driver.execute_cdp_cmd("Captchas.automaticSolver", {
        "timeout": 120000,
        "solverType": "datadome"
    })
    #  {message: 'Solver message', success: true, timestamp: 170000000}
    print(f"Captchas solver result: {res}")
    print("title", driver.title)  
	
    # screenshot
    print('Page screenshot')
    driver.get_screenshot_as_file('./solver_cf.png')
```

{% endtab %}
{% endtabs %}

### **參數規範**

\
發送CDP命令時，必須包含 `solverType` 參數。

```
cloudflare    
google-v2    
datadome
```

###  **統一返回結構**

\
無論您使用我們的驗證碼解決方案破解何種類型的驗證碼，其返回結構均保持一致。

```
res= {
  message: 'captcha solver success',   //Description
  success: true,  //Sovler status   
  timestamp: 1755763768   //Timestamp
}
```