Cách tích hợp CapSolver với Composio AI Tự động hóa trình duyệt

Chạy script
  -> SDK Agent của OpenAI quyết định công cụ nào cần gọi
  -> Công cụ tùy chỉnh của Composio: complete_recaptcha_v2
       -> Playwright mở trang
       -> capsolver.solve(...) trả về gRecaptchaResponse
       -> Áp dụng token vào g-recaptcha-response
       -> Playwright gửi và chờ trang
       -> Đọc trang và xác định chấp nhận
  -> Công cụ trả về {"accepted": ..., "message": ...}
  -> Agent báo cáo kết quả từ accepted

pip install composio composio-openai-agents openai-agents capsolver pydantic playwright
playwright install chromium

# Khóa API.
COMPOSIO_API_KEY = "ak_..."
OPENAI_API_KEY = "sk-..."          # Khóa API OpenAI chính thức của bạn.
os.environ["OPENAI_API_KEY"] = OPENAI_API_KEY   # SDK OpenAI đọc khóa từ môi trường.

# Cấu hình CapSolver và Composio.
capsolver.api_key = "CAP-..."
composio = Composio(
    api_key=COMPOSIO_API_KEY,
    provider=OpenAIAgentsProvider(),
)

import os
from typing import List, cast
import capsolver
from agents import Agent, Runner, SQLiteSession
from composio import Composio
from composio.core.models.custom_tool import CustomTool
from composio.core.models.tool_router import ToolRouterExperimentalConfig
from composio_openai_agents import OpenAIAgentsProvider
from playwright.sync_api import sync_playwright
from pydantic import BaseModel, Field

# Khóa API.
COMPOSIO_API_KEY = "ak_..."
OPENAI_API_KEY = "sk-..."          # Khóa API OpenAI chính thức của bạn.
os.environ["OPENAI_API_KEY"] = OPENAI_API_KEY

# Cấu hình CapSolver và Composio.
capsolver.api_key = "CAP-..."
composio = Composio(
    api_key=COMPOSIO_API_KEY,
    provider=OpenAIAgentsProvider(),
)


# Lược đồ đầu vào cho công cụ tùy chỉnh; Composio yêu cầu BaseModel Pydantic ở đây.
class CompleteRecaptchaInput(BaseModel):
    target_url: str = Field(
        default="https://www.google.com/recaptcha/api2/demo",
        description="Địa chỉ URL trang chứa demo reCAPTCHA v2",
    )
    website_key: str = Field(
        default="6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ-",
        description="Khóa website reCAPTCHA v2 từ trang hiện tại",
    )


# Đăng ký toàn bộ luồng như một công cụ Composio mà agent có thể gọi.
# Ghi chú kiểu tham số đầu tiên là bắt buộc cho Composio để suy diễn lược đồ.
@composio.experimental.tool(preload=True)
def complete_recaptcha_v2(input: CompleteRecaptchaInput, _ctx):
    """Mở trang bằng Playwright, giải reCAPTCHA v2, gửi và xác minh."""
    with sync_playwright() as p:
        browser = p.chromium.launch(headless=False)  # Đặt headless=True để ẩn cửa sổ.
        page = browser.new_page()
        try:
            page.goto(input.target_url)
            # Yêu cầu CapSolver giải reCAPTCHA v2.
            solution = capsolver.solve(
                {
                    "type": "ReCaptchaV2TaskProxyLess",
                    "websiteURL": input.target_url,
                    "websiteKey": input.website_key,
                }
            )
            token = solution.get("gRecaptchaResponse")
            page.evaluate(
                """
                (token) => {
                    const textarea = document.getElementById('g-recaptcha-response');
                    if (textarea) {
                        textarea.value = token;
                    }
                }
                """,
                token,
            )
            page.click("#recaptcha-demo-submit")
            page.wait_for_load_state("networkidle")
            result_page = page.content()
            # Thành công chỉ khi trang thực sự hiển thị văn bản thành công
            accepted = "Verification Success" in result_page
            return {
                "accepted": accepted,
                "message": (
                    "Verification Success"
                    if accepted
                    else "Trang không báo Verification Success"
                ),
            }
        finally:
            browser.close()
def main():
    experimental: ToolRouterExperimentalConfig = {
        "custom_tools": cast(List[CustomTool], [complete_recaptcha_v2]),
    }
    session = composio.sessions.create(
        user_id="playwright-recaptcha-demo-user",
        experimental=experimental,
        sandbox={"enable": False},  # Chạy công cụ trong quá trình này, không phải trong sandbox.
    )
    agent = Agent(
        name="Trợ lý reCAPTCHA Playwright",
        instructions=(
            "Khi người dùng yêu cầu chạy demo, gọi complete_recaptcha_v2 "
            "với giá trị mặc định. Báo cáo thành công chỉ khi accepted là true."
        ),
        model="gpt-5.2",
        tools=session.tools(),
    )
    # Bộ nhớ cho cuộc trò chuyện nhiều lần
    memory = SQLiteSession("conversation")
    print("Demo Composio + reCAPTCHA v2 Playwright đang chạy...")
    user_input = (
        "Gọi complete_recaptcha_v2 ngay bây giờ với target_url và website_key mặc định. Không hỏi xác nhận."
    )
    result = Runner.run_sync(
        starting_agent=agent,
        input=user_input,
        session=memory,
    )
    print(f"Trợ lý: {result.final_output}\n")
if __name__ == "__main__":
    main()

image_src = page.locator("#demoCaptcha_CaptchaImage").get_attribute("src")
if not image_src or "," not in image_src:
    raise RuntimeError("Không tìm thấy URL dữ liệu hình ảnh CAPTCHA hợp lệ")
base64_image = image_src.split(",", 1)[1]  # Loại bỏ phần đầu "data:image/...;base64,"

class CompleteImageCaptchaInput(BaseModel):
    target_url: str = Field(
        default="https://captcha.com/demos/features/captcha-demo.aspx",
        description="Địa chỉ URL trang demo CAPTCHA hình ảnh",
    )
    module: str = Field(
        default="common",
        description="Mô-đun nhận dạng ImageToTextTask của CapSolver",
    )

@composio.experimental.tool(preload=True)
def complete_image_captcha(input: CompleteImageCaptchaInput, _ctx):
    """Mở trang bằng Playwright, nhận dạng CAPTCHA hình ảnh, gửi và xác minh."""
    with sync_playwright() as p:
        browser = p.chromium.launch(headless=False)
        page = browser.new_page()
        try:
            page.goto(input.target_url)
            page.wait_for_selector("#demoCaptcha_CaptchaImage", state="visible")

            # src hình ảnh đã là URL dữ liệu; loại bỏ phần đầu để lấy Base64.
            image_src = page.locator("#demoCaptcha_CaptchaImage").get_attribute("src")
            if not image_src or "," not in image_src:
                raise RuntimeError("Không tìm thấy URL dữ liệu hình ảnh CAPTCHA hợp lệ")
            base64_image = image_src.split(",", 1)[1]
            solution = capsolver.solve(
                {
                    "type": "ImageToTextTask",
                    "websiteURL": input.target_url,
                    "module": input.module,
                    "body": base64_image,
                }
            )
            captcha_text = solution.get("text")
            if not isinstance(captcha_text, str) or not captcha_text:
                raise RuntimeError("CapSolver không trả về văn bản đã nhận diện")
            page.fill("#captchaCode", captcha_text)      # Ghi kết quả vào #captchaCode.
            page.click("#validateCaptchaButton")
            page.wait_for_load_state("networkidle")
            result_page = page.content()
            # Trang demo hiển thị "Correct!" khi thành công, "Incorrect!" khi thất bại.
            accepted = "Correct!" in result_page
            return {
                "accepted": accepted,
                "recognized_text": captcha_text,
                "message": "Correct!" if accepted else "Trang không báo Correct!",
            }
        finally:
            browser.close()

Playwright mở trang CAPTCHA
  -> Chờ #demoCaptcha_CaptchaImage hiển thị
  -> Đọc src (URL dữ liệu) và loại bỏ phần đầu để lấy Base64
  -> capsolver.solve(ImageToTextTask) trả về văn bản
  -> page.fill ghi kết quả vào #captchaCode
  -> page.click kích hoạt #validateCaptchaButton
  -> page.content kiểm tra Correct! hoặc Incorrect!
  -> finally đóng trình duyệt

solution = capsolver.solve({
    "type": "ImageToTextTask",
    "module": "number",
    "images": [base64_image],
})

answers = solution["answers"]

experimental.tool: tham số đầu tiên của "complete_recaptcha_v2" phải được ghi chú bằng lớp con BaseModel Pydantic. Nhận được: <class 'inspect._empty'>

403 APIKey_InsufficientPermissions
Đường dẫn này yêu cầu quyền ghi "phiên"

Công cụ Composio = Các hành động trang Playwright + Kết quả CapSolver + Xác minh trạng thái trang