Python ile GeeTest v4: ID Bir Kez Okunur, Her Gönderim Çözülür

Python’da GeeTest v4, form gönderimi başına bir id ve bir çağrıya iner. captcha_id değerini sayfadan tek bir kez okuyun, CapSkip SDK içindeki solver.geetest_v4() ile bir geçiş isteyin ve dönen beş değeri, yani captcha_id, lot_number, pass_token, gen_time ve captcha_output değerlerini, aynı adlarla geri gönderin. CapSkip GeeTest v4 çözücü çözme işini kendi Windows bilgisayarınızda sabit lisansla yapar; bu yüzden reddedilen bir geçiş yalnızca bir çözüm daha demektir, ek ücret yoktur. Her denemeden önce bir şey almanız gerekmez; gt ve challenge çiftine ihtiyaç duyan şu akıştan farkı budur: GeeTest v3 akışı.
GeeTest v4 çözmeden önce neye ihtiyacınız var
- Windows üzerinde CapSkip 5.0.0 veya daha yenisi (changelog, GeeTest v4 çözmeyi orada 14 Kasım 2026 tarihiyle listeler) ve Python SDK 1.8.0 veya daha yenisi (16 Kasım 2026). API belgelerinin GeeTest v4 bölümü isteği anlatır.
- Python 3.10 veya daha yenisi; bu, capskip 1.8.0 ve requests 2.34.2 tarafından bildirilen alt sınırdır. Çalıştırdığım sürümler Windows 11 üzerinde Python 3.11.7, 3.13.7 ve 3.14.0 idi. İki paketi python -m pip install capskip requests ile kurun. capskip paketi ayrıca yalnızca async istemcinin kullandığı httpx ve aiofiles paketlerini de kurar.
- CapSkip için bir adres. Local modu (127.0.0.1) yalnızca onu çalıştıran bilgisayardan erişilebilir. Server modu ise bunun yerine ağınızı veya genel IP’nizi dinler, böylece başka makinelerdeki script’ler ona ulaşabilir. Kurulum kılavuzunun bağlantı ayarları bölümü, modun nereden değiştirildiğini gösterir.
Kendi yazdığım iki mock sunucuyla test ettim: biri CapSkip’in, diğeri yorum formu olan bir sitenin yerini tutuyor. Gerçek bir çözüm yapılmadı, bu yüzden size verebileceğim gerçek bir çözüm süresi yok ve mock’taki her site kuralı benimdir. Gerçek bir sitede backend, beş değeri GeeTest’e özel anahtarından üretilen bir imzayla iletir; bunu GeeTest sunucu API başvurusu anlatır. Bir mock, gerçek bir backend’in herhangi bir şeyi kabul ettiğini gösteremez.
1. Adım: captcha_id değerini sayfada bulun
İlk bloğu comment_geetest.py olarak kaydedin ve sonraki her bloğu sırayla dosyanın sonuna ekleyin. Dosya 3. Adım’dan sonra tamamlanır. PAGE_URL değerini widget’ı gösteren sayfaya ayarlayın. Server modunda host alanına CapSkip makinesinin adresini yazın.
# python -m pip install capskip requests
import re
import requests
from capskip import ApiException, CapSkip
PAGE_URL = "https://example.com/comment" # the page that shows the widget
FIELDS = ("captcha_id", "lot_number", "pass_token", "gen_time", "captcha_output")
# Local mode. In Server mode, use the address of the CapSkip machine.
solver = CapSkip(host="127.0.0.1", port=8080)captcha_id herkese açıktır ve her ziyaretçi için aynıdır; bu yüzden onu bir kez okuyup yeniden kullanırsınız. Sayfa onu initGeetest4 fonksiyonuna captchaId seçeneği olarak verir ve widget script’i de gcaptcha4.geetest.com/load adresine yaptığı isteğin captcha_id sorgu parametresi olarak gönderir. CapSkip GeeTest v4 sayfası 32 karakterlik bir id tarif eder, ama SDK hiçbir biçim denetlemez; bu yüzden desen herhangi bir sözcük karakterini veya tireyi kabul eder. Çağrıyı ayrıştırmak yerine seçeneği adıyla arar; bu yaklaşım iç içe yapılara, tek tırnaklara ve farklı bir anahtar sırasına dayanır.
def read_captcha_id(html):
"""Return the captcha_id the page gives to the GeeTest v4 script."""
for pattern in (
r"\bcaptchaId[\"']?\s*:\s*[\"']([\w-]+)[\"']", # initGeetest4({captchaId: ...})
r"[?&]captcha_id=([\w-]+)", # a gcaptcha4.geetest.com/load address
):
found = re.search(pattern, html)
if found:
return found.group(1)
raise RuntimeError("no captcha_id in the page, read it from the Network tab")
def open_session():
session = requests.Session()
page = session.get(PAGE_URL, timeout=30) # cookies arrive with the page
return session, read_captcha_id(page.text)read_captcha_id fonksiyonunu altı mock sayfada çalıştırdım: id çift tırnak içinde, diğer seçeneklerin arasında tek tırnak içinde, ilk sırada olmayan tırnaklı bir anahtarla iç içe bir nesnede, anahtarı sonda olan bir değişkende, yalnızca bir load adresinde ve hiçbir yerde (çünkü bir script çağrıyı çalışma zamanında kuruyor). Son durumda tarayıcının Network sekmesini bir kez açın, gcaptcha4 için süzün ve captcha_id değerini load isteğinden kopyalayın. Fonksiyonu gerçek bir siteye karşı çalıştırmadım.
2. Adım: geetest_v4() ile bir geçiş isteyin
Metodun imzası solver.geetest_v4(captcha_id, url, **options) biçimindedir. SDK görevi gönderir, yanıt hazır olana kadar yoklamayı sürdürür ve bir sözlük geri verir, bu yüzden bir bekleme döngüsüne gerek yoktur. url, widget’ın bulunduğu sayfanın tam adresidir. Aşağıdaki blok form için yalnızca beş alanı tutar ve risk_type değerini yalnızca siz ayarlarsanız ekler.
def pick(result):
if result.get("isOffline"):
print("offline pass: the site decides whether to accept it")
missing = [name for name in FIELDS if name not in result]
if missing:
raise RuntimeError(f"GeeTest answer did not parse, missing {missing}")
return {name: result[name] for name in FIELDS}
def get_pass(captcha_id, risk_type=None):
options = {"risk_type": risk_type} if risk_type else {}
return pick(solver.geetest_v4(captcha_id, PAGE_URL, **options))Sözlük beş değeri ayrı anahtarlar olarak tutar. Ayrıca CapSkip’in göreve verdiği numara olan captchaId değerini de tutar; bu widget id’si değildir: form, alt çizgili captcha_id ister. code anahtarı ham JSON dizesini tutar; API belgelerine göre res.php beş değeri bu biçimde paketler. SDK bunu sizin için ayrıştırır ve belgeleri izleyen mock’umda code, beş değere ayrışan bir dizeydi. code değerini değil, ayrı alanları gönderin.
GeeTest’e ulaşılamadığında widget ziyaretçiyi çevrimdışı modda geçirir ve sözlükte ayrıca True olarak ayarlanmış isOffline de bulunur. Aksi halde anahtar yoktur. pick fonksiyonu bir not yazdırır ve yine de beş alanı döndürür, çünkü çevrimdışı bir geçişi kabul edip etmeyeceğine site karar verir.
risk_type seçeneği, çağıranın bir challenge seçmesine izin veren siteler içindir. API belgelerine göre değerler şunlardır: slide, icon, nine, word, phrase, match, winlinze, svg_seed, svg_icon ve ai. GeeTest bunlardan birini yalnızca site izin veriyorsa uygular, bu yüzden aksi halde seçeneği dışarıda bırakın. SDK yalnızca bir dize olup olmadığını denetler: slide ve nine mock’a değişmeden ulaştı, riskType, risk_type olarak yeniden adlandırıldı ve risk_type=bogus gibi uydurma bir değer de gönderildi.
Hiçbir şey gönderilmeden önce SDK; eksik, boş veya dize olmayan bir captcha_id, boş olan ya da mutlak bir http veya https URL’si olmayan bir sayfa adresi, dize olmayan bir risk_type, farklı değerlere sahip riskType ve risk_type ile API’nin almadığı her seçenek için ValidationException fırlatır. Buna hCaptcha ve MTCaptcha metotlarının kabul ettiği ama bunun kabul etmediği userAgent ile v3’ün gt ve challenge adları da dahildir. Sunucusu olmayan bir porta karşı bunların her biri saniyenin yüzde birinden çok daha kısa sürede hata verdi. API belgeleri aynı hatalar için ERROR_PAGEURL ve ERROR_BAD_PARAMETERS verir; yani ham in.php çağıran biri, sizin bir istisna gördüğünüz yerde bu kodları görür.
geetest_v4() metodu CapSkip içinde gerçek bir tarayıcı çalıştırır; bu yüzden SDK ona defaultTimeout değerini değil, varsayılan olarak 300 saniye olan recaptchaTimeout değerini verir. İkisini de denetledim. defaultTimeout 3 saniyeyken ve hiç yanıt vermeyen bir mock’a karşı, çağrı 9 saniye sonra hâlâ yokluyordu. recaptchaTimeout 3 iken TimeoutException 3,76 saniye sonra fırlatıldı, çünkü SDK 0; 0,25; 0,76 ve 1,76. saniyelerde sordu, 2 saniye daha uyudu ve süre sınırına ancak ondan sonra baktı. Aynı program başarıyı da geciktirir: 1 saniye sonra hazır olan bir geçiş 1,76 saniyede, 2 saniye sonra hazır olan 3,76 saniyede ve 6 saniye sonra hazır olan 7,76 saniyede geldi. Bunlar mock’a karşı Python 3.14.0, capskip 1.8.0 ve varsayılan yoklama ile alınan değerlerdir. CapSkip GeeTest v4 sayfası tek tıklamalı bir geçiş için 1 ila 4 saniye, bir kaydırma için yaklaşık 15 ila 20 saniye verir; bu yüzden recaptchaTimeout değerini sitenizin sunabileceği en yavaş türe göre belirleyin.
3. Adım: beş değeri gönderin, sonraki gönderim için yeniden çözün
Beş değeri yukarıdaki adlarla kendi alanlarınızın yanında gönderin ve sayfanın kendi gönderiminin Network sekmesinde gönderdikleriyle karşılaştırın. Fonksiyon ayrıca sayfayı Referer olarak gönderir. requests kütüphanesi ne Referer ne de Origin ekler ve bazı framework’ler ikisi de olmayan bir HTTPS form gönderimini geri çevirir; mock’um da 403 ile bunu yaptı.
POST_URL = PAGE_URL # the form's action address, if it differs from the page
def post_comment(session, fields, author, text):
return session.post(
POST_URL,
data={"author": author, "comment": text, **fields}, # your form's own fields
headers={"Referer": PAGE_URL}, # requests sends none by itself
timeout=30,
)Her form gönderimi için yeniden çözün. API belgeleri böyle der ve mock’um buna uyar: aynı beş değerin ikinci gönderimini zaten kullanılmış diye reddetti, ayrıca ömrü 2 saniyeye ayarlıyken çözümden 3 saniye sonra gönderilen bir geçişi de reddetti. Bu yüzden döngü, yorumlar üzerindeki döngünün içinde bir geçiş ister; captcha_id ise open_session fonksiyonundan bir kez gelir. Yeni bir çözümü yalnızca ERROR_CAPTCHA_UNSOLVABLE geldiğinde veya site captcha denetiminin başarısız olduğunu söylediğinde ister. Başka her ApiException fırlatılır, çünkü yanlış bir anahtar aynı şekilde yine başarısız olur.
Ret testi, sitenizden alınan tam bir ifadedir, burada captcha check failed. Yalnızca captcha sözcüğüne dayalı bir test, boş bir yorumdan sonra yeniden gösterilen ve hâlâ widget işaretlemesini taşıyan yorum sayfasıyla eşleşti ve captcha ile ilgisi olmayan bir hataya üç görev harcadı. Daha kısa check failed ifadesi Referer denetiminden gelen 403 sayfasıyla eşleşti.
def submit_all(session, captcha_id, comments, passes=None):
saved = 0
for index, (author, text) in enumerate(comments):
for attempt in range(1, 4):
ready = passes[index] if passes and attempt == 1 else None
try:
fields = ready or get_pass(captcha_id) # a new solve per form post
except ApiException as err:
if "ERROR_CAPTCHA_UNSOLVABLE" not in str(err):
raise # a wrong key or a bad request fails again
print(f"comment {index + 1}, attempt {attempt}: unsolvable, new task")
continue
reply = post_comment(session, fields, author, text)
if "Comment saved" in reply.text: # your site's success sign
saved += 1
break
if "captcha check failed" not in reply.text.lower(): # your phrase
raise RuntimeError(f"refused ({reply.status_code}), not the captcha")
print(f"comment {index + 1}, attempt {attempt}: pass refused, new solve")
else:
raise RuntimeError(f"comment {index + 1}: no luck after 3 attempts")
return saved
if __name__ == "__main__":
session, captcha_id = open_session()
comments = [("alice", "First"), ("alice", "Second"), ("alice", "Third")]
print(submit_all(session, captcha_id, comments), "comments saved")Onu python comment_geetest.py ile çalıştırın (py comment_geetest.py de çalışır). Mock’a karşı script, Python 3.11.7, 3.13.7 ve 3.14.0 üzerinde aynı davrandı:
| Mock ayarı | Ne oldu |
|---|---|
| Üç yorum, varsayılanlar | Aynı captcha_id ile üç görev, üç gönderim kabul edildi |
| Elle yazılmış bir gönderimle: aynı beş değer iki kez gönderildi | İkinci gönderim zaten kullanılmış diye reddedildi |
| Elle yazılmış bir gönderimle: geçiş çözümden 3 saniye sonra gönderildi, mock ömrü 2 saniye | Çok eski diye reddedildi ve sonraki yeni çözüm geçti |
| Başta iki çözülemeyen yanıt | İki yeniden deneme ve üçüncü görevden gelen geçiş kabul edildi |
| Üst üste üç çözülemeyen yanıt | Üç görev kullanıldıktan sonra RuntimeError |
| Çevrimdışı geçiş, site kabul ediyor | Not yazdırıldı, gönderim bir görevden sonra kabul edildi |
| Çevrimdışı geçiş, site reddediyor | Üç görev, ardından RuntimeError |
| Boş yorum, sayfa widget işaretlemesiyle yeniden gösteriliyor | Bir görevden sonra RuntimeError. Test olarak yalnızca captcha sözcüğü kullanılırsa, üç görev |
| Referer başlığı olmayan form gönderimi | 403, bir görevden sonra RuntimeError |
| Anahtar doğrulaması açık, SDK varsayılan anahtarı | Bir görevden sonra ApiException. Doğru apiKey ile kabul edildi |
Tabloyu GeeTest’in değil, mock’umun ve script’imin bir testi olarak okuyun. Belgeler, hızlı göndermenizi ve her form gönderimi için yeniden çözmenizi söyler. Tek kullanım ve iki saniyelik ömür mock’umun kurallarıdır.
AsyncCapSkip ile aynı anda birkaç gönderim
Async istemci yerini tek bir nedenle hak eder: bir geçiş saniyeler sürer ve üçü birlikte istenebilir. AsyncCapSkip httpx üzerine kuruludur, bu yüzden asyncio.gather çözümleri üst üste bindirirken form gönderimleri düz requests ile kalır. Mock geçiş başına 3,0 saniye alırken, üç gönderim art arda çözümle 11,35 saniye, üst üste bindirilince 4,09 saniye sürdü; bu ölçüm Python 3.14.0 üzerinde ve mock’ta aynı anda üç görev açıkken alındı.
Her iki bloktaki 8080 portu 2captcha tarzı hizmetin varsayılanıdır, bu yüzden CapSkip ayarlarında gösterilen portu kullanın. Daha büyük bir havuz deseni için şu yazıya bakın: Python ile paralel captcha çözme. 3. Adım’daki ana bloğu aşağıdakiyle değiştirin. Başarısız bir çözüm solve_all içinde None olur ve submit_all tek bir çağrıyla yeniden ister; bu yüzden yanlış bir anahtar yine aynı ApiException ile biter. Yalnızca taze iken gönderebileceğiniz kadar geçiş isteyin ve uzun bir listeyi parçalara bölün.
import asyncio
from capskip import AsyncCapSkip
async def solve_all(captcha_id, count):
# Local mode. In Server mode, use the address of the CapSkip machine.
async_solver = AsyncCapSkip(host="127.0.0.1", port=8080)
jobs = [async_solver.geetest_v4(captcha_id, PAGE_URL) for _ in range(count)]
results = await asyncio.gather(*jobs, return_exceptions=True)
return [pick(r) if isinstance(r, dict) else None for r in results]
def submit_overlapped(comments):
session, captcha_id = open_session()
passes = asyncio.run(solve_all(captcha_id, len(comments)))
return submit_all(session, captcha_id, comments, passes)
if __name__ == "__main__":
comments = [("alice", "First"), ("alice", "Second"), ("alice", "Third")]
print(submit_overlapped(comments), "comments saved")Yaygın hatalar
CapSkip kodları API belgelerinden, istisna satırları SDK kaynağından gelir; son satır ise belgelerdeki her form gönderimi için yeniden çözme satırını nasıl okuduğumdur.
| Hata | Neden | Düzeltme |
|---|---|---|
| ValidationException | SDK, 2. Adım’daki nedenlerden biriyle, CapSkip’e ulaşmadan argümanları makinenizde reddetti | İstisna metni sorunlu argümanı gösterir |
| ERROR_CAPTCHA_UNSOLVABLE | Bu görev için geçiş elde edilemedi | Yeni bir görev gönderin; submit_all en fazla üç denemeye kadar bunu yapar. Belgeler, uygulamanın Settings içinde ayarlanan bir yedek metin döndürebileceğini söyler, bu yüzden o metni değiştirdiyseniz onunla eşleştirin |
| ERROR_KEY_DOES_NOT_EXIST veya ERROR_WRONG_USER_KEY | Uygulama anahtarları denetler (API Key Validation) ve sizinki eksik ya da yanlış. apiKey olmadan yapılan çağrılar, mock’un ilk kodla yanıtladığı capskip anahtarını kullanır | Gerçek anahtarınızı CapSkip() için apiKey olarak verin |
| ERROR_PROXY_FORMAT | Belgeler bunu CapSkip’in okuyamadığı bir proxy değeri için listeler ve şema öneki istemez. SDK önekli bir değeri değişmeden gönderdi | login:password@IP:PORT biçiminde, http:// olmadan yazın |
| NetworkException | Görev gönderilirken o host ve porttan yanıt yok; bunu Windows’ta yaklaşık 2 saniye sonra gördüm. Yoklama ortasında sessizleşen bir sunucu bunun yerine TimeoutException verir | CapSkip’in açık olduğundan ve host ile portun bağlantı ayarlarıyla eşleştiğinden emin olun |
| TimeoutException | recaptchaTimeout içinde geçiş gelmedi; başka bir değer vermediyseniz 300 saniye | Görevi CapSkip uygulamasında inceleyin ve script’i yeniden çalıştırın |
| Site captcha denetiminin başarısız olduğunu söylüyor | Belgelenmiş bir liste değil, benim çıkarımım: beş değer daha önce kullanıldı, çok eskiydi ya da değiştirildi | Her seti bir kez, hemen ve değiştirmeden gönderin; sayfayı Referer olarak verin |
FAQ
CapSkip’i farklı bir bilgisayardan çağırabilir miyim?
Evet, Server modu ile. CapSkip bilgisayarında bağlantı ayarlarından açın, sonra o bilgisayarın adresini CapSkip() için host olarak verin; API Key Validation açıksa anahtarınızı da apiKey olarak ekleyin. Server modu başlarken CapSkip portunu her adrese açar; bu yüzden başkalarını dışarıda tutan şey, güvenmediğiniz makineler için bir Windows Güvenlik Duvarı engelleme kuralıdır. Bir izin kuralı daha eklemek hiçbir şeyi değiştirmez. Yine kendi Windows makinenizdir ve kullanım yine ölçülmez.
GeeTest v4 için proxy gerekir mi?
Başlamak için hayır. API belgeleri test için tek bir adresi sorun görmez ve tek bir adresten gelen sürekli bir akışın GeeTest hız sınırlamasının hedefi olduğunu söyler. Hacim için uygulamaya bir proxy havuzu yükleyin ya da bir göreve havuzdan üstün gelen kendi proxy’sini verin. Seçimi captcha çözücü için proxy yazısı ele alır. Python’da seçenek ya şu biçimde bir sözlüktür, proxy={"type": "HTTP", "uri": "login:password@IP:PORT"}, ya da yanında proxytype bulunan düz bir dizedir. İki biçim de mock’a proxy ve proxytype alanları olarak ulaştı.
Sayfa bana bunun yerine bir gt ve bir challenge verirse ne olur?
O zaman site GeeTest v3 çalıştırıyordur; v3 her deneme için yeni bir challenge ister ve challenge, validate ve seccode döndürür. Bu akış şu yazıda anlatılır: Python ile GeeTest v3.
Kısa özet
Python’da GeeTest v4, bir kez okunan bir captcha_id, her form gönderimi için bir çözüm ve değiştirilmeden geri gönderilen beş alandır. CapSkip, kendi bilgisayarınızda çalışan bir sınırsız captcha çözücü olduğu için tekrarlanan bir çözüm faturaya hiçbir şey eklemez. Python CAPTCHA çözücü sayfası diğer türler için SDK çağrılarını listeler.
