Serper

Serper MCP サーバー

Serper API と連携し、Google 検索結果を通じてウェブ、ニュース、画像、動画を包括的に検索できる MCP サーバー実装です。また、検索結果からコンテンツを抽出する FireCrawl を使用したウェブスクレイピング機能や、位置情報ベースのサービスも含まれています。

機能

• ウェブ検索：一般的なクエリ、ナレッジグラフ、「関連する質問」など
• ニュース検索：記事、プレスリリース、情報源を含む最新コンテンツ
• 画像検索：写真、図表、ロゴなどのビジュアルコンテンツ
• 動画検索：YouTube などのプラットフォーム上の動画
• マップ検索：詳細情報を含む場所、事業所、名所
• レビュー検索：事業所や場所に関する詳細なユーザーレビューと評価
• ウェブスクレイピング：検索結果で見つかったあらゆるウェブページからコンテンツを抽出して整形
• 位置情報サービス：位置情報を考慮した検索に使用する現在の GPS 座標を取得
• 位置情報ベースの検索結果：国や地域を指定した検索機能
• リッチ検索結果の整形：ナレッジグラフやアンサーボックスからの構造化データ

ツール

• serper_web_search

  • 位置情報を考慮してウェブ検索を実行します
  • 入力：
    • query（string）：検索語
    • location（string、任意）：位置情報（例：「United States」、「India」）
    • gl（string、任意）：Google の国コード（例：「us」、「in」、「uk」）
    • num（number、任意）：結果の件数（最大 20 件）

• serper_news_search

  • ニュース記事やプレスリリースを検索します
  • 入力：
    • query（string）：ニュース検索語
    • location（string、任意）：位置情報
    • gl（string、任意）：Google の国コード
    • num（number、任意）：結果の件数（最大 20 件）

• serper_image_search

  • 画像、写真、図、その他のビジュアルコンテンツを検索します
  • 入力：
    • query（string）：画像検索語
    • gl（string、任意）：Google の国コード（例：「us」、「in」、「uk」）
    • num（number、任意）：結果の件数（最大 20 件）

• serper_video_search

  • YouTube などのプラットフォームから動画を検索します
  • 入力：
    • query（string）：動画検索語
    • gl（string、任意）：Google の国コード（例：「us」、「in」、「uk」）
    • num（number、任意）：結果の件数（最大 20 件）

• serper_maps_search

  • 場所、企業、スポットを検索します
  • 入力：
    • query（string）：場所または企業の検索語
    • ll（string、任意）：'@latitude,longitude,zoom' 形式の位置座標（例：'@40.6973709,-74.1444871,11z'）
    • useCurrentLocation（boolean、任意）：座標が指定されていない場合に、現在の IP ベースの位置情報を使用するかどうか（デフォルト：true）
    • num（number、任意）：結果の件数（最大 20 件）
  • 戻り値：
    • 企業名と住所
    • 地理座標
    • 評価とレビュー
    • 企業の種類とカテゴリ
    • 利用可能な場合は連絡先情報

• serper_reviews_search

  • 特定の場所または企業の詳細なレビューを取得します
  • 入力：
    • placeId（string）：Google Place ID（必須。マップ検索で取得します）
    • cid（string、任意）：Google Customer ID（マップ検索から取得）
    • fid（string、任意）：Google Featured ID（マップ検索から取得）
    • sortBy（string、任意）：レビューの並べ替え方法（"mostRelevant"、"newest"、"highestRating"、"lowestRating"）
    • num（number、任意）：取得するレビューの件数（最大 20 件）
  • 戻り値：
    • 詳細なレビュー本文
    • 評価と日付の情報
    • レビュアーのプロフィールと統計情報
    • いいね数とユーザーエンゲージメントデータ

• gps_coordinates

  • 現在地の座標を取得します
  • 入力：
    • fallbackToIP（boolean、任意）：正確な GPS 情報を取得できない場合に、IP ベースの位置情報を使用するかどうか（デフォルト：true）
  • 戻り値：
    • 緯度と経度
    • 精度情報
    • マップサービスで位置を表示するためのリンク

• firecrawl_scrape

  • あらゆるウェブページからコンテンツをスクレイピングして抽出します
  • 入力：
    • url（string）：スクレイピングするページの URL
    • formats（array、任意）：出力形式（デフォルト ["markdown"]）

設定

API キーの取得

1. Serper の場合：Serper.dev アカウントに登録します
2. FireCrawl の場合：FireCrawl アカウントに登録します
3. アカウントのダッシュボードから API キーを生成します

Claude Desktop での使用

以下を claude_desktop_config.json に追加します：

Docker

{
  "mcpServers": {
    "serper": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SERPER_API_KEY",
        "-e",
        "FIRECRAWL_API_KEY",
        "mcp/hs-search"
      ],
      "env": {
        "SERPER_API_KEY": "YOUR_SERPER_API_KEY_HERE",
        "FIRECRAWL_API_KEY": "YOUR_FIRECRAWL_API_KEY_HERE"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "serper": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-serper"
      ],
      "env": {
        "SERPER_API_KEY": "YOUR_SERPER_API_KEY_HERE",
        "FIRECRAWL_API_KEY": "YOUR_FIRECRAWL_API_KEY_HERE"
      }
    }
  }
}

ビルドと実行

Docker のビルド：

docker build -t mcp/hs-search:latest .

Docker の実行：

docker run -i --rm \
  -e SERPER_API_KEY="your-serper-api-key-here" \
  -e FIRECRAWL_API_KEY="your-firecrawl-api-key-here" \
  mcp/hs-search

ローカル開発：

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run server
SERPER_API_KEY="your-serper-api-key-here" FIRECRAWL_API_KEY="your-firecrawl-api-key-here" npm start

使用例

Claude でツールを使用する方法の例をいくつか紹介します。

1. ウェブ検索：

   Can you search for "climate change solutions" and summarize the results?
   

2. ニュース検索：

   Find me the latest news about "artificial intelligence" in the United States.
   

3. 画像検索：

   Can you find images of "Mars rover Perseverance" and describe what you see?
   

4. 動画検索：

   Search for videos about "how to make sourdough bread" and summarize the top results.
   

5. 地図検索：

   Search for "coffee shops" near me and tell me which ones have the highest ratings.
   

6. レビュー検索：

   Search for "Apple Store" and then get all the reviews for the highest-rated location.
   

7. 位置情報と地図の連携：

   What's my current location? Now find Italian restaurants within 2 miles of me.
   

8. 地図とレビューの連携：

   Find the top-rated "pizza places" near me and show me their most recent reviews.
   

9. 位置情報の取得：

   What is my current location? Can you show the coordinates on a map?
   

10. ウェブスクレイピング：

    TypeScript のインターフェースに関するドキュメントを検索し、検索結果ページの 1 つから内容をスクレイピングして説明してください。
    

ライセンス

この MCP サーバーは MIT ライセンスのもとでライセンスされています。MIT ライセンスの利用規約に従うことを条件に、ソフトウェアを自由に使用、変更、配布できます。