Serpapi Google Search

🚀 SerpApi MCP サーバー

このサーバーは、MCP（モデルコンテキストプロトコル）サーバーを構築し、以下の目的に使用されます。

• SerpApiを使用して、解析済みの検索エンジン結果ページ（SERPs）を高速で取得します。

このMCPサーバーは、SerpApiと統合されており、複数の検索エンジンで検索を実行し、リアルタイムおよびアーカイブされた結果を取得できます。また、MCPクライアントまたはホスト（例：GrokやClaude for Desktop）とシームレスにやり取りできるように、ツールやリソースを公開しています。

📦 インストール

SerpApi MCPサーバーをセットアップするには、必要なPythonライブラリをインストールします。

pip install mcp serpapi python-dotenv

また、SerpApi APIキーが必要です。SerpApiに登録して取得してください。

🚀 クイックスタート

1. サーバーコードを保存します。例えば、server.pyというファイルに保存します。

2. APIキーを設定します。同じディレクトリに.envファイルを作成し、SerpApi APIキーを追加します。

SERPAPI_API_KEY=your_api_key_here

3. サーバーを起動します。

python server.py

4. MCPクライアントと統合します。サーバーをMCPクライアントまたはホスト（例：Claude for Desktop）に接続します。Claudeの場合は、Claude_desktop_config.jsonを更新します。

{
  "mcpServers": {
    "serpapi": {
      "command": "python",
      "args": ["path/to/server.py"]
    }
  }
}

クライアントを再起動してサーバーを読み込みます。

✨ 主な機能

• サポートされる検索エンジン：Google、Google Light、Bing、Walmart、Yahoo、eBay、YouTube、DuckDuckGo、Yandex、Baidu

• ツール：

  • search：指定されたエンジンで検索を実行し、クエリとオプションのパラメータを指定できます。

• リソース：

  • locations：Googleの場所を検索します。

💻 使用例

これらの例は、サーバーに接続されたMCPクライアント（例：Python MCPクライアントSDKを使用して作成されたもの）を前提としています。

基本的な使用法

サポートされる検索エンジンのリストを取得します。

engines = await session.read_resource("locations")
print(engines)

高度な使用法

Googleで「コーヒー」を検索し、場所フィルターを適用します。

result = await session.call_tool("search", {
    "query": "咖啡",
    "engine": "google",
    "location": "奥斯汀, 德州"
})
print(result)

📚 ドキュメント

設定

APIキーは、.envファイルでSERPAPI_API_KEYとして設定します。

サーバーの起動

本番モード

サーバーを起動します。

python server.py

開発モード

MCP Inspectorを使用してデバッグします。

mcp dev server.py

🔧 テスト

MCP InspectorまたはMCPクライアントを使用してサーバーをテストします。Claude for Desktopの場合は、Claude_desktop_config.jsonでサーバーを設定し、アプリケーションを再起動して、ハンマーアイコンを使用して利用可能なツールを探索およびテストします。