Die Integration von CaptchaSonic in Ihre Browser-Automatisierungs-Workflows ermöglicht es, komplexe CAPTCHA-Challenges ohne manuelles Eingreifen zu umgehen. Diese Anleitung behandelt Installation, Konfiguration und Nutzung der CaptchaSonic-Erweiterung in automatisierten Umgebungen.

> [!TIP]
> **Bevorzugte Methode**: Für Automatisierung im großen Maßstab empfehlen wir die direkte Nutzung unserer API. Die Browser-Erweiterung eignet sich jedoch ideal für Tools wie Selenium, Puppeteer und Playwright, bei denen eine echte Browserumgebung erforderlich ist.

---

## 1. Erste Schritte

Bevor Sie die Erweiterung in Ihren Automatisierungsskripten nutzen können, benötigen Sie einen gültigen API-Schlüssel aus Ihrem CaptchaSonic-Dashboard.

1.  **Konto erstellen**: Registrieren Sie sich unter [captchasonic.com](https://captchasonic.com).
2.  **API-Schlüssel abrufen**: Melden Sie sich im [Dashboard](https://captchasonic.com/app) an und kopieren Sie Ihren persönlichen API-Schlüssel.

![Ausgabe des CaptchaSonic-Dashboards](/guides/CR/guide.7.png)

---

## 2. Installation & Einrichtung

### Für Chrome und Chromium-basierte Browser

Automatisierungs-Frameworks benötigen oft einen fest codierten API-Schlüssel, wenn Sie kein dauerhaftes Browserprofil verwenden.

1.  **Quellcode herunterladen**: Klonen oder laden Sie das [CaptchaSonic-Erweiterungs-Repository](https://github.com/Captcha-Sonic/CaptchaSonic-Extension/releases/latest) herunter.
2.  **API-Schlüssel konfigurieren**:
    *   Wechseln Sie in den Ordner `config` im Quellcode der Erweiterung.
    *   Öffnen Sie die Standard-Konfigurationsdatei (meist `config.json` oder ähnlich).
    *   Fügen Sie Ihren API-Schlüssel in das Feld `apiKey` ein.
3.  **In Chrome laden**:
    *   Öffnen Sie `chrome://extensions/`.
    *   Aktivieren Sie den **Entwicklermodus**.
    *   Klicken Sie auf **Entpackte Erweiterung laden** und wählen Sie den geänderten Erweiterungsordner aus.

> [!IMPORTANT]
> Stellen Sie sicher, dass Ihr Automatisierungs-Framework so konfiguriert ist, dass das Laden entpackter Erweiterungen erlaubt ist. In Selenium geschieht dies über `ChromeOptions`.

### Für Firefox

1.  **XPI herunterladen**: Installieren Sie die Erweiterung aus dem [Firefox-Add-ons-Store](https://addons.mozilla.org/en-US/firefox/addon/captchasonic/) oder laden Sie den neuesten Build aus den [CaptchaSonic-Erweiterungs-Releases](https://github.com/Captcha-Sonic/CaptchaSonic-Extension/releases/latest) herunter.
2.  **Manuelle Installation**: Öffnen Sie `about:addons`, klicken Sie auf das Zahnradsymbol und wählen Sie **Add-on aus Datei installieren**.

---

## 3. Integration in Automatisierungs-Frameworks

Um die Erweiterung in Ihrem Code zu verwenden, geben Sie den Pfad zum Erweiterungsordner oder zur Erweiterungsdatei an.

### Selenium (Python)

```python
from selenium import webdriver
from selenium.webdriver.chrome.options import Options

chrome_options = Options()
chrome_options.add_argument("--load-extension=/path/to/extracted/extension")

driver = webdriver.Chrome(options=chrome_options)
driver.get("https://web.captcha-target.com")
```

### Playwright (Node.js)

```javascript
const { chromium } = require('playwright');

(async () => {
  const pathToExtension = require('path').join(__dirname, 'my-extension');
  const userDataDir = '/tmp/test-user-data-dir';
  const browserContext = await chromium.launchPersistentContext(userDataDir, {
    headless: false,
    args: [
      `--disable-extensions-except=${pathToExtension}`,
      `--load-extension=${pathToExtension}`,
    ],
  });
  // ... your automation logic
})();
```

---

## 4. Parameter konfigurieren

Im Popup der Erweiterung oder in der Konfigurationsdatei können Sie fein einstellen, wie CAPTCHAs behandelt werden:

*   **Auto-Solve**: Startet den Lösungsvorgang automatisch, sobald ein CAPTCHA erkannt wird.
*   **Solve Delay**: Fügt vor dem Lösen eine natürliche Verzögerung hinzu, um menschliches Verhalten nachzuahmen.
*   **Target Types**: Aktivieren bzw. deaktivieren Sie bestimmte Solver für reCAPTCHA, hCaptcha, GeeTest usw.

---

## 5. Überlegungen zum Deployment

*   **Headless-Modus**: Standard-Erweiterungen laufen nicht im echten Headless-Modus (`--headless=new`). Verwenden Sie auf Linux-Servern `--headless=old` oder einen virtuellen Framebuffer (Xvfb).
*   **Proxy-Unterstützung**: Die meisten Erweiterungen respektieren die System-Proxy-Einstellungen des Browsers, die Sie über Ihr Automatisierungs-Framework konfigurieren.

---

## 6. Fazit

Mit der CaptchaSonic-Erweiterung reduzieren Sie die Komplexität interaktiver Challenges in Ihren Browser-Automatisierungsaufgaben deutlich.

Für weiterführenden technischen Support oder individuelle Integrationswünsche wenden Sie sich über das [Dashboard](https://captchasonic.com/app) an unser Team.
