Przeglądarka CDP dla agentów AI: Przewodnik dla programistów - zilustrowana okładka artykułu Clawbrowser

Przeglądarka CDP dla agentów AI: Przewodnik dla programistów

Clawbrowser Teamair- agentscdpprzewodnik

Agenci AI potrzebują przeglądarek. Niezależnie od tego, czy Twój agent drapie dane, wypełnia formularze, zarządza wieloma kontami lub nawigacją wielostopniowych przepływów roboczych, kontroluje przeglądarkę za pomocą protokołu. Dla każdego głównego agenta, protokół ten jest CDP (Chrome DevTools Protocol). Problem: połączenie agenta ze standardową instancją Chromium jest wykrywane i blokowane w ciągu kilku minut. Przeglądarka CDP dla agentów AI potrzebuje więcej niż WebSocket punktu końcowego. Potrzebuje zarządzanych odcisków palców, proxy routingu i izolacji sesji, wszystkie dostępne przez ten sam interfejs CDP Twój agent już mówi.

TL; DR: CDP jest standardowym protokołem AI agentów do sterowania przeglądarkami. Standardowy Chrome eksponuje sygnały automatyki, które systemy anty-bot wykrywają natychmiast. Clawbrowser jest forkiem Chromium z Native CDP, zarządzane odciski palców na 20 + powierzchniach, built- in routing proxy i MCP server. Twój agent łączy się z prawdziwą przeglądarką, która nie zostaje zablokowana.


Czym jest Chrome DevTools Protocol?

CDP jest protokołem opartym na WebSocket- który daje zewnętrzne programy pełną kontrolę nad przeglądarką Chromium. Został zbudowany dla Chrome DevTools (inspektor otwierasz z F12), ale stał się de facto standardem browser automation.

Dzięki CDP klient może:

  • Przejdź do adresów URL i zarządzaj zakładkami
  • Wykonaj dowolne JavaScript w kontekście strony
  • Zrzut ekranu i PDF
  • Interceptuj i modyfikuj żądania sieciowe
  • Zarządzanie plikami cookie, przechowywaniem i buforem
  • Symulowanie wejścia użytkownika: kliknięcia, naciśnięcia klawiszy, przewijanie

Model połączenia jest prosty. Uruchom Chrome z portu debugowania, a każdy klient WebSocket może się połączyć:

# Start Chrome with CDP enabled
chrome --remote-debugging-port=9222
// Connect from Node.js with Puppeteer
const browser = await puppeteer.connect({
  browserWSEndpoint: 'ws://localhost:9222/devtools/browser/...'
});
const page = await browser.newPage();

Jeden protokół, jeden punkt końcowy, pełna kontrola przeglądarki.


Dlaczego każdy agent AI wykorzystuje CDP

CDP jest uniwersalnym łącznikiem pomiędzy czynnikami AI i przeglądarkami. Każda główna struktura agenta oczekuje CDP endpoint:

Agent Framework Połączenie CDP
Claude Code MCP server lub CDP endpoint
OpenAI Codex connect_over_cdp()
Cursor CDP WebSocket
Browser Use CDP endpoint
Hermes Agent CDP endpoint
OpenClaw CDP endpoint
Kilo Code CDP endpoint
Puppeteer Native CDP client
Playwright (Chromium) connect_over_cdp()

Kiedy agent potrzebuje przeglądarki, oczekuje ws://localhost:9222. Nie Juggler (Firefox protokół), nie WebDriver BiDi, nie własność REST API. CDP.

Dlatego też przeglądarki oparte na Firefox- detect nie mogą podłączyć się do większości plików roboczych bez warstwy adaptera, ponieważ używają zupełnie innego protokołu. Agent → CDP → Browser, przeglądarka musi być oparta na Chromium.


Problem: standardowy Chromium zostaje wykryty

