Çözüm başına ödeme · API
1. Gizli komut dosyası
Site anahtarıyla yüklenen bir komut dosyası, onu kullanan her sayfada arka planda çalışır. Ziyaretçi herhangi bir onay kutusu görmez ve hiçbir işlem yapmaz.
Site anahtarıyla yüklenen bir komut dosyası, onu kullanan her sayfada arka planda çalışır. Ziyaretçi herhangi bir onay kutusu görmez ve hiçbir işlem yapmaz.
Toplanan davranış verilerine göre Google, ziyaretçiye insanın olma olasılığını gösteren bir skor verir. Eşiği site sahibi belirler.
Site skoru kendi eşiğiyle karşılaştırır. Altındaysa ek doğrulama isteyebilir veya isteği engelleyebilir.
grecaptcha.execute çağırır.success değerinin true olduğunu, skorun eşiği karşıladığını ve action’ın eşleştiğini kontrol eder. Düşük skorlu geçerli bir token yine de reddedilebilir.reCAPTCHA v3 skorları 0.0 (muhtemel bot) ile 1.0 (muhtemel insan) arasındadır. Google 0.5 eşiğini önerir. Uygulamadan veya ayarlamadan önce gerçek trafiği gözlemleyin.
Google 11 skor düzeyi destekler. Ücretsiz Essentials 0.1, 0.3, 0.7 ve 0.9 döndürür; faturalama tüm düzeyleri ve reason code’ları açar. Staging ve ilk hafta skorları üretimden farklı olabilir.
CapMonster Cloud minScore parametresi (0.1–0.9) tokenun minimum skorunu belirler. Sitenin eşiğine uyun; 0.9 gibi yüksek değerler başarısız denemeleri artırır.
pageAction, grecaptcha.execute içindeki action ile eşleşmelidir. Yalnızca harf, rakam, eğik çizgi ve alt çizgi kullanın. Siteler uyumsuzlukları reddedebilir. Hem minScore hem pageAction gönderin.
Skor testi bir backend gerektirir: skor siteverify yanıtında gelir.
1. Test sayfasında site key’inizi kullanın ve bir action ile grecaptcha.execute çağırın.
2. Token ve gizli anahtarı backend’inizden https://www.google.com/recaptcha/api/siteverify adresine gönderin.
3. Dönen score değerini eşiğinizle karşılaştırın ve action değerini doğrulayın.
Kendi test sayfanızı oluşturmadan reCAPTCHA v3 demo sayfamızı deneyin.
Tablo, dört reCAPTCHA v3 çözüm servisi için fiyat, API yanıt süresi ve başarı oranını listeler.
| Parametre | CapMonster Cloud | 2Captcha | CapSolver | DeathByCaptcha |
|---|---|---|---|---|
1000 çözüm fiyatı (başlangıç) | $ 0.90 | $1.45 | $1.00 | $2.89 |
API yanıt süresi | ≤ 2 s | ≤ 2 s | < 3 s | ≤ 3 s |
Çözüm başarı oranı | %99’a kadar | ~77–92% | ~95–98% | ~64–90% |
Uyarı: 2Captcha, CapSolver ve DeathByCaptcha ilgili sahiplerinin ticari markalarıdır. CapMonster Cloud bu kuruluşlarla ilişkili değildir. Performans metrikleri ve fiyat karşılaştırmaları, 28.09.2026 tarihli kamuya açık verilere ve dahili kıyaslamalara dayanır.
$0.10
Yeni kullanıcılar CapMonster Cloud’u denemek için $0.10 test bakiyesi alır.
1. CapMonster Cloud’a kaydolun.
2. Hesabınıza bağlı e-posta ile canlı sohbet veya support@capmonster.cloud üzerinden destekle iletişime geçin.
CapMonster Cloud captcha parametrelerini alır, kendi sunucularında işler ve kullanıma hazır bir token döndürür. Kullanıcı etkileşimi olmadan kontrolü geçmek için bu tokenı forma ekleyin. RecaptchaV3TaskProxyless görevi CapMonster Cloud’un kendi proxy sunucularında çalışır, bu yüzden proxy parametreleri göndermezsiniz.
Bu adımda API anahtarınızı, captcha türünü ve parametrelerini gönderirsiniz. Servis, daha sonra sonucu alabilmeniz için size benzersiz bir taskId döndürür.
reCAPTCHA v3’ü çözme isteğinizde aşağıdaki parametreleri belirtmeniz gerekir:
| Parametre | Açıklama |
|---|---|
typestringZorunlu | RecaptchaV3TaskProxyless |
websiteURLstringZorunlu | captchanın çözüldüğü sayfanın adresi |
websiteKeystringZorunlu | sitenizdeki captchanın bulunduğu sayfada belirtilen anahtar tanımlayıcı (sitekey) https://www.google.com/recaptcha/api.js?render=SITE_KEY6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob |
isEnterprisebooleanİsteğe bağlı | reCAPTCHA v3 Enterprise için RecaptchaV3TaskProxyless içinde isEnterprise: true ayarlayın (true/false veya 1/0). CapMonster Cloud bunu RecaptchaV3EnterpriseTask gibi işler. |
minScoredoubleİsteğe bağlı | 0.1 ile 0.9 arasında bir değer alabilir |
pageActionstringİsteğe bağlı | Google’daki ReCaptcha bileşeni tarafından iletilen action parametresinin değeri. Varsayılan değer: verify grecaptcha.execute('site_key', {action: 'login_test'}) |
https://api.capmonster.cloud/createTask{
"clientKey": "API_KEY",
"task": {
"type": "RecaptchaV3TaskProxyless",
"websiteURL": "https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta",
"websiteKey": "6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob",
"minScore": 0.3,
"pageAction": "myverify"
}
}
{
"errorId":0,
"taskId":407533072
}
https://api.capmonster.cloud/getTaskResult{
"clientKey":"API_KEY",
"taskId": 407533072
}
{
"errorId": 0,
"status": "ready",
"solution": {
"gRecaptchaResponse": "3AHJ_VuvYIBNBW5yyv0zRYJ75VkOKv…hKj9_xGBJKnQimF72rfoq3Iy-DyGHMwLAo6a3"
}
}
{
"errorId": 0,
"status": "ready",
"solution": {
"userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/155.0.0.0 Safari/537.36",
"gRecaptchaResponse": "0cAFcWeA5Y3...hF8UWA",
"cookies": {
"nocookies": "true"
}
}
}userAgent da içerir. Token gönderirken veya hedef sayfada çözümü doğrularken, tarayıcınızın ya da betiğinizin kullandığından farklı olsa bile bu UserAgent değerini kullanın.userAgent da içerir. Token gönderirken veya hedef sayfada çözümü doğrularken, tarayıcınızın ya da betiğinizin kullandığından farklı olsa bile bu UserAgent değerini kullanın.Bir reCAPTCHA v3 görevi için site anahtarı (websiteKey) ve action adı (pageAction) gerekir.
1. Sayfaya sağ tıklayıp Inspect’i seçin.
2. Elements veya Network’te api.js?render=SITE_KEY arayın. render= sonrası değer websiteKey’dir. reCAPTCHA Enterprise enterprise.js?render=SITE_KEY kullanır.
3. grecaptcha.execute('SITE_KEY', {action: 'ACTION'}) bulun. ACTION, pageAction’dır. Enterprise grecaptcha.enterprise.execute kullanır. Atlanırsa görev varsayılan olarak verify kullanır.
4. Her iki değeri toplamak için Playwright gibi bir headless tarayıcıda grecaptcha.execute’i yakalayın. JavaScript, Python ve C# örnekleri CapMonster Cloud belgelerinde.
import asyncio
from capmonstercloudclient import CapMonsterClient, ClientOptions
from capmonstercloudclient.requests import RecaptchaV3ProxylessRequest
client_options = ClientOptions(api_key="YOUR_API_KEY") # CapMonster Cloud API anahtarınızı girin
cap_monster_client = CapMonsterClient(options=client_options)
# Gerekirse önce bakiyeyi kontrol edebilirsiniz
balance = asyncio.run(cap_monster_client.get_balance())
print("Balance:", balance)
recaptcha_v3_request = RecaptchaV3ProxylessRequest(
websiteUrl="https://lessons.zennolab.com/captchas/recaptcha/v3.php?level=beta", # Captcha içeren sayfanızın URL’si
websiteKey="6Le0xVgUAAAAAIt20XEB4rVhYOODgTl00d8juDob", # Doğru değeri girin
minScore=0.7, # Minimum güven puanı eşiği
pageAction="myverify" # Sayfadaki işlem (action)
)
async def solve_captcha():
return await cap_monster_client.solve_captcha(recaptcha_v3_request)
responses = asyncio.run(solve_captcha())
print(responses)Playwright, Puppeteer veya Selenium ile CI/CD’de kayıt, ödeme ve form akışlarını size ait veya test etmeye yetkili olduğunuz sayfalarda çalıştırın.
Korumalı formların ve uç noktaların sürümler ve eşik değişikliklerinden sonra çalışmaya devam ettiğini kontrol edin.
Skor tabanlı kontroller kullanan açık sayfalardan herkese açık verileri toplayın.
Görünmez bot kontrollerine dayanan sitelerde otomatik yardımcı iş akışlarını destekleyin.
Bir iş akışı captcha’ya geldiğinde ajan MCP üzerinden token isteyebilir.
CapMonster Cloud’u herkese açık veriler ve size ait veya test etmeye yetkili olduğunuz siteler için kullanın. İzin olmadan giriş veya paywall arkasındaki üçüncü taraf verileri toplamak yasaktır.
reCAPTCHA Enterprise skor tabanlı kontroller kullanır: Essentials dört düzey döndürür.
Premium ve Enterprise 11 düzey döndürür, sırasıyla temel ve gelişmiş explainability nedenleriyle.
reCAPTCHA v3 Enterprise için RecaptchaV3TaskProxyless içinde isEnterprise: true ayarlayın (true/false veya 1/0). CapMonster Cloud bunu RecaptchaV3EnterpriseTask gibi işler.
POST https://www.google.com/recaptcha/api/siteverify secret=YOUR_SECRET_KEY response=TOKEN
Kendi sitenizde secret ve response değerlerini https://www.google.com/recaptcha/api/siteverify adresine gönderin. Tokenlar 2 dakikada sona erer ve bir kez çalışır. success, score ve action alanlarını kontrol edin; Google 0.5 eşiğini önerir.
Node.js ve Python örnekleri, hata işleme ve skora dayalı eylemler için Captcha API (Google reCAPTCHA v3) rehberine bakın.
Python SDK
secretSecret keymissing-input-secretsecret parametresi eksik
secretSecret keyinvalid-input-secretsecret parametresi geçersiz veya hatalı biçimlendirilmiş
responseTokenmissing-input-responseToken eksik
responseTokeninvalid-input-responseToken geçersiz veya hatalı biçimlendirilmiş
requestRequestbad-requestİstek geçersiz veya hatalı biçimlendirilmiş
responseToken ömrütimeout-or-duplicateToken çok eski veya daha önce kullanılmış
reCAPTCHA v2reCAPTCHA v3· geçerlireCAPTCHA v2 EnterprisereCAPTCHA v3 Enterprise
GeeTest
Cloudflare TurnstileCloudflare Bot Challenge
DataDome
Tencent CAPTCHA
Amazon Waf
Faucet Pay
Imperva (Incapsula)
Prosopo
Text CAPTCHA
BinanceComplexImageTask Recaptcha
ComplexImageTask RecognitionreCAPTCHA Enterprise (Spotify, Yahoo)
Yidun
MTCaptcha
Altcha
Funcaptcha
TSPD
Hunt
Alibaba
Friendly
reCAPTCHA v3 dokümantasyonu (EN) →reCAPTCHA v3 Enterprise dokümantasyonu (EN) →Python’da Selenium & CapMonster Cloud ile ReCaptcha v3 nasıl çözülür (EN) →JavaScript’te Selenium & CapMonster Cloud ile ReCaptcha v3 nasıl çözülür (EN) →C# ile Selenium & CapMonster Cloud kullanarak ReCaptcha v3 nasıl çözülür (EN) →Captcha API (Google reCAPTCHA v3): geliştiriciler için belgeler ve entegrasyon kılavuzu (EN) →minScore parametresi 0.1 ile 0.9 arasında değerler kabul eder ve CapMonster Cloud'a döndürülen tokenın taşıması gereken minimum güven puanını bildirir. 0.3 makul bir başlangıç noktasıdır. Çok yüksek bir değer (ör. 0.9) çözüm hataları olasılığını artırır; çok düşük bir değer sunucu tarafı eşiğinizin zaten reddetmesi gereken puanlı tokenlar döndürebilir. Değeri test ortamındaki gerçek red oranlarına göre ayarlayın.
Sayfayı açın ve geliştirici araçlarında api.js?render=SITE_KEY ifadesini arayın. render= sonrasındaki değer sitekey değeridir. action, grecaptcha.execute(siteKey, {action: "..."}) çağrısında bulunur. Bu çağrıyı Playwright ile otomatik yakalayabilirsiniz. Bazı değerler her yüklemede değişir; bunları aldıktan hemen sonra görevi oluşturun. Tüm adımları inceleyin.
1.0 büyük olasılıkla meşru bir etkileşimi, 0.0 ise büyük olasılıkla bir botu gösterir. Google varsayılan eşik olarak 0.5 önerir. Uygun puan sitenin eşiğine bağlıdır. minScore değerini buna göre ayarlayın ve gerçek trafiğe göre düzenleyin. Puanı kontrol etme adımları.
reCAPTCHA v3'ten alınan bir token yaklaşık 2 dakika geçerlidir. Otomasyon hattınız tokenı bu süre içinde sunucuya göndermelidir; süre dolduktan sonra Google'ın siteverify uç noktası success: false döndürür. Çözüm adımını form gönderimine mümkün olduğunca yakın tutun ve istekler arasında tokenları önbelleğe almayın.
Her token yalnızca bir kez doğrulanabilir. Süresi dolmuş veya kullanılmış token için timeout-or-duplicate döner. Her gönderim için yeni token isteyin.
reCAPTCHA v3 tokenı enjekte etmek için gizli yanıt alanını bulun (genellikle g-recaptcha-response ID'li textarea veya input) ve CAPTCHA çözüm hizmetinden aldığınız tokenı ekleyin. Üç otomasyon çerçevesinde nasıl yapılacağı aşağıdadır.
Playwright / Puppeteer (Node.js)
const token = "YOUR_TOKEN";
await page.evaluate((t) => {
document.getElementById('g-recaptcha-response').value = t;
}, token);
await page.click('#submit-btn');Selenium (Python)
token = "YOUR_TOKEN"
driver.execute_script(f"document.getElementById('g-recaptcha-response').value = '{token}';")
driver.find_element("id", "submit-btn").click()Bazı siteler tokenı doğrulamak için callback fonksiyonları kullanır. Form gönderilmezse konsoldan (___grecaptcha_cfg.clients) fonksiyon adını bulun ve manuel olarak çağırın:
await page.evaluate((t) => {
window.onSuccessCallback(t);
}, token);Google'dan gelen success: true yanıtı yalnızca tokenın geçerli olduğu anlamına gelir. Token puanı yapılandırılmış eşiğinizin altındaysa backend isteği yine de reddedebilir.
Başka bir yaygın sorun action uyuşmazlığıdır. Token, görev oluşturulurken kullanılan action değeriyle doğrulanmalıdır.
Sorunu teşhis etmek için:
success true ise error-codes dizisi genellikle boştur; bu yüzden asıl kontrol edilmesi gereken alanlar score ve action'dır.
Evet. reCAPTCHA v3 görevine isEnterprise: true ekleyin (kabul edilen değerler: true/false veya 1/0). Görev, RecaptchaV3EnterpriseTask ile aynı şekilde işlenir. Yukarıdaki bölüme ve API belgelerine bakın.
Hiçbir araç gelişen korumalara karşı %100 başarı oranı garanti edemez; ancak CapMonster Cloud reCAPTCHA v3 çözümünde yüksek başarı oranı sunar. Veriler CapMonster Cloud ekibinin aylık dahili karşılaştırma testlerine dayanır. Gerçek API yanıt süresi ve başarı oranı hedef siteye, sunucu yüküne ve ağ koşullarına göre değişir.
reCAPTCHA, Google LLC şirketinin ticari markasıdır. CapMonster Cloud, Google ile bağlantılı değildir ve Google tarafından onaylanmamıştır. Hizmet; herkese açık veriler, sahip olduğunuz veya test etme yetkiniz olan siteler, görüntü tanıma ve erişilebilirlik için tasarlanmıştır. Giriş veya ödeme ile korunan üçüncü taraf verilerini izinsiz toplamak yasaktır; kendi hesaplarınız bundan etkilenmez. Çalışmaya başlamadan önce verilerinizin hukuki durumunu siz belirlersiniz.