CAPSOLVER
Blog
Cara Menyelesaikan CAPTCHA Apapun di HyperBrowser Menggunakan CapSolver (Panduan Pemasangan Lengkap)

Cara Menyelesaikan CAPTCHA Apa pun di HyperBrowser Menggunakan CapSolver (Panduan Pemasangan Lengkap)

Logo of CapSolver

Emma Foster

Machine Learning Engineer

26-Mar-2026

Agen browser AI sedang mengubah cara pengembang berinteraksi dengan web. Dari pengambilan data hingga otomatisasi alur kerja, agen-agen ini menelusuri halaman, mengisi formulir, dan mengekstrak informasi tanpa intervensi manusia. Tapi ketika CAPTCHA muncul, agen tersebut berhenti.

HyperBrowser menawarkan infrastruktur browser berbasis cloud yang dirancang khusus untuk agen AI, dengan penyelesaian CAPTCHA native untuk Turnstile dan reCAPTCHA. Tapi web memiliki lebih dari dua jenis CAPTCHA. AWS WAF, GeeTest, varian reCAPTCHA perusahaan, dan tantangan anti-bot lainnya masih tidak terselesaikan oleh alat native sendiri.

CapSolver mengisi celah ini. Dengan mengunggah ekstensi CapSolver Chrome langsung ke HyperBrowser melalui API ekstensinya, Anda mendapatkan cakupan CAPTCHA menyeluruh di setiap sesi, setiap jenis CAPTCHA, dan setiap skala, tanpa mengubah kode otomatisasi Anda.


Apa itu HyperBrowser?

HyperBrowser adalah platform infrastruktur browser berbasis cloud yang dirancang khusus untuk agen AI. Menyediakan sesi browser yang dikelola dengan akses CDP (Chrome DevTools Protocol) native, dukungan proxy, dan kemampuan anti-pendeteksian secara bawaan.

Fitur Utama

  • Sesi Browser Berbasis Cloud: Mulai sesi browser terisolasi sesuai kebutuhan, tanpa perlu instalasi Chrome lokal
  • Akses CDP Native: Hubungkan Playwright, Puppeteer, atau Selenium langsung ke sesi cloud melalui WebSocket
  • HyperAgent: Agen otomatisasi browser AI yang terintegrasi untuk tugas web berbasis bahasa alami
  • Anti-Deteksi: Profil stealth, proxy perumahan, dan randomisasi fingerprint yang terintegrasi dalam setiap sesi
  • Dukungan Ekstensi Chrome: API unggah ekstensi kelas pertama -- ZIP ekstensi, unggah, dan sertakan ke dalam sesi apa pun
  • Infrastruktur yang Dapat Diskalakan: Jalankan ratusan sesi bersamaan tanpa mengelola kumpulan browser

Mengapa Pengembang Memilih HyperBrowser

HyperBrowser menghilangkan beban operasional otomatisasi browser. Alih-alih mengelola biner Chromium, konfigurasi headless, rotasi proxy, dan anti-fingerprinting, Anda mendapatkan API bersih yang mengembalikan URL WebSocket. Hubungkan skrip Playwright atau Puppeteer dan mulai otomatisasi.


Apa itu CapSolver?

CapSolver adalah layanan penyelesaian CAPTCHA terkemuka yang menyediakan solusi berbasis AI untuk mengatasi berbagai tantangan CAPTCHA. Dengan dukungan berbagai jenis CAPTCHA dan waktu respons cepat, CapSolver terintegrasi dengan mulus ke dalam alur kerja otomatis.

Jenis CAPTCHA yang Didukung


Prasyarat

Sebelum mengatur integrasi, pastikan Anda memiliki:

  1. Akun HyperBrowser dengan API key (daftar di hyperbrowser.ai)
  2. Akun CapSolver dengan API key dan kredit (daftar di sini)
  3. Ekstensi CapSolver Chrome yang diunduh dan dikonfigurasi
  4. Node.js 18+ dengan @hyperbrowser/sdk dan playwright-core terinstal
bash Copy
npm install @hyperbrowser/sdk playwright-core

Setup Langkah Demi Langkah

Langkah 1: Dapatkan API Key CapSolver Anda

  1. Daftar atau masuk di capsolver.com
  2. Navigasi ke Dasbor Anda
  3. Salin API key Anda (format: CAP-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX)
  4. Tambahkan kredit ke akun Anda (gunakan kode bonus HYPERBROWSER untuk tambahan 6% pada recharge pertama)

Langkah 2: Unduh dan Konfigurasi Ekstensi CapSolver

Unduh ekstensi CapSolver Chrome dan konfigurasikan dengan API key Anda:

  1. Kunjungi rilis ekstensi CapSolver di GitHub
  2. Unduh versi terbaru CapSolver.Browser.Extension-chrome-vX.X.X.zip
  3. Ekstrak ekstensi:
bash Copy
mkdir -p capsolver-extension
unzip CapSolver.Browser.Extension-chrome-v*.zip -d capsolver-extension/
  1. Buka capsolver-extension/assets/config.js dan atur API key Anda:
js Copy
export const defaultConfig = {
  apiKey: 'CAP-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',  // kunci Anda di sini
  useCapsolver: true,
  // ... sisa konfigurasi
};
  1. Verifikasi struktur ekstensi:
bash Copy
ls capsolver-extension/manifest.json
# Harus ada

Langkah 3: ZIP Direktori Ekstensi

API unggah ekstensi HyperBrowser memerlukan file ZIP. Paket ekstensi yang dikonfigurasi:

bash Copy
cd capsolver-extension && zip -r ../capsolver-extension.zip . && cd ..

Ini menciptakan capsolver-extension.zip di akar proyek Anda, siap untuk diunggah.

Langkah 4: Unggah Ekstensi ke HyperBrowser

Gunakan SDK HyperBrowser untuk mengunggah file ZIP ekstensi. Ini hanya perlu dilakukan sekali โ€” extensionId yang dikembalikan bisa digunakan kembali di semua sesi.

typescript Copy
import { Hyperbrowser } from "@hyperbrowser/sdk";

const client = new Hyperbrowser({
  apiKey: process.env.HYPERBROWSER_API_KEY,
});

// Unggah ekstensi CapSolver (operasi sekali)
const ext = await client.extensions.create({
  filePath: "capsolver-extension.zip",
});

console.log("ID Ekstensi:", ext.id);
// Simpan ID ini โ€” Anda akan menggunakannya kembali untuk setiap sesi

Tips: Simpan ext.id dalam variabel lingkungan atau konfigurasi Anda. Anda hanya perlu mengunggah ulang jika mengubah versi ekstensi atau API key.

Langkah 5: Buat Sesi dengan Ekstensi

Buat sesi HyperBrowser yang memuat ekstensi CapSolver:

typescript Copy
const session = await client.sessions.create({
  extensionIds: [ext.id],
  useProxy: true, // Memerlukan rencana berbayar โ€” hapus untuk tier gratis
  solveCaptchas: false, // Menggunakan CapSolver alih-alih penyelesaian native
});

console.log("ID Sesi:", session.id);
console.log("URL WebSocket:", session.wsEndpoint);

Catatan: Atur solveCaptchas: false saat menggunakan CapSolver untuk menghindari konflik antara dua mekanisme penyelesaian. Jika Anda ingin keduanya sebagai rantai cadangan, lihat bagian "Kapan Menggunakan Native vs CapSolver" di bawah ini.

Langkah 6: Hubungkan Playwright ke Sesi

Hubungkan Playwright ke sesi HyperBrowser melalui endpoint WebSocket:

typescript Copy
import { chromium } from "playwright-core";

const browser = await chromium.connectOverCDP(session.wsEndpoint);
const context = browser.contexts()[0];
const page = context.pages()[0] || await context.newPage();

// Navigasi ke halaman yang dilindungi CAPTCHA
await page.goto("https://www.google.com/recaptcha/api2/demo");

// Tunggu ekstensi CapSolver mendeteksi dan menyelesaikan CAPTCHA
await page.waitForTimeout(30000);

// Kirim formulir
await page.click("#recaptcha-demo-submit");
await page.waitForLoadState("networkidle");

// Verifikasi keberhasilan
const result = await page.textContent("body");
console.log("Hasil:", result);
// Harapan: berisi "Verification Success"

await browser.close();
await client.sessions.stop(session.id);

Langkah 7: Uji di Halaman Demo reCAPTCHA

