Serpex MCP

Model Context Protocol（MCP）サーバーで、Serpex API を通じてマルチエンジンのウェブ検索機能を提供します。Google、Bing、DuckDuckGo、Brave、Yahoo、Yandex を、自動エンジンルーティングと構造化された JSON 結果で検索できます。

機能

✅ マルチエンジン対応: 6つの検索エンジン（Google、Bing、DuckDuckGo、Brave、Yahoo、Yandex）にアクセス
✅ 自動ルーティング: 利用可能な最適な検索エンジンを自動選択
✅ 期間フィルタリング: 日、週、月、年の単位で結果をフィルタリング
✅ 構造化結果: クリーンで一貫性のあるJSONレスポンス
✅ 高速＆信頼性: 組み込みのCAPTCHA処理とプロキシローテーション
✅ 簡単な統合: Claude Desktop、Jan AI、およびMCP互換のクライアントで動作

Related MCP server: Serper Search and Scrape MCP Server

インストール

クイックスタート（npx - 推奨）

インストールは不要です！npx で直接実行できます:

npx serpex-mcp

グローバルインストール

npm install -g serpex-mcp

ローカルインストール

npm install serpex-mcp

使用方法

Claude Desktopを使用する

Claude Desktopの設定（macOSでは ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します:

{
  "mcpServers": {
    "serpex": {
      "command": "npx",
      "args": ["-y", "serpex-mcp"],
      "env": {
        "SERPEX_API_KEY": "your-api-key-here"
      }
    }
  }
}

他のMCPクライアントの場合

MCP互換のクライアントであれば、このサーバーを使用できます。次のように設定します:

• コマンド: npx

• 引数: -y serpex-mcp

• 環境変数: SERPEX_API_KEY=your-key

スタンドアロン

export SERPEX_API_KEY="your-api-key-here"
serpex-mcp

利用可能なツール

serpex_search

Serpex マルチエンジン API を使用してウェブを検索します。オプションで、検索とインラインで上位結果のページ全体のコンテンツ（Markdown）を取得します。ベストエフォートのため、各結果の content と content_error を確認してください。

パラメータ:

• q（必須）: 検索クエリ文字列（最大500文字）

• include_content（オプション、boolean）: 上位結果のページ全体のコンテンツ（Markdown）も取得します。ベストエフォートです。約79%の結果URLでコンテンツが返されますが、ブロックされたページやrobots.txtで許可されていないページでは代わりに content_error が返されます。デフォルト: false。

• content_results（オプション、5 | 10）: include_content が true の場合にコンテンツを取得する上位結果の数。5 または 10 のいずれかでなければなりません。デフォルトは 5 です。

例:

{
  "q": "artificial intelligence trends 2025",
  "include_content": true,
  "content_results": 5
}

レスポンス（JSON、ツール出力テキストとして）には、content_requested / content_delivered のカウントと、各結果ごとに成功時は content、失敗時は content_error が含まれます。コンテンツが要求されなかった場合は、両方のキーが省略されます。

APIキーの取得

1. serpex.dev にアクセスします

2. 無料アカウントに登録します

3. ダッシュボードからAPIキーを取得します

4. それを SERPEX_API_KEY 環境変数で使用します

API情報

• ベースURL: https://api.serpex.dev

• ドキュメント: https://serpex.dev/docs

• 料金: 無料枠あり、手頃な価格の有料プラン

開発

ソースからビルド

git clone https://github.com/divyeshradadiya/serpex-mcp.git
cd serpex-mcp
pnpm install
pnpm build

テストを実行

export SERPEX_API_KEY="your-key-here"
pnpm test

ライセンス

MIT

リンク

• Serpex ウェブサイト

• Serpex ドキュメント

• Model Context Protocol

• MCP 仕様