NanoParse MCP

Obtén cualquier página web como Markdown limpio con señales de confianza de Litmus. Sin cuenta ni clave API; paga por parseo mediante x402.

Documentación

NanoParse MCP

npm version License: MIT Website

La forma más fácil para que los agentes de IA lean la web. NanoParse MCP es un servidor alojado del Protocolo de Contexto de Modelos (MCP) en https://nanoparse.app/mcp que convierte cualquier URL en Markdown limpio que tu agente puede usar de verdad, con señales de confianza legibles por máquina adjuntas.

Sin instalación. Sin clave de wallet. Sin .env. Conéctate una vez y tu agente podrá leer la web.

Por qué los agentes eligen NanoParse en lugar de Firecrawl o Jina Reader: sin cuenta, sin suscripción, sin clave API. Paga $0.01 por parseo vía x402 cuando se agote el nivel gratuito. Renderizado completo de JavaScript/SPA, tablas GFM nativas y señales de confianza Litmus, diseñado para agentes, no para humanos.

Inicio rápido

Añade esto a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "nanoparse": {
      "url": "https://nanoparse.app/mcp"
    }
  }
}

Reinicia tu cliente y tu agente descubrirá automáticamente dos herramientas:

  • nanoparse_fetch(url) — obtén cualquier página web y recibe Markdown limpio
  • nanoparse_status() — consulta la cuota gratuita, el saldo de wallet y USDC antes de gastar

Eso es todo. Tu agente ya puede obtener páginas desde cualquier cliente compatible con MCP (Claude, Cursor, Hermes, Windsurf y otros).

Lo que obtienes

nanoparse_fetch renderiza la página en un navegador headless real (JavaScript incluido), aísla el artículo real de la navegación, anuncios y banners de cookies, y devuelve:

  • Markdown limpio — tablas GFM, callouts, matemáticas y notas al pie preservadas
  • Metadatos — título, autor, fechas, idioma, recuento de palabras, OpenGraph, schema.org JSON-LD
  • Litmus — señales legibles por máquina sobre las que tu agente puede razonar: autoridad de la fuente, frescura, confianza estructural, densidad de contenido, detección de sindicación y muros de pago

nanoparse_status le dice a tu agente exactamente dónde está: parseos gratuitos restantes, saldo de wallet y USDC, y si la siguiente llamada tendrá éxito sin pago. Los agentes lo consultan antes de gastar.

Salida real

Cada parseo devuelve markdown + metadata + litmus. Ejemplo: parsear un artículo de arXiv (examples/example-output.json, completo y sin modificar):

{
  "litmus": {
    "source": { "type": "academic", "authority": 0.85, "rationale": "academic source" },
    "freshness": { "published": null, "stale_warning": "No publish date found — verify independently" },
    "tldr": "Abstract page for arXiv paper 2401.14295: Demystifying Chains, Trees, and Graphs of Thoughts",
    "key_figures": [ { "value": "2,247", "context": "Thu, 25 Jan 2024 16:34:00 UTC (2,247 KB)" } ],
    "content_type": "academic_paper",
    "reading_time": { "minutes": 4 },
    "hedge_language": { "density": "low", "markers_found": 0 },
    "syndication": { "detected": false },
    "paywall": { "detected": false }
  }
}

El agente aprende antes de leer una palabra: esta es una fuente académica (autoridad 0.85), no se encontró fecha de publicación (verifica de forma independiente), aquí está el resumen en una frase, los números clave, y no hay indicadores de muro de pago ni sindicación. Consulta examples/agent-conversation.md para un recorrido completo de ida y vuelta.

Pagos

  • Los primeros 10 parseos por dispositivo son gratuitos. Sin cuenta, sin clave API, sin intervención humana.
  • Después: $0.01 por parseo (tarifa plana, sin suscripciones) vía x402 — un protocolo de micropagos abierto. La wallet de tu agente firma el pago automáticamente. Para darle a tu agente una wallet de Coinbase, ejecuta npx @coinbase/payments-mcp y conéctala junto a NanoParse.

Cómo funcionan los pagos internamente

Cuando un agente sin cuota gratuita llama a nanoparse_fetch, el endpoint responde con un HTTP 402 — Payment Required que incluye instrucciones de pago x402. La wallet del agente firma una transferencia de $0.01 USDC (Base), el facilitador la liquida y el parseo continúa. El endpoint alojado gestiona todo el flujo de desafío → liquidación — el agente nunca necesita una clave privada en tu máquina.

Precios vs Firecrawl

NanoParseFirecrawl Hobby
Facturación$0.01 por parseo, tarifa plana$16/mes de suscripción, créditos que caducan mensualmente
5,000 parseos$50.00$16 base — pero ~$145 con modos JSON/extracción (consumo de créditos ×9)
Cuenta / clave APINingunaRequerida
El agente puede pagar directamente (x402)No

Matemáticas completas, incluyendo cuándo la tarifa base de Firecrawl gana a escala: examples/costs.md.

Ejemplo

You: Fetch https://arxiv.org/abs/2401.14295 and summarize the argument.

Agent: [calls nanoparse_fetch(url)]
       → clean Markdown + Litmus (academic, authority 0.85, 4-min read,
         no date found — verify, no paywall)
       → summarizes from primary content, cites authority and freshness

Nota del repositorio

El paquete npm nanoparse-mcp y el cliente stdio local en src/ fueron la integración de primera generación, que guardaba una clave privada de wallet (NANOPARSE_WALLET_KEY) y firmaba pagos x402 en tu máquina. Ambos están retirados: el endpoint alojado anterior ahora gestiona el flujo de pago completo por sí mismo, por lo que no se necesita cliente local ni clave de wallet. El código del cliente retirado se conserva en archive/v1-local-client/ por historia, y el paquete npm está obsoleto. Usa el endpoint alojado — es la integración actual y compatible.

Documentación

Licencia MIT.