MTCaptcha di Python: Ambil Sitekey, Pecahkan, dan Kirim

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 mock | Yang dilakukan skrip |
|---|---|
| Konfigurasi halaman seperti di dokumentasi, dengan action | Satu task, in.php menerima action, POST formulir diterima |
| Konfigurasi dalam satu baris dengan callback dan tanpa action, seperti halaman demo | Satu task, tidak ada field action yang dikirim, POST formulir diterima |
| Halaman menetapkan action tetapi panggilan tidak menyertakannya | Tiga task, tiga POST formulir ditolak, lalu RuntimeError |
| Dua pemecahan pertama berakhir dengan ERROR_CAPTCHA_UNSOLVABLE | Dua pesan percobaan ulang, lalu token task ketiga diterima |
| Token berusia 3 detik saat dikirim, masa berlaku mock diatur 2 detik | Ditolak karena basi, lalu token baru diterima |
| Error sitekey atau domain tidak dikenal pada polling | ApiException 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 Referer | RuntimeError setelah satu task, tanpa token baru |
| Halaman login ditampilkan lagi setelah kata sandi salah, diuji dengan kata captcha saja | Tiga 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.
| Kesalahan | Penyebab | Perbaiki |
|---|---|---|
| ValidationException | SDK menolak panggilan sebelum mengirimnya, karena salah satu alasan di Langkah 2 | Pesan menyebut masalahnya, jadi perbaiki argumen itu |
| ERROR_RECAPTCHA_INVALID_SITEKEY | MTCaptcha tidak mengenali sitekey | Salin ulang dari mtcaptchaConfig. Pengiriman ulang akan gagal, jadi skrip memunculkan error |
| ERROR_RECAPTCHA_INVALID_DOMAIN | Sitekey tidak diizinkan pada domain alamat yang Anda kirim | Gunakan alamat halaman tempat widget sebenarnya berada |
| ERROR_CAPTCHA_UNSOLVABLE | MTCaptcha tidak berhasil dilewati | Kirim task baru, yang dilakukan skrip untuk Anda hingga tiga kali |
| ERROR_TASK_NOT_SUPPORTED | CapSkip lebih lama daripada rilis yang menambahkan MTCaptcha | Instal CapSkip 4.3.0 atau rilis yang lebih baru |
| ERROR_WRONG_USERAGENT | Dokumentasi API yang aktif mencantumkannya untuk User-Agent yang tidak dapat dipakai pada task. Aplikasi asli tidak pernah menerima opsi userAgent dari kode saya | Hapus opsi userAgent dari get_token |
| ERROR_WRONG_USER_KEY atau ERROR_KEY_DOES_NOT_EXIST | API Key Validation aktif dan key salah. Panggilan tanpa apiKey dikirim dengan key capskip | Berikan key asli Anda ke CapSkip() sebagai apiKey |
| TimeoutException | Tidak ada token dalam defaultTimeout, 120 detik kecuali Anda mengubahnya | Pantau task di Monitor CapSkip, lalu jalankan skrip lagi |
| NetworkException | Tidak ada yang menjawab di host dan port itu saat task dikirim, atau balasannya berupa error HTTP. Jika CapSkip berhenti menjawab saat polling, Anda mendapat TimeoutException | Jalankan CapSkip dan pastikan host dan port cocok dengan pengaturan koneksinya |
| Situs menolak token yang tampak baik-baik saja | Token sudah pernah dipakai, terlalu lama, tidak menyertakan action halaman, atau datang tanpa Referer | Kirim 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.
