SearchPipe

SearchPipe インテグレーション

AI エージェントを構築する開発者向けのウェブ検索 API および MCP サーバーである SearchPipe の公式インテグレーションパッケージです。

このリポジトリには以下が含まれます。

• リモート MCP エンドポイント — Streamable HTTP を使って、任意の MCP クライアントを SearchPipe に接続できます（ローカルへのインストールは不要です）
• LangChain SDK — リトリーバー、ツール、回答コンポーネント用の pip install langchain-searchpipe
• Python SDK — Search API 用の公式軽量クライアント、pip install searchpipe
• TypeScript SDK — 依存関係ゼロの公式クライアント（ESM + CJS）、npm install searchpipe

SearchPipe サーバー自体は searchpipe.tech で提供されるマネージドサービスです。ご要望に応じてセルフホストにも対応します。

MCP アクセス（リモート）

MCP クライアントの設定（Claude Desktop、Cursor、Windsurf など）に追加してください。

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

または、URL パラメーターの代わりに Authorization ヘッダーを使用してください。

{
  "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. ダッシュボード → 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 パラメーターを使用）

戻り値：query、answer、results[] を含む Tavily 形式の SearchResponse。

リンク

• ウェブサイト：searchpipe.tech
• API ドキュメント：searchpipe.tech/docs
• MCP エンドポイント：https://searchpipe.tech/mcp/

ライセンス

MIT