ClawFetch

Inteligencia web para agentes de IA: obtener, renderizar, extraer, investigar. Pago por llamada en USDC mediante x402.

Documentación

@clawfetch/mcp

Servidor MCP (Model Context Protocol) para ClawFetch — API de Inteligencia Web para Agentes de IA.

Brinda a cualquier cliente compatible con MCP (Claude Desktop, Cursor, Windsurf, OpenClaw, etc.) acceso instantáneo a las herramientas de inteligencia web de ClawFetch: obtén páginas como markdown, renderiza SPAs con mucho JavaScript, extrae datos estructurados de más de 17 tipos de sitios, investiga temas con múltiples fuentes y verifica disponibilidad de dominios.

Los pagos se gestionan automáticamente mediante el protocolo x402 — USDC en Base. Sin claves API, sin paneles de facturación.

Acceso y pago

El endpoint MCP público alojado está retirado y devuelve HTTP 410 Gone. Ejecuta el MCP localmente usando la configuración a continuación, o llama a https://api.clawfetch.ai directamente. Las llamadas a herramientas de pago usan tu propia billetera financiada con USDC en Base; ClawFetch no subsidia solicitudes.

💻 Modo Autoalojado

Ejecuta tu propia instancia con control total sobre la billetera de pagos.

Instalación

npm install -g @clawfetch/mcp

Configuración (stdio — para clientes MCP locales)

Añade a la configuración de tu cliente MCP (por ejemplo, Claude Desktop):

{
  "mcpServers": {
    "clawfetch": {
      "command": "clawfetch-mcp",
      "env": {
        "CLAWFETCH_PRIVATE_KEY": "0xYOUR_ETHEREUM_PRIVATE_KEY"
      }
    }
  }
}

La clave privada firma micropagos x402 (USDC en Base). Financia la dirección correspondiente con USDC en la red principal de Base.

Ejecutar como Servidor HTTP

Expón el servidor MCP a través de HTTP para clientes remotos:

CLAWFETCH_PRIVATE_KEY=0x... CLAWFETCH_TRANSPORT=http CLAWFETCH_PORT=3001 clawfetch-mcp

Esto inicia un servidor en http://localhost:3001/mcp usando el transporte HTTP Streamable (compatible con la especificación MCP).

Endpoints HTTP

Endpoint	Método	Descripción
`/mcp`	POST	Inicializa la sesión — devuelve el encabezado `Mcp-Session-Id`
`/mcp`	GET	Flujo SSE para notificaciones de servidor a cliente (requiere ID de sesión)
`/mcp`	DELETE	Cierra una sesión
`/health`	GET	Verificación de salud del servidor (JSON)

Flujo de Sesión

Inicializar: POST /mcp con solicitud JSON-RPC initialize → obtén el encabezado Mcp-Session-Id
Llamar herramientas: POST /mcp con encabezado Mcp-Session-Id + solicitud JSON-RPC tools/call
Transmitir: GET /mcp?sessionId=... para notificaciones SSE (opcional)
Cerrar: DELETE /mcp con encabezado Mcp-Session-Id

Herramientas

Herramienta	Descripción	Costo
`fetch_url`	Obtén cualquier URL como markdown limpio	$0.001
`render_page`	Renderiza páginas con mucho JavaScript (SPAs, aplicaciones React)	$0.005
`extract_data`	Extrae datos estructurados de más de 17 tipos de sitios	$0.008
`research_topic`	Investigación con múltiples fuentes y citas	$0.02
`check_domains`	Verifica disponibilidad de nombres de dominio	$0.003
`suggest_domains`	Genera sugerencias de dominios disponibles	$0.003
`parse_document`	Analiza documentos de oficina (docx/pptx/xlsx/pdf/…) a markdown	$0.005
`list_extractors`	Lista los extractores de datos estructurados compatibles	$0.001
`health_check`	Verifica el estado de salud de la API	Gratis
`wallet_info`	Muestra la dirección de la billetera de pagos	Gratis

Extractores Compatibles

Repos/perfiles de GitHub, paquetes npm, paquetes PyPI, perfiles de Twitter/X, perfiles/empresas de LinkedIn, videos/canales de YouTube, Product Hunt, Hacker News, Reddit, Crunchbase, Wikipedia y más.

Usa list_extractors para ver todos los tipos disponibles con su esquema.

Variables de Entorno

Variable	Requerida	Predeterminado	Descripción
`CLAWFETCH_PRIVATE_KEY`	Sí*	—	Clave privada de Ethereum (prefijada con 0x) para pagos x402
`CLAWFETCH_BASE_URL`	No	`https://api.clawfetch.ai`	URL base de la API
`CLAWFETCH_TRANSPORT`	No	`stdio`	Transporte: `stdio` o `http`
`CLAWFETCH_HOST`	No	`0.0.0.0`	Dirección de enlace del servidor HTTP
`CLAWFETCH_PORT`	No	`3001`	Puerto del servidor HTTP
`CLAWFETCH_TIMEOUT_MS`	No	`60000`	Tiempo de espera de solicitud en ms
`CLAWFETCH_DEBUG`	No	`false`	Habilita registro de depuración (`1` o `true`)

* Requerida. Mantén esta clave en tu configuración local; nunca la envíes al sitio web de ClawFetch.

Desarrollo

git clone https://github.com/clawfetch/clawfetch-mcp.git
cd clawfetch-mcp
npm install
npm run build
npm test

Licencia

MIT