Berikut adalah skrip end-to-end lengkap yang mengunggah ekstensi, membuat sesi, menyelesaikan CAPTCHA, dan memverifikasi hasilnya:

typescript Copy
import { Hyperbrowser } from "@hyperbrowser/sdk";
import { chromium } from "playwright-core";

const HYPERBROWSER_API_KEY = process.env.HYPERBROWSER_API_KEY!;
const CAPSOLVER_EXTENSION_ID = process.env.CAPSOLVER_EXTENSION_ID; // Opsional: gunakan ID yang sudah ada

async function main() {
  const client = new Hyperbrowser({ apiKey: HYPERBROWSER_API_KEY });

  // Langkah 1: Unggah ekstensi (atau gunakan ID yang sudah ada)
  let extensionId = CAPSOLVER_EXTENSION_ID;

  if (!extensionId) {
    const ext = await client.extensions.create({
      filePath: "capsolver-extension.zip",
    });
    extensionId = ext.id;
    console.log("Ekstensi diunggah:", extensionId);
  }

  // Langkah 2: Buat sesi dengan ekstensi CapSolver
  const session = await client.sessions.create({
    extensionIds: [extensionId],
    useProxy: true, // Memerlukan rencana berbayar โ€” hapus untuk tier gratis
    solveCaptchas: false,
  });

  console.log("Sesi dimulai:", session.id);

  // Langkah 3: Hubungkan Playwright
  const browser = await chromium.connectOverCDP(session.wsEndpoint);
  const context = browser.contexts()[0];
  const page = context.pages()[0] || await context.newPage();

  try {
    // Langkah 4: Navigasi ke demo reCAPTCHA
    console.log("Mengarah ke demo reCAPTCHA...");
    await page.goto("https://www.google.com/recaptcha/api2/demo");

    // Langkah 5: Tunggu CapSolver menyelesaikan CAPTCHA
    console.log("Menunggu CapSolver menyelesaikan CAPTCHA...");
    await page.waitForTimeout(30000);

    // Langkah 6: Kirim formulir
    console.log("Mengirim formulir...");
    await page.click("#recaptcha-demo-submit");
    await page.waitForLoadState("networkidle");

    // Langkah 7: Periksa hasil
    const bodyText = await page.textContent("body");

    if (bodyText?.includes("Verification Success")) {
      console.log("CAPTCHA diselesaikan dengan sukses!");
    } else {
      console.log("Hasil verifikasi:", bodyText?.slice(0, 200));
    }
  } finally {
    await browser.close();
    await client.sessions.stop(session.id);
    console.log("Sesi dihentikan.");
  }
}

main().catch(console.error);

Jalankan itu:

bash Copy
HYPERBROWSER_API_KEY=your_key npx tsx captcha-test.ts

Cara Kerjanya di Balik Layar

Berikut alur lengkap dari unggah ekstensi hingga penyelesaian CAPTCHA:

Copy
  Pengaturan Sekali
  โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•

  capsolver-extension/           HyperBrowser Cloud
  โ”œโ”€โ”€ manifest.json    โ”€โ”€ZIPโ”€โ”€โ–บ  POST /extensions
  โ”œโ”€โ”€ assets/config.js           โ”‚
  โ””โ”€โ”€ background.js              โ–ผ
                                 extensionId: "ext_abc123"
                                 (disimpan, bisa digunakan kembali)

  Alur Sesi Per-Sesi
  โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•โ•

  Skrip Anda                    HyperBrowser Cloud
  โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€
  sessions.create({       โ”€โ”€โ–บ    Mulai Chromium berbasis cloud
    extensionIds: [id],          โ”‚
    useProxy: true               โ”œโ”€โ”€ Muat ekstensi CapSolver
  })                             โ”œโ”€โ”€ Terapkan proxy + stealth
                                 โ–ผ
                          โ—„โ”€โ”€    wsEndpoint (URL WebSocket)

  playwright.connectOverCDP()    Terhubung ke browser cloud
       โ”‚
       โ–ผ
  page.goto(target_url)   โ”€โ”€โ–บ   Chromium memuat halaman
                                 โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                                 โ”‚  Halaman dengan widget CAPTCHA    โ”‚
                                 โ”‚                              โ”‚
                                 โ”‚  Ekstensi CapSolver:        โ”‚
                                 โ”‚  1. Skrip konten mendeteksi   โ”‚
                                 โ”‚     jenis CAPTCHA di halaman   โ”‚
                                 โ”‚  2. Pekerja layanan memanggil   โ”‚
                                 โ”‚     API CapSolver            โ”‚
                                 โ”‚  3. Token solusi diterima      โ”‚
                                 โ”‚  4. Token dimasukkan ke      โ”‚
                                 โ”‚     bidang formulir tersembunyi  โ”‚
                                 โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                      โ”‚
  page.waitForTimeout(30s)            โ”‚ (penyelesaian terjadi di sini)
       โ”‚                              โ”‚
       โ–ผ                              โ–ผ
  page.click("Submit")    โ”€โ”€โ–บ   Form mengirimkan dengan token yang valid
                                      โ”‚
                          โ—„โ”€โ”€         โ–ผ
                                 Google demo: "Verification Success!"

