Hướng dẫn giải reCAPTCHA v3 trong OpenAI Agents SDK

reCAPTCHA v3 hoạt động một cách vô hình — không có hộp kiểm, không có lưới hình ảnh — đánh giá tương tác của người dùng ngầm. Khi các đại lý của OpenAI Agents SDK truy cập các API và trang được bảo vệ bởi v3, chúng nhận được điểm số thấp, gây ra việc chặn hoặc thách thức thứ cấp. CapSolver tạo ra các token reCAPTCHA v3 có điểm số cao (0.7-0.9) thông qua dịch vụ AI của mình, tích hợp với OpenAI Agents SDK bằng @function_tool để cho phép đại lý của bạn vượt qua xác minh vô hình mà không cần tương tác trực quan.

TL;DR

• reCAPTCHA v3 là vô hình và dựa trên điểm số — các đại lý sẽ thất bại mà không có thông báo khi điểm số quá thấp
• CapSolver tạo ra các token điểm số cao (0.7-0.9) trong 3-8 giây thông qua loại nhiệm vụ reCaptchaV3
• Yêu cầu các tham số website_url, website_key và page_action (tên hành động như "đăng nhập" hoặc "gửi")
• Tích hợp sử dụng @function_tool của OpenAI Agents SDK với execute_tool() bất đồng bộ của CapSolver
• Không cần trình duyệt — chế độ token hoạt động cho mọi triển khai reCAPTCHA v3

Tại sao reCAPTCHA v3 khác với v2

reCAPTCHA v3 không bao giờ hiển thị thách thức trực quan. Thay vào đó, nó chạy JavaScript ở nền đánh giá phiên người dùng từ 0.0 (có thể là bot) đến 1.0 (có thể là người thật). Chủ trang web thiết lập ngưỡng — thường từ 0.5-0.7 — và chặn hoặc thách thức các yêu cầu dưới ngưỡng đó.

Đối với các đại lý của OpenAI, điều này tạo ra chế độ thất bại âm thầm. Đại lý không thấy widget CAPTCHA để giải quyết. Thay vào đó, các cuộc gọi API trả về lỗi 403, các biểu mẫu gửi đi thất bại mà không thông báo, hoặc trang web chuyển hướng đến trang lỗi. Không hiểu rằng reCAPTCHA v3 đang chặn chúng, các đại lý không thể phục hồi.

Tài liệu reCAPTCHA v3 của Google giải thích rằng điểm số dựa trên "tương tác với trang web của bạn" — các trình duyệt tự động không có chuyển động chuột, không có hành vi cuộn, và điều hướng nhanh liên tục có điểm số dưới 0.3, gây ra việc chặn.

CapSolver giải quyết vấn đề này bằng cách tạo các token có điểm số từ 0.7-0.9, vượt qua hầu hết các ngưỡng trang web. Đại lý gửi token này cùng yêu cầu của mình, và trang chấp nhận nó như là tương tác của người thật đáng tin cậy.

Những gì bạn cần trước khi bắt đầu

pip install git+https://github.com/capsolver-ai/capsolver-core.git
pip install git+https://github.com/capsolver-ai/capsolver-agent.git
pip install openai-agents

export CAPSOLVER_API_KEY="your-capsolver-api-key"
export OPENAI_API_KEY="your-openai-api-key"

Bạn cần xác định page_action của reCAPTCHA v3 cho trang đích của mình. Các hành động phổ biến: login, submit, homepage, register, checkout. Tìm nó bằng cách tìm trong mã nguồn trang cho grecaptcha.execute(sitekey, {action: '...'}).

Bước 1 — Đăng ký giải reCAPTCHA v3 như một công cụ hàm

from agents import Agent, Runner, function_tool
from capsolver_agent.schema import execute_tool

@function_tool
async def solve_recaptcha_v3(
    website_url: str,
    website_key: str,
    page_action: str = "verify",
    min_score: float = 0.7
) -> str:
    """Giải quyết thách thức reCAPTCHA v3 bị ẩn và trả về token điểm số cao.
    
    Sử dụng khi trang web sử dụng reCAPTCHA v3 (vô hình, dựa trên điểm số).
    Token phải được gửi cùng yêu cầu của bạn dưới dạng 'g-recaptcha-response'.
    
    Args:
        website_url: URL đầy đủ của trang
        website_key: khóa trang web của reCAPTCHA v3
        page_action: tên hành động (ví dụ: 'login', 'submit', 'verify')
        min_score: điểm số chấp nhận được tối thiểu (mặc định 0.7, phạm vi 0.1-0.9)
    """
    result = await execute_tool("solve_captcha", {
        "captcha_type": "reCaptchaV3",
        "website_url": website_url,
        "website_key": website_key,
        "page_action": page_action,
        "min_score": min_score
    }, api_key="YOUR_CAPSOLVER_API_KEY")
    
    if result["success"]:
        return f"reCAPTCHA v3 đã giải quyết (điểm số ≥{min_score}). Token: {result['solution']['token']}"
    return f"Thất bại: {result['error']}"

Bước 2 — Xây dựng đại lý

v3_agent = Agent(
    name="Đại lý Truy cập API",
    instructions="""Bạn truy cập các API và trang được bảo vệ bởi reCAPTCHA v3 (vô hình).
    
    Các dấu hiệu cho thấy trang sử dụng v3:
    - Thẻ script: <script src="...recaptcha/api.js?render=SITE_KEY">
    - Không có widget CAPTCHA trực quan trên trang
    - API trả về lỗi 403 hoặc thất bại mà không thông báo
    
    Khi bạn cần token v3:
    1. Xác định khóa trang từ tham số render trong script
    2. Xác định page_action từ các cuộc gọi grecaptcha.execute
    3. Gọi solve_recaptcha_v3 với các tham số này
    4. Gửi token dưới dạng g-recaptcha-response cùng yêu cầu của bạn""",
    tools=[solve_recaptcha_v3]
)

async def main():
    result = await Runner.run(
        v3_agent,
        "Truy cập API tại https://example.com/api/data. Nó sử dụng reCAPTCHA v3 "
        "với khóa trang 6LdKlZEpAAAAAN... và hành động 'getData'. Cho tôi một token hợp lệ."
    )
    print(result.final_output)

import asyncio
asyncio.run(main())

Bước 3 — Xác định tham số reCAPTCHA v3

Tham số reCAPTCHA v3 được tìm thấy trong JavaScript trang:

// Khóa trang trong thẻ script
<script src="https://www.google.com/recaptcha/api.js?render=6LdKlZEpAAAAAN..."></script>

// Hành động trong cuộc gọi execute
grecaptcha.execute('6LdKlZEpAAAAAN...', {action: 'submit'}).then(function(token) {
    document.getElementById('g-recaptcha-response').value = token;
});

Hướng dẫn xác định reCAPTCHA v3 giải thích cách trích xuất các giá trị này. Mở rộng CapSolver tự động phát hiện các tham số v3 trên bất kỳ trang nào.

Nhận Mã Thưởng Của Bạn: Sử dụng mã WEBS tại Bảng điều khiển CapSolver để nhận thêm 5% thưởng cho mỗi lần nạp tiền.

Kết luận

Giải quyết reCAPTCHA v3 trong OpenAI Agents SDK yêu cầu xác định khóa trang và hành động, sau đó gọi loại nhiệm vụ reCaptchaV3 của CapSolver qua @function_tool. Khác với v2, không có widget trực quan — đại lý phải nhận ra các lỗi âm thầm và tạo token điểm số cao một cách chủ động. CapSolver tạo ra token có điểm số 0.7-0.9 trong 3-8 giây, vượt qua xác minh vô hình mà không cần tương tác trình duyệt.

Câu hỏi thường gặp

Điểm số nào mà CapSolver tạo ra cho reCAPTCHA v3?

CapSolver tạo ra các token có điểm số từ 0.7-0.9, vượt qua hầu hết các ngưỡng trang web. Hầu hết các trang thiết lập ngưỡng tại 0.5-0.7, vì vậy các token của CapSolver luôn vượt qua xác minh.

Bạn có cần trình duyệt để giải reCAPTCHA v3 không?

Không. Chế độ token hoạt động mà không cần trình duyệt. Cung cấp khóa trang, URL và hành động — nhận lại token. Điều này khiến việc giải v3 nhanh hơn và đơn giản hơn v2 trong hầu hết các trường hợp.

Nếu bạn không biết page_action thì sao?

Thử các hành động phổ biến: verify, submit, login, homepage. Nếu không hoạt động, kiểm tra mã nguồn trang để tìm grecaptcha.execute. Tham số hành động luôn hiển thị trong JavaScript phía client.

reCAPTCHA v3 Enterprise có khác không?

Có. reCAPTCHA v3 Enterprise có thể yêu cầu cờ enterprise: true và có thể cần token s. CapSolver xử lý các phiên bản Enterprise — thêm enterprise: true vào tham số nếu cách tiếp cận thông thường thất bại.