如何在 OpenAI 代理 SDK 中解决 reCAPTCHA

# CapSolver 核心引擎
pip install git+https://github.com/capsolver-ai/capsolver-core.git

# CapSolver 代理工具
pip install git+https://github.com/capsolver-ai/capsolver-agent.git

# OpenAI 代理 SDK
pip install openai-agents

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

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

@function_tool
async def solve_recaptcha(
    website_url: str, 
    website_key: str, 
    captcha_type: str = "reCaptchaV2"
) -> str:
    """在网站上解决 reCAPTCHA 挑战并返回验证令牌。
    
    在需要绕过网页上的 reCAPTCHA 验证时使用此工具。
    
    参数:
        website_url: 包含 reCAPTCHA 的页面完整 URL
        website_key: reCAPTCHA 网站密钥（在 data-sitekey 属性中找到）
        captcha_type: 可为 'reCaptchaV2' 或 'reCaptchaV3'（默认: reCaptchaV2）
    
    返回:
        要作为 g-recaptcha-response 提交的已解决 reCAPTCHA 令牌
    """
    result = await execute_tool("solve_captcha", {
        "captcha_type": captcha_type,
        "website_url": website_url,
        "website_key": website_key
    }, api_key="YOUR_CAPSOLVER_API_KEY")
    
    if result["success"]:
        return f"reCAPTCHA 已解决。令牌: {result['solution']['token']}"
    return f"解决失败: {result['error']}"

from agents import Agent, Runner

# 创建具有 CAPTCHA 解决能力的代理
captcha_agent = Agent(
    name="Web Access Agent",
    instructions="""您是一个帮助用户与网站交互的网络访问代理。当任务需要访问受 reCAPTCHA 保护的页面时，请使用 solve_recaptcha 工具获取验证令牌。 
    
    对于 reCAPTCHA v2: 使用 captcha_type='reCaptchaV2'
    对于 reCAPTCHA v3: 使用 captcha_type='reCaptchaV3'
    
    始终提供用户请求中的精确 website_url 和 website_key。""",
    tools=[solve_recaptcha]
)

# 运行代理
async def main():
    result = await Runner.run(
        captcha_agent,
        "我需要访问 https://example.com/login，它有 reCAPTCHA v2。"
        "网站密钥是 6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI。"
        "请解决它并给我令牌。"
    )
    print(result.final_output)

import asyncio
asyncio.run(main())

@function_tool
async def solve_recaptcha_v3(
    website_url: str,
    website_key: str,
    page_action: str = "verify",
    min_score: float = 0.7
) -> str:
    """解决 reCAPTCHA v3（不可见、基于分数）挑战。
    
    当网站使用 reCAPTCHA v3 时使用此工具——没有可见的复选框，
    但网站在后台验证基于分数的令牌。
    
    参数:
        website_url: 页面的完整 URL
        website_key: reCAPTCHA v3 网站密钥
        page_action: 用于评分的操作名称（例如，'login'、'submit'、'verify'）
        min_score: 最低可接受分数（0.0-1.0，默认 0.7）
    """
    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 以高分数解决。令牌: {result['solution']['token']}"
    return f"解决失败: {result['error']}"

from agents import Agent, Runner, function_tool

@function_tool
async def solve_recaptcha(website_url: str, website_key: str, captcha_type: str = "reCaptchaV2") -> str:
    """解决 reCAPTCHA 并返回令牌。"""
    result = await execute_tool("solve_captcha", {
        "captcha_type": captcha_type,
        "website_url": website_url,
        "website_key": website_key
    }, api_key="YOUR_CAPSOLVER_API_KEY")
    if result["success"]:
        return f"令牌: {result['solution']['token']}"
    return f"失败: {result['error']}"

@function_tool
async def check_solver_balance() -> str:
    """检查剩余的 CAPTCHA 解决积分。"""
    result = await execute_tool("get_balance", {}, api_key="YOUR_CAPSOLVER_API_KEY")
    if result["success"]:
        return f"余额: ${result['balance']:.2f}"
    return "无法检查余额"

# 多功能代理
web_agent = Agent(
    name="自主网络代理",
    instructions="""您帮助用户访问可能受 reCAPTCHA 保护的网络资源。您可以解决 reCAPTCHA v2（可见复选框）和 v3（不可见基于分数）。如果用户询问成本，请在解决前检查余额。
    
    解决 reCAPTCHA 时:
    - v2: 使用 captcha_type='reCaptchaV2' 
    - v3: 使用 captcha_type='reCaptchaV3' 并在已知时包含 page_action
    
    清晰返回令牌，以便用户可以将其提交到表单中。""",
    tools=[solve_recaptcha, check_solver_balance]
)

async def run_web_agent(task: str):
    result = await Runner.run(web_agent, task)
    return result.final_output

import os
from agents import Agent, Runner, function_tool
from capsolver_agent.schema import create_executor

# 带自定义设置的生产执行器
executor = create_executor(
    api_key=os.environ["CAPSOLVER_API_KEY"],
    default_timeout=90,      # 90 秒超时
    polling_interval=3       # 每 3 秒轮询一次
)

@function_tool
async def solve_recaptcha_production(
    website_url: str,
    website_key: str,
    captcha_type: str = "reCaptchaV2"
) -> str:
    """具有重试逻辑的生产级 reCAPTCHA 解决器。"""
    for attempt in range(3):
        result = await executor.execute("solve_captcha", {
            "captcha_type": captcha_type,
            "website_url": website_url,
            "website_key": website_key
        })
        if result["success"]:
            return f"已解决（尝试 {attempt+1}）。令牌: {result['solution']['token']}"
        if attempt < 2:
            await asyncio.sleep(2)
    return f"三次尝试后失败: {result.get('error')}"