Mengapa Penyelesaian Berbasis Ekstensi Bekerja Sangat Baik

Pendekatan ekstensi Chrome CapSolver memiliki keunggulan utama dibandingkan penyelesaian berbasis API: ekstensi berjalan di dalam konteks browser itu sendiri. Ini berarti:

  1. Deteksi Otomatis: Skrip konten memindai setiap halaman untuk widget CAPTCHA yang dikenal โ€” tidak perlu kode deteksi manual
  2. Injeksi Token Native: Token dimasukkan langsung ke DOM, persis seperti browser pengguna nyata
  3. Tidak Ada Kode Koordinasi: Anda tidak perlu menulis createTask() / getTaskResult() / logika injeksi โ€” semuanya ditangani oleh ekstensi
  4. Bekerja dengan Setiap Kerangka: Baik Anda menggunakan Playwright, Puppeteer, atau Selenium untuk terhubung, ekstensi bekerja dengan cara yang sama

Gunakan Ekstensi CapSolver Ketika:

  • Anda menghadapi AWS WAF, GeeTest, atau varian reCAPTCHA perusahaan
  • Anda membutuhkan waktu penyelesaian yang lebih cepat untuk otomatisasi volume tinggi
  • Anda ingin penyelesaian CAPTCHA yang konsisten antara HyperBrowser dan browser yang Anda host sendiri
  • Anda membutuhkan cakupan CAPTCHA terluas untuk situs target yang tidak dikenal
typescript Copy
// Komprehensif: ekstensi CapSolver
const session = await client.sessions.create({
  extensionIds: [capsolverExtId],
  solveCaptchas: false,
  useProxy: true, // Memerlukan rencana berbayar โ€” hapus untuk tier gratis
});

Gunakan Keduanya sebagai Rantai Cadangan:

Untuk keandalan maksimal, Anda dapat mengaktifkan keduanya. Penyelesaian native menangani Turnstile/reCAPTCHA tanpa biaya tambahan, dan CapSolver menangani yang lainnya:

typescript Copy
// Kedua-duanya: keduanya diaktifkan
const session = await client.sessions.create({
  extensionIds: [capsolverExtId],
  solveCaptchas: true, // Native menangani Turnstile/reCAPTCHA
  useProxy: true, // Memerlukan rencana berbayar โ€” hapus untuk tier gratis
  // Ekstensi CapSolver menangani AWS WAF, GeeTest, dll.
});

Catatan: Ketika keduanya diaktifkan untuk jenis CAPTCHA yang sama (misalnya reCAPTCHA), yang menyelesaikan terlebih dahulu menang. Dalam praktiknya, ini berjalan dengan baik โ€” tidak ada konflik.

Alternatif: Pendekatan API CapSolver

Jika Anda lebih suka tidak menggunakan ekstensi browser โ€” atau membutuhkan kontrol yang lebih halus terhadap alur penyelesaian โ€” Anda dapat menggunakan API REST CapSolver secara langsung. Ini bekerja dengan sesi HyperBrowser apa pun, tanpa perlu mengunggah ekstensi.
const HYPERBROWSER_API_KEY = process.env.HYPERBROWSER_API_KEY!;
const CAPSOLVER_API_KEY = process.env.CAPSOLVER_API_KEY!;

