MTCaptcha di Python: Ambil Sitekey, Pecahkan, dan Kirim

mtcaptcha in python - MTCaptcha in Python: Scrape the Sitekey, Solve and Post

Untuk menangani MTCaptcha di Python tanpa browser, muat halaman login dengan requests, baca sitekey dan action dari objek mtcaptchaConfig-nya, teruskan keduanya ke solver.mtcaptcha() dari SDK CapSkip, lalu kirim token yang dikembalikan di field mtcaptcha-verifiedtoken pada pengiriman formulir. Yang bekerja di balik panggilan itu adalah pemecah MTCaptcha CapSkip, yang berjalan di PC Windows Anda sendiri dengan lisensi tetap, jadi token yang ditolak tidak membebani Anda selain satu putaran lagi melalui loop.

Apa yang Anda butuhkan

  • PC Windows dengan CapSkip 4.3.0 (9 November 2026, rilis pertama dengan MTCaptcha) atau lebih baru. Lihat panduan penyiapan untuk cara menginstalnya. Salinan di PC saya menerima metode mt_captcha, tetapi saya tidak dapat membaca versinya.
  • Python 3.10 atau lebih baru, batas minimum yang dinyatakan capskip 1.7.0, requests 2.34.2 dan urllib3 2.8.0, ditambah capskip 1.7.0 atau lebih baru, versi pertama dengan metode MTCaptcha. Saya hanya menjalankannya di Python 3.11.7, 3.13.7, dan 3.14.0.
  • Kedua paket diinstal dari PowerShell dengan python -m pip install capskip requests (py -m pip juga bisa), jadi pip tidak perlu ada di PATH Anda.
  • Sebuah alamat untuk CapSkip. Dalam mode Local (127.0.0.1), hanya PC yang menjalankan CapSkip yang dapat menjangkaunya. Mode Server menambahkan jaringan atau IP publik Anda, sehingga PC lain atau Windows VPS dapat mengirim permintaan yang sama. Kedua mode dijelaskan di bagian pengaturan koneksi dalam panduan penyiapan. Biarkan setiap pengaturan Service Emulator pada nilai defaultnya, karena SDK berbicara dengan CapSkip dalam format defaultnya dan layanan emulasi mungkin menjawab secara berbeda.

Saya menguji skrip ini terhadap dua mock buatan saya, satu berperan sebagai CapSkip dan satu sebagai situs login. Aplikasi CapSkip asli di PC saya menerima tiga task MTCaptcha, dengan sitekey demo publik dan alamat halaman dari contoh SDK sendiri, untuk melihat token asli dan mengukur waktu panggilan SDK. Tidak ada situs yang pernah memeriksa token, jadi tidak ada di sini yang menunjukkan bahwa situs sungguhan menerimanya, dan setiap aturan situs pada mock adalah buatan saya. Untuk cara situs memeriksa token, lihat dokumentasi MTCaptcha, yaitu panduan validasi token.

Langkah 1: siapkan sesi dan temukan sitekey MTCaptcha

Simpan blok kode pertama sebagai mtcaptcha_login.py. Setiap blok setelahnya, termasuk blok berikutnya di langkah ini, diletakkan di akhir file yang sama sesuai urutan yang ditunjukkan, dan file ini lengkap setelah Langkah 4. Satu string User-Agent dipakai untuk pemuatan halaman, pemecahan, dan pengiriman formulir, jadi pilih string browser terkini mana pun. Dalam mode Server, isi alamat server Anda pada host. Jika API Key Validation aktif, berikan juga key Anda sebagai apiKey.

# python -m pip install capskip requests
import re

import requests
from capskip import ApiException, CapSkip

LOGIN_URL = "https://example.com/login"  # the page that shows the widget
USER_AGENT = (
    "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
    "(KHTML, like Gecko) Chrome/140.0.0.0 Safari/537.36"
)

# Local mode. In Server mode, use your server's address as the host.
solver = CapSkip(host="127.0.0.1", port=8080)

Sebagian besar halaman MTCaptcha mengonfigurasi widget dengan objek mtcaptchaConfig inline yang nilai sitekey-nya diawali MTPublic-, dan objek itu mungkin juga menetapkan action. Halaman demo CapSkip menuliskannya dalam satu baris dengan key lang, tiga callback, dan tanpa action. Dokumentasi CapSkip menyebarkannya ke beberapa baris dan menambahkan action. Halaman lain memakai tanda kutip tunggal dan key tanpa tanda kutip. Fungsi di bawah mencari setiap key berdasarkan namanya, jadi semua gaya itu terbaca, tetapi fungsi inline di dalam objek, atau script yang tidak mengakhiri objek dengan kurung kurawal tutup dan titik koma atau dengan tag script penutup, akan menggagalkannya.

Fungsi ini memunculkan error ketika halaman tidak memiliki objek semacam itu atau tidak ada sitekey di dalamnya, dan yang pertama adalah kasus nyata. GET ke halaman demo 2Captcha mengembalikan HTML yang sitekey-nya hanya muncul di petunjuknya. Untuk halaman seperti itu, salin sitekey sekali dari alamat iframe widget, tempat sitekey menjadi parameter query sitekey pada service.mtcaptcha.com. Jika halaman menetapkan action, kirimkan action itu. Menurut dokumentasi action milik MTCaptcha, panggilan pemeriksaan melaporkan action yang dipakai widget saat dimulai, sehingga situs dapat membandingkannya. Jika halaman tidak menetapkan action, jangan kirim apa pun.

def read_config(html):
    """Return (sitekey, action) from the page's mtcaptchaConfig object."""
    found = re.search(r"mtcaptchaConfig\s*=\s*\{(.*?)(?:\}\s*;|</script>)", html, re.S)
    if not found:
        raise RuntimeError("no mtcaptchaConfig in the page source")

    def value(name):
        pattern = r"(?<![\w-])[\"']?" + name + r"[\"']?\s*:\s*[\"']([^\"']+)[\"']"
        pair = re.search(pattern, found.group(1))
        return pair.group(1) if pair else None

    sitekey = value("sitekey")
    if not sitekey:
        raise RuntimeError("no sitekey in mtcaptchaConfig")
    return sitekey, value("action")

Saya menjalankan read_config pada tiga gaya tanda kutip dari mock saya, pada objek bersarang sebelum sitekey dan sebelum action, pada konfigurasi tanpa titik koma di akhir, dan pada salinan tersimpan dari dua halaman publik. Halaman demo CapSkip memberikan sitekey-nya dan tanpa action, dan halaman demo 2Captcha memunculkan error di atas. Ketiga versi Python memberikan hasil yang sama.

Langkah 2: minta token melalui SDK

Anda memanggil solver.mtcaptcha(sitekey, url, **options). Panggilan ini mengirim task, melakukan polling untuk hasilnya, dan mengembalikan dictionary, jadi Anda tidak menulis loop. Berikan alamat asli halaman sebagai url, karena MTCaptcha hanya menerbitkan token untuk domain tempat sebuah sitekey terdaftar. Tambahkan fungsi ini di akhir file. Fungsi ini menambahkan action hanya jika halaman menetapkannya.

def get_token(sitekey, action):
    options = {"userAgent": USER_AGENT}
    if action:  # only when the page's config sets one
        options["action"] = action
    return solver.mtcaptcha(sitekey, LOGIN_URL, **options)["token"]

Sebelum apa pun dikirim, SDK memvalidasi argumen Anda. Sitekey yang bukan MTPublic- diikuti hingga 55 huruf, angka, tanda hubung, atau garis bawah, alamat halaman yang bukan URL http atau https absolut, atau opsi yang tidak diterima API MTCaptcha, seperti invisible, langsung memunculkan ValidationException. Sitekey yang ditempel sebagai sk=MTPublic- diterima, dan SDK membuang prefiksnya.

Dalam tiga eksekusi nyata, dictionary berisi key "captchaId", "code", dan "token", dan dua yang terakhir adalah string yang sama, yaitu untuk mtcaptcha-verifiedtoken. Setiap token asli diawali v1( dan diakhiri **), panjangnya 418 karakter dan memiliki lima field yang dipisahkan koma, dengan field ketiga berisi sitekey. Dokumentasi mencantumkan contoh yang lebih pendek, jadi jangan memvalidasi token berdasarkan panjangnya.

Opsi userAgent menentukan string browser yang disampaikan CapSkip ke MTCaptcha. Saya meneruskan string milik sesi itu sendiri, sehingga pemecahan, pemuatan halaman, dan pengiriman formulir menampilkan satu browser yang sama. Tanpa opsi ini, CapSkip memakai string Chrome untuk Windows. Tidak ada yang saya baca yang menyebut MTCaptcha membandingkan keduanya, dan saya tidak mengujinya. Dokumentasi API yang aktif mencantumkan ERROR_WRONG_USERAGENT untuk User-Agent yang tidak dapat dipakai pada task, dan aplikasi asli tidak pernah menerima opsi userAgent saya, jadi jika aplikasi menjawab dengan error itu, hapus opsi tersebut dari get_token.

Waktu, dari sesaat sebelum panggilan hingga kembali: 3.77 detik sekali pada Python 3.14.0 dan 3.76 detik dua kali pada 3.11.7, dengan capskip 1.7.0, polling default, dan aplikasi CapSkip asli di Windows 11. Ketiga panggilan itu tidak mengirim userAgent maupun action. Jadwal polling SDK membentuk angka tersebut: terhadap mock, SDK menanyakan hasil pada 0, 0.25, 0.76, 1.76, 3.76, dan 7.76 detik setelah submit, dan token mock yang siap kapan saja antara 1.9 dan 3.6 detik kembali pada 3.76. Jadi pemecahan asli selesai di antara polling pada 1.76 dan 3.76 detik, dan tiga eksekusi bukanlah benchmark.

Tidak ada browser yang berjalan untuk pemecahan MTCaptcha, jadi SDK menunggu selama defaultTimeout mengizinkan, 120 detik secara default. Dengan defaultTimeout diturunkan menjadi 6 detik, mock yang tidak pernah menjawab memunculkan TimeoutException 7.78 detik setelah panggilan, karena tidur terakhir di antara polling melewati batasnya.

Langkah 3: kirim formulir selagi token masih segar

Di browser, widget menulis token ke input tersembunyi bernama mtcaptcha-verifiedtoken. Tanpa browser, Anda mengirim field itu sendiri, di samping field milik formulir. Fungsi di bawah, yang juga ditambahkan di akhir file, melakukannya. Session membawa cookie halaman ke POST formulir. Jika action pada formulir menunjuk ke tempat lain, ubah argumen pertama pada panggilan session.post.

Token hanya bisa dipakai sekali, dan hanya untuk waktu singkat. Panduan validasi MTCaptcha menyebut token biasanya berlaku selama beberapa menit tetapi memberi masa berlaku default 60 hingga 120 detik, dan secara default token hanya bisa diperiksa sekali, jadi kirim dalam waktu satu menit. Dokumentasi CapSkip meminta Anda meminta token tepat sebelum POST formulir, sehingga get_token dijalankan setelah halaman dimuat dan POST formulir menyusul segera. Jika Anda menambahkan jeda sendiri, lakukan pemecahan setelahnya. Token yang ditolak sudah terpakai, jadi loop di Langkah 4 meminta yang baru.

POST formulir juga menyebut halaman sebagai Referer, karena requests tidak mengirim Referer maupun Origin, dan beberapa framework menolak POST formulir HTTPS tanpa keduanya. Mock saya memerankan salah satunya, dan tanpa header itu ia menjawab 403.

def post_form(session, token, username, password):
    return session.post(
        LOGIN_URL,
        data={
            "username": username,  # your form's own fields go here
            "password": password,
            "mtcaptcha-verifiedtoken": token,
        },
        headers={"Referer": LOGIN_URL},  # requests sends none by itself
        timeout=30,
    )

Langkah 4: skrip login lengkap untuk MTCaptcha di Python

Tambahkan blok terakhir di akhir mtcaptcha_login.py, yang kemudian menjadi lengkap. Atur LOGIN_URL lalu jalankan python mtcaptcha_login.py (atau py mtcaptcha_login.py). Dua string adalah placeholder untuk situs Anda: "Welcome", teks yang ditampilkan login yang berhasil, dan "captcha check failed", frasa yang terkandung dalam penolakan captcha dari situs Anda sendiri. Skrip menyerah setelah tiga percobaan.

Menurut dokumentasi CapSkip, ERROR_CAPTCHA_UNSOLVABLE dijawab dengan mengirim task baru, dan skrip hanya mencoba ulang pada kode itu. Dokumentasi menyebut dua kegagalan yang berulang jika Anda mengirim ulang task yang sama, yaitu sitekey yang tidak dikenal dan sitekey yang tidak diizinkan pada domain halaman, dan setiap error lainnya juga menghentikan skrip. Di dalam pesan ApiException, kode datang sebagai teks polos atau terbungkus amplop JSON, dan which_error mengambilnya dari keduanya.

POST formulir yang ditolak mendapat token baru hanya jika balasan memuat frasa penolakan captcha dari situs Anda. Pakailah frasa seperti yang dikutip, jangan pernah kata captcha saja. Halaman login yang ditampilkan lagi setelah kata sandi salah tetap membawa mtcaptchaConfig dan mtcaptcha-verifiedtoken milik widget, jadi kata itu saja akan cocok dan menghabiskan tiga token. Saya melihatnya terhadap mock saya. Dengan frasa yang hanya ada pada penolakan, satu task yang terpakai.

def which_error(err):
    # The message holds the code as bare text or inside a JSON envelope.
    found = re.search(r"ERROR_[A-Z_]+", str(err))
    return found.group(0) if found else str(err)


def log_in(username, password):
    session = requests.Session()
    session.headers["User-Agent"] = USER_AGENT
    for attempt in range(1, 4):
        page = session.get(LOGIN_URL, timeout=30)  # cookies first, then config
        sitekey, action = read_config(page.text)
        try:
            token = get_token(sitekey, action)
        except ApiException as err:
            code = which_error(err)
            if code != "ERROR_CAPTCHA_UNSOLVABLE":
                raise  # a bad sitekey or domain would fail the same way again
            print(f"attempt {attempt}: {code}, new task")
            continue
        reply = post_form(session, token, username, password)
        if "Welcome" in reply.text:  # use a sign your site shows on success
            return reply
        if "captcha check failed" not in reply.text.lower():  # your site's phrase
            raise RuntimeError(f"login refused ({reply.status_code}), not the captcha")
        print(f"attempt {attempt}: captcha refused ({reply.status_code}), new token")
    raise RuntimeError("no login after 3 attempts")


if __name__ == "__main__":
    print(log_in("alice", "YOUR_PASSWORD").text[:40])

Terhadap mock, ketiga versi Python memberikan hasil yang identik:

Pengaturan mockYang dilakukan skrip
Konfigurasi halaman seperti di dokumentasi, dengan actionSatu task, in.php menerima action, POST formulir diterima
Konfigurasi dalam satu baris dengan callback dan tanpa action, seperti halaman demoSatu task, tidak ada field action yang dikirim, POST formulir diterima
Halaman menetapkan action tetapi panggilan tidak menyertakannyaTiga task, tiga POST formulir ditolak, lalu RuntimeError
Dua pemecahan pertama berakhir dengan ERROR_CAPTCHA_UNSOLVABLEDua pesan percobaan ulang, lalu token task ketiga diterima
Token berusia 3 detik saat dikirim, masa berlaku mock diatur 2 detikDitolak karena basi, lalu token baru diterima
Error sitekey atau domain tidak dikenal pada pollingApiException setelah satu task dan tanpa POST formulir, baik sebagai JSON maupun teks polos
Kata sandi salah dengan teks penolakan biasa, atau POST formulir tanpa header RefererRuntimeError setelah satu task, tanpa token baru
Halaman login ditampilkan lagi setelah kata sandi salah, diuji dengan kata captcha sajaTiga task, lalu RuntimeError. Dengan pengujian frasa, satu task

Baca tabel ini sebagai pengujian mock saya, bukan pengujian situs sungguhan mana pun. Sekali pakai, masa berlaku singkat, dan kecocokan action mengikuti dokumentasi, tetapi masa berlaku dua detik adalah angka sembarang dari saya.

Kesalahan umum

Sebagian besar error ini bersumber dari Dokumentasi API MTCaptcha, kecuali pada baris yang menyebut bahwa saya melihatnya sendiri.

