CaptchaSonic Tarayıcı Eklentisi, manuel gezinme sırasında veya Selenium gibi otomasyon çerçeveleri içinde CAPTCHA'ları çözmenin en kolay yoludur. Bu kılavuz, desteklenen tüm tarayıcılar için kurulum ve yapılandırmayı kapsar.

---

## 🚀 Temel Özellikler

*   **Tıklamasız Çözme**: Çoğu büyük CAPTCHA türünü otomatik olarak algılar ve çözmeyi başlatır.
*   **Görünmez Mod**: Görüşünüzü engellemeden arka planda çalışır.
*   **Geniş Uyumluluk**: reCAPTCHA (v2/v3/Invisible), hCaptcha, GeeTest ve daha fazlası için destek.
*   **Kara Liste Desteği**: Otomatik çözmeyi devre dışı bırakmak istediğiniz belirli alan adlarını tanımlayın.

---

## 1. Ön Koşullar

Kurulumdan önce şunlara sahip olmanız gerekir:
1.  Bir [CaptchaSonic Hesabı](https://captchasonic.com).
2.  [Panelinizden](https://captchasonic.com/app) alınmış bir **API Anahtarı**.

> [!IMPORTANT]
> API anahtarınız özeldir. Asla paylaşmayın veya herkese açık depolara eklemeyin.

---

## 2. Kurulum

### Google Chrome İçin

Eklentimiz yeni AI modelleriyle sık güncellendiğinden, en son özellikler için "paketlenmemiş" sürümün kurulmasını öneririz.

1.  **Mağazadan Kurun**: En kolay yol — doğrudan [Chrome Web Mağazasından](https://chromewebstore.google.com/detail/captchasonic-automatic-ca/dkkdakdkffippajmebplgnpmijmnejlh) ekleyin.

Ya da henüz yayımlanmamış en son sürüm için:

1.  **İndirin**: En son eklenti ZIP dosyasını [GitHub Sürümlerimizden](https://github.com/Captcha-Sonic/CaptchaSonic-Extension/releases/latest) alın.
2.  **Çıkarın**: İndirilen klasörü diskinizde kalıcı bir konuma açın.
3.  **Eklentileri Yönetin**: Chrome'u açın ve `chrome://extensions/` adresine gidin.
4.  **Geliştirici Modu**: Sağ üst köşedeki **Developer Mode** anahtarını etkinleştirin.
5.  **Paketlenmemiş Yükleme**: **Load unpacked** düğmesine tıklayın ve çıkarılan klasörü seçin.

![Chrome Eklentisi Kurulum Adımları](/guides/BE/guide.7.png)

### Mozilla Firefox İçin

1.  **Mağazadan Kurun**: Doğrudan [Firefox Eklentilerinden](https://addons.mozilla.org/en-US/firefox/addon/captchasonic/) ekleyin.

Ya da bir `.xpi` dosyasından manuel olarak kurun:

1.  **İndirin**: [GitHub Sürümlerimizden](https://github.com/Captcha-Sonic/CaptchaSonic-Extension/releases/latest) `.xpi` dosyasını alın.
2.  **Eklentiler Menüsü**: Firefox'u açın, menü düğmesine (üç çizgi) tıklayın ve **Add-ons and Themes** seçeneğini seçin.
3.  **Dosyadan Kurun**: Yönettiğiniz eklentilerin üstündeki dişli simgesine tıklayın ve **Install Add-on From File...** seçeneğini seçin.
4.  **Onaylayın**: `.xpi` dosyasını seçin ve **Add** düğmesine tıklayın.

---

## 3. Yapılandırma

Kurulduktan sonra ayarlar açılır penceresini açmak için tarayıcı araç çubuğundaki CaptchaSonic simgesine tıklayın.

1.  **Kimlik Doğrulama**: **API Anahtarınızı** ilk alana yapıştırın ve **Save** düğmesine tıklayın.
2.  **Modülleri Etkinleştirin**: Otomatik olarak çözmek istediğiniz CAPTCHA türlerini açın.
3.  **Gelişmiş Seçenekler**:
    *   **Solving Delay**: Daha insan benzeri görünmek istiyorsanız bir gecikme ayarlayın.
    *   **Auto-Submit**: Bir challenge çözüldükten sonra "Verify" düğmesine otomatik olarak tıklar.

![Eklenti Ayarları Arayüzü](/guides/BE/guide.17.png)

---

## 4. Kullanım

Eklenti "ayarla ve unut" mantığıyla tasarlanmıştır.

*   **Algılama**: CAPTCHA içeren bir sayfayı ziyaret ettiğinizde eklenti simgesi bir challenge bulduğunu belirtmek için durum değiştirir.
*   **Durum**: CAPTCHA bileşeninin yakınında çözme ilerlemesini gösteren küçük bir durum rozeti görünebilir.
*   **Tamamlanma**: Çözüldüğünde eklenti sonuç token'ını girer ve yapılandırıldıysa formu gönderir.

---

## 5. Sorun Giderme (SSS)

**S: Eklenti CAPTCHA'yı çözmüyor.**
*   C: Yeterli krediniz olduğundan emin olmak için [Panelinizi](https://captchasonic.com/app) kontrol edin. API anahtarınızın ayarlarda doğru yapıştırıldığını doğrulayın.

**S: reCAPTCHA v3'te "Low Score" hatası alıyorum.**
*   C: reCAPTCHA v3, tarayıcınızın geçmişine ve IP itibarına bağlıdır. Yüksek kaliteli bir proxy kullanmayı veya tarayıcı önbelleğinizi temizlemeyi deneyin.

**S: Chrome eklentinin "bozuk" olduğunu söylüyor.**
*   C: Bu genellikle eklenti yüklendikten sonra klasörü taşıdığınızda olur. `chrome://extensions/` sayfasından kaldırın ve "Load unpacked" ile yeniden yükleyin.

---

## 6. Destek

Kalıcı sorunlarla karşılaşırsanız, lütfen [Resmi Panel](https://captchasonic.com/app) üzerindeki canlı sohbet aracılığıyla teknik ekibimize ulaşın.

---

> [!TIP]
> **Geliştirici Notu**: Yüksek hacimli veri kazıma mı yapıyorsunuz? Önemli ölçüde daha yüksek verim için tarayıcı eklentisi yerine [REST API](/docs/api) kullanmayı düşünün.
