pip install botasaurus

from botasaurus.browser import browser, Driver

@browser()
def scrape_page(driver: Driver, data):
    driver.get("https://example.com")
    title = driver.get_text("h1")
    return {"title": title}

# Chạy trình quét
result = scrape_page()

pip install botasaurus capsolver requests python-dotenv

CAPSOLVER_API_KEY=CAP-YOUR_API_KEY_HERE

# shared/config.py
import os
from pathlib import Path
from dotenv import load_dotenv

# Tải tệp .env từ thư mục gốc dự án
ROOT_DIR = Path(__file__).parent.parent
load_dotenv(ROOT_DIR / ".env")

class Config:
    """Lớp cấu hình cho tích hợp CapSolver."""

    # Khóa API CapSolver
    CAPSOLVER_API_KEY: str = os.getenv("CAPSOLVER_API_KEY", "")

    # Các điểm cuối API CapSolver
    CAPSOLVER_API_URL = "https://api.capsolver.com"
    CREATE_TASK_ENDPOINT = f"{CAPSOLVER_API_URL}/createTask"
    GET_RESULT_ENDPOINT = f"{CAPSOLVER_API_URL}/getTaskResult"

    @classmethod
    def validate(cls) -> bool:
        """Kiểm tra xem cấu hình có hợp lệ không."""
        if not cls.CAPSOLVER_API_KEY:
            print("Lỗi: CAPSOLVER_API_KEY chưa được thiết lập!")
            return False
        return True

<div class="g-recaptcha" data-sitekey="6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-"></div>

grecaptcha.render('container', {'sitekey': '6Le-xxxxx...'});

# utils/capsolver_helper.py
import time
import requests
from shared.config import Config

def solve_recaptcha_v2(
    website_url: str,
    website_key: str,
    is_invisible: bool = False,
    timeout: int = 120
) -> dict:
    """
    Giải reCAPTCHA v2 bằng API CapSolver.

    Args:
        website_url: URL của trang có CAPTCHA
        website_key: Khóa trang web reCAPTCHA
        is_invisible: Có phải là reCAPTCHA v2 không hiển thị không
        timeout: Thời gian tối đa chờ giải pháp (giây)

    Returns:
        dict với 'gRecaptchaResponse' token
    """

    if not Config.validate():
        raise Exception("Cấu hình không hợp lệ - kiểm tra khóa API của bạn")

    # Xây dựng nhiệm vụ
    task = {
        "type": "ReCaptchaV2TaskProxyLess",
        "websiteURL": website_url,
        "websiteKey": website_key,
    }

    if is_invisible:
        task["isInvisible"] = True

    payload = {
        "clientKey": Config.CAPSOLVER_API_KEY,
        "task": task
    }

    # Tạo nhiệm vụ
    response = requests.post(Config.CREATE_TASK_ENDPOINT, json=payload)
    result = response.json()

    if result.get("errorId") and result.get("errorId") != 0:
        raise Exception(f"Không thể tạo nhiệm vụ: {result.get('errorDescription')}")

    task_id = result.get("taskId")

    # Kiểm tra kết quả
    start_time = time.time()
    while time.time() - start_time < timeout:
        time.sleep(2)

        result_payload = {
            "clientKey": Config.CAPSOLVER_API_KEY,
            "taskId": task_id
        }

        response = requests.post(Config.GET_RESULT_ENDPOINT, json=result_payload)
        result = response.json()

        if result.get("status") == "ready":
            return result.get("solution", {})

        elif result.get("status") == "failed":
            raise Exception(f"Nhận nhiệm vụ thất bại: {result.get('errorDescription')}")

    raise Exception(f"Đã hết thời gian sau {timeout} giây")

from botasaurus.browser import browser, Driver
from shared.config import Config
from utils.capsolver_helper import solve_recaptcha_v2

DEMO_URL = "https://www.google.com/recaptcha/api2/demo"
DEMO_SITEKEY = "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-"

@browser(headless=False)
def solve_recaptcha_v2_with_api(driver: Driver, data: dict):
    """Giải reCAPTCHA v2 bằng API CapSolver và chèn token."""

    url = data.get("url", DEMO_URL)
    site_key = data.get("site_key", DEMO_SITEKEY)

    # Bước 1: Tải trang
    driver.get(url)
    driver.sleep(2)

    # Bước 2: Trích xuất khóa trang từ trang (tùy chọn)
    extracted_key = driver.run_js("""
        const recaptchaDiv = document.querySelector('.g-recaptcha');
        return recaptchaDiv ? recaptchaDiv.getAttribute('data-sitekey') : null;
    """)

    if extracted_key:
        site_key = extracted_key

    # Bước 3: Giải CAPTCHA qua API CapSolver
    solution = solve_recaptcha_v2(
        website_url=url,
        website_key=site_key
    )

    token = solution.get("gRecaptchaResponse")

    # Bước 4: Chèn token vào trang
    driver.run_js(f"""
        // Đặt giá trị trường văn bản ẩn
        const responseField = document.querySelector('[name="g-recaptcha-response"]');
        if (responseField) {{
            responseField.value = "{token}";
        }}

        // Kích hoạt callback nếu có sẵn
        if (typeof ___grecaptcha_cfg !== 'undefined') {{
            try {{
                const clients = ___grecaptcha_cfg.clients;
                for (const key in clients) {{
                    const client = clients[key];
                    if (client && client.callback) {{
                        client.callback("{token}");
                    }}
                }}
            }} catch (e) {{}}
        }}
    """)

    # Bước 5: Gửi biểu mẫu
    submit_button = driver.select('input[type="submit"]')
    if submit_button:
        submit_button.click()
        driver.sleep(2)

    return {"success": True, "token_length": len(token)}

# Chạy demo
result = solve_recaptcha_v2_with_api(data={"url": DEMO_URL, "site_key": DEMO_SITEKEY})

grecaptcha.execute('siteKey', {action: 'login'})
// 'login' là pageAction của bạn

def solve_recaptcha_v3(
    website_url: str,
    website_key: str,
    page_action: str,
    timeout: int = 120
) -> dict:
    """
    Giải reCAPTCHA v3 bằng API CapSolver.

    Args:
        website_url: URL của trang có CAPTCHA
        website_key: Khóa trang web reCAPTCHA
        page_action: Tham số hành động (BẮT Buộc cho v3)
        timeout: Thời gian tối đa chờ giải pháp (giây)

    Returns:
        dict với 'gRecaptchaResponse' token
    """

    if not Config.validate():
        raise Exception("Cấu hình không hợp lệ - kiểm tra khóa API của bạn")

    if not page_action:
        raise Exception("pageAction là BẮT Buộc cho reCAPTCHA v3")

    # Xây dựng nhiệm vụ
    task = {
        "type": "ReCaptchaV3TaskProxyLess",
        "websiteURL": website_url,
        "websiteKey": website_key,
        "pageAction": page_action,  # BẮT Buộc cho v3
    }

    payload = {
        "clientKey": Config.CAPSOLVER_API_KEY,
        "task": task
    }

    # Tạo nhiệm vụ
    response = requests.post(Config.CREATE_TASK_ENDPOINT, json=payload)
    result = response.json()

    if result.get("errorId") and result.get("errorId") != 0:
        raise Exception(f"Không thể tạo nhiệm vụ: {result.get('errorDescription')}")

    task_id = result.get("taskId")

    # Kiểm tra kết quả
    start_time = time.time()
    while time.time() - start_time < timeout:
        time.sleep(2)

        result_payload = {
            "clientKey": Config.CAPSOLVER_API_KEY,
            "taskId": task_id
        }

        response = requests.post(Config.GET_RESULT_ENDPOINT, json=result_payload)
        result = response.json()

        if result.get("status") == "ready":
            return result.get("solution", {})

        elif result.get("status") == "failed":
            raise Exception(f"Nhận nhiệm vụ thất bại: {result.get('errorDescription')}")

    raise Exception(f"Đã hết thời gian sau {timeout} giây")

