SearchPipe Integrations
Official integration packages for SearchPipe — a web search API and MCP server for developers building AI agents.
This repository contains:
- Remote MCP endpoint — connect any MCP client to SearchPipe via Streamable HTTP (no local install needed)
- LangChain SDK —
pip install langchain-searchpipefor retriever, tool, and answer components - Python SDK —
pip install searchpipe, official thin client over the Search API - TypeScript SDK —
npm install searchpipe, official zero-dependency client (ESM + CJS)
The SearchPipe server itself is a managed service at searchpipe.tech. Self-hosting is available on request.
MCP Access (Remote)
Add to your MCP client config (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"searchpipe": {
"url": "https://searchpipe.tech/mcp/?api_key=sp-your-api-key-here"
}
}
}
Or use an Authorization header instead of URL parameter:
{
"mcpServers": {
"searchpipe": {
"url": "https://searchpipe.tech/mcp/",
"headers": {
"Authorization": "Bearer sp-your-api-key-here"
}
}
}
}
See claude_desktop_config.json.example for a ready-to-copy template.
LangChain Integration
pip install langchain-searchpipe
See langchain-searchpipe/README.md for full usage examples (retriever, tool, answer components).
Official SDKs
Both SDKs are thin wrappers over POST /search — same parameters, same response shape as the 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);
Both default to https://searchpipe.tech and read the key from SEARCHPIPE_API_KEY. See each SDK's README for the full API, error classes, and self-hosting options.
Getting an API Key
- Sign up at searchpipe.tech
- Verify your email
- Go to Dashboard → API Keys → copy your
sp-key - New accounts receive free credits to try the service
Tool Schema
searchpipe_search
Run a web search with optional AI-generated answer.
Returns: Tavily-style SearchResponse with query, answer, results[].
Links
- Website: searchpipe.tech
- API Docs: searchpipe.tech/docs
- MCP Endpoint:
https://searchpipe.tech/mcp/
License
MIT
