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"

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:
    """解决不可见的reCAPTCHA v3挑战并返回高分令牌。
    
    在站点使用reCAPTCHA v3（不可见、基于评分）时使用。
    令牌必须作为"g-recaptcha-response"与您的请求一起提交。
    
    参数:
        website_url: 页面的完整URL
        website_key: reCAPTCHA v3网站密钥
        page_action: 动作名称（例如"login"、"submit"、"verify"）
        min_score: 最低可接受分数（默认0.7，范围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已解决（分数≥{min_score}）。令牌: {result['solution']['token']}"
    return f"失败: {result['error']}"

v3_agent = Agent(
    name="API访问代理",
    instructions="""您访问受reCAPTCHA v3（不可见、基于评分）保护的API和页面。
    
    页面使用v3的标志:
    - 脚本标签: <script src="...recaptcha/api.js?render=SITE_KEY">
    - 页面上没有可见的CAPTCHA小部件
    - API返回403或无声失败
    
    当您需要v3令牌时:
    1. 从脚本的render参数中识别站点密钥
    2. 从grecaptcha.execute调用中识别page_action
    3. 使用这些参数调用solve_recaptcha_v3
    4. 将令牌作为g-recaptcha-response与您的请求一起提交""",
    tools=[solve_recaptcha_v3]
)

async def main():
    result = await Runner.run(
        v3_agent,
        "访问https://example.com/api/data的API。它使用站点密钥6LdKlZEpAAAAAN...和动作'getData'的reCAPTCHA v3。给我一个有效的令牌。"
    )
    print(result.final_output)

import asyncio
asyncio.run(main())

// 脚本src中的站点密钥
<script src="https://www.google.com/recaptcha/api.js?render=6LdKlZEpAAAAAN..."></script>

// execute调用中的动作
grecaptcha.execute('6LdKlZEpAAAAAN...', {action: 'submit'}).then(function(token) {
    document.getElementById('g-recaptcha-response').value = token;
});