Standardowy Chromium --remote-debugging-port działa dobrze do czasu sprawdzenia przez stronę docelową automatyzacji. Systemy anty-bot, takie jak Cloudflare, DataDome i PerimeterX wykrywają Chrome napędzany CDP poprzez wiele sygnałów:

1. navigator.webdriver Flaga. Chrome ustawia to na true kiedy jest kontrolowany przez CDP. To pierwsza rzecz, którą sprawdzają skrypty anty-bot.

2. CDP runtime artefakty.Runtime.evaluate wywołania pozostawiają ślady w kontekście wykonywania JavaScript, które różnią się od rzeczywistych interakcji użytkownika.

3. Domyślne odciski palców. Świeża instancja Chrome zwraca wartości Canvas, WebGL i AudioContext. Prawdziwe przeglądarki posiadają unikalne odciski palców w kształcie GPU, sterowniki i konfigurację systemu operacyjnego.

4. Brak profilu przeglądarki. Brak historii przeglądania, brak plików cookie, brak czcionek buforowych, brak rozszerzeń. Czysta instalacja to sygnał bot.

5. Tryb bez głowy przecieka. Nawet --headless=new produkuje wykrywalne różnice w zachowaniu renderowania, tablice plugin i wymiary ekranu.

Wynik: Twój agent łączy się z Chrome, nawigacja do celu i uderza w ścianę CAPTCHA lub cichy blok. Połączenie CDP działa doskonale.


Podłączenie Twojego agenta do przeglądarki Clawbrowser

Clawbrowser to widelec Chromium zbudowany dokładnie dla tego przypadku zastosowania: przeglądarka CDP dla agentów AI, które obsługują anti-detect na poziomie przeglądarki. Twój agent łączy się ze standardowym CDP endpoint. Przeglądarka obsługuje wszystko inne.

Rozpocznij sesję z zarządzanym odciskiem palca

# Start Clawbrowser with a managed fingerprint profile
clawctl session start --profile residential-us-1

# CDP endpoint is immediately available
# ws://localhost:9222/devtools/browser/...

Połącz z Playwright lub Puppeteer

from playwright.sync_api import sync_playwright

with sync_playwright() as p:
    # Connect to Clawbrowser's CDP endpoint, same as any Chrome
    browser = p.chromium.connect_over_cdp("ws://localhost:9222")
// Puppeteer: zero changes to existing code
const browser = await puppeteer.connect({
  browserWSEndpoint: 'ws://localhost:9222/devtools/browser/...'
});
const page = await browser.newPage();

Uruchom wiele izolowanych sesji z routowaniem proxy

# Session 1: US residential proxy, unique fingerprint
clawctl session start --profile us-east --proxy socks5://us-proxy:1080

# Session 2: EU residential proxy, different fingerprint
clawctl session start --profile eu-west --proxy socks5://eu-proxy:1080

Każda sesja otrzymuje kompletny, wewnętrznie spójny profil odcisków palców. Canvas renders dopasowuje się do zgłoszonego GPU. Parametry WebGL pasują do karty graficznej. Właściwości nawigatora pasują do systemu operacyjnego i wersji przeglądarki. Timezone pasuje do lokalizacji proxy. Systemy antybotowe widzą prawdziwą przeglądarkę, ponieważ każda powierzchnia opowiada tę samą historię.


CDP + MCP: Dwa protokoły, One Clawbrowser

CDP daje niskie poziomy kontroli przeglądarki. MCP (Model Context Protocol) daje agentom AI wysoki poziom dostępu do narzędzia. Clawbrowser obsługuje zarówno w tej samej instancji.

Dzięki CDP Twój agent wysyła komendy granularne: przejdź do URL, kliknij element na współrzędnych, wykonaj ten JavaScript. Pełna kontrola, pełna elastyczność, więcej kodu.

Z MCP, Twój agent wywołuje funkcje narzędzia: navigate, screenshot, extract_text. MCP server przekłada je na operacje CDP wewnątrz. Mniej kodu, szybsza integracja, ale mniej granulowanej kontroli.

Praktyczny podział:

  • Użyj CDP gdy Twój agent uruchamia skrypty automatyzacji, potrzebuje przechwytywania sieci lub bezpośrednio używa Puppeteer / Playwright.
  • Użyj MCP gdy Twój agent jest LLM, który potrzebuje dostępu do przeglądarki na poziomie narzędzi (Claude Code, Codex lub dowolny agent kompatybilny z MCP-).
  • Użyj obu, gdy Twój orchestrator zarządza sesją nad CDP, podczas gdy poszczególne czynniki LLM oddziałują przez MCP.

Żadna inna przeglądarka nie oferuje obu protokołów w tej samej instancji.


Opcje przeglądarki CDP w porównaniu

Cecha Clawbrowser Chrome Browserbase Steel Camoufox
CDP native Tak. Tak. Tak. Tak. Nie.
Anti- detection 20 + powierzchnie None Tak. Tak. Tak.
Zarządzanie odciskami palców Tak. Nie. Tak. Tak. Tak (BrowserForge)
Proxy routing Budowa Nie. Tak. Tak. Podręcznik
MCP server Budowa Nie. Nie. Nie. Nie.
Deployment Lokalna / samoobsługowa Lokalne Tylko chmura Tylko chmura Lokalne
Price Wolne Wolne Od $150 / mo Od $99 / mo Wolne

Clawbrowser jest jedyną opcją, która łączy Native CDP, zarządzane odciski palców, built- w routingu proxy i MCP serwera, i jest bezpłatny. Alternatywy Cloud (Browserbase, Steel) pobierać peresession i dodać opóźnienie sieci między agentem i przeglądarką. Camoufox jest bezpłatny, ale wykorzystuje Firefox i Juggler, co oznacza, że nie kompatybilność CDP z frameworkiem agenta.


Rozpoczęcie

# Install Clawbrowser
clawctl install

# Start a session with default fingerprint
clawctl session start --profile default

Twój istniejący kod CDP działa bez zmian. Wskaż agenta na punkt końcowy. Przeglądarka automatycznie obsługuje pobieranie odcisków palców, routing proxy i anti-detect.


FAQ

Czy Clawbrowser współpracuje z Puppeteer i Playwright?

Tak. Clawbrowser ujawnia standardowy CDP endpoint. Użyj puppeteer.connect() lub playwright.chromium.connect_over_cdp() z URL WebSocket dokładnie tak, jak byś chciał z regularnym Chrome. Nie wymaga zmian kodu.

Czy mogę uruchomić kilka sesji jednocześnie?

Tak. Każda sesja otrzymuje swój własny CDP endpoint, profil odcisków palców, cookies i opcjonalne proxy. Uruchom tyle sesji, ile obsługuje sprzęt. Sesje są w pełni izolowane bez wspólnego stanu między nimi.

Czy Clawbrowser jest darmowy dla celów komercyjnych?

Tak. Clawbrowser jest darmowym i otwartym źródłem. Brak ograniczeń użytkowania, brak cen sesji, brak wymaganych kluczy API. Użyj go w produkcji, w CI/CD lub na lokalnej maszynie.

Jaka jest różnica między CDP a MCP w Clawbrowser?

CDP (Chrome DevTools Protocol) zapewnia kontrolę przeglądarki na niskim poziomie: nawigację, kliknięcie, wykonanie JavaScript, przechwytywanie żądań sieciowych. MCP (Model Context Protocol) zapewnia dostęp do narzędzi na wysokim poziomie: nawigacja, screenshot, tekst ekstraktu. Clawbrowser obsługuje jednocześnie w tej samej instancji przeglądarki.

Czy działa w trybie środowiska Docker i bez głowy?

Tak. Clawbrowser działa w Docker z tym samym końcowym CDP narażone. --headless dla środowisk serwerów. Wszystkie funkcje zarządzania odciskami palców działają identycznie w trybie bezgłowym.

Czytaj dalej

Zobacz wszystkie →