Explainers

GeeTest v4 CAPTCHA Değişiklikleri ve Çözüm Kılavuzu

Bir sayfada GeeTest v4 ile karşılaştınız ve mevcut otomasyon akışınızın kırılacağından mı endişeleniyorsunuz? Önce net konuşalım: CaptchaAI GeeTest v3'ü yüksek başarı oranıyla çözer. GeeTest v4'ü çözmez. Bu yazıda v4'ün v3'ten mimari olarak nerede ayrıldığını, bir sitenin hangi sürümü çalıştırdığını nasıl tespit edeceğinizi ve CaptchaAI'nin bu tabloda nerede durduğunu adım adım göreceksiniz.

GeeTest, Türkiye'deki e-ticaret ve fintech ekosisteminde giriş ve ödeme akışlarını koruyan yaygın bir doğrulama katmanıdır. Bu yüzden QA ve veri kazıma ekipleri için "site hangi GeeTest sürümünü kullanıyor?" sorusu pratik bir öneme sahiptir — çünkü çözüm yaklaşımı sürüme göre tamamen değişir.


GeeTest v3 ile v4 arasındaki temel farklar

Özellik GeeTest v3 GeeTest v4
Başlatma Sunucudan gelen gt + challenge Yalnızca captcha_id
Doğrulama parametresi API çağrısıyla alınır İstemci tarafında üretilir
Doğrulama türleri Kaydırma, tıklama Kaydırma, tıklama, simge seçme, uzamsal akıl yürütme
Doğrulama Sunucu challenge değerini döndürür lot_number + pass_token kullanır
API uç noktası api.geetest.com gcaptcha4.geetest.com
Zorluk ölçekleme Sabit Riske göre uyarlanır

Özetle v4'ün getirdiği üç temel değişiklik:

  • Başlatma tek bir captcha_id ile yapılır; gt + challenge ikilisi kalkar.
  • Doğrulama verisi artık istemci tarafında üretilir, sunucudan hazır gelmez.
  • Zorluk sabit değildir; oturumun risk skoruna göre uyarlanır.

GeeTest v4'ün eklediği yeni doğrulama türleri

v4, v3'teki iki türün üzerine iki yeni tür daha ekler; hepsi aynı captcha_id akışından geçer:

  • Kaydırmalı bulmaca: klasik "parçayı yerine sürükle" doğrulaması. v3'ten tanıdık ve en yaygın türdür.
  • Tıklayarak seçim: kullanıcı belirli nesneleri tıklar (ör. "tüm yüzleri seçin"). Simge tanımaya dayanır.
  • Uzamsal akıl yürütme: v4 ile gelen yeni tür — şekiller uzamsal bir düzende yerleştirilir, v3'e göre belirgin biçimde daha karmaşıktır.
  • Simge eşleştirme: belirli bir sırayla gösterilen simgelerin eşleştirilmesi. Elle otomatikleştirmesi en zor türlerden biridir.

Hangi tür çıkarsa çıksın sayfa GeeTest v4 çalıştırıyordur ve CaptchaAI onu çözemez. CaptchaAI GeeTest v3'ü çözer.


Bir sayfanın GeeTest v4 kullanıp kullanmadığını tespit etme

GeeTest v4'ü v3'ten ayırmak sürüm tespitiyle başlar. Sayfa kaynağındaki şu sinyallere bakın:

  • gcaptcha4.geetest.com isteği veya gt4.js betiği görüyorsanız → site v4 çalıştırıyordur.
  • Klasik api.geetest.com uç noktasını ve bir challenge parametresini görüyorsanız → elinizdeki v3'tür.

Betikler çoğunlukla JavaScript ile geç yüklendiğinden, tespiti ham HTML üzerinde değil işlenmiş sayfa üzerinde yapmak gerekir. Aşağıdaki Selenium örneği captcha_id değerini ayıklar ve sürümü doğrular.

# extract_geetest_v4.py
import re
from selenium import webdriver


def extract_geetest_v4_params(url):
    """Extract GeeTest v4 captcha_id from a page."""
    driver = webdriver.Chrome()
    driver.get(url)

    page_source = driver.page_source

    # GeeTest v4 uses captcha_id instead of gt
    match = re.search(r'captcha_id["\']?\s*[:=]\s*["\']([a-f0-9]+)', page_source)
    captcha_id = match.group(1) if match else None

    # Check for v4-specific script
    is_v4 = "gcaptcha4" in page_source or "gt4.js" in page_source

    driver.quit()

    return {
        "captcha_id": captcha_id,
        "is_v4": is_v4,
        "pageurl": url,
    }


# Usage
params = extract_geetest_v4_params("https://staging.example.com/qa-login")
print(f"Captcha ID: {params['captcha_id']}")
print(f"Is v4: {params['is_v4']}")

