SearchPipe

SearchPipe 集成

SearchPipe 的官方集成包。SearchPipe 是面向 AI Agent 开发者的网页搜索 API 和 MCP 服务。

此仓库包含：

• 远程 MCP 端点 — 通过 Streamable HTTP 将任何 MCP 客户端连接到 SearchPipe（无需本地安装）
• LangChain SDK — 使用 pip install langchain-searchpipe 安装，提供检索器、工具和答案组件
• Python SDK — 使用 pip install searchpipe 安装，是 Search API 的官方轻量客户端
• TypeScript SDK — 使用 npm install searchpipe 安装，是官方零依赖客户端（ESM + CJS）

SearchPipe 服务本身是由 searchpipe.tech 提供的托管服务。可应要求提供自托管方案。

MCP 访问（远程）

将以下内容添加到 MCP 客户端配置中（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "searchpipe": {
      "url": "https://searchpipe.tech/mcp/?api_key=sp-your-api-key-here"
    }
  }
}

也可以使用 Authorization 标头，而不是 URL 参数：

{
  "mcpServers": {
    "searchpipe": {
      "url": "https://searchpipe.tech/mcp/",
      "headers": {
        "Authorization": "Bearer sp-your-api-key-here"
      }
    }
  }
}

可参阅 claude_desktop_config.json.example，其中提供了可直接复制的模板。

LangChain 集成

pip install langchain-searchpipe

完整用法示例（检索器、工具和答案组件）请参阅 langchain-searchpipe/README.md。

官方 SDK

两个 SDK 都是对 POST /search 的轻量封装，使用与 REST API 相同的参数和响应结构。

Python（sdks/python/）：

pip install searchpipe

from searchpipe import SearchPipe

client = SearchPipe(api_key="sp-YOUR_KEY")
resp = client.search("FastAPI tutorial", max_results=5, include_answer=True)
print(resp.answer)
for r in resp.results:
    print(r.score, r.title, r.url)

JavaScript / TypeScript（sdks/typescript/）：

npm install searchpipe

import { SearchPipe } from "searchpipe";

const client = new SearchPipe({ apiKey: "sp-YOUR_KEY" });
const resp = await client.search({ query: "FastAPI tutorial", maxResults: 5, includeAnswer: true });
console.log(resp.answer);

两者默认使用 https://searchpipe.tech，并从 SEARCHPIPE_API_KEY 读取密钥。完整 API、错误类和自托管选项请参阅各 SDK 的 README。

获取 API 密钥

1. 在 searchpipe.tech 注册
2. 验证电子邮件
3. 前往 Dashboard → API Keys → 复制你的 sp- 密钥
4. 新账户会获赠免费额度，可用于试用服务

工具架构

searchpipe_search

执行网页搜索，可选择使用 AI 生成答案。

参数	类型	必填	默认值	说明
query	string	✅	—	搜索查询
max_results	integer	—	5	结果数量（1–20）
include_answer	boolean	—	false	是否包含 AI 生成的答案
include_raw_content	boolean	—	false	是否包含完整页面内容
api_key	string	—	—	API 密钥（或使用环境变量 / URL 参数）

返回值：Tavily 风格的 SearchResponse，包含 query、answer、results[]。

链接

• 网站：searchpipe.tech
• API 文档：searchpipe.tech/docs
• MCP 端点：https://searchpipe.tech/mcp/

许可证

MIT