Cara Menyelesaikan reCAPTCHA v3 dalam OpenAI Agents SDK

reCAPTCHA v3 beroperasi secara tidak terlihat — tidak ada kotak centang, tidak ada grid gambar — menilai interaksi pengguna di latar belakang. Ketika agen OpenAI Agents SDK mengakses API dan halaman yang dilindungi oleh v3, mereka menerima skor rendah yang memicu blokir atau tantangan lanjutan. CapSolver menghasilkan token reCAPTCHA v3 dengan skor tinggi (0,7-0,9) melalui layanan AI-nya, terintegrasi dengan OpenAI Agents SDK via @function_tool agar agen Anda dapat melewati verifikasi yang tidak terlihat tanpa interaksi visual apa pun.

TL;DR

• reCAPTCHA v3 tidak terlihat dan berbasis skor — agen gagal diam-diam ketika skornya terlalu rendah
• CapSolver menghasilkan token dengan skor tinggi (0,7-0,9) dalam 3-8 detik via tipe tugas reCaptchaV3
• Membutuhkan parameter website_url, website_key, dan page_action (nama tindakan seperti "login" atau "submit")
• Integrasi menggunakan @function_tool dari OpenAI Agents SDK dengan execute_tool() async CapSolver
• Tidak diperlukan browser — mode token berfungsi untuk semua implementasi reCAPTCHA v3

Mengapa reCAPTCHA v3 Berbeda dari v2

reCAPTCHA v3 tidak pernah menampilkan tantangan yang terlihat. Sebaliknya, ia menjalankan JavaScript di latar belakang yang memberi skor sesi pengguna dari 0,0 (kemungkinan bot) hingga 1,0 (kemungkinan manusia). Pemilik situs menetapkan ambang batas — biasanya 0,5-0,7 — dan memblokir atau menantang permintaan di bawah skor tersebut.

Untuk Agens OpenAI, ini menciptakan mode kegagalan diam-diam. Agen tidak melihat widget CAPTCHA untuk diselesaikan. Sebaliknya, panggilan API mengembalikan kesalahan 403, pengiriman formulir gagal diam-diam, atau situs mengalihkan ke halaman kesalahan. Tanpa memahami bahwa reCAPTCHA v3 menghalangi mereka, agen tidak dapat pulih.

Dokumentasi reCAPTCHA v3 Google menjelaskan bahwa skor didasarkan pada "interaksi dengan situs Anda" — browser otomatis tanpa gerakan mouse, tidak ada perilaku scroll, dan navigasi cepat secara konsisten mendapat skor di bawah 0,3, memicu blokir.

CapSolver menyelesaikan ini dengan menghasilkan token dengan skor 0,7-0,9, yang melewati hampir semua ambang batas situs. Agen mengirimkan token ini bersama permintaannya, dan situs menerimanya sebagai interaksi manusia yang percaya diri.

Apa yang Perlu Anda Miliki Sebelum Memulai

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"

Anda perlu mengidentifikasi page_action reCAPTCHA v3 untuk situs target Anda. Tindakan umum: login, submit, homepage, register, checkout. Temukan dengan mencari sumber halaman untuk grecaptcha.execute(sitekey, {action: '...'}).

Langkah 1 — Daftarkan Penyelesaian reCAPTCHA v3 sebagai Fungsi Alat

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:
    """Menyelesaikan tantangan reCAPTCHA v3 yang tidak terlihat dan mengembalikan token dengan skor tinggi.
    
    Gunakan ini ketika situs menggunakan reCAPTCHA v3 (tidak terlihat, berbasis skor).
    Token harus dikirimkan sebagai 'g-recaptcha-response' bersama permintaan Anda.
    
    Args:
        website_url: URL lengkap halaman
        website_key: kunci situs reCAPTCHA v3
        page_action: nama tindakan (misalnya, 'login', 'submit', 'verify')
        min_score: skor minimum yang diterima (default 0,7, rentang 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 diselesaikan (skor ≥{min_score}). Token: {result['solution']['token']}"
    return f"Gagal: {result['error']}"

Langkah 2 — Bangun Agens

v3_agent = Agent(
    name="Agens Akses API",
    instructions="""Anda mengakses API dan halaman yang dilindungi oleh reCAPTCHA v3 (tidak terlihat).
    
    Tanda halaman menggunakan v3:
    - Tag skrip: <script src="...recaptcha/api.js?render=SITE_KEY">
    - Tidak ada widget CAPTCHA yang terlihat di halaman
    - API mengembalikan 403 atau gagal diam-diam
    
    Ketika Anda membutuhkan token v3:
    1. Identifikasi kunci situs dari parameter render skrip
    2. Identifikasi page_action dari panggilan grecaptcha.execute
    3. Panggil solve_recaptcha_v3 dengan parameter ini
    4. Kirim token sebagai g-recaptcha-response bersama permintaan Anda""",
    tools=[solve_recaptcha_v3]
)

async def main():
    result = await Runner.run(
        v3_agent,
        "Akses API di https://example.com/api/data. Situs ini menggunakan reCAPTCHA v3 "
        "dengan kunci situs 6LdKlZEpAAAAAN... dan tindakan 'getData'. Beri saya token yang valid."
    )
    print(result.final_output)

import asyncio
asyncio.run(main())

Langkah 3 — Identifikasi Parameter reCAPTCHA v3

Parameter reCAPTCHA v3 ditemukan dalam JavaScript halaman:

// Kunci situs dalam tag skrip
<script src="https://www.google.com/recaptcha/api.js?render=6LdKlZEpAAAAAN..."></script>

// Tindakan dalam panggilan execute
grecaptcha.execute('6LdKlZEpAAAAAN...', {action: 'submit'}).then(function(token) {
    document.getElementById('g-recaptcha-response').value = token;
});

Garis panduan identifikasi reCAPTCHA v3 menjelaskan cara mengekstrak nilai-nilai ini. Ekstensi CapSolver mendeteksi parameter v3 secara otomatis di halaman mana pun.

Dapatkan Kode Bonus Anda: Gunakan kode WEBS di Dashboard CapSolver untuk mendapatkan bonus tambahan 5% pada setiap recharge.

Kesimpulan

Menyelesaikan reCAPTCHA v3 dalam OpenAI Agents SDK memerlukan identifikasi kunci situs dan page_action, lalu memanggil tugas reCaptchaV3 CapSolver melalui @function_tool. Berbeda dengan v2, tidak ada widget yang terlihat — agen harus mengenali kegagalan diam-diam dan secara proaktif menghasilkan token dengan skor tinggi. CapSolver menghasilkan token dengan skor 0,7-0,9 dalam 3-8 detik, melewati verifikasi yang tidak terlihat tanpa interaksi browser apa pun.

FAQ

Berapa skor yang dihasilkan CapSolver untuk reCAPTCHA v3?

CapSolver menghasilkan token dengan skor 0,7-0,9, yang melewati hampir semua ambang batas situs. Kebanyakan situs menetapkan ambang batasnya pada 0,5-0,7, sehingga token CapSolver secara konsisten melewati verifikasi.

Apakah saya membutuhkan browser untuk menyelesaikan reCAPTCHA v3?

Tidak. Mode token berfungsi tanpa browser apa pun. Berikan kunci situs, URL, dan tindakan — terima token kembali. Ini membuat penyelesaian v3 lebih cepat dan sederhana dibandingkan v2 dalam kebanyakan kasus.

Apa yang terjadi jika saya tidak tahu page_action?

Coba tindakan umum: verify, submit, login, homepage. Jika tidak bekerja, periksa sumber halaman untuk panggilan grecaptcha.execute. Parameter tindakan selalu terlihat dalam JavaScript klien.

Apakah reCAPTCHA v3 Enterprise berbeda?

Ya. v3 Enterprise mungkin memerlukan bendera enterprise: true dan mungkin token s. CapSolver menangani variasi Enterprise — tambahkan enterprise: true ke parameter Anda jika pendekatan standar gagal.