English Français العربية

SearchPipe

السجل الرسمي البحث والويب

Real-time web search for AI agents: ranked results, source URLs, and optional AI answers.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http searchpipe 'https://searchpipe.tech/mcp/' --header 'Authorization: <Bearer <sp- API key>. Create one at https://searchpipe.tech/dashboard/api-keys>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "searchpipe": {
            "type": "http",
            "url": "https://searchpipe.tech/mcp/",
            "headers": {
                "Authorization": "<Bearer <sp- API key>. Create one at https://searchpipe.tech/dashboard/api-keys>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. SearchPipe Integrations
  2. MCP Access (Remote)
  3. LangChain Integration
  4. Official SDKs
  5. Getting an API Key
  6. Tool Schema
  7. Links
  8. License

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-searchpipe for 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

  1. Sign up at searchpipe.tech
  2. Verify your email
  3. Go to Dashboard → API Keys → copy your sp- key
  4. New accounts receive free credits to try the service

Tool Schema

Run a web search with optional AI-generated answer.

ParameterTypeRequiredDefaultDescription
querystring✅—Search query
max_resultsinteger—5Number of results (1–20)
include_answerboolean—falseInclude AI-generated answer
include_raw_contentboolean—falseInclude full page content
api_keystring——API key (or use env var / URL param)

Returns: Tavily-style SearchResponse with query, answer, results[].

License

MIT

الأسئلة الشائعة

ما هو SearchPipe؟

Real-time web search for AI agents: ranked results, source URLs, and optional AI answers.

كيف أثبّت SearchPipe؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http searchpipe 'https://searchpipe.tech/mcp/' --header 'Authorization: <Bearer <sp- API key>. Create one at https://searchpipe.tech/dashboard/api-keys>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج SearchPipe إلى مفتاح API؟

نعم. يتطلب Authorization، وتضبطها في إعداداته.

هل SearchPipe مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون SearchPipe؟

ينشره SearchPipe. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.