Web2Actions

Verwandeln Sie eine Website in einen MCP-Server, den Ihr KI-Agent nutzen kann – ganz ohne API.

Web2Actions beobachtet den Browserverkehr einer Website, rekonstruiert die tatsächlichen Netzwerk-Endpunkte der Site und verpackt sie in einen sauberen Satz benannter Tools, die Ihr KI-Agent über Model Context Protocol (MCP) aufrufen kann. Keine öffentliche API erforderlich.

So funktioniert es

1. Erfassen – Melden Sie sich einmal auf einer Website an; der Browserverkehr wird aufgezeichnet.

2. Generieren – Ein LLM wandelt den erfassten Verkehr in eine Connector-Definition um: saubere benannte Tools mit Eingaben, Ausgaben und Risiko-Tags.

3. Validieren – Jedes Tool wird gegen die Live-Website getestet.

4. Bereitstellen – Der validierte Connector wird als standardmäßiger MCP-Server bereitgestellt.

Die Erfassung ist menschlich gesteuert, nicht automatisch. Wir raten nicht jeden Button und klicken nicht für Sie auf der Website. Ein echtes Browserfenster öffnet sich auf Ihrem Rechner; Sie melden sich an und führen die Aktionen aus, die Sie in Tools verwandeln möchten, und wir zeichnen diesen Verkehr auf. Dieselbe Philosophie gilt im gehosteten Produkt – es ist ein Popup-Browser, den Sie steuern. Die CLI führt diesen Browser nur für Sie aus.

Related MCP server: Clarity MCP Server

Installation

pip install -e .

Befehle

Jeder Befehl ist web2actions <befehl> [optionen].

model – LLM-Anbieter und Modell wählen (gespeichert)

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 – Datenverkehr einer Website aufzeichnen

Öffnet einen Browser zur URL, zeichnet den Netzwerkverkehr auf, den Sie beim Anmelden und Klicken erzeugen, und schreibt dann einen JSON-Dump.

# 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"

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

generate – erfassten Verkehr in eine Connector-Definition verwandeln

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

Optionen: --model (oder WEB2ACTIONS_MODEL-Umgebungsvariable), --output/-o.

validate – Connector gegen das Schema prüfen

web2actions validate connector.json
# -> VALID

serve – Connector als MCP-Server bereitstellen (stdio)

web2actions serve connector.json

Verbindet den Connector über stdio mit dem MCP-Client Ihres KI-Agenten.

End-to-End-Beispiel

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

Mit einem vorhandenen Beispiel starten (keine Erfassung nötig)

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

Eigene LLM mitbringen (BYOK)

Web2Actions verwendet litellm, das über eine OpenAI-kompatible Schnittstelle mit über 100 Anbietern verbindet. Sie wählen einen Anbieter und ein Modell mit einfachen Befehlen – keine Codeänderungen, und die Auswahl wird für zukünftige Läufe gespeichert.

Unterstützte Anbieter

litellm unterstützt über 100 Anbieter, darunter OpenAI, Anthropic, Google Gemini, OpenRouter, DeepSeek, Groq, xAI, Mistral, OpenAI-kompatible lokale Server (Ollama / llama.cpp / vLLM), Bedrock, Azure und mehr.

Jeder Anbieter liest seine Standard-API-Schlüssel-Umgebungsvariable (z. B. OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY, OPENROUTER_API_KEY, DEEPSEEK_API_KEY, GROQ_API_KEY, XAI_API_KEY) oder benötigt bei lokalen Servern gar keinen Schlüssel.

Standardmodell mit einem einfachen Befehl festlegen

# 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

Sobald festgelegt, verwendet generate dieses Modell automatisch:

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

Pro Lauf überschreiben

Übergeben Sie --model, um für einen einzelnen Befehl einen anderen Anbieter/ein anderes Modell zu verwenden, oder setzen Sie die Umgebungsvariable WEB2ACTIONS_MODEL. Priorität: --model > WEB2ACTIONS_MODEL > gespeicherte Konfiguration.

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

Wenn kein Schlüssel gesetzt ist

generate schlägt elegant fehl und teilt Ihnen mit, welchen Schlüssel Sie setzen müssen – es stürzt nie mit einem rohen Stack-Trace ab.

Repository-Struktur

• connector-spec/ – die Connector-Definitionsschema + Validator

• capture/ – Browsersitzung + Verkehrsaufzeichnung + Rauschfilterung

• generate/ – LLM-Extraktion (günstiger Pfad) + Sandbox-Fallback

• validate/ – Live-Tool-Smoke-Tests + Risiko-Tagging

• mcp-runtime/ – der gemeinsame MCP-Server, der jeden Connector bedient

• cli/ – der web2actions-Kommandozeilen-Wrapper

Lizenz

Apache-2.0. Basierend auf den Open-Source-Projekten CLI-Anything / CLI-Anything-Web.