NanoParse

NanoParse MCP

让 AI Agent 轻松读取网页。 NanoParse MCP 是一个托管的 Model Context Protocol 服务，地址为 https://nanoparse.app/mcp，可将任意 URL 转换为 Agent 能实际使用的整洁 Markdown，并附上机器可读的可信度信号。

无需安装。无需钱包密钥。无需 .env。连接一次，Agent 就能读取网页。

**Agent 为何选择 NanoParse，而非 Firecrawl 或 Jina Reader：**每个页面都会附带 Litmus——20 个机器可读信号，让 Agent 在阅读任何内容之前就能判断是否应信任并引用该页面。免费额度用完后，可通过 x402 按每次解析 $0.005 付费。支持完整 JavaScript/SPA 渲染和原生 GFM 表格。无需账户、订阅或 API 密钥。

快速开始

将以下内容添加到 MCP 客户端配置中：

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

重启客户端后，Agent 会自动发现两个工具：

• nanoparse_fetch(url) — 获取任意网页并返回整洁的 Markdown
• nanoparse_status() — 在付费前检查免费额度、钱包和 USDC 余额

就这么简单。现在，Agent 可以在任何兼容 MCP 的客户端（Claude、Cursor、Hermes、Windsurf 等）中获取网页。

你将获得

nanoparse_fetch 会在真实的无头浏览器中渲染页面（包括 JavaScript），从导航栏、广告和 Cookie 横幅中分离出正文，并返回：

• 整洁的 Markdown — 保留 GFM 表格、提示框、数学公式和脚注
• 元数据 — 标题、作者、日期、语言、字数、OpenGraph、schema.org JSON-LD
• Litmus — Agent 可据此进行推理的机器可读信号：来源权威性、时效性、结构可信度、内容密度、联合发布及付费墙检测

nanoparse_status 会准确告知 Agent 当前状态：剩余免费解析次数、钱包和 USDC 余额，以及下一次调用能否免付费成功。Agent 会在付费前调用它。

实际输出

每次解析都会返回 markdown + metadata + litmus。以下是实际解析一篇 arXiv 论文得到的完整 litmus 对象（examples/example-output.json 中的 Markdown 已截断，Litmus 内容完整且未经修改）：

{
  "litmus": {
    "source": { "type": "academic", "authority": 0.85, "rationale": "academic source" },
    "freshness": { "published": null, "age": "unknown", "stale_warning": "No publish date found — verify independently", "modified": null, "has_correction": false, "correction_note": null },
    "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)" } ],
    "structural_trust_score": { "level": "medium", "trust_factors": ["High-authority source", "No publish date found — verify independently"] },
    "hedge_language": { "density": "low", "markers_found": 0, "per_500_words": 0 },
    "content_density": { "thin_content": false, "substantive_sentence_ratio": 0.76 },
    "syndication": { "detected": false, "note": null },
    "paywall": { "detected": false, "note": null },
    "content_type": "academic_paper",
    "reading_time": { "minutes": 4 },
    "is_archived": { "archive_org": true, "archive_is": false },
    "outbound_authority": { "score": 0.54, "top_domains": ["ui.adsabs.harvard.edu", "scholar.google.com"] },
    "boilerplate_ratio": { "ratio": 0.08, "confidence": "high" }
  }
}

Agent 在阅读任何内容之前就能获知：这是一个学术来源（权威性为 0.85），结构可信度为中等——权威性较高，但未找到发布日期，因此需要独立核实。Agent 还能获得一句话摘要、关键数据，以及确认不存在付费墙或联合发布标记。完整的实际交互过程请参见 examples/agent-conversation.md。

付款

• 使用已签名钱包，每月可免费解析 10 次（签署申领消息即可，无需付款），或者每个网络可匿名免费试用 3 次。无需账户、API 密钥或人工参与。
• 之后：每次解析 $0.005（固定价格，无订阅），通过 x402——一种开放的微支付协议完成。Agent 的钱包会自动签署付款。若要为 Agent 提供 Coinbase 钱包，请运行 npx @coinbase/payments-mcp，并将其与 NanoParse 一并连接。

两种方式的复制粘贴教程——一种是无需编写代码的钱包 MCP 方式，另一种是约 40 行的 REST 客户端——包含准确的 402 → sign → retry 循环，以及值得据此分支处理的错误代码：examples/pay-with-x402.md。

支付机制详解

当没有免费额度的 Agent 调用 nanoparse_fetch 时，端点会返回 HTTP 402 — Payment Required，并附带 x402 支付指令。Agent 的钱包会签署一笔 0.005 美元的 USDC（Base）转账，由支付协调方完成结算，然后继续解析。托管端点会处理整个挑战 → 结算流程，Agent 无需使用你机器上的私钥。

与 Firecrawl 的定价对比

	NanoParse	Firecrawl Hobby
计费方式	每次解析固定收费 0.005 美元	每月订阅 16 美元，额度每月过期
5,000 次解析	25.00 美元	基础费用 16 美元；但使用 JSON／提取模式时约为 145 美元（额度消耗量为 9 倍）
账户／API 密钥	无需	必需
Agent 可直接支付（x402）	是	否

完整计算过程，包括 Firecrawl 的基础费率何时能在大规模使用时更划算：examples/costs.md。

示例

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

仓库说明

nanoparse-mcp npm 包和本地 stdio 客户端是第一代集成方案，它会在你的机器上保存钱包私钥（NANOPARSE_WALLET_KEY）并签署 x402 支付。二者均已停止使用：上述托管端点现在会自行处理完整支付流程，因此无需本地客户端或钱包密钥。已弃用的客户端代码保存在 archive/v1-local-client/ 中，以供查阅历史记录；npm 包也已弃用。请使用托管端点——这是当前受支持的集成方式。

文档

• 快速入门与集成：nanoparse.app/quickstart
• 对比与定价：nanoparse.app/compare
• API + MCP 端点：nanoparse.app
• 安全策略：SECURITY.md — 如发现漏洞，请发送邮件至 [email protected] 报告 （也发布于 https://nanoparse.app/.well-known/security.txt）

采用 MIT 许可。