🌐 Agent Browser API

Un navegador headless universal y totalmente funcional para agentes de IA. Dale a cualquier agente — Zapier Agents, Custom GPTs, Claude, Cursor, LangChain, CrewAI, n8n, Make, o tu propio código — un navegador Chromium real: renderizado de JavaScript, búsqueda web, clics, escritura, relleno de formularios, menús desplegables, capturas de pantalla, extracción de tablas y datos, y generación de PDF.

🇮🇳 Hindi TL;DR: Yeh ek real browser hai jo koi bhi AI agent use kar sakta hai — 3 tarike: simple REST API, OpenAPI import (Custom GPT), ya native MCP (Claude/Cursor/ChatGPT). Deploy karo, API key set karo, ho gaya. ✅ 26/26 tests passing.

🔌 Funciona con CUALQUIER agente — tres formas de conectarse

Guías completas de copiar y pegar por plataforma: INTEGRATIONS.md · Específicos de Zapier: ZAPIER_SETUP.md

Related MCP server: WebControl

✨ Características

Además: autenticación por clave de API, CORS, limitación de tasa, protección SSRF, caducidad automática de sesiones + expulsión LRU, conceptos básicos de stealth, esperas de asentamiento SPA, truncamiento de salida para seguridad del contexto LLM, hints de error útiles, /llms.txt y una especificación OpenAPI completa.

🚀 Inicio rápido

Despliegue gratuito (Render) — recomendado

1. Haz fork/sube este repositorio a GitHub.

2. Ve a render.com → Nuevo → Blueprint → elige este repositorio (render.yaml se detecta automáticamente).

3. Copia la API_KEY generada desde la pestaña Entorno del servicio.

4. En vivo en https://your-service.onrender.com 🎉

También funciona en Railway, Fly.io o cualquier host Docker.

Docker

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

Ejecutar localmente

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

🧪 Pruébalo

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"

Ejecuta la suite completa de pruebas de humo: npm test — 26 comprobaciones que cubren cada endpoint y un viaje de ida y vuelta real con un cliente MCP.

⚙️ Configuración (variables de entorno)

🔒 Notas de seguridad

• Siempre establece API_KEY en producción (el blueprint de Render genera una automáticamente).

• Solo se permiten URLs http/https; las direcciones localhost/privadas/metadatos están bloqueadas por defecto.

• Ejecuta detrás de HTTPS (Render/Railway te dan TLS gratis).

• evaluate ejecuta JS arbitrario dentro de la página sandbox — mantén tu clave de API en secreto.

• Los endpoints públicos (sin clave) son información de solo lectura: /, /health, /openapi.yaml, /llms.txt, /v1/tools.

📁 Estructura del proyecto

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

Licencia

MIT