Jina Reader

@pipeworx/jina-reader

通过 Jina AI Reader，将任意 URL 转换为简洁、适合大模型处理的 Markdown，并支持网页搜索。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1882+ 个实时数据源的 MCP 网关。这是独立的非官方集成，与上游提供方无关联、未经其认可，也未由其发布。

工具

工具	可回答的问题
read_url	网页的可读内容，以 Markdown 格式返回，并剔除导航、广告和模板内容。
search	查询的网页搜索结果，以 Markdown 格式返回。

身份验证

需要 Jina API 密钥。 Jina 已停止匿名服务层级——现在，r.jina.ai 和 s.jina.ai 都会对未经身份验证的请求返回 401 AuthenticationRequiredError。该工具包于 2026 年 6 月发布时无需密钥，但上游现在已不再如此。

• 平台密钥： PLATFORM_JINA_KEY，由网关作为 _apiKey 注入。自 2026-09-01 起已配置并启用（当天已通过部署的网关验证 search，fleet #719），调用方无需自备密钥。这是额度固定的免费密钥，不会按月重置，因此预期的最终状态是额度耗尽，而不是密钥过期。
• 自带密钥： 在调用时传入 _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 不属于上述任何一种情况：密钥有效，但 Token 额度已用完。该工具包会明确说明这一点，网关则将其记录为 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 跨整个目录路由——因此你不必再添加第二个 MCP 服务。目前无法挂载不含这些工具的工具包端点；如果额外的架构定义占用的上下文多于路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是此工具包的工具：

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

两个 URL 都连接到同一个网关和同样的 1882+ 个数据源。唯一的区别是，直接列出的是哪个工具包的工具；无论连接哪个 URL，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。

独立运行（无需 gateway 账号）

此软件包也可作为本地 stdio MCP 服务运行，无需 Pipeworx 账号，也无需经过网关往返：

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

或者直接运行，确认它可以启动：

npx -y @pipeworx/mcp-jina-reader

它通过 stdin/stdout 使用 MCP 通信，并响应 initialize/tools/list/tools/call，仅提供此软件包中的工具，不包含上方网关连接额外提供的任何共享元工具。使用相同的源代码和工具，无需 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗的英语提问，而不是直接调用工具——这既适用于上方的软件包端点，也适用于完整网关：

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

网关会选择合适的工具并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT