Skip to content
CaptchaSonic

Browser-Automatisierung mit CaptchaSonic

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.
  2. API-Schlüssel abrufen: Melden Sie sich im Dashboard an und kopieren Sie Ihren persönlichen API-Schlüssel.

Ausgabe des CaptchaSonic-Dashboards


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 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 oder laden Sie den neuesten Build aus den CaptchaSonic-Erweiterungs-Releases 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)

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)

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 an unser Team.