Python’da MTCaptcha: Sitekey’i Çekin, Çözün ve Gönderin

Python’da MTCaptcha’yı tarayıcı olmadan işlemek için giriş sayfasını requests ile yükleyin, sitekey’i ve action değerini sayfanın mtcaptchaConfig nesnesinden okuyun, ikisini de CapSkip SDK’nın solver.mtcaptcha() çağrısına verin ve dönen token’ı form gönderiminin mtcaptcha-verifiedtoken alanında yollayın. Çağrının arkasındaki CapSkip MTCaptcha çözücüsü, kendi Windows bilgisayarınızda sabit bir lisansla çalışır; bu yüzden reddedilen bir token size döngüde bir tur daha atmaktan başka bir şeye mal olmaz.
Neye ihtiyacınız var
- CapSkip 4.3.0 (9 Kasım 2026, MTCaptcha desteği olan ilk sürüm) veya üzerini çalıştıran bir Windows bilgisayarı. Nasıl kurulacağını kurulum kılavuzu anlatır. Bilgisayarımdaki kopya mt_captcha metodunu kabul etti, ama sürümünü okuyamadım.
- Python 3.10 veya üzeri (capskip 1.7.0, requests 2.34.2 ve urllib3 2.8.0 paketlerinin bildirdiği asgari sürüm) ve ayrıca MTCaptcha metodu bulunan ilk sürüm olan capskip 1.7.0 veya üzeri. Bunları yalnızca Python 3.11.7, 3.13.7 ve 3.14.0 üzerinde çalıştırdım.
- İki paket de PowerShell’den python -m pip install capskip requests komutuyla kurulur (py -m pip de olur); bu yüzden pip’in PATH içinde olması gerekmez.
- CapSkip için bir adres. Local modunda (127.0.0.1) ona yalnızca CapSkip’i çalıştıran bilgisayar erişebilir. Server modu ağ adresinizi veya genel IP’nizi ekler; böylece başka bir bilgisayar ya da bir Windows VPS aynı istekleri gönderebilir. Her iki modu da kurulum kılavuzunda bağlantı ayarları başlığı altında bulursunuz. Service Emulator ayarını varsayılan değerinde bırakın, çünkü SDK CapSkip ile varsayılan biçiminde konuşur ve emüle edilen bir servis farklı yanıt verebilir.
Bu script’i yazdığım iki sahte (mock) sunucuya karşı test ettim: biri CapSkip’in, diğeri bir giriş sitesinin yerini tutuyordu. Bilgisayarımdaki gerçek CapSkip uygulaması, gerçek bir token görmek ve SDK çağrısının süresini ölçmek için, SDK’nın kendi örneğindeki herkese açık demo sitekey ve sayfa adresiyle üç MTCaptcha görevi aldı. Hiçbir site bir token’ı denetlemedi; bu yüzden buradaki hiçbir şey gerçek bir sitenin bir token’ı kabul ettiğini göstermez ve mock’taki her site kuralı benimdir. Bir sitenin token’ı nasıl denetlediği için bkz. MTCaptcha token doğrulama kılavuzu.
1. Adım: oturumu hazırlayın ve MTCaptcha sitekey’ini bulun
İlk kod bloğunu mtcaptcha_login.py olarak kaydedin. Ondan sonraki her blok, bu adımdaki sıradaki de dahil, gösterilen sırayla aynı dosyanın sonuna girer ve dosya 4. Adım’dan sonra tamamlanır. Sayfa yüklemesi, çözüm ve form gönderimi için tek bir User-Agent dizesi kullanılır, bu yüzden güncel herhangi bir tarayıcı dizesi seçin. Server modunda sunucunuzun adresini host içine yazın. API Key Validation açıksa anahtarınızı apiKey olarak da verin.
# 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)Çoğu MTCaptcha sayfası widget’ı satır içi bir mtcaptchaConfig nesnesiyle yapılandırır; nesnenin sitekey değeri MTPublic- ile başlar ve bir action da ayarlayabilir. CapSkip demo sayfası onu tek satırda, bir lang anahtarı ve üç callback ile, action olmadan yazar. CapSkip belgeleri onu birkaç satıra yayar ve bir action ekler. Başka sayfalar tek tırnak ve tırnaksız anahtarlar kullanır. Aşağıdaki fonksiyon her anahtarı adıyla arar, bu yüzden bunların hepsini okur; ancak nesnenin içinde satır içi bir fonksiyon olması ya da bir script’in nesneyi kapanan süslü parantez ve noktalı virgülle ya da kapanış script etiketiyle bitirmemesi onu bozar.
Sayfada böyle bir nesne ya da içinde bir sitekey yoksa hata verir ve ilki gerçek bir durumdur. 2Captcha’nın demo sayfasına yapılan bir GET, sitekey’in yalnızca açıklamalarında geçtiği bir HTML döndürdü. Böyle bir sayfa için sitekey’i bir kez widget’ın iframe adresinden kopyalayın; orada service.mtcaptcha.com üzerindeki sitekey sorgu parametresidir. Sayfa bir action ayarlıyorsa onu gönderin: MTCaptcha action belgeleri kontrol çağrısının widget’ın başladığı action değerini bildirdiğini söyler, böylece bir site karşılaştırabilir. Sayfa action ayarlamıyorsa hiçbir şey göndermeyin.
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")read_config fonksiyonunu mock’umdaki üç tırnak stilinde, iç içe bir nesnenin sitekey’den önce ve action değerinden önce geldiği config’lerde, sonunda noktalı virgül olmayan bir config’te ve iki herkese açık sayfanın kayıtlı kopyalarında çalıştırdım. CapSkip demo sayfası sitekey verdi, action vermedi; 2Captcha’nın demo sayfası yukarıdaki hatayı verdi. Üç Python sürümü de aynı sonucu verdi.
2. Adım: token’ı SDK üzerinden isteyin
solver.mtcaptcha(sitekey, url, **options) çağrısını yaparsınız. Görevi gönderir, sonucu yoklar ve bir sözlük döndürür; yani döngü yazmazsınız. url olarak sayfanın gerçek adresini verin, çünkü MTCaptcha token’ı yalnızca bir sitekey’in kayıtlı olduğu alan adları için verir. Bu fonksiyonu dosyanın sonuna ekleyin. Fonksiyon action değerini yalnızca sayfa bir tane ayarlamışsa ekler.
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"]Hiçbir şey gönderilmeden önce SDK argümanlarınızı doğrular. MTPublic- ile başlayıp ardından en fazla 55 harf, rakam, tire veya alt çizgi gelmeyen bir sitekey, mutlak bir http veya https URL’si olmayan bir sayfa adresi ya da MTCaptcha API’sinin almadığı bir seçenek (örneğin invisible) hemen ValidationException fırlatır. sk=MTPublic- biçiminde yapıştırılmış bir sitekey kabul edilir ve SDK öneki söker.
Üç gerçek çalıştırmada sözlük "captchaId", "code" ve "token" anahtarlarını taşıdı; son ikisi aynı dizedir, yani mtcaptcha-verifiedtoken alanı için olan dize. Her gerçek token v1( ile başladı, **) ile bitti, 418 karakter uzunluğundaydı ve virgülle ayrılmış beş alan taşıyordu; üçüncüsü sitekey’di. Belgeler daha kısa örnekler yazdırır, bu yüzden bir token’ı uzunluğuna bakarak doğrulamayın.
userAgent seçeneği, CapSkip’in MTCaptcha’ya sunduğu tarayıcı dizesini belirler. Ben oturumun kendi dizesini veriyorum; böylece çözüm, sayfa yüklemesi ve form gönderimi tek bir tarayıcı gibi görünür. Verilmezse CapSkip Windows için bir Chrome dizesi kullanır. Okuduğum hiçbir şey MTCaptcha’nın ikisini karşılaştırdığını söylemiyor ve bunu test etmedim. Güncel API belgeleri, görev için kullanılamayan bir User-Agent için ERROR_WRONG_USERAGENT kodunu listeler ve gerçek uygulama userAgent seçeneğimi hiç görmedi; bu yüzden bu hatayı verirse seçeneği get_token içinden çıkarın.
Süre, çağrıdan hemen önceden dönüşüne kadar: Python 3.14.0 üzerinde bir kez 3,77 saniye, 3.11.7 üzerinde iki kez 3,76 saniye; capskip 1.7.0, varsayılan yoklama ve Windows 11 üzerindeki gerçek CapSkip uygulaması ile. Bu üç çağrı ne userAgent ne de action gönderdi. SDK’nın yoklama takvimi bu değeri şekillendirir: mock’a karşı sonucu gönderimden 0; 0,25; 0,76; 1,76; 3,76 ve 7,76 saniye sonra istedi ve 1,9 ile 3,6 saniye arasında herhangi bir anda hazır olan bir mock token 3,76 saniyede geri geldi. Yani gerçek çözüm 1,76 ve 3,76 saniyelik yoklamalar arasında bitti ve üç çalıştırma bir kıyaslama değildir.
MTCaptcha çözümü için hiçbir tarayıcı çalışmaz, bu yüzden SDK defaultTimeout izin verdiği kadar bekler; varsayılan 120 saniyedir. defaultTimeout 6 saniyeye düşürüldüğünde hiç yanıt vermeyen bir mock, çağrıdan 7,78 saniye sonra TimeoutException fırlattı, çünkü yoklamalar arasındaki son uyku sınırı aştı.
3. Adım: formu token tazeyken gönderin
Bir tarayıcıda widget, token’ı mtcaptcha-verifiedtoken adlı gizli bir input alanına yazar. Tarayıcı olmadan o alanı kendiniz, formun kendi alanlarının yanında gönderirsiniz. Aşağıdaki fonksiyon, o da dosyanın sonuna eklenir, bunu yapar. Oturum, sayfanın çerezlerini form gönderimine taşır. Formun action değeri başka bir yere işaret ediyorsa session.post çağrısının ilk argümanını değiştirin.
Bir token bir kez çalışır ve yalnızca kısa bir süre için. MTCaptcha’nın doğrulama kılavuzu bir token’ın normalde birkaç dakika geçerli olduğunu söyler ama varsayılan sona erme süresi olarak 60 ile 120 saniye verir ve varsayılan olarak yalnızca bir kez denetlenebilir; bu yüzden bir dakika içinde gönderin. CapSkip belgeleri token’ı form gönderiminden hemen önce istemenizi ister; bu yüzden get_token sayfa yüklemesinden sonra çalışır ve form gönderimi hemen ardından gelir. Kendi bekleme süreniz varsa çözümü ondan sonra yapın. Reddedilen bir token harcanmıştır, bu yüzden 4. Adım’daki döngü yenisini ister.
Form gönderimi sayfayı Referer olarak da bildirir, çünkü requests ne Referer ne de Origin gönderir ve bazı framework’ler ikisi de olmayan bir HTTPS form gönderimini reddeder. Mock’um böyle bir framework’ün yerini tutuyor ve başlık olmadan 403 yanıtı verdi.
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,
)4. Adım: Python’da MTCaptcha için tam giriş script’i
Son bloğu mtcaptcha_login.py dosyasının sonuna ekleyin; dosya artık tamamdır. LOGIN_URL değerini ayarlayın ve python mtcaptcha_login.py komutunu çalıştırın (ya da py mtcaptcha_login.py). İki dize sitenize göre yer tutucudur: başarılı bir girişin gösterdiği metin olan "Welcome" ve sitenizin kendi captcha reddinin içerdiği bir ifade olan "captcha check failed". Üç denemeden sonra pes eder.
CapSkip belgelerine göre ERROR_CAPTCHA_UNSOLVABLE kodunun yanıtı yeni bir görev göndermektir ve script yalnızca bu kodu yeniden dener. Belgeler, aynı görevi yeniden gönderirseniz tekrarlanan iki hatayı adlandırır: bilinmeyen bir sitekey ve sayfanın alan adında izin verilmeyen bir sitekey; diğer her hata da script’i durdurur. ApiException iletisinin içinde kod düz metin olarak ya da bir JSON zarfına sarılı gelir ve which_error onu ikisinden de ayıklar.
Reddedilen bir form gönderimi, yanıt sitenizin captcha ret ifadesini içeriyorsa yeni bir token alır. Alıntılanana benzer bir ifade kullanın, asla yalın captcha kelimesini değil. Yanlış bir parolanın ardından yeniden gösterilen bir giriş sayfası hâlâ widget’ın kendi mtcaptchaConfig ve mtcaptcha-verifiedtoken değerlerini taşır; yalın kelime eşleşir ve üç token harcatır. Bunu mock’umda gördüm. Yalnızca retin içerdiği bir ifadeyle bir görev harcanır.
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])Mock’a karşı üç Python sürümü de aynı sonuçları verdi:
| Mock ayarı | Script ne yaptı |
|---|---|
| Sayfa config’i belgelerdeki gibi, bir action ile | Tek görev, in.php action değerini aldı, form gönderimi kabul edildi |
| Callback içeren ve action içermeyen tek satırlık config, demo sayfasındaki gibi | Tek görev, action alanı gönderilmedi, form gönderimi kabul edildi |
| Sayfa bir action ayarlıyor ama çağrı onu dışarıda bırakıyor | Üç görev, üç reddedilen form gönderimi, ardından RuntimeError |
| İlk iki çözüm ERROR_CAPTCHA_UNSOLVABLE ile bitiyor | İki yeniden deneme iletisi, ardından üçüncü görevin token’ı kabul edildi |
| Token gönderildiğinde 3 saniyelikti, mock ömrü 2 saniyeye ayarlı | Süresi dolmuş olduğu için reddedildi, sonra yeni bir token kabul edildi |
| Yoklamada bilinmeyen sitekey ya da alan adı hatası | Bir görevden sonra ApiException ve form gönderimi yok, JSON ya da düz metin olarak |
| Yanlış parola ve düz bir ret metni ya da Referer başlığı olmayan bir form gönderimi | Bir görevden sonra RuntimeError, yeni token yok |
| Yanlış parolanın ardından yeniden gösterilen giriş sayfası, yalın captcha kelimesine göre test edildi | Üç görev, ardından RuntimeError. İfade testiyle tek görev |
Tabloyu gerçek bir sitenin değil, mock’umun testi olarak okuyun. Tek kullanım, kısa ömür ve action eşleşmesi belgeleri izler, ama iki saniyelik ömür benim seçtiğim keyfî bir sayıdır.
Yaygın hatalar
Bu hataların çoğunun kaynağı CapSkip MTCaptcha API belgeleri, bir satırın bunu kendim gördüğümü söylediği durumlar hariç.
| Hata | Neden | Düzeltme |
|---|---|---|
| ValidationException | SDK çağrıyı göndermeden, 2. Adım’daki nedenlerden biri yüzünden reddetti | İleti sorunu adıyla söyler, bu yüzden o argümanı düzeltin |
| ERROR_RECAPTCHA_INVALID_SITEKEY | MTCaptcha sitekey’i tanımıyor | Onu mtcaptchaConfig içinden yeniden kopyalayın. Yeniden gönderim başarısız olurdu, bu yüzden script hata fırlatır |
| ERROR_RECAPTCHA_INVALID_DOMAIN | Sitekey’in gönderdiğiniz adresin alan adında kullanılmasına izin yok | Widget’ın gerçekten bulunduğu sayfanın adresini kullanın |
| ERROR_CAPTCHA_UNSOLVABLE | MTCaptcha geçilemedi | Yeni bir görev gönderin; script bunu sizin için üç kereye kadar yapar |
| ERROR_TASK_NOT_SUPPORTED | CapSkip, MTCaptcha’yı ekleyen sürümden eski | CapSkip 4.3.0 veya daha yeni bir sürümü kurun |
| ERROR_WRONG_USERAGENT | Güncel API belgeleri bunu, görev için kullanılamayan bir User-Agent için listeler. Gerçek uygulama kodumdaki userAgent seçeneğini hiç görmedi | userAgent seçeneğini get_token içinden çıkarın |
| ERROR_WRONG_USER_KEY veya ERROR_KEY_DOES_NOT_EXIST | API Key Validation açık ve anahtar yanlış. apiKey olmadan yapılan bir çağrı capskip anahtarıyla gider | CapSkip() fonksiyonuna gerçek anahtarınızı apiKey olarak verin |
| TimeoutException | defaultTimeout içinde token yok, değiştirmediyseniz 120 saniye | Görevi CapSkip’in Monitor sekmesinde izleyin, sonra script’i yeniden çalıştırın |
| NetworkException | Görev gönderilirken o host ve portta hiçbir şey yanıt vermiyor ya da yanıt bir HTTP hatasıydı. CapSkip yoklama sırasında yanıt vermeyi bırakırsa bunun yerine TimeoutException alırsınız | CapSkip’i başlatın ve host ile portun bağlantı ayarlarıyla eşleştiğini doğrulayın |
| Bir site, iyi görünen bir token’ı reddediyor | Token daha önce kullanılmıştı, çok eskiydi, sayfanın action değerini içermiyordu ya da Referer olmadan geldi | Her token’ı bir kez, hemen, sayfa Referer olarak ve sayfanın kendi action değeriyle gönderin |
FAQ
Script, CapSkip’ten farklı bir makinede çalışabilir mi?
Evet, Server modu üzerinden. CapSkip bilgisayarının bağlantı ayarlarından onu açın ve o bilgisayarın adresini CapSkip() çağrısına host olarak verin. Başka hiçbir şey değişmez. Server modu CapSkip için yönetici hakları gerektirir ve kurulum kılavuzu statik bir genel IP önerir. Server modu başladığında CapSkip portunu her adrese açar; bu yüzden ulaşmaması gereken makineler için bir Windows Firewall engelleme kuralı ekleyin. Çözücü kendi Windows donanımınızda kalır ve hiçbir şey ölçülmez.
Script invisible MTCaptcha widget’larıyla çalışır mı?
CapSkip’in MTCaptcha çözücü sayfası, invisible bir widget’ın görünür olanla aynı istekten geçtiğini ve aynı türde bir token döndürdüğünü söyler. API belgelerinin MTCaptcha bölümü invisible moddan söz etmez ve ben invisible bir widget’a karşı hiçbir şey çalıştırmadım; bu yüzden doğrulanmamış sayın. Sayfanızın yine de sitekey’i kaynağında taşıması gerekir, çünkü read_config onu orada arar.
MTCaptcha için proxy gerekir mi?
Başlamak için hayır. Belgeler test için tek bir adresin yeterli olduğunu söyler, ama tek bir adresten sürekli çözmenin hız sınırlamasını davet ettiğini belirtir. Yüksek hacim için uygulamanın MTCaptcha ayarlarında bir proxy listesi yükleyin ya da mtcaptcha() çağrısına bir proxy seçeneği verin, örneğin proxy={"type": "HTTP", "uri": "login:password@IP:PORT"}. Mock proxy’yi ve türünü aldı; gerçek bir proxy kullanmadım.
Kısa özet
Python’da MTCaptcha üç hamleye iner: sitekey’i ve action değerini sayfadan okuyun, token’ı form gönderiminden hemen önce isteyin ve bir form gönderimi reddedilince yeniden isteyin. CapSkip, kendi çalıştırdığınız bir yerel captcha çözücü olduğu için reddedilen bir token faturaya hiçbir zaman yansımaz. Python CAPTCHA çözücü sayfası diğer türler için SDK çağrılarını listeler, MTCaptcha demosu ise bir token’ı gerçek bir formda denemenizi sağlar.
