NanoParse

NanoParse MCP

AI エージェントがウェブを読むための最も簡単な方法です。 NanoParse MCP は、https://nanoparse.app/mcp でホストされている Model Context Protocol サーバーです。あらゆる URL を、エージェントが実際に活用できるクリーンな Markdown に変換し、機械可読な信頼性シグナルを付加します。

インストール不要。ウォレットキー不要。.env 不要。一度接続すれば、エージェントはウェブを読めるようになります。

エージェントが Firecrawl や Jina Reader ではなく NanoParse を選ぶ理由： すべてのページに Litmus が付属します。エージェントがページを一言も読む前に、そのページを信頼して引用すべきかどうかを判断できる、20 個の機械可読なシグナルです。無料枠を使い切った後は、解析 1 回につき $0.005 を x402 経由で支払います。完全な JavaScript／SPA レンダリングとネイティブ GFM テーブルに対応しています。アカウント、サブスクリプション、API キーは不要です。

クイックスタート

次の設定を MCP クライアントの設定に追加します。

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

クライアントを再起動すると、エージェントが 2 つのツールを自動検出します。

• nanoparse_fetch(url) — 任意のウェブページを取得し、クリーンな Markdown を返します
• nanoparse_status() — 支払いの前に、無料枠、ウォレット、USDC 残高を確認します

これで完了です。これでエージェントは、MCP 対応クライアント（Claude、Cursor、Hermes、Windsurf など）からページを取得できるようになります。

利用できる機能

nanoparse_fetch は実際のヘッドレスブラウザーでページをレンダリングし（JavaScript もすべて処理します）、ナビゲーション、広告、Cookie バナーを除いて記事本文を抽出し、次の情報を返します。

• クリーンな Markdown — GFM テーブル、コールアウト、数式、脚注を保持します
• メタデータ — タイトル、著者、日付、言語、単語数、OpenGraph、schema.org JSON-LD
• Litmus — エージェントが推論に利用できる機械可読なシグナル：ソースの権威性、新しさ、構造上の信頼性、コンテンツ密度、シンジケーションとペイウォールの検出

nanoparse_status は、エージェントに現在の状況を正確に伝えます。残りの無料解析回数、ウォレットと USDC 残高、次の呼び出しが支払いなしで成功するかどうかを確認できます。エージェントは支払いの前にこれを呼び出します。

実際の出力

すべての解析で 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" }
  }
}

エージェントは一言も読む前に、これが学術的なソース（権威性 0.85）であり、構造上の信頼性は 中程度 — 権威性は高いものの、公開日が見つからなかったため、独自に確認する必要がある — と判断できます。さらに、一文の要約、重要な数値、ペイウォールやシンジケーションのフラグがないことも確認できます。実際の一連のやり取りについては、examples/agent-conversation.md をご覧ください。

支払い

• 署名済みウォレットで毎月 10 回まで無料で解析できます（請求メッセージに署名するだけで、支払いは不要です）。または、ネットワークごとに匿名で 3 回まで無料で試せます。アカウント、API キー、人の操作は不要です。
• 無料枠を使い切った後は、解析 1 回につき $0.005（定額、サブスクリプションなし）を、オープンなマイクロペイメントプロトコルの x402 経由で支払います。エージェントのウォレットが自動的に支払いに署名します。エージェントに Coinbase ウォレットを使わせるには、npx @coinbase/payments-mcp を実行し、NanoParse と併せて接続します。

どちらの方法にも使えるコピー＆ペースト用の手順を用意しています。コード不要のウォレット MCP を使う方法と、約 40 行の REST クライアントを使う方法を掲載しています。正確な 402 → sign → retry の処理手順と、分岐処理に使えるエラーコードも含まれています：examples/pay-with-x402.md。

決済の仕組み

無料枠のないエージェントがnanoparse_fetchを呼び出すと、エンドポイントはx402の決済指示を含むHTTP 402 — Payment Requiredを返します。エージェントのウォレットが$0.005のUSDC（Base）送金に署名し、ファシリテーターが決済を処理すると、解析が続行されます。ホスト型エンドポイントがチャレンジから決済完了までのフロー全体を処理するため、エージェントがマシン上の秘密鍵を必要とすることはありません。

Firecrawlとの料金比較

	NanoParse	Firecrawl Hobby
料金体系	解析1回あたり一律$0.005	月額$16のサブスクリプション。クレジットは毎月失効します
解析5,000回	$25.00	基本料金は$16。ただし、JSON／抽出モードでは約$145（クレジット消費量が9倍）
アカウント／APIキー	不要	必須
エージェントによる直接決済（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ライセンスです。