🌐 Agent Browser API

Ein universeller, voll funktionsfähiger Headless-Browser für KI-Agenten. Gib jedem Agenten — Zapier Agents, Custom GPTs, Claude, Cursor, LangChain, CrewAI, n8n, Make oder deinem eigenen Code — einen echten Chromium-Browser: JavaScript-Rendering, Websuche, Klicken, Tippen, Formularausfüllen, Dropdowns, Screenshots, Tabellen- und Datenextraktion sowie PDF-Erstellung.

🇮🇳 Hindi-Kurzfassung: Dies ist ein echter Browser, den jeder KI-Agent nutzen kann — 3 Möglichkeiten: einfache REST-API, OpenAPI-Import (Custom GPT) oder natives MCP (Claude/Cursor/ChatGPT). Deployen, API-Key setzen, fertig. ✅ 26/26 Tests bestanden.

🔌 Funktioniert mit JEDEM Agenten — drei Verbindungsmöglichkeiten

Vollständige Copy-Paste-Anleitungen pro Plattform: INTEGRATIONS.md · Zapier-spezifisch: ZAPIER_SETUP.md

Related MCP server: WebControl

✨ Funktionen

Außerdem: API-Key-Authentifizierung, CORS, Ratenbegrenzung, SSRF-Schutz, automatischer Sitzungsablauf + LRU-Verdrängung, Stealth-Grundlagen, SPA-Settle-Wartezeiten, Ausgabekürzung für LLM-Kontextsicherheit, hilfreiche Fehler-hints, /llms.txt und eine vollständige OpenAPI-Spezifikation.

🚀 Schnellstart

Kostenlos deployen (Render) — empfohlen

1. Dieses Repo auf GitHub forken/pushen.

2. Zu render.com gehen → Neu → Blueprint → dieses Repo auswählen (render.yaml wird automatisch erkannt).

3. Den generierten API_KEY aus dem Environment-Tab des Dienstes kopieren.

4. Live unter https://your-service.onrender.com 🎉

Funktioniert auch auf Railway, Fly.io oder jedem Docker-Host.

Docker

docker build -t agent-browser .
docker run -p 8080:8080 -e API_KEY=your-secret-key agent-browser

Lokal ausführen

npm install            # installs deps + Chromium
API_KEY=your-secret-key npm start
# → agent-browser v2.0.0 listening on :8080

🧪 Ausprobieren

BASE=http://localhost:8080; KEY=your-secret-key

# Read a JS-heavy page as markdown
curl -X POST $BASE/v1/browse -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://news.ycombinator.com"}'

# Search the web
curl -X POST $BASE/v1/search -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"query":"best CRM for startups","limit":5}'

# Extract every table on a page as JSON
curl -X POST $BASE/v1/tables -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://www.scrapethissite.com/pages/forms/"}'

# Multi-step: search Wikipedia interactively
SID=$(curl -s -X POST $BASE/v1/sessions -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://en.wikipedia.org"}' | jq -r .sessionId)
curl -X POST $BASE/v1/sessions/$SID/fill -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"fields":{"input[name=search]":"Artificial intelligence"}}'
curl -X POST $BASE/v1/sessions/$SID/press -H "X-API-Key: $KEY" -H "Content-Type: application/json" \
  -d '{"key":"Enter"}'
curl $BASE/v1/sessions/$SID/content -H "X-API-Key: $KEY"
curl -X DELETE $BASE/v1/sessions/$SID -H "X-API-Key: $KEY"

Führe die vollständige Smoke-Test-Suite aus: npm test — 26 Prüfungen, die jeden Endpunkt und einen echten MCP-Client-Roundtrip abdecken.

⚙️ Konfiguration (Umgebungsvariablen)

🔒 Sicherheitshinweise

• API_KEY in Produktion immer setzen (das Render-Blueprint generiert automatisch einen).

• Nur http/https-URLs sind erlaubt; localhost/private/Metadaten-Adressen sind standardmäßig blockiert.

• Hinter HTTPS betreiben (Render/Railway geben dir TLS kostenlos).

• evaluate führt beliebiges JS innerhalb der Sandbox-Seite aus — halte deinen API-Key geheim.

• Öffentliche (ohne Schlüssel) Endpunkte sind schreibgeschützte Infos: /, /health, /openapi.yaml, /llms.txt, /v1/tools.

📁 Projektstruktur

src/server.js         # Express API: auth, CORS, rate limit, routes
src/actions.js        # Shared high-level actions (used by REST + MCP)
src/browser.js        # Chromium lifecycle, sessions, TTL/LRU, SSRF guard
src/extract.js        # HTML → markdown, CSS extraction, tables, elements
src/search.js         # Multi-engine web search with fallback
src/mcp.js            # MCP server (Streamable HTTP, 22 tools)
src/tools-manifest.js # GET /v1/tools (OpenAI function format)
openapi.yaml          # Full API specification
test/run-tests.sh     # 26-check smoke-test suite (incl. MCP round-trip)
Dockerfile            # Production image (Playwright base, version-pinned)
render.yaml           # One-click Render deploy

Lizenz

MIT