🎉BARUCapSolver untuk agen AI
Selenium CAPTCHA solver landing page hero section with code snippet and CTA buttons
Selenium CAPTCHA solver landing page hero section with code snippet and CTA buttons

Otomatisasi Agen · LangChain

Tambahkan CapSolver ke agen LangChain Anda — selesaikan CAPTCHA dalam satu panggilan alat

Agen CapSolver menambahkan LangChain BaseTools yang sudah jadi melalui get_langchain_tools() ke agen ReAct atau LangGraph Anda. Saat CAPTCHA muncul, ia memanggil pemecah, mendapatkan token, dan melanjutkan—didukung oleh SDK asli untuk LangChain, alat browser, dan MCP.

Langchain •agent runner

agent → browser.navigate("signup")
agent → form.fill(profile)
CAPTCHA detected
tool_call: solve_recaptcha()span: tools.solve_recaptcha · sitekey + page_url
token returned → agent.resume()
final_output: signup complete
CapSolver Agent Tools

Solving captcha...

Alur kerja agen CAPTCHA

01

Deteksi

CAPTCHA atau verifikasi muncul

02

Ekstrak

URL, kunci situs, metadata

03

Memecahkan

tugas CapSolver

04

Kembali

Solusi dikembalikan ke agen

05

Lanjutkan

Agen melanjutkan alur kerja

Tambahkan penyelesaian CAPTCHA ke agen LangChain Anda

01

Dibuat untuk loop agen

Pemecah CAPTCHA LangChain berguna ketika alur kerja agen menyentuh situs web nyata dan dapat dihentikan oleh validasi lalu lintas atau tantangan CAPTCHA.

02

Pola asli alat

Ekspos CapSolver sebagai alat LangChain yang dapat dipanggil dengan masukan yang jelas, sehingga agen dapat meminta penyelesaian CAPTCHA hanya saat diperlukan.

03

Pemulihan produksi

Tangani percobaan ulang, kesalahan, ID permintaan, dan batas waktu tanpa merusak alur kerja agen.

04

Batasan alat yang jelas

Agen Anda mengontrol alur kerja. CapSolver menangani tugas penyelesaian dan mengembalikan hasilnya.

Mengapa agen LangChain memerlukan pemulihan CAPTCHA dalam produksi

LangChain dirancang untuk agen yang mengambil tindakan melalui alat. Dalam alur kerja otomatisasi browser, loop ini sering diinterupsi oleh reCAPTCHA atau Cloudflare Turnstile. Solusi yang tepat adalah dengan tidak mengubah CapSolver menjadi kerangka kerja agen — melainkan menjadikan CapSolver sebagai lapisan infrastruktur CAPTCHA yang siap untuk agen yang dapat dihubungi oleh setiap agen browser dunia nyata bila diperlukan.

Lapisan Alur Kerja

Berperan dalam alur kerja LangChain

Apa yang ditambahkan CapSolver

Agen LangChain

Merencanakan tugas, memilih alat, dan memelihara status.

Alat pemulihan CAPTCHA yang dapat dipanggil dan hanya dapat dipanggil bila diperlukan.

API CapSolver

Menciptakan tugas khusus tantangan dan mengembalikan solusi.

Menangani reCAPTCHA v2/v3, Cloudflare Challenge / Turnstile, dan tantangan lain yang didukung melalui API.

Observabilitas

Melacak panggilan alat, kesalahan, dan status alur kerja

ID tugas CAPTCHA, jenis tantangan, status penyelesaian, dan kode kesalahan/percobaan ulang.

Arsitektur

Jaga tanggung jawab tetap jelas: LangChain mengatur, CapSolver memecahkan CAPTCHA

Gunakan CapSolver sebagai alat terfokus dalam alur kerja LangChain Anda. Agen memberikan URL situs web, kunci situs, dan detail tantangan. Alat ini membuat tugas, memeriksa hasilnya, dan mengembalikan solusi. LangChain mengelola alur kerja agen, sementara CapSolver menangani penyelesaian CAPTCHA.

Deteksi

Tantangan CAPTCHA hadir di halaman target.

Ekstrak

Kumpulkan URL situs web, Kunci situs web, dan jenis tantangan.

Buat

Panggil CapSolver createTask dengan objek tugas yang benar.

Jajak pendapat

Periksa getTaskResult hingga tugas siap atau waktu habis. Gunakan penundaan percobaan ulang untuk kesalahan batas kecepatan.

Lanjutkan

Alat ini mengembalikan token terstruktur dan agen LangChain melanjutkan tugas awal.

Amati

Catat ID tugas, status, dan kode kesalahan/percobaan ulang.

Mulai Cepat

Bangun alat Python LangChain dengan CapSolver API

Bungkus CapSolvercreateTask+getTaskResultdalam satu alat: info terstruktur masuk, hasil terstruktur keluar. Pemungutan suara menggunakan interval tetap dengan batas waktu keseluruhan.

capsolver_solve_captcha.py
# pip install "capsolver-agent[langchain]" langchain-openai langgraph
# export CAPSOLVER_API_KEY=CAP-XXXXXX
# export OPENAI_API_KEY=sk-XXXXXX

import asyncio
import os
from langchain_core.tools import tool
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent
from capsolver_agent.schema import create_executor
from _env import load_example_env  # demo only: reads repo-root .env

load_example_env()

# 1. Wrap CapSolver as one LangChain tool.
#    createTask + result polling are handled inside capsolver-agent.
executor = create_executor()  # key from CAPSOLVER_API_KEY

@tool
async def solve_captcha(captcha_type: str, website_url: str, website_key: str) -> dict:
    """Solve a captcha (reCaptchaV2 / reCaptchaV3 / cloudflare) and return its token.

    captcha_type: captcha family, e.g. reCaptchaV2
    website_url:  full URL of the page that loads the captcha
    website_key:  site key found on that page
    """
    result = await executor.execute(
        "solve_captcha",
        {"captcha_type": captcha_type, "website_url": website_url, "website_key": website_key},
    )
    if not result.get("success"):
        return {"ok": False, "error": result.get("error", "unknown error")}
    return {"ok": True, "token": result["solution"]["token"]}

# 2. Any OpenAI-compatible chat model works; the LLM decides when to call the tool.
llm = ChatOpenAI(model=os.environ.get("OPENAI_MODEL", "gpt-4o"), temperature=0)

# 3. Give the tool to a ReAct agent.
agent = create_react_agent(llm, [solve_captcha])

# 4. Run.
PROMPT = (
    "Solve the reCaptchaV2 at https://www.google.com/recaptcha/api2/demo "
    "with site key 6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ- "
    "and report the first 40 characters of the token."
)
result = asyncio.run(agent.ainvoke({"messages": [("user", PROMPT)]}))
print(result["messages"][-1].content)

Tambahkan alat ke agen LangChain

get_langchain_tools()mengembalikan BaseTools standar yang berada di samping browser, ekstraksi data, atau alat alur kerja yang sudah digunakan agen Anda.

langchain_agent.py
# pip install "capsolver-agent[langchain]" langchain-openai langgraph
# export CAPSOLVER_API_KEY=CAP-XXXXXX
# export OPENAI_API_KEY=sk-XXXXXX

import asyncio
import os
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent
from capsolver_agent.langchain_tools import get_langchain_tools
from _env import load_example_env  # demo only: reads repo-root .env

load_example_env()

# CapSolver's ready-made LangChain BaseTools, backed by capsolver-core:
# solve_captcha, detect_captchas, solve_on_page, get_balance, get_supported_captchas
tools = get_langchain_tools(api_key=os.environ["CAPSOLVER_API_KEY"])

llm = ChatOpenAI(model=os.environ.get("OPENAI_MODEL", "gpt-4o"), temperature=0)

# The solver tools sit beside the browser / data / workflow tools your agent already uses
agent = create_react_agent(llm, tools)

result = asyncio.run(  # CapSolver tools are async, so use ainvoke
    agent.ainvoke(
        {
            "messages": [
                {
                    "role": "user",
                    "content": "Solve the reCaptchaV2 at "
                               "https://www.google.com/recaptcha/api2/demo with site key "
                               "6Le-wvkSAAAAAPBMRTvw0Q4Muexq9bi0DJwx_mJ- and report the "
                               "first 40 characters of the token.",
                }
            ]
        }
    )
)

print(result["messages"][-1].content)
capsolver-agent adalah paket Python murni. Instal dengan

dan impor alat secara langsung — tidak diperlukan paket JavaScript atau TypeScript.

Praktik Terbaik Produksi

Bangun penyelesaian CAPTCHA siap produksi untuk agen LangChain

01

Manajemen rahasia

Simpan CAPSOLVER_API_KEY dalam variabel lingkungan atau manajer rahasia.

Mengapa

Mencegah paparan kunci yang tidak disengaja dalam prompt, log, dan repositori.

02

Skema alat

Usahakan masukan alat tetap sempit dan diketik (website_url, website_key).

Mengapa

Mengurangi kebingungan model dan pembuatan argumen yang tidak aman.

03

Deteksi

Baca jenis tantangan dan kunci situs dari konteks halaman.

Mengapa

Model tidak boleh menebak parameter halaman dari teks mentah.

04

Jajak pendapat & coba lagi

Periksa status tugas pada interval yang ditentukan dan hentikan setelah waktu habis. Coba lagi kesalahan API dengan backoff.

Mengapa

Mencegah pemuatan yang tidak perlu dan loop agen yang tidak terkendali.

05

Pencatatan

Catat task_id, jenis tantangan, status, dan kode kesalahan/percobaan ulang.

Mengapa

Membuat debugging dan dukungan lebih mudah.

06

Penanganan kesalahan

Hentikan kegagalan berulang dan kirimkan tugas untuk ditinjau manusia bila diperlukan.

Mengapa

Mencegah percobaan ulang secara buta pada alur kerja yang sensitif atau tidak pasti.

07

Kepatuhan

Tinjau persyaratan situs, otorisasi pengguna, persyaratan privasi, dan batas tarif.

Mengapa

Menjaga otomatisasi tetap selaras dengan kasus penggunaan yang disetujui.

Kesesuaian Ekosistem

CapSolver bekerja dengan infrastruktur browser Anda—tidak menggantikannya

01

Basis Peramban / Baja

02

Penulis Drama / Dalang

03

LangChain / LangGraph

Pekerjaan utama

Eksekusi browser yang dihosting dan manajemen sesi.

Kontrol browser dan interaksi DOM.

Orkestrasi agen dan penggunaan alat.

Tanpa CapSolver

Sesi browser dapat tetap berjalan, namun CAPTCHA mungkin menghentikan alur kerja.

Otomatisasi dapat mendeteksi dan berinteraksi dengan halaman, namun masih memerlukan logika penyelesaian CAPTCHA.

Agen dapat memanggil alat, namun tidak memiliki alat bawaan untuk memecahkan CAPTCHA.

Dengan CapSolver

CapSolver menangani tugas CAPTCHA saat sesi browser tetap aktif.

Otomatisasi mengirimkan data tantangan ke CapSolver dan menggunakan solusi yang dikembalikan.

Agen memanggil CapSolver sebagai alat dan melanjutkan alur kerja dengan hasilnya.

Kasus Penggunaan yang Paling Sesuai

Dibuat untuk tim agen B2B yang menjalankan alur kerja browser dalam produksi

Otomatisasi Penjualan

Riset penjualan resmi dan alur kerja CRM mungkin mengalami CAPTCHA atau pemeriksaan verifikasi selama tugas browser.

Teknologi SDM

Alur kerja perekrutan yang disetujui dapat dijeda saat verifikasi muncul selama tugas browser multi-langkah.

QA dan Alat Pengujian

Pengujian menyeluruh untuk pendaftaran, pembayaran, dan formulir memerlukan penanganan CAPTCHA yang jelas untuk mengurangi kegagalan pengujian.

RegTech dan Kepatuhan

Pemeriksaan registri publik dan alur kerja pengumpulan bukti memerlukan keandalan, log audit, dan perilaku fallback yang jelas.

Otomatisasi Penelitian

Alur kerja data publik yang sah mungkin dijeda ketika sumber memperlihatkan CAPTCHA atau pemeriksaan verifikasi.

RPA dalaman

Alur kerja berulang yang diizinkan pengguna mendapat manfaat dari lapisan pemulihan CAPTCHA yang jelas ketika validasi lalu lintas memblokir tugas.

Penggunaan yang Bertanggung Jawab

Gunakan CapSolver untuk otomatisasi yang sah dan resmi

CapSolver ditujukan untuk penggunaan yang sah dan sah, termasuk pengujian QA yang disetujui, RPA internal, tugas agen resmi pengguna, dan alur kerja data publik yang sesuai. Sebelum mengotomatiskan situs web, tinjau persyaratannya, aturan privasi yang berlaku, batas kapasitas, dan persyaratan kepatuhan organisasi Anda.

01

Pengujian QA resmi

02

RPA yang disetujui

03

Alur kerja data publik

04

Tugas agen resmi pengguna

05

Otomatisasi yang ditinjau kepatuhan

06

Otomatisasi e-niaga

Pertanyaan Umum

Integrasi Terkait

Jelajahi lebih banyak integrasi CapSolver untuk tumpukan agen Anda

Pilih integrasi lain untuk menambahkan penyelesaian CAPTCHA ke alur kerja agen atau browser Anda.

01

Server MCP

Hubungkan CapSolver ke klien lain yang mendukung alat MCP.

Lihat Integrasi
02

Penulis naskah drama

Tambahkan penyelesaian CAPTCHA ke otomatisasi browser khusus.

Lihat Integrasi
03

Penggunaan Peramban

Tambahkan CapSolver sebagai tindakan untuk agen AI berbasis browser.

Lihat Integrasi
04

SDK Agen OpenAI

Tambahkan penyelesaian CAPTCHA melalui alat fungsi dan alur kerja agen.

Lihat Integrasi

Jika agen LangChain Anda berfungsi dalam demo tetapi terhenti dalam produksi, tambahkan lapisan pemulihan CAPTCHA.

Mulailah dengan pembungkus alat di atas, tinjau dokumentasi CapSolver, dan hubungi tim saat Anda memerlukan dukungan perusahaan, volume yang lebih tinggi, atau jalur integrasi SDK asli.