Bir CAPTCHA MCP sonucunu tarayıcı ajanında kullanın

1. 1.

   Yerel MCP sunucusunu yapılandırın

   solvethree-mcp sunucusunu npx üzerinden başlatmak için MCP kurulum talimatlarını izleyin. Bu, barındırılan bir uç nokta değil, yerel bir stdio sunucusudur. SOLVETHREE_API_KEY ve SOLVETHREE_PROXY değerlerini ana makinenin ortamı üzerinden sağlayın; kimlik bilgilerini ajanın istemine koymayın.

2. 2.

   Kullanılabilir araçları ve site profilini kontrol edin

   Kullanılabilir yetenekleri incelemek için solvethree_capabilities çağrısını yapın. reCAPTCHA Enterprise için çalışma alanında hedeflenen ana makine adı, yakalama eylemi ve reCAPTCHA türüne uygun etkin bir profil zaten bulunmalıdır. Bir oluşturma aracına site ve action geçirmek bu profili oluşturmaz. Kurulum hâlâ gerekiyorsa Site profilleri sayfasını kullanın.

3. 3.

   Tarayıcının eşleşen isteği gönderebildiğini doğrulayın

   Tarayıcı, aynı sabitlenmiş proxy'yi ve döndürülen userAgent ile secChUa değerlerini desteklemelidir. Ayrıca uygulamanın çerezlerini, CSRF alanlarını ve oturum gereksinimlerini korumalıdır. Tarayıcı aracı bunları yapılandıramıyorsa ilgisiz bir tarayıcı oturumu kullanmak yerine çözüm için ödeme yapmadan önce durun.

reCAPTCHA MCP aracında kullanılan tek proxy, araç argümanlarından değil SOLVETHREE_PROXY üzerinden gelir. Tarayıcıdan gönderim sırasında bu proxy'yi sabit tutun. Ana makine özel çözüm verilerini alır; bu nedenle token'ları ve proxy kimlik bilgilerini rutin ajan raporlarına dahil etmeyin.

MCP sunucusu ve tarayıcı yapılandırıldıktan sonra bu talimatı kullanın. Hedef ana makine adını ve yürütme eylemini uygulamanın isteğinden alarak sağlayın. solvethree_create_recaptcha varsayılan olarak Enterprise v3 kullanır; zorunlu argümanları site, action ve requestId şeklindedir.

Use the already-configured solvethree MCP server for one reCAPTCHA Enterprise task.
The target hostname must have an active workspace profile before creation.
1. Keep one requestId for this logical task. Ask before starting another paid task.
2. Call solvethree_create_recaptcha with site, action and that requestId.
   The server reads its target proxy from SOLVETHREE_PROXY.
3. Save the returned id. Call solvethree_get_task for that id while pending/solving,
   stopping at ready, failed or the agreed deadline. Never poll by creating again.
4. If ready, submit solution.token using the application’s actual token parameter.
   Use the returned userAgent/secChUa and the same pinned proxy in the browser.
   Keep the application’s cookies, CSRF fields and session requirements.
5. Read the application response. Report task ID and outcome, not secret solution data.
If the browser tool cannot configure that proxy and identity, stop and explain the
missing capability instead of claiming it submitted an equivalent request.

Kaydedilen görev id değeri solvethree_get_task içindir; web sitesine gönderilecek değer değildir. pending ve solving, kararlaştırılan süre sınırı içinde beklemeye devam etmeniz gerektiği anlamına gelir. Yalnızca ready kullanılabilir bir çözüm içerir. failed durumunda errorCode ve error değerlerini okuyun ve bu görevin durumunu sorgulamayı bırakın.

Evrensel bir otomatik doldurma adımı yoktur. Sonucu kullanan uygulama isteğini belirleyin, ardından eşleşen çözüm alanını kullanın. Aşağıdaki her sonuç için döndürülen tarayıcı kimliğini ve başarılı proxy'yi amaçlanan hedefte kullanın.

Gönderimden sonra uygulamanın yanıtını inceleyin. Bir görevin ready durumunda olması, hedefin çözümü kabul ettiğini değil, çözümün üretildiğini gösterir. Hedef çözümü reddederse önce giden isteği inceleyin: gerçek token, çerez veya üstbilgilerin, eşleşen proxy, kimlik ve uygulama oturumuyla birlikte gönderildiğini doğrulayın. Çözümü ifşa etmeden görev kimliğini ve uygulama sonucunu raporlayın.

Her mantıksal görev için bir requestId üretin ve bunu özgün girdilerle birlikte saklayın. Bu değer 1–64 ASCII harfi, rakam, alt çizgi veya kısa çizgi içermelidir. Bir id almadan önce oluşturma işlemi zaman aşımına uğrarsa mevcut göreve yeniden ulaşmak için aynı oluşturma isteğini aynı requestId ve değiştirilmemiş girdilerle tekrarlayın. Görevin id değeri zaten elinizdeyse solvethree_get_task kullanın.

Bu kimliği yeniden kullanırken girdileri değiştirmeyin: bunu yapmak çakışmaya yol açar. Sırf bir yanıt kayboldu veya durum sorgulama süresi doldu diye yeni bir kimlik üretmeyin. Bu olayların hiçbiri özgün görevin başarısız olduğunu kanıtlamaz.

Her MCP oluşturma çağrısı en fazla bir görev oluşturur, ancak bu durum ajana bir harcama sınırı getirmez. Başka bir mantıksal göreve başlamadan önce onay alınmasını zorunlu kılın. Nihai bir başarısızlık durumunda, düzeltilmiş bir isteğin gerekli olup olmadığına karar vermeden önce errorCode ve error değerlerini inceleyin; başarısız çözümlerin ücreti iade edilir. İstek hatası, durumu failed olan bir görevden ayrı bir sorundur.