PacketStream

PacketStream MCP 服务：为 AI Agent 提供实时网页搜索和 Markdown 格式的网页

PacketStream 运行一个托管的 Model Context Protocol（MCP）服务，为 AI Agent 和大模型应用提供两种 Web 工具。packetstream_search 会在全球使用最广泛的搜索引擎上执行实时搜索，并以 Markdown 和 JSON 格式返回结果。packetstream_fetch 会通过 PacketStream 的住宅网络获取网页，并以 Markdown 格式返回网页内容本身，而不是摘要。可将其连接到 Claude Code、Codex、Cursor、Gemini CLI、VS Code、Claude Desktop、Cline，或任何支持远程服务的其他 MCP 客户端。每次成功调用的费用为 $0.0025（每 1,000 次 $2.50），从预付余额中扣除，无需订阅；请参阅定价。

此仓库包含 Claude Code、Codex、Cursor 和 Gemini CLI 的插件与扩展文件。服务运行在 PacketStream 上，因此无需自行托管。为客户端安装插件，或让任意 MCP 客户端连接到服务 URL。

完整文档：https://packetstream.io/docs/mcp/

工具：网页搜索和页面抓取

工具	功能
packetstream_search	执行实时网页搜索，并以 Markdown 格式返回结果，同时将 JSON 响应作为结构化内容返回。你可以设置国家/地区、语言、位置、设备、页码和时间范围。结果类型：search、news、shopping、places、autocomplete、scholar 和 ai_mode。
packetstream_fetch	读取一个公开的 http 或 https 页面，并以 Markdown 格式返回页面内容，而不是摘要，同时提供最终 URL、HTTP 状态和标题。请求通过 PacketStream 的住宅网络发送。

这两种工具都只读取内容。除了每次成功调用的费用外，它们不会更改你的电脑或 PacketStream 账户中的任何内容。

关于 packetstream_fetch，请注意：

• 它只读取静态 HTML。需要 JavaScript 的页面会返回错误。
• 默认最多返回 40,000 个字符。若页面较长，Agent 会从下一个字符开始再次调用。
• 它不会读取 robots.txt。你可以决定 Agent 读取哪些网站，并需取得法律、合同或网站运营方要求的任何许可。请参阅服务条款第 7 节。
• 它会将网页文本标记为不可信内容，让 Agent 将其视为数据，而非指令。

MCP 参考文档列出了所有参数和结果格式。如果你想从自己的代码中调用 REST Search API 和 Fetch API，也可以使用同一个 API 密钥。

服务 URL

有两个 URL。两者提供相同的工具，价格也相同。请使用客户端的 Streamable HTTP 传输方式。

URL	连接方式
https://api.packetstream.io/v1/mcp/oauth	使用 PacketStream 账户登录。客户端会在浏览器中打开 PacketStream 页面，你选择允许即可。无需将密钥写入配置文件。
https://api.packetstream.io/v1/mcp	使用 API 密钥，通过 Authorization: Bearer YOUR_API_KEY 发送。适用于允许你设置请求头的客户端。

此仓库中的插件使用登录 URL。

开始之前

1. 注册并为余额充值。
2. 如果客户端使用 API 密钥，请在控制面板的 MCP 页面创建一个密钥。密钥只会显示一次，请在其出现时复制。

安装插件或连接客户端

Claude Code

claude plugin marketplace add packetstream/packetstream-mcp
claude plugin install packetstream@packetstream

对于 Claude Code 2.1.275 或更高版本，你可以在 Claude Code 中一步完成这两项操作：

/plugin install packetstream --marketplace packetstream/packetstream-mcp

然后运行 /mcp，选择 packetstream 并登录。

Codex

codex plugin marketplace add packetstream/packetstream-mcp
codex plugin add packetstream@packetstream
codex mcp login packetstream

最后一条命令会在浏览器中打开登录页面。

Cursor

如果 Cursor Marketplace 中列出了 PacketStream，请在那里安装，并在 Cursor 提示时登录。要手动设置，请将以下内容添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "packetstream": {
      "url": "https://api.packetstream.io/v1/mcp/oauth"
    }
  }
}

Gemini CLI

gemini extensions install https://github.com/packetstream/packetstream-mcp

然后启动 Gemini CLI，并运行 /mcp auth packetstream 登录。

VS Code

将以下内容添加到工作区中的 .vscode/mcp.json，或者运行 MCP: Open User Configuration，为所有工作区添加配置。VS Code 会提示你输入一次 API 密钥，并安全地保存：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "packetstream-api-key",
      "description": "PacketStream API key",
      "password": true
    }
  ],
  "servers": {
    "packetstream": {
      "type": "http",
      "url": "https://api.packetstream.io/v1/mcp",
      "headers": { "Authorization": "Bearer ${input:packetstream-api-key}" }
    }
  }
}