from botasaurus.browser import browser, Driver
from shared.config import Config
from utils.capsolver_helper import solve_recaptcha_v3

DEMO_URL = "https://recaptcha-demo.appspot.com/recaptcha-v3-request-scores.php"
DEMO_SITEKEY = "6LdyC2cUAAAAACGuDKpXeDorzUDWXmdqeg-xy696"
PAGE_ACTION = "examples/v3scores"

@browser(headless=False)
def solve_recaptcha_v3_with_api(driver: Driver, data: dict):
    """Giải reCAPTCHA v3 bằng API CapSolver và chèn token."""

    url = data.get("url", DEMO_URL)
    site_key = data.get("site_key", DEMO_SITEKEY)
    page_action = data.get("page_action", PAGE_ACTION)

    # Bước 1: Tải trang
    driver.get(url)
    driver.sleep(2)

    # Bước 2: Giải CAPTCHA qua API CapSolver
    solution = solve_recaptcha_v3(
        website_url=url,
        website_key=site_key,
        page_action=page_action
    )

    token = solution.get("gRecaptchaResponse")

    # Bước 3: Chèn token vào trang
    driver.run_js(f"""
        const token = "{token}";

        // Đặt trường ẩn nếu tồn tại
        const responseField = document.querySelector('[name="g-recaptcha-response"]');
        if (responseField) {{
            responseField.value = token;
        }}

        // Tạo trường ẩn nếu biểu mẫu tồn tại nhưng trường không tồn tại
        const forms = document.querySelectorAll('form');
        forms.forEach(form => {{
            let field = form.querySelector('[name="g-recaptcha-response"]');
            if (!field) {{
                field = document.createElement('input');
                field.type = 'hidden';
                field.name = 'g-recaptcha-response';
                form.appendChild(field);
            }}
            field.value = token;
        }});
    """)

    # Bước 4: Gửi hoặc xác minh
    buttons = driver.select_all("button")
    for button in buttons:
        if "verify" in button.text.lower() or "submit" in button.text.lower():
            button.click()
            driver.sleep(2)
            break

    return {"success": True, "token_length": len(token)}

# Chạy demo
result = solve_recaptcha_v3_with_api(data={
    "url": DEMO_URL,
    "site_key": DEMO_SITEKEY,
    "page_action": PAGE_ACTION
})

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

def solve_turnstile(
    website_url: str,
    website_key: str,
    action: str = None,
    cdata: str = None,
    timeout: int = 120
) -> dict:
    """
Giải quyết Cloudflare Turnstile bằng API CapSolver.

    Args:
        website_url: Địa chỉ URL của trang web chứa Turnstile
        website_key: Khóa trang web Turnstile (bắt đầu bằng 0x4)
        action: Hành động tùy chọn từ thuộc tính data-action
        cdata: Cdata tùy chọn từ thuộc tính data-cdata
        timeout: Thời gian chờ tối đa để nhận giải pháp (giây)

    Returns:
        dict với trường 'token'
    """

    if not Config.validate():
        raise Exception("Cấu hình không hợp lệ - kiểm tra khóa API của bạn")

    # Xây dựng dữ liệu nhiệm vụ
    task = {
        "type": "AntiTurnstileTaskProxyLess",
        "websiteURL": website_url,
        "websiteKey": website_key,
    }

    # Thêm thông tin tùy chọn
    metadata = {}
    if action:
        metadata["action"] = action
    if cdata:
        metadata["cdata"] = cdata

    if metadata:
        task["metadata"] = metadata

    payload = {
        "clientKey": Config.CAPSOLVER_API_KEY,
        "task": task
    }

    # Tạo nhiệm vụ
    response = requests.post(Config.CREATE_TASK_ENDPOINT, json=payload)
    result = response.json()

    if result.get("errorId") and result.get("errorId") != 0:
        raise Exception(f"Không thể tạo nhiệm vụ: {result.get('errorDescription')}")

    task_id = result.get("taskId")

    # Kiểm tra kết quả
    start_time = time.time()
    while time.time() - start_time < timeout:
        time.sleep(2)

        result_payload = {
            "clientKey": Config.CAPSOLVER_API_KEY,
            "taskId": task_id
        }

        response = requests.post(Config.GET_RESULT_ENDPOINT, json=result_payload)
        result = response.json()

        if result.get("status") == "ready":
            return result.get("solution", {})

        elif result.get("status") == "failed":
            raise Exception(f"Nhiệm vụ thất bại: {result.get('errorDescription')}")

    raise Exception(f"Đã hết thời gian sau {timeout} giây")

