WebWatch MCP

🔍 WebWatch MCP

Un servidor de Model Context Protocol (MCP) para monitorear cambios en sitios web. Realiza seguimiento de URLs, detecta cambios de contenido, compara instantáneas y extrae contenido con selectores CSS, todo desde tu asistente de IA.

Características

• Monitoreo de URLs — Supervisa cualquier página web para detectar cambios de contenido
• Selectores CSS — Realiza seguimiento de elementos específicos (precios, titulares, información de acciones)
• Historial de instantáneas — Almacenamiento respaldado por SQLite de cada estado de página
• Detección de diferencias — Observa exactamente qué cambió, línea por línea
• Extracción de contenido — Obtén datos estructurados de cualquier página bajo demanda

Herramientas

Herramienta	Descripción
watch_url	Agrega una URL a la lista de monitoreo con selector CSS opcional y etiqueta
list_watches	Lista todas las URLs monitoreadas con estado y estadísticas
check_now	Obtén una URL ahora, compárala con la instantánea anterior y devuelve las diferencias
get_changes	Explora el historial de cambios de una o todas las URLs monitoreadas
compare_snapshots	Compara dos instantáneas cualesquiera lado a lado
extract_content	Extracción de contenido puntual con selectores CSS

Instalación

# Clone and build
git clone https://github.com/leviai-tools/webwatch-mcp.git
cd webwatch-mcp
npm install
npm run build

# Or install globally
npm install -g @leviai/webwatch-mcp

Uso con Claude Desktop

Agrega a tu claude_desktop_config.json:

{
  "mcpServers": {
    "webwatch": {
      "command": "node",
      "args": ["/path/to/webwatch-mcp/build/index.js"],
      "env": {
        "WEBWATCH_DATA_DIR": "/path/to/data/dir"
      }
    }
  }
}

O si está instalado globalmente:

{
  "mcpServers": {
    "webwatch": {
      "command": "webwatch-mcp"
    }
  }
}

Variables de entorno

Variable	Predeterminado	Descripción
WEBWATCH_DATA_DIR	~/.webwatch-mcp	Directorio para la base de datos SQLite

Ejemplos de flujos de trabajo

Monitorear una página de precios

You: "Watch https://example.com/pricing — track the .pricing-table element"
→ watch_url(url, selector=".pricing-table", label="Example pricing")

You: "Check if pricing changed"
→ check_now("https://example.com/pricing")

Realizar seguimiento de cambios de la competencia

You: "Add these competitor pages to my watchlist"
→ watch_url for each URL

You: "Show me all recent changes"
→ get_changes(limit=20)

Extraer datos bajo demanda

You: "What are the headlines on HN right now?"
→ extract_content("https://news.ycombinator.com", ".titleline > a")

Almacenamiento de datos

Todos los datos se almacenan localmente en SQLite en ~/.webwatch-mcp/webwatch.db (configurable mediante WEBWATCH_DATA_DIR).

Tablas:

• watches — URLs monitoreadas con selectores y etiquetas
• snapshots — Contenido de página capturado en cada verificación
• changes — Diferencias detectadas entre instantáneas consecutivas

Requisitos

• Node.js ≥ 18.0.0

Licencia

MIT