KesalahanPenyebabPerbaiki
ValidationExceptionSDK menolak panggilan sebelum mengirimnya, karena salah satu alasan di Langkah 2Pesan menyebut masalahnya, jadi perbaiki argumen itu
ERROR_RECAPTCHA_INVALID_SITEKEYMTCaptcha tidak mengenali sitekeySalin ulang dari mtcaptchaConfig. Pengiriman ulang akan gagal, jadi skrip memunculkan error
ERROR_RECAPTCHA_INVALID_DOMAINSitekey tidak diizinkan pada domain alamat yang Anda kirimGunakan alamat halaman tempat widget sebenarnya berada
ERROR_CAPTCHA_UNSOLVABLEMTCaptcha tidak berhasil dilewatiKirim task baru, yang dilakukan skrip untuk Anda hingga tiga kali
ERROR_TASK_NOT_SUPPORTEDCapSkip lebih lama daripada rilis yang menambahkan MTCaptchaInstal CapSkip 4.3.0 atau rilis yang lebih baru
ERROR_WRONG_USERAGENTDokumentasi API yang aktif mencantumkannya untuk User-Agent yang tidak dapat dipakai pada task. Aplikasi asli tidak pernah menerima opsi userAgent dari kode sayaHapus opsi userAgent dari get_token
ERROR_WRONG_USER_KEY atau ERROR_KEY_DOES_NOT_EXISTAPI Key Validation aktif dan key salah. Panggilan tanpa apiKey dikirim dengan key capskipBerikan key asli Anda ke CapSkip() sebagai apiKey
TimeoutExceptionTidak ada token dalam defaultTimeout, 120 detik kecuali Anda mengubahnyaPantau task di Monitor CapSkip, lalu jalankan skrip lagi
NetworkExceptionTidak ada yang menjawab di host dan port itu saat task dikirim, atau balasannya berupa error HTTP. Jika CapSkip berhenti menjawab saat polling, Anda mendapat TimeoutExceptionJalankan CapSkip dan pastikan host dan port cocok dengan pengaturan koneksinya
Situs menolak token yang tampak baik-baik sajaToken sudah pernah dipakai, terlalu lama, tidak menyertakan action halaman, atau datang tanpa RefererKirim setiap token sekali saja, segera, dengan halaman sebagai Referer dan action milik halaman itu sendiri

FAQ

Bisakah skrip berjalan di mesin yang berbeda dari CapSkip?

Bisa, melalui mode Server. Aktifkan di pengaturan koneksi pada PC CapSkip dan berikan alamat PC itu sebagai host ke CapSkip(). Tidak ada hal lain yang berubah. Mode Server mengharuskan CapSkip berjalan sebagai administrator, dan panduan penyiapan menyarankan IP publik statis. Saat mode Server dimulai, CapSkip membuka portnya untuk semua alamat, jadi tambahkan aturan blokir Windows Firewall untuk mesin yang tidak boleh menjangkaunya. Pemecah tetap berada di perangkat keras Windows Anda sendiri dan tidak ada yang diukur.

Apakah skrip bekerja dengan widget MTCaptcha invisible?

Halaman pemecah MTCaptcha CapSkip menyebut bahwa widget invisible melalui permintaan yang sama dengan widget yang terlihat dan mengembalikan jenis token yang sama. Bagian MTCaptcha di dokumentasi API tidak menyebut mode invisible, dan saya tidak menjalankan apa pun terhadap widget invisible, jadi anggap belum terkonfirmasi. Halaman Anda tetap harus memuat sitekey di sumbernya, karena read_config membutuhkannya di sana.

Apakah saya perlu proxy untuk MTCaptcha?

Tidak untuk memulai. Dokumentasi menyebut satu alamat tidak masalah untuk pengujian, tetapi menyatakan bahwa pemecahan terus-menerus dari satu alamat mengundang pembatasan laju. Untuk volume besar, muat daftar proxy di pengaturan MTCaptcha pada aplikasi, atau berikan opsi proxy ke mtcaptcha(), seperti proxy={"type": "HTTP", "uri": "login:password@IP:PORT"}. Mock menerima proxy beserta tipenya; saya tidak memakai proxy sungguhan.

Versi singkatnya

MTCaptcha di Python intinya tiga langkah: baca sitekey dan action dari halaman, minta token tepat sebelum POST formulir, dan minta lagi ketika POST formulir ditolak. Karena CapSkip adalah pemecah captcha lokal yang Anda jalankan sendiri, token yang ditolak tidak pernah menambah tagihan. Lihat Halaman pemecah CAPTCHA Python untuk panggilan SDK tipe lainnya, dan buka Demo MTCaptcha untuk mencoba token di formulir sungguhan.