Jina Reader

@pipeworx/jina-reader

Jina AI Readerを使って、あらゆるURLをLLM向けのクリーンなMarkdownに変換し、ウェブ検索も実行します。

Pipeworxの一部です。AI エージェントを1882以上のライブデータソースに接続するMCPゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携、承認、公開のいずれもされていません。

ツール

ツール	回答する内容
read_url	ナビゲーション、広告、定型文を除去した、ウェブページの読みやすいコンテンツをMarkdownで返します。
search	検索クエリに対するウェブ検索の上位結果をMarkdownで返します。

認証

Jina APIキーが必要です。 Jinaは匿名利用枠を廃止しました。現在、r.jina.aiとs.jina.aiのどちらも、認証なしのリクエストに対して401 AuthenticationRequiredErrorを返します。このパックは2026年6月にキー不要として公開されましたが、上流プロバイダーではすでにその状況ではありません。

• プラットフォームキー： ゲートウェイが_apiKeyとして注入するPLATFORM_JINA_KEYです。2026-09-01から提供・稼働中です（同日、デプロイ済みゲートウェイでsearchのライブ検証を実施、フリート #719）。呼び出し元が独自のキーを用意する必要はありません。固定トークン枠の無料キーで、月ごとにリセットされないため、想定される最終状態はキーの有効期限切れではなく残高の枯渇です。
• BYO： 呼び出し時に_apiKeyを渡してください。無料キーはhttps://jina.ai/readerで取得できます。

Jinaの401レスポンス本文はそれぞれ異なります。キーの期限切れと決めつける前に確認する価値があります。

本文	意味
AuthenticationRequiredError: Authentication is required to use this endpoint	キーがまったく送信されていません
AuthenticationFailedError: Invalid API key	送信されたキーが間違っているか、取り消されています
AuthenticationRequiredError: … bad network reputation (ASnnnn)	ブロックされたネットワークからの匿名呼び出しです

402は上記のいずれでもありません。キーは有効ですが、トークン残高を使い切っています。このパックはそのことを明示しており、ゲートウェイではplatform_quota_exhaustedとして記録されます。これは購入が必要な状態であり、キーをローテーションする状態でも、Jinaの障害でもありません。2026-09-01より前はこの状態がupstream_downとして扱われており、ベンダー側の障害と誤解される可能性がありました。

データソース

• Reader：https://r.jina.ai/ — https://jina.ai/reader
• Search：https://s.jina.ai/

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

{
  "mcpServers": {
    "jina-reader": {
      "url": "https://gateway.pipeworx.io/jina-reader/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/jina-reader/mcpのtools/listは、上の表にあるツールに加えて、共有Pipeworxメタツール（ask_pipeworx、discover_tools、search_within、remember／recallなど、ゲートウェイ全体で使えるツール一式）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック独自のツールとともに約30個の共有ツールが一覧表示されます。接続のinitializeレスポンスには正確な範囲が記載されており、その日の状況を確認するうえでの確実な情報源です。

これは意図的な設計であり、偶然の多重化ではありません。メタツールを使うと、このパックの対象外の質問にも、カタログ全体を横断してルーティングするask_pipeworxを通じて回答できます。2つ目のMCP サーバーを追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費がルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

または、Pipeworxのフルゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらのURLも、同じゲートウェイと同じ1882以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworxを使えばすべてのツールにアクセスできます。

MCPクライアントがない場合：HTTPで呼び出す

当社のjina-readerキーは有料アカウント向けに確保されています。そのため、POST https://gateway.pipeworx.io/v1/tools/read_urlへの匿名呼び出しには、引数とともに独自のキーを_apiKeyとして渡す必要があります。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/read_urlを呼び出します。ツールを探すには、{"query":"..."}を指定してPOST https://gateway.pipeworx.io/v1/tools/search_packsを呼び出します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行でき、Pipeworx アカウントやゲートウェイとの往復通信は不要です。

{
  "mcpServers": {
    "jina-reader": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-jina-reader"]
    }
  }
}

または、直接実行して起動することを確認できます。

npx -y @pipeworx/mcp-jina-reader

標準入力／標準出力を介して MCP で通信し、initialize／tools/list／tools/call に対して、このパックのツールのみを使って応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールで、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックのエンドポイントでも、完全なゲートウェイでも利用できます。

ask_pipeworx({ question: "your question about Jina Reader data" })

ゲートウェイが適切なツールを選択し、引数を自動的に入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT