Die CaptchaSonic-Browser-Erweiterung ist der einfachste Weg, CAPTCHAs beim manuellen Surfen oder in Automatisierungs-Frameworks wie Selenium zu lösen. Diese Anleitung behandelt Installation und Konfiguration für alle unterstützten Browser.

---

## 🚀 Wichtigste Funktionen

*   **Lösen ohne Klick**: Erkennt die meisten gängigen CAPTCHA-Typen automatisch und startet den Lösungsvorgang.
*   **Unsichtbarer Modus**: Arbeitet im Hintergrund, ohne Ihre Ansicht zu stören.
*   **Breite Kompatibilität**: Unterstützt reCAPTCHA (v2/v3/unsichtbar), hCaptcha, GeeTest und weitere.
*   **Sperrliste**: Legen Sie bestimmte Domains fest, auf denen die automatische Lösung deaktiviert werden soll.

---

## 1. Voraussetzungen

Bevor Sie installieren, benötigen Sie:
1.  Ein [CaptchaSonic-Konto](https://captchasonic.com).
2.  Einen **API-Schlüssel** aus Ihrem [Dashboard](https://captchasonic.com/app).

> [!IMPORTANT]
> Ihr API-Schlüssel ist privat. Geben Sie ihn niemals weiter und committen Sie ihn nicht in öffentliche Repositories.

---

## 2. Installation

### Für Google Chrome

Da unsere Erweiterung häufig mit neuen KI-Modellen aktualisiert wird, empfehlen wir die Installation der „entpackten“ Version, um immer die neuesten Funktionen zu erhalten.

1.  **Installation aus dem Store**: Der einfachste Weg – fügen Sie sie direkt aus dem [Chrome Web Store](https://chromewebstore.google.com/detail/captchasonic-automatic-ca/dkkdakdkffippajmebplgnpmijmnejlh) hinzu.

Oder für den neuesten, noch nicht veröffentlichten Build:

1.  **Herunterladen**: Laden Sie das neueste Erweiterungs-ZIP aus unseren [GitHub-Releases](https://github.com/Captcha-Sonic/CaptchaSonic-Extension/releases/latest) herunter.
2.  **Entpacken**: Entpacken Sie den heruntergeladenen Ordner an einen dauerhaften Speicherort auf Ihrer Festplatte.
3.  **Erweiterungen verwalten**: Öffnen Sie Chrome und navigieren Sie zu `chrome://extensions/`.
4.  **Entwicklermodus**: Aktivieren Sie den Schalter **Entwicklermodus** oben rechts.
5.  **Entpackte Erweiterung laden**: Klicken Sie auf **Entpackte Erweiterung laden** und wählen Sie den entpackten Ordner aus.

![Schritte zur Einrichtung der Chrome-Erweiterung](/guides/BE/guide.7.png)

### Für Mozilla Firefox

1.  **Installation aus dem Store**: Fügen Sie sie direkt über [Firefox-Add-ons](https://addons.mozilla.org/en-US/firefox/addon/captchasonic/) hinzu.

Oder installieren Sie manuell aus einer `.xpi`-Datei:

1.  **Herunterladen**: Laden Sie die `.xpi`-Datei aus unseren [GitHub-Releases](https://github.com/Captcha-Sonic/CaptchaSonic-Extension/releases/latest) herunter.
2.  **Add-ons-Menü**: Öffnen Sie Firefox, klicken Sie auf die Menüschaltfläche (drei Striche) und wählen Sie **Add-ons und Themes**.
3.  **Aus Datei installieren**: Klicken Sie auf das Zahnradsymbol über Ihren Erweiterungen und wählen Sie **Add-on aus Datei installieren...**.
4.  **Bestätigen**: Wählen Sie die `.xpi`-Datei aus und klicken Sie auf **Hinzufügen**.

---

## 3. Konfiguration

Klicken Sie nach der Installation auf das CaptchaSonic-Symbol in der Browser-Symbolleiste, um das Einstellungs-Popup zu öffnen.

1.  **Authentifizierung**: Fügen Sie Ihren **API-Schlüssel** in das erste Feld ein und klicken Sie auf **Speichern**.
2.  **Module aktivieren**: Schalten Sie die CAPTCHA-Typen ein, die automatisch gelöst werden sollen.
3.  **Erweiterte Optionen**:
    *   **Lösungsverzögerung**: Legen Sie eine Verzögerung fest, wenn Sie menschlicher wirken möchten.
    *   **Automatisch absenden**: Klickt nach dem Lösen einer Challenge automatisch auf „Verify“.

![Einstellungsoberfläche der Erweiterung](/guides/BE/guide.17.png)

---

## 4. Nutzung

Die Erweiterung ist für den Betrieb nach dem Einrichten gedacht („einstellen und vergessen“).

*   **Erkennung**: Wenn Sie eine Seite mit CAPTCHA aufrufen, ändert das Erweiterungssymbol seinen Zustand und zeigt eine erkannte Challenge an.
*   **Status**: Neben dem CAPTCHA-Widget kann ein kleines Statusabzeichen erscheinen, das den Fortschritt des Lösens anzeigt.
*   **Abschluss**: Nach dem Lösen trägt die Erweiterung das Ergebnis-Token ein und sendet das Formular bei entsprechender Konfiguration ab.

---

## 5. Fehlersuche (FAQ)

**F: Die Erweiterung löst das CAPTCHA nicht.**
*   A: Prüfen Sie Ihr [Dashboard](https://captchasonic.com/app), ob genügend Guthaben vorhanden ist. Kontrollieren Sie, ob Ihr API-Schlüssel korrekt in den Einstellungen eingefügt wurde.

**F: Ich erhalte bei reCAPTCHA v3 den Fehler „Low Score“.**
*   A: reCAPTCHA v3 hängt vom Browserverlauf und der IP-Reputation ab. Versuchen Sie einen hochwertigen Proxy oder leeren Sie den Browser-Cache.

**F: Chrome meldet, die Erweiterung sei „beschädigt“.**
*   A: Das passiert meist, wenn Sie den Erweiterungsordner nach dem Laden verschoben haben. Entfernen Sie sie einfach unter `chrome://extensions/` und klicken Sie erneut auf „Entpackte Erweiterung laden“.

---

## 6. Support

Wenn Sie anhaltende Probleme haben, wenden Sie sich bitte über den Live-Chat im [offiziellen Dashboard](https://captchasonic.com/app) an unser technisches Team.

---

> [!TIP]
> **Hinweis für Entwickler**: Scraping mit hohem Volumen? Nutzen Sie statt der Browser-Erweiterung besser unsere [REST-API](/docs/api) für deutlich höheren Durchsatz.
