Web2Actions

Convierte un sitio web en un servidor MCP que tu agente de IA puede usar — sin necesidad de API.

Web2Actions observa el tráfico del navegador de un sitio web, ingenia la ingeniería inversa de los endpoints de red reales del sitio y los empaqueta en un conjunto limpio de herramientas con nombre que tu agente de IA puede llamar mediante Model Context Protocol (MCP). No se requiere API pública.

Cómo funciona

1. Captura — inicia sesión en un sitio una vez; se registra el tráfico del navegador.

2. Genera — un LLM convierte el tráfico capturado en una definición de conector: herramientas limpias con nombre, entradas, salidas y etiquetas de riesgo.

3. Valida — cada herramienta se prueba con humo contra el sitio en vivo.

4. Sirve — el conector validado se expone como un servidor MCP estándar.

La captura es impulsada por humanos, no automática. No adivinamos cada botón ni hacemos clic en el sitio por ti. Se abre un navegador real en tu máquina; tú inicias sesión y realizas las acciones que quieres convertir en herramientas, y nosotros registramos ese tráfico. La misma filosofía se aplica en el producto alojado: es un navegador emergente que tú controlas. La CLI solo ejecuta ese navegador por ti.

Related MCP server: Clarity MCP Server

Instalar

pip install -e .

Comandos

Cada comando es web2actions <comando> [opciones].

model — elige tu proveedor y modelo de LLM (persistido)

web2actions model                       # show current
web2actions model google/gemini-2.5-flash   # set default model (persisted)
web2actions model --provider openrouter # set default provider
web2actions model --alias sonnet=anthropic/claude-sonnet-4  # alias
web2actions model --aliases             # list aliases

capture — registra el tráfico de un sitio

Abre un navegador en la URL, registra el tráfico de red que generas mientras inicias sesión y haces clic, y luego escribe un volcado JSON.

# Open the site; log in and click around manually; press Enter when done.
web2actions capture https://app.example.com

# Filter out analytics/static noise and save to a chosen file.
web2actions capture https://app.example.com --filter -o dump.json

# Automate a simple form login (fill + submit), then continue capturing.
web2actions capture https://app.example.com --login \
  --username you@example.com --password "..." \
  --username-selector "#username" --password-selector "#password" \
  --submit-selector "#submit-btn" --success-indicator "#dashboard"

Opciones: --login, --username, --password, --username-selector, --password-selector, --submit-selector, --success-indicator, --filter, --output/-o.

generate — convierte el tráfico capturado en una definición de conector

web2actions generate dump.json --model claude-sonnet-4 -o connector.json

Opciones: --model (o variable de entorno WEB2ACTIONS_MODEL), --output/-o.

validate — verifica un conector contra el esquema

web2actions validate connector.json
# -> VALID

serve — expone un conector como servidor MCP (stdio)

web2actions serve connector.json

Conecta el conector al cliente MCP de tu agente de IA a través de stdio.

Ejemplo de extremo a extremo

web2actions capture https://example.com --filter -o dump.json
web2actions generate dump.json --model claude-sonnet-4 -o connector.json
web2actions validate connector.json
web2actions serve connector.json

Comienza desde un ejemplo existente (sin necesidad de captura)

web2actions validate connector-spec/examples/simple-crm.json
web2actions serve connector-spec/examples/simple-crm.json

Trae tu propio LLM (BYOK)

Web2Actions usa litellm, que se conecta a más de 100 proveedores a través de una interfaz compatible con OpenAI. Eliges un proveedor y un modelo con comandos simples — sin cambios de código, y la elección se recuerda para futuras ejecuciones.

Proveedores compatibles

litellm admite más de 100 proveedores, incluyendo OpenAI, Anthropic, Google Gemini, OpenRouter, DeepSeek, Groq, xAI, Mistral, servidores locales compatibles con OpenAI (Ollama / llama.cpp / vLLM), Bedrock, Azure, y más.

Cada proveedor lee su variable de entorno estándar de clave de API (por ejemplo OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY, OPENROUTER_API_KEY, DEEPSEEK_API_KEY, GROQ_API_KEY, XAI_API_KEY) o, para servidores locales, no necesita clave en absoluto.

Establece el modelo predeterminado con un comando simple

# Pick a provider + model once; it is remembered (saved to ~/.web2actions/config.toml)
web2actions model openai/gpt-4o-mini
web2actions model anthropic/claude-sonnet-4
web2actions model gemini/gemini-2.5-flash
web2actions model openrouter/anthropic/claude-sonnet-4
web2actions model deepseek/deepseek-chat

# Show the current model
web2actions model

# Set a default provider
web2actions model --provider openrouter

# Add a short alias, then use it anywhere
web2actions model --alias sonnet=anthropic/claude-sonnet-4
web2actions generate dump.json --model sonnet

# List your aliases
web2actions model --aliases

Una vez establecido, generate usa ese modelo automáticamente:

web2actions model google/gemini-2.5-flash
export GEMINI_API_KEY=...            # only needed the first time, per provider
web2actions generate dump.json       # uses gemini-2.5-flash

Anular por ejecución

Pasa --model para usar un proveedor/modelo diferente para un solo comando, o establece la variable de entorno WEB2ACTIONS_MODEL. Precedencia: --model > WEB2ACTIONS_MODEL > configuración guardada.

web2actions generate dump.json --model openai/gpt-4o-mini

Si no se establece ninguna clave

generate falla de manera elegante y te dice qué clave establecer — nunca se bloquea con un rastro de pila sin procesar.

Estructura del repositorio

• connector-spec/ — el esquema de definición de conector + validador

• capture/ — sesión de navegador + registro de tráfico + filtrado de ruido

• generate/ — extracción con LLM (ruta económica) + respaldo en sandbox

• validate/ — pruebas de humo de herramientas en vivo + etiquetado de riesgo

• mcp-runtime/ — el servidor MCP compartido que sirve cualquier conector

• cli/ — el envoltorio de línea de comandos web2actions

Licencia

Apache-2.0. Construido sobre los proyectos de código abierto CLI-Anything / CLI-Anything-Web.