Claude 和 Claude Desktop

将 PacketStream 添加为自定义连接器。它会使用你的 PacketStream 账户登录，因此无需密钥：

1. 在 Claude 中，打开 Customize > Connectors，选择 + Add，然后选择 Add custom connector。
2. 将其命名为 PacketStream，并输入 https://api.packetstream.io/v1/mcp/oauth 作为服务 URL。
3. Claude 会在浏览器中打开 PacketStream。登录并选择 Allow。
4. 在聊天中，点击 + 按钮，在 Connectors 下启用 PacketStream。

对于 Team 和 Enterprise 计划，需要由所有者先添加连接器；请参阅 Claude 自定义连接器。连接器关联到你的 Claude 账户，因此 Claude Desktop 也可以使用它。若要改用 API 密钥在 Claude Desktop 中使用，请按照 Claude Desktop 设置操作。

Cline

除非设置传输方式，否则 Cline 使用 SSE，因此请在其 MCP 设置中的服务配置里添加 "type": "streamableHttp"：

{
  "mcpServers": {
    "packetstream": {
      "type": "streamableHttp",
      "url": "https://api.packetstream.io/v1/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

其他 MCP 客户端

任何支持远程 Streamable HTTP 服务的客户端都可以连接。将 API 密钥放在 Authorization 标头中，发送至 https://api.packetstream.io/v1/mcp；如果客户端支持 MCP 登录（OAuth），例如 ChatGPT，则可使用 https://api.packetstream.io/v1/mcp/oauth。我们尚未测试 ChatGPT。如果客户端只能运行本地（stdio）服务，请使用 mcp-remote bridge。客户端设置提供了各客户端的配置和故障排除指南。

我们测试过的内容

我们使用 Claude 自定义连接器端到端测试了登录流程。我们使用 Claude Code、Codex CLI 和 mcp-remote bridge 测试了 API 密钥设置。我们尚未测试 Claude Code、Codex、Cursor 或 Gemini CLI 中的登录，也未测试 VS Code 和 Cline 的设置；这些步骤依据各客户端的文档。如果登录在你的客户端中失败，请使用其 API 密钥设置。

定价

• 每次成功调用收费 $0.0025（每 1,000 次 $2.50），搜索和抓取均如此。费用从你的 PacketStream 预付余额中扣除。
• 调用失败不收费，但 计费中所述的一种罕见情况除外。没有有效密钥或未登录的调用绝不会计费。
• 连接和列出工具均免费。
• 没有免费套餐，也没有订阅。你需要先充值，最低购买金额为 $50。购买的余额不会过期。
• Agent 可能会在一项任务中多次调用这些工具。请检查客户端的工具审批设置，以控制支出。

限制：同一个密钥的所有调用共用每秒 20 次的限额，突发上限为 200 次。每个已登录的应用都有独立的同等限额。

隐私

• PacketStream 不会存储你的搜索查询、搜索结果、你获取的 URL 或页面内容。对于每次调用，我们会记录其请求 ID 和时间、密钥或已连接的应用、请求类型、结果、处理请求的提供商、尝试次数、耗时和费用。控制面板会显示你近期的请求和每日用量。
• 为了回答搜索请求，我们会使用 PacketStream 自己的账户，将你的查询及其选项发送给第三方搜索数据提供商。我们不会向他们发送你的账户身份、API 密钥或 IP 地址。
• 获取内容的请求会通过 PacketStream 住宅网络传输。只有当页面使用未加密的 http 时，该网络上的设备才能读取页面内容。
• 登录的应用永远无法看到你的密码、API 密钥、付款详情或代理流量。它只能使用 MCP 工具。若要断开应用连接，请使用控制面板的 MCP 页面。在应用内断开连接会删除该应用保存的登录信息。支持撤销令牌的应用也会在我们的系统中终止该令牌；否则，该令牌会一直有效，直到 30 天未使用或你在控制面板中断开连接。

请阅读完整的隐私政策和服务条款。

支持

• 电子邮件：[email protected]
• 联系表单：https://packetstream.io/contact-us/
• 故障排除：https://packetstream.io/docs/mcp/clients/#troubleshooting

许可证

此仓库中的文件根据 Apache License 2.0 授权。“PacketStream”和 PacketStream 徽标是 PacketStream Inc. 的商标；该许可证不授予使用它们的权限。请参阅 NOTICE。