Örnekte bilinçli olarak bir staging QA adresi kullanıldı; bu tespit betiklerini yalnızca yetkiniz olan ortamlarda çalıştırın. Kişisel veri içeren akışlarda çalışıyorsanız, bu adımların KVKK kapsamındaki yetkili QA ve veri toplama süreçlerine dahil olduğundan emin olun.


CaptchaAI nerede devreye girer?

CaptchaAI GeeTest v3'ü çözer. GeeTest v4'ü çözmez. geetest metodu v3 değerlerini (gt, yeni bir challenge ve pageurl) alır; challenge, validate ve seccode döndürür. v4 için parametresi yoktur, bu yüzden bir v4 captcha_id değerini gt olarak göndermeyin. Önce yukarıdaki kontrolü çalıştırın: sayfa gcaptcha4.geetest.com veya gt4.js yüklüyorsa v4 çalıştırıyordur ve CaptchaAI onu çözemez. Sayfa hâlâ v3 çalıştırıyorsa tam akışı API Kullanarak GeeTest v3 Nasıl Çözülür? rehberinde bulabilirsiniz.

CaptchaAI'nin thread tabanlı planları, GeeTest v3 dahil desteklenen tüm türleri kapsar; günlük kota, çözüm başına ücret veya CAPTCHA türüne göre ek ücret yoktur. BASIC ($15/ay, 5 thread) ile başlayıp hacminiz büyüdükçe üst planlara geçebilirsiniz. USD bazlı sabit aylık fiyatlandırma, TL dalgalanmasına karşı öngörülebilir bir maliyet planlaması sağladığı için Türkiye'deki ekipler açısından pratik bir avantajdır.


v4 doğrulaması nasıl farklılaşır?

Bir v3 sayfasında başarılı bir doğrulama üç değer verir: geetest_challenge, geetest_validate ve geetest_seccode. Sitenin backend'i bunları GeeTest ile kontrol eder. Bir v4 sayfasında ise captchaObj.getValidate() bunların yerine dört değer döndürür: lot_number, captcha_output, pass_token ve gen_time. Sitenin backend'i bu değerleri, kendi captcha_id değeri ve özel anahtarıyla imzaladığı bir sign_token ile birlikte GeeTest'in gcaptcha4.geetest.com üzerindeki v4 /validate uç noktasına gönderir (GeeTest'in v4 web API ve sunucu API belgeleri). Üç v3 alanını okuyan veya dolduran kod, bir v4 sayfasında üzerinde çalışacağı hiçbir şey bulamaz.


Sorun giderme

Sorun Sebep Çözüm
Önceden çalışan bir sayfada gt / challenge araması hiçbir şey bulmuyor Site, sunucunun verdiği bir challenge değeri olmayan GeeTest v4'e geçmiş Sayfada gcaptcha4.geetest.com veya gt4.js olup olmadığını kontrol edin; CaptchaAI yalnızca GeeTest v3'ü çözer
CaptchaAI'den ERROR_WRONG_CAPTCHA_ID Geçersiz gt veya challenge; örneğin gt olarak gönderilen bir v4 captcha_id değeri Her istekte sayfanın v3 gt değerini ve yeni bir challenge gönderin
captcha_id bulunamıyor Değer JavaScript ile geç oluşturuluyor İşlenen sayfadan ayıklamak için Selenium kullanın

Sık sorulan sorular

CaptchaAI GeeTest v4'ü çözüyor mu?

Hayır. CaptchaAI GeeTest v3'ü çözer. GeeTest v4'ü çözmez. Bir sayfanın hangi sürümü çalıştırdığını yukarıdaki kontrolle doğrulayın.

GeeTest v4 için başarı oranı nedir?

Verilebilecek bir v4 oranı yok. CaptchaAI GeeTest v3'ü yüksek başarı oranıyla çözer. GeeTest v4'ü çözmez.

CaptchaAI GeeTest v3'ü ne kadar hızlı çözüyor?

GeeTest v3 için yayımlanmış bir hız rakamı yok. CaptchaAI GeeTest v3'ü yüksek başarı oranıyla çözer; gerçek süre hacme, ağ koşullarına ve thread tahsisinize göre değişebilir.

Site v4'e geçerse v3 entegrasyonum çalışmaya devam eder mi?

Hayır. v4'te sunucunun verdiği bir challenge yoktur ve başarılı bir doğrulama üç değer yerine dört değer döndürür; bu yüzden bir v3 entegrasyonu olduğu gibi bir v4 sayfasına yöneltilemez. CaptchaAI GeeTest v3'ü çözer, GeeTest v4'ü çözmez.


İlgili kılavuzlar


GeeTest v3'ü çözün — CaptchaAI ile başlayın. CaptchaAI GeeTest v4'ü çözmez.

Bu makale için yorumlar devre dışı bırakılmıştır.