from botasaurus.browser import browser, Driver
from shared.config import Config
from utils.capsolver_helper import solve_turnstile

DEMO_URL = "https://peet.ws/turnstile-test/non-interactive.html"
DEMO_SITEKEY = "0x4AAAAAAABS7vwvV6VFfMcD"

@browser(headless=False)
def solve_turnstile_with_api(driver: Driver, data: dict):
    """Giải quyết Cloudflare Turnstile bằng API CapSolver và chèn token."""

    url = data.get("url", DEMO_URL)
    site_key = data.get("site_key", DEMO_SITEKEY)

    # Bước 1: Tải trang
    driver.get(url)
    driver.sleep(3)

    # Bước 2: Trích xuất khóa trang từ trang (tùy chọn)
    extracted_params = driver.run_js("""
        const turnstileDiv = document.querySelector('.cf-turnstile, [data-sitekey]');
        if (turnstileDiv) {
            const key = turnstileDiv.getAttribute('data-sitekey');
            if (key && key.startsWith('0x')) {
                return {
                    sitekey: key,
                    action: turnstileDiv.getAttribute('data-action')
                };
            }
        }
        return null;
    """)

    if extracted_params and extracted_params.get("sitekey"):
        site_key = extracted_params["sitekey"]

    # Bước 3: Giải Turnstile qua API CapSolver
    solution = solve_turnstile(
        website_url=url,
        website_key=site_key,
        action=extracted_params.get("action") if extracted_params else None
    )

    token = solution.get("token")

    # Bước 4: Chèn token vào trang
    driver.run_js(f"""
        const token = "{token}";

        // Tìm và điền trường cf-turnstile-response
        const responseFields = [
            document.querySelector('[name="cf-turnstile-response"]'),
            document.querySelector('[name="cf_turnstile_response"]'),
            document.querySelector('input[name*="turnstile"]')
        ];

        for (const field of responseFields) {{
            if (field) {{
                field.value = token;
                break;
            }}
        }}

        // Tạo trường ẩn nếu form tồn tại nhưng trường không có
        const forms = document.querySelectorAll('form');
        forms.forEach(form => {{
            let field = form.querySelector('[name="cf-turnstile-response"]');
            if (!field) {{
                field = document.createElement('input');
                field.type = 'hidden';
                field.name = 'cf-turnstile-response';
                form.appendChild(field);
            }}
            field.value = token;
        }});
    """)

    # Bước 5: Gửi form
    submit_btn = driver.select('button[type="submit"], input[type="submit"]')
    if submit_btn:
        submit_btn.click()
        driver.sleep(2)

    return {"success": True, "token_length": len(token)}

# Chạy ví dụ
result = solve_turnstile_with_api(data={"url": DEMO_URL, "site_key": DEMO_SITEKEY})

# Nhận token
solution = solve_recaptcha_v2(url, site_key)
token = solution.get("gRecaptchaResponse")

# Sử dụng ngay lập tức - không lưu trữ để sử dụng sau
driver.run_js(f'document.querySelector("[name=g-recaptcha-response]").value = "{token}"')
driver.select('button[type="submit"]').click()

try:
    solution = solve_recaptcha_v2(url, site_key)
except Exception as e:
    print(f"Giải quyết Captcha thất bại: {e}")
    # Triển khai logic thử lại hoặc phương án dự phòng

driver.sleep(2)  # Chờ sau khi tải trang
# ... giải Captcha ...
driver.sleep(1)  # Chờ trước khi gửi form

if not Config.validate():
    raise Exception("Vui lòng cấu hình khóa API trong tệp .env")