NanoParse MCP

Busque qualquer página da web para obter Markdown limpo com sinais de confiança da Litmus. Sem conta ou chave de API; pague por parse via x402.

Documentação

NanoParse MCP

npm version License: MIT Website

A maneira mais fácil de agentes de IA lerem a web. NanoParse MCP é um servidor hospedado do Model Context Protocol em https://nanoparse.app/mcp que transforma qualquer URL em Markdown limpo que seu agente pode realmente usar — com sinais de confiança legíveis por máquina anexados.

Sem instalação. Sem chave de carteira. Sem .env. Conecte-se uma vez e seu agente poderá ler a web.

Por que agentes escolhem NanoParse em vez de Firecrawl ou Jina Reader: sem conta, sem assinatura, sem chave de API. Pague $0,01 por parse via x402 quando o nível gratuito acabar. Renderização completa de JavaScript/SPA, tabelas GFM nativas e sinais de confiança Litmus — construído para agentes, não para humanos.

Início rápido

Adicione isto à configuração do seu cliente MCP:

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

Reinicie seu cliente, e seu agente descobrirá automaticamente duas ferramentas:

  • nanoparse_fetch(url) — busque qualquer página da web e receba Markdown limpo de volta
  • nanoparse_status() — verifique a cota gratuita, saldo da carteira e USDC antes de gastar

É isso. Seu agente agora pode buscar páginas de dentro de qualquer cliente compatível com MCP (Claude, Cursor, Hermes, Windsurf e outros).

O que você obtém

nanoparse_fetch renderiza a página em um navegador headless real (JavaScript e tudo), isola o artigo real de navegação, anúncios e banners de cookies, e retorna:

  • Markdown limpo — tabelas GFM, callouts, matemática e notas de rodapé preservadas
  • Metadados — título, autor, datas, idioma, contagem de palavras, OpenGraph, schema.org JSON-LD
  • Litmus — sinais legíveis por máquina que seu agente pode raciocinar: autoridade da fonte, frescor, confiança estrutural, densidade de conteúdo, detecção de sindicalização e paywall

nanoparse_status diz ao seu agente exatamente onde ele está: parses gratuitos restantes, saldo da carteira e USDC, e se a próxima chamada terá sucesso sem pagamento. Agentes o chamam antes de gastar.

Saída real

Cada parse retorna markdown + metadata + litmus. Exemplo — parse de um artigo arXiv (examples/example-output.json, completo e sem modificações):

{
  "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 }
  }
}

O agente aprende antes de ler uma palavra: esta é uma fonte acadêmica (0,85 de autoridade), nenhuma data de publicação foi encontrada (verifique de forma independente), aqui está o resumo de uma frase, os números-chave, e não há flag de paywall ou sindicalização. Veja examples/agent-conversation.md para um round-trip completo trabalhado.

Pagamentos

  • Os primeiros 10 parses por dispositivo são gratuitos. Sem conta, sem chave de API, sem humano necessário.
  • Depois disso: $0,01 por parse (fixo, sem assinaturas) via x402 — um protocolo aberto de micropagamento. A carteira do seu agente assina o pagamento automaticamente. Para dar ao seu agente uma carteira Coinbase, execute npx @coinbase/payments-mcp e conecte-a junto com NanoParse.

Como os pagamentos funcionam nos bastidores

Quando um agente sem cota gratuita chama nanoparse_fetch, o endpoint responde com um HTTP 402 — Payment Required carregando instruções de pagamento x402. A carteira do agente assina uma transferência de $0,01 USDC (Base), o facilitador a liquida, e o parse prossegue. O endpoint hospedado lida com todo o fluxo de desafio → liquidação — o agente nunca precisa de uma chave privada na sua máquina.

Preços vs Firecrawl

NanoParseFirecrawl Hobby
Cobrança$0,01 por parse, fixo$16/mês de assinatura, créditos expiram mensalmente
5.000 parses$50,00$16 base — mas ~$145 com modos JSON/extração (queima de crédito 9×)
Conta / chave de APINenhumaNecessária
Agente pode pagar diretamente (x402)SimNão

Matemática completa, incluindo quando a taxa base do Firecrawl vence em escala: examples/costs.md.

Exemplo

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 do repositório

O pacote npm nanoparse-mcp e o cliente stdio local em src/ foram a integração de primeira geração, que mantinha uma chave privada de carteira (NANOPARSE_WALLET_KEY) e assinava pagamentos x402 na sua máquina. Ambos estão aposentados: o endpoint hospedado acima agora lida com o fluxo completo de pagamento em si, então nenhum cliente local ou chave de carteira é necessário. O código do cliente aposentado está preservado em archive/v1-local-client/ para histórico, e o pacote npm está obsoleto. Use o endpoint hospedado — ele é a integração atual e suportada.

Documentação

Licenciado sob MIT.