async function solveCaptchaViaAPI(
pageUrl: string,
siteKey: string
): Promise<string> {
// Buat tugas
const createRes = await fetch("https://api.capsolver.com/createTask", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
clientKey: CAPSOLVER_API_KEY,
task: {
type: "ReCaptchaV2TaskProxyLess",
websiteURL: pageUrl,
websiteKey: siteKey,
},
}),
});
const { taskId, errorDescription } = await createRes.json();
if (!taskId) throw new Error(createTask gagal: ${errorDescription});

// Poll untuk hasil
for (let i = 0; i < 40; i++) {
await new Promise((r) => setTimeout(r, 3000));
const resultRes = await fetch("https://api.capsolver.com/getTaskResult", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ clientKey: CAPSOLVER_API_KEY, taskId }),
});
const result = await resultRes.json();
if (result.status === "ready") {
return result.solution.gRecaptchaResponse;
}
}
throw new Error("Waktu habis");
}

async function main() {
const client = new Hyperbrowser({ apiKey: HYPERBROWSER_API_KEY });

// Tidak perlu ekstensi โ€” sesi biasa saja
const session = await client.sessions.create({
solveCaptchas: false,
});

const browser = await chromium.connectOverCDP(session.wsEndpoint);
const context = browser.contexts()[0];
const page = context.pages()[0] || await context.newPage();

try {
await page.goto("https://www.google.com/recaptcha/api2/demo");

Copy
// Deteksi sitekey dari DOM
const siteKey = await page.evaluate(() => {
  const el = document.querySelector(".g-recaptcha[data-sitekey]");
  return el?.getAttribute("data-sitekey") ?? "";
});
console.log("Sitekey:", siteKey);

// Selesaikan via API CapSolver
const token = await solveCaptchaViaAPI(page.url(), siteKey);
console.log("Token diterima, panjang:", token.length);

// Sisipkan token
await page.evaluate((t) => {
  const textarea = document.querySelector(
    'textarea[name="g-recaptcha-response"]'
  );
  if (textarea) (textarea as HTMLTextAreaElement).value = t;
}, token);

// Kirim
await page.click("#recaptcha-demo-submit");
await page.waitForLoadState("networkidle");

const body = await page.textContent("body");
console.log(
  body?.includes("Verification Success")
    ? "CAPTCHA diselesaikan via API!"
    : body?.slice(0, 200)
);

} finally {
await browser.close();
await client.sessions.stop(session.id);
}
}

main().catch(console.error);

Copy
### Kapan Menggunakan API vs Ekstensi

| | Ekstensi | API |
|---|---|---|
| **Pengaturan** | Unggah ZIP sekali, gunakan ID | Tidak perlu pengaturan โ€” hanya API key |
| **Deteksi** | Otomatis (content script) | Manual (query DOM untuk sitekey) |
| **Injeksi token** | Otomatis | Manual (eval JS) |
| **Kontrol** | Tidak transparan โ€” ekstensi menangani semua | Kontrol penuh atas setiap langkah |
| **Terbaik untuk** | Otomasi set-and-forget | Logika penyelesaian kustom, strategi ulang |

---

## Troubleshooting

### Ekstensi Tidak Dimuat dalam Sesi

**Gejala**: CAPTCHA tidak diselesaikan; halaman berperilaku seperti tidak ada ekstensi.

**Kemungkinan penyebab**:
1. **ID ekstensi salah** -- Verifikasi ID yang dikembalikan dari `client.extensions.create()` dikirimkan dengan benar
2. **ZIP rusak** -- Ulangi pengarsipan direktori ekstensi (pastikan `manifest.json` berada di akar ZIP, bukan di subfolder)
3. **API key tidak ada** -- Periksa bahwa `assets/config.js` memiliki kunci CapSolver yang valid sebelum mengarsip

**Perbaikan**:
```bash
# Verifikasi struktur ZIP -- manifest.json harus di akar
unzip -l capsolver-extension.zip | head -20
# Harus menunjukkan: manifest.json (BUKAN capsolver-extension/manifest.json)

CAPTCHA Tidak Diselesaikan (Form Gagal)

Gejala: Halaman dimuat, tetapi CAPTCHA tetap tidak diselesaikan setelah menunggu.

Kemungkinan penyebab:

  1. Waktu menunggu terlalu singkat -- Tingkatkan waitForTimeout menjadi 45-60 detik
  2. API key tidak valid -- Masuk ke dashboard CapSolver Anda dan verifikasi kunci
  3. Saldo tidak cukup -- Isi ulang akun CapSolver Anda
  4. Jenis CAPTCHA tidak didukung -- Lihat dokumen CapSolver untuk jenis yang didukung

Koneksi WebSocket Sesi Gagal

Gejala: chromium.connectOverCDP() melemparkan kesalahan koneksi.

Perbaikan: Pastikan sesi masih aktif. Sesi memiliki timeout (default tergantung paket). Buat sesi baru jika sesi sebelumnya habis:

typescript Copy
try {
  const browser = await chromium.connectOverCDP(session.wsEndpoint);
} catch (err) {
  console.log("Sesi habis, membuat yang baru...");
  const newSession = await client.sessions.create({
    extensionIds: [extensionId],
    useProxy: true, // Memerlukan paket berbayar โ€” hapus untuk tier gratis
  });
  const browser = await chromium.connectOverCDP(newSession.wsEndpoint);
}

Ekstensi Berjalan Lokal Tapi Tidak di HyperBrowser

Gejala: Ekstensi CapSolver berjalan saat dimuat lokal di Chrome, tetapi gagal di sesi HyperBrowser.

Kemungkinan penyebab:

  1. config.js tidak termasuk dalam ZIP -- Periksa kembali ZIP mencakup assets/config.js yang dimodifikasi
  2. Keterbatasan jaringan -- Ekstensi perlu mengakses api.capsolver.com. Pastikan jaringan sesi HyperBrowser mengizinkan HTTPS keluar
  3. Versi ekstensi tidak sesuai -- Gunakan versi terbaru ekstensi CapSolver untuk kompatibilitas terbaik

Praktik Terbaik

1. Unggah Ekstensi Sekali, Gunakan ID yang Sama

Unggah ekstensi adalah satu kali. Simpan extensionId yang dikembalikan dan gunakan kembali di semua sesi:

typescript Copy
// Unggah sekali
const ext = await client.extensions.create({ filePath: "capsolver-extension.zip" });
const CAPSOLVER_EXT_ID = ext.id;

// Gunakan di setiap sesi
for (const url of targetUrls) {
  const session = await client.sessions.create({
    extensionIds: [CAPSOLVER_EXT_ID],
    useProxy: true, // Memerlukan paket berbayar โ€” hapus untuk tier gratis
  });
  // ... otomasi
  await client.sessions.stop(session.id);
}

2. Selalu Aktifkan Proksi

CAPTCHA lebih mungkin muncul (dan lebih sulit diselesaikan) saat permintaan berasal dari IP datacenter. Proksi bawaan HyperBrowser membantu:

typescript Copy
const session = await client.sessions.create({
  extensionIds: [extensionId],
  useProxy: true, // Memerlukan paket berbayar โ€” hapus untuk tier gratis. Proksi residensial mengurangi frekuensi CAPTCHA
});

3. Gunakan Waktu Tunggu yang Tepat

Jenis CAPTCHA berbeda-beda waktu penyelesaian:

Jenis CAPTCHA Waktu Penyelesaian Khas Waktu Tunggu Direkomendasikan
reCAPTCHA v2 (checkbox) 5-15 detik 30 detik
reCAPTCHA v2 (invisible) 5-15 detik 25 detik
reCAPTCHA v3 3-10 detik 20 detik
Cloudflare Turnstile 3-10 detik 20 detik
AWS WAF 5-15 detik 30 detik
GeeTest v3/v4 5-20 detik 30 detik

Tips: Jika ragu, gunakan 30 detik. Lebih baik menunggu sedikit lebih lama daripada mengirim terlalu dini.

4. Pantau Saldo CapSolver Anda

Setiap penyelesaian CAPTCHA memakan kredit. Tambahkan pemeriksaan saldo ke otomasi Anda untuk menghindari gangguan:

typescript Copy
import axios from "axios";

async function checkBalance(apiKey: string): Promise<number> {
  const response = await axios.post("https://api.capsolver.com/getBalance", {
    clientKey: apiKey,
  });
  return response.data.balance || 0;
}

const balance = await checkBalance(process.env.CAPSOLVER_API_KEY!);
if (balance < 1) {
  console.warn("Saldo CapSolver rendah! Isi ulang di capsolver.com");
}

5. Bersihkan Sesi

Selalu hentikan sesi ketika selesai untuk menghindari biaya yang tidak perlu:

typescript Copy
try {
  // ... kode otomasi Anda
} finally {
  await browser.close();
  await client.sessions.stop(session.id);
}

6. Ulangi ZIP Setelah Mengganti API Key

Jika Anda mengganti kunci API CapSolver, Anda perlu memperbarui config.js, mengarsip ulang, dan mengunggah kembali:

bash Copy
# Perbarui kunci di config.js, lalu:
cd capsolver-extension && zip -r ../capsolver-extension.zip . && cd ..

Kemudian unggah ZIP baru dan perbarui extensionId yang tersimpan.


Kesimpulan

HyperBrowser dan CapSolver bersama-sama menyediakan setup penyelesaian CAPTCHA paling komprehensif yang tersedia untuk otomasi browser AI:

  1. HyperBrowser menangani infrastruktur -- sesi awan, proksi, anti-pendeteksian, dan penyelesaian CAPTCHA native untuk Turnstile dan reCAPTCHA
  2. CapSolver memperluas cakupan -- AWS WAF, GeeTest, reCAPTCHA enterprise, dan setiap jenis CAPTCHA yang solver native tidak capai

Integrasi sederhana: ZIP ekstensi CapSolver, unggah sekali via SDK HyperBrowser, dan sertakan ke sesi mana pun. Tidak ada deteksi CAPTCHA tingkat kode, tidak ada injeksi token, tidak ada polling API. Ekstensi menangani semuanya di dalam konteks browser.

Baik Anda membangun web scraper, agen AI, atau pipeline otomasi, kombinasi ini berarti CAPTCHA tidak lagi menjadi penghalang โ€” terlepas dari jenisnya.


Siap memulai? Daftar di CapSolver dan gunakan kode bonus HYPERBROWSER untuk bonus 6% tambahan pada recharge pertama Anda!


FAQ

Apa itu HyperBrowser?

HyperBrowser adalah platform infrastruktur browser awan untuk agen AI. Menyediakan sesi browser yang dikelola, terisolasi dengan akses CDP, sehingga Anda dapat menghubungkan Playwright, Puppeteer, atau Selenium ke instance Chromium yang dihosting awan. Termasuk proksi bawaan, anti-pendeteksian, dan penyelesaian CAPTCHA native untuk Turnstile dan reCAPTCHA.

Bagaimana cara kerja unggah ekstensi?

HyperBrowser memiliki API ekstensi kelas pertama. Anda ZIP direktori ekstensi Chrome, unggah via client.extensions.create(), dan menerima extensionId. Kirim ID ini ke client.sessions.create() dan ekstensi dimuat ke sesi browser awan secara otomatis.

Jenis CAPTCHA apa yang didukung CapSolver?

CapSolver mendukung reCAPTCHA v2 (checkbox dan invisible), reCAPTCHA v3, reCAPTCHA Enterprise, Cloudflare Turnstile, Cloudflare 5-second Challenge, AWS WAF, GeeTest v3/v4, dan lainnya. Ekstensi Chrome secara otomatis mendeteksi jenis CAPTCHA dan menyelesaikannya.

Berapa biaya CapSolver?

CapSolver menawarkan harga kompetitif berdasarkan jenis CAPTCHA dan volume. Kunjungi capsolver.com untuk harga saat ini. Gunakan kode HYPERBROWSER untuk bonus 6% pada recharge pertama Anda.

Apakah saya perlu mengunggah ulang ekstensi untuk setiap sesi?

Tidak. Unggah ekstensi sekali dan gunakan extensionId yang dikembalikan di semua sesi. Anda hanya perlu mengunggah ulang jika mengubah kunci API CapSolver di dalam ekstensi atau memperbarui versi ekstensi.

Bolehkah saya menggunakan Puppeteer alih-alih Playwright?

Ya. HyperBrowser mendukung Playwright, Puppeteer, dan Selenium. Ganti panggilan connectOverCDP Playwright dengan setara Puppeteer:

typescript Copy
import puppeteer from "puppeteer-core";

const browser = await puppeteer.connect({
  browserWSEndpoint: session.wsEndpoint,
});

Ekstensi CapSolver berjalan identik terlepas dari framework otomasi yang Anda gunakan untuk terhubung.

Apakah HyperBrowser gratis?

HyperBrowser menawarkan tier gratis dengan sesi terbatas. Paket berbayar membuka lebih banyak sesi, timeout lebih lama, dan fitur tambahan. Kunjungi hyperbrowser.ai untuk harga saat ini.

Pernyataan Kepatuhan: Informasi yang diberikan di blog ini hanya untuk tujuan informasi. CapSolver berkomitmen untuk mematuhi semua hukum dan peraturan yang berlaku. Penggunaan jaringan CapSolver untuk kegiatan ilegal, penipuan, atau penyalahgunaan sangat dilarang dan akan diselidiki. Solusi penyelesaian captcha kami meningkatkan pengalaman pengguna sambil memastikan kepatuhan 100% dalam membantu menyelesaikan kesulitan captcha selama pengambilan data publik. Kami mendorong penggunaan layanan kami secara bertanggung jawab. Untuk informasi lebih lanjut, silakan kunjungi Syarat Layanan dan Kebijakan Privasi.

Lebih lanjut

Buka Browser Menggunakan CapSolver
Cara Menyelesaikan CAPTCHA di OpenBrowser Menggunakan CapSolver (Panduan Otomatisasi Agen AI)

Selesaikan CAPTCHA di OpenBrowser dengan CapSolver. Otomatisasi reCAPTCHA, Turnstile, dan lainnya untuk agen AI dengan mudah.

AI
Logo of CapSolver

Aloรญsio Vรญtor

26-Mar-2026

HyperBrowser dengan CapSolver
Cara Menyelesaikan CAPTCHA Apa pun di HyperBrowser Menggunakan CapSolver (Panduan Pemasangan Lengkap)

Selesaikan CAPTCHA apa pun di HyperBrowser dengan CapSolver. Otomatiskan reCAPTCHA, Turnstile, AWS WAF, dan lainnya dengan lebih mudah.

AI
Logo of CapSolver

Emma Foster

26-Mar-2026

Menyelesaikan Captcha untuk Pemantauan Harga Agen AI: Panduan Langkah demi Langkah
Menyelesaikan Captcha untuk Agen AI Pemantauan Harga: Panduan Langkah demi Langkah

Pelajari cara menyelesaikan CAPTCHA secara efektif untuk agen AI pemantauan harga dengan CapSolver. Panduan langkah demi langkah ini menjamin pengumpulan data yang tidak terputus dan wawasan pasar yang ditingkatkan.

AI
Logo of CapSolver

Lucas Mitchell

25-Mar-2026

Menyelesaikan CAPTCHA dengan NanoClaw dan CapSolver
Cara Memecahkan CAPTCHA Secara Otomatis dengan NanoClaw dan CapSolver

Panduan langkah demi langkah untuk menggunakan CapSolver dengan NanoClaw untuk menyelesaikan secara otomatis reCAPTCHA, Turnstile, AWS WAF, dan CAPTCHA lainnya. Bekerja dengan agen Claude AI, tanpa kode, dan banyak browser.

AI
Logo of CapSolver

Nikolai Smirnov

20-Mar-2026

Menyelesaikan CAPTCHA dengan TinyFish AgentQ
Cara Menyelesaikan CAPTCHA dengan TinyFish AgentQL โ€“ Panduan Langkah demi Langkah Menggunakan CapSolver

Pelajari cara mengintegrasikan CapSolver dengan TinyFish AgentQL untuk menyelesaikan CAPTCHA seperti reCAPTCHA dan Cloudflare Turnstile secara otomatis. Tutorial langkah demi langkah dengan contoh SDK Python dan JavaScript untuk otomatisasi web berbasis AI yang mulus.

AI
Logo of CapSolver

Aloรญsio Vรญtor

19-Mar-2026

Mengintegrasikan CapSolver dengan Web MCP: Panduan untuk Agen Otonom
Mengintegrasikan CapSolver dengan Web MCP: Panduan untuk Agen Otonom

Tingkatkan kemampuan otomatisasi web agen AI Anda. Panduan ini menjelaskan cara mengintegrasikan CapSolver untuk penyelesaian captcha yang efisien dalam kerangka kerja Web MCP, memastikan operasi yang andal dan sesuai aturan.

AI
Logo of CapSolver

Lucas Mitchell

17-Mar-2026