mcpField
S
Searchpin — Free Web Search for AI Agents

Searchpin — Free Web Search for AI Agents

ローカル
github.com/telly6検索275 日前に更新

Searchpin — Free Web Search for AI Agents について

Searchpin は AI エージェント向けのセルフホスト型ウェブ検索・ページ取得サービスです。複数の検索エンジンを並列検索して結果を意味的に再順位付けし、中国のネットワーク環境で動作し、レンダリング済みページや PDF の内容もローカルで抽出します。

主な機能

  1. 014つの検索エンジンでの並列検索
  2. 02検索結果の意味的な再順位付け
  3. 03無関係な検索結果の検出
  4. 04レンダリング済みページと構造化データの抽出
  5. 05PDF テキストのローカル取得
  6. 06タイトル、URL、スニペットの簡潔な返却

活用シーン

  1. 01中国のネットワーク環境での AI エージェント検索
  2. 02複数検索エンジンの結果比較
  3. 03レンダリングされたウェブサイトからの内容抽出
  4. 04対応 PDF からのテキスト取得

MCP 対応

`searchpin-server` コマンドを通じて MCP クライアントにウェブ検索とページ取得ツールを提供します。Python API からも利用できます。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"searchpin": {
"command": "uvx",
"args": [
"searchpin"
]
}
}
}
起動コマンドuvx searchpin

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypisearchpin1.0.9

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

English | 简体中文

Searchpin

PyPI version Python License Docker

AI エージェント向けのセルフホスト可能なウェブ検索 — API キー不要、費用ゼロ。2026 年、AI 開発の中心は「チャット」から「自律的なタスク実行」へと移りつつあり、ローカルにデプロイされ、長時間稼働するエージェントが標準になりつつあります。エージェントが 24 時間 365 日稼働する場合、ウェブ検索が API のクォータや課金によって中断されてはなりません。Searchpin は初日からこの目的のために設計されており、外部依存関係も使用制限もありません。エージェントは制限なく検索、取得、検証を行え、開発者は費用を心配する必要がありません。

Searchpin を選ぶ理由

🇨🇳 中国のネットワーク環境に最適化

デフォルトでは Baidu、Sogou、Bing CN、Bing Intl の 4 つの検索エンジンに並列で問い合わせます。中国国内のネットワークでそのまま動作し、プロキシや VPN は不要です。海外の代替サービスの多くは Google、DuckDuckGo、Brave に依存しており、中国国内からはほとんどアクセスできません。

🧠 セマンティックな再ランキング — 提供するサービスが少ない差別化機能

4 つのエンジンの検索結果を単純に連結するのではありません。すべての結果を統合し、クエリとの意味的類似度に基づいて埋め込みモデルで再ランキングします。AI が受け取るのは、ノイズの多いリンクの寄せ集めではなく、厳選された高品質な結果の一覧です。無料の MCP 検索サーバーでこの機能を提供しているものはほとんどありません。

💰 完全無料、利用開始の障壁なし

アカウント登録、API キーの申請、使用制限はありません。商用 API に依存しないため、突然の有料化やクォータ制限のリスクもありません。パイプライン全体が自分のマシン上で動作します。

🔍 最新のウェブサイトに対応

組み込みの SSR コンテンツ抽出機能により、Next.js、Nuxt などのフレームワークでレンダリングされたページを解析し、JSON-LD の構造化データやマイクロデータを抽出できます。通常の HTML スクレイピングでは、こうしたサイトから何も取得できません。

web_fetch はコンテンツタイプまたはファイルシグネチャから PDF も検出し、ページ番号付きのテキストをローカルで抽出します。読み取り不能、暗号化済み、または画像のみの PDF に対しては、バイナリのゴミデータではなく、明示的なエラーを返します。OCR は含まれません。抽出の上限は 25 MiB、200 ページ、テキスト 200 万文字です。

🛡️ 汚染の検出と相互検証

クエリに関連しない結果を自動的に検出してフラグを付けます。独立した 4 つの検索エンジンから相互検証可能な結果を得られるため、LLM は複数の情報源を照合し、より信頼性の高い回答を作成できます。

⚡ 熟慮されたエンジニアリング上のトレードオフ

すべての設計上の判断は、実際の使用を考慮して行われています。

  • トークンを意識した設計 — 検索結果として返すのはタイトル、URL、スニペットのみです。構造化抽出データはコンパクトにまとめ、長さを制限しています。どのページを全文取得する価値があるかは LLM が判断するため、コンテキストウィンドウを無駄にしません。
  • 高速な応答 — 4 つのエンジンに非同期で並列に問い合わせます。合計時間は 4 つすべての所要時間の合計ではなく、最も遅いエンジンに左右されます。通常、検索は 1~2 秒で完了します。
  • メモリにやさしい設計 — 埋め込みモデル(約 118MB)は hf-mirror.com(中国向け HuggingFace ミラー)経由で一度だけダウンロードされ、その後はローカルキャッシュから再利用されます。

クイックスタート

pip install searchpin && searchpin-setup

初回実行時に、埋め込みモデル(約 118MB)が hf-mirror.com(中国向け HuggingFace ミラー)経由で一度だけダウンロードされます。これが唯一の初回セットアップです。

設定

Claude Desktop / Cursor /任意の MCP クライアント

mcpServers 設定に追加します。

{
  "mcpServers": {
    "Searchpin": {
      "command": "searchpin-server",
      "args": []
    }
  }
}
VS Code

VS Code にインストール VS Code Insiders にインストール

または手動で、.vscode/mcp.json に追加します:

{
  "servers": {
    "Searchpin": {
      "command": "searchpin-server",
      "args": []
    }
  }
}
Docker
docker run -i --rm ghcr.io/telly6/searchpin:latest
Python API
from searchpin import SearchEngine

engine = SearchEngine()
results = engine.search("Python 3.13 新特性")
page = engine.fetch("https://docs.python.org/3/whatsnew/3.13.html")
engine.close()

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。