Outscraper MCP

🚀 Outscraper MCP Server

このサーバーは、OutscraperのGoogle Mapsデータ抽出サービスへのアクセスを提供する、効率的なModel Context Protocol (MCP) サーバーです。高い信頼性でGoogle Mapsデータを抽出するための2つの重要なツールを実装しています。

✨ 主な機能

Google Mapsデータ抽出

• 🗺️ Google Maps検索 - 詳細情報を含む企業や場所を検索します。
• ⭐ Google Mapsレビュー - 任意のGoogle Mapsの場所から顧客レビューを抽出します。

高度な機能

• データエンリッチメント - エンリッチメントパラメータを使用して、追加の連絡先情報で結果を強化します。
• 多言語対応 - さまざまな言語でデータを検索および抽出します。
• 地域フィルタリング - 特定の国/地域を対象にして、ローカライズされた結果を取得します。
• 柔軟なソート - 関連性、日付、評価などでレビューをソートします。
• 時間ベースのフィルタリング - カットオフパラメータを使用して、特定の日付以降のレビューをフィルタリングします。
• 大量データ対応 - 大規模なリクエストの非同期処理を自動的に扱います。

📦 インストール

Smitheryを使用したインストール (推奨)

Smithery を介してClaude Desktop用のOutscraper MCPサーバーを自動的にインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install outscraper-mcp --client claude

PyPIを使用したインストール

# pipを使用する場合
pip install outscraper-mcp

# uvを使用する場合 (推奨)
uv add outscraper-mcp

# 一度だけ実行する場合、uvxを使用
uvx outscraper-mcp

手動インストール

git clone https://github.com/jayozer/outscraper-mcp
cd outscraper-mcp

# uvを使用する場合 (推奨)
uv sync

# pipを使用する場合
pip install -e .

🔧 設定

APIキーの取得

1. Outscraper でサインアップします。
2. プロファイルページからAPIキーを取得します。

環境変数の設定

export OUTSCRAPER_API_KEY="your_api_key_here"

または、.env ファイルを作成します。

OUTSCRAPER_API_KEY=your_api_key_here

🛠️ クライアント設定

Claude Desktop

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

Smitheryを介した自動設定:

{
  "mcpServers": {
    "outscraper": {
      "command": "npx",
      "args": ["-y", "@smithery/cli", "run", "outscraper-mcp"],
      "env": {
        "OUTSCRAPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

ローカルインストールを介した設定:

{
  "mcpServers": {
    "outscraper": {
      "command": "uvx",
      "args": ["outscraper-mcp"],
      "env": {
        "OUTSCRAPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

手動インストールを介した設定:

{
  "mcpServers": {
    "outscraper": {
      "command": "uv",
      "args": ["run", "python", "-m", "outscraper_mcp"],
      "env": {
        "OUTSCRAPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Cursor AI

UVXを使用した自動インストール (推奨):

{
  "mcpServers": {
    "outscraper": {
      "command": "uvx",
      "args": ["outscraper-mcp"],
      "env": {
        "OUTSCRAPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

手動インストール:

{
  "mcpServers": {
    "outscraper": {
      "command": "outscraper-mcp",
      "env": {
        "OUTSCRAPER_API_KEY": "your_api_key_here"
      }
    }
  }
}

⚠️ 重要提示

Cursorユーザーの場合、設定ファイルは通常以下の場所にあります。

• macOS: ~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Windows: %APPDATA%\Cursor\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json
• Linux: ~/.config/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

🛠️ ツールリファレンス

google_maps_search

Google Mapsで企業や場所を検索します。

# パラメータ:
query: str              # 検索クエリ (例: 'restaurants brooklyn usa')
limit: int = 20         # 結果の数 (最大: 400)
language: str = "en"    # 言語コード
region: str = None      # 国/地域コード (例: 'US', 'GB')
drop_duplicates: bool = False  # 重複結果を削除するかどうか
enrichment: List[str] = None   # 追加サービス ['domains_service', 'emails_validator_service']

google_maps_reviews

Google Mapsの場所からレビューを抽出します。

# パラメータ:
query: str              # 場所のクエリ、場所ID、または企業名
reviews_limit: int = 10 # 場所ごとのレビュー数 (0は無制限)
limit: int = 1          # 処理する場所の数
sort: str = "most_relevant"  # ソート順: 'most_relevant', 'newest', 'highest_rating', 'lowest_rating'
language: str = "en"    # 言語コード
region: str = None      # 国/地域コード
cutoff: int = None      # 特定の日付以降のレビューのUnixタイムスタンプ

🚀 サーバーの実行

開発とテスト

# FastMCPインスペクタ - ウェブベースのテストダッシュボード
fastmcp dev outscraper_mcp/server.py

# 次に、ブラウザで以下を開きます: http://127.0.0.1:6274
# リアルタイムの応答でGoogle Mapsツールのインタラクティブなテスト

Stdioトランスポート (デフォルト)

# PyPIインストールを介した場合
outscraper-mcp

# uvを介した場合
uv run python -m outscraper_mcp

# 手動インストールを介した場合
python -m outscraper_mcp

HTTPトランスポート

from outscraper_mcp import mcp

if __name__ == "__main__":
    mcp.run(transport="streamable-http", host="127.0.0.1", port=8000)

💻 使用例

例1: レストランを検索してレビューを取得する

# 1. レストランを検索する
results = google_maps_search(
    query="italian restaurants manhattan nyc",
    limit=5,
    language="en",
    region="US"
)

# 2. 特定の場所のレビューを取得する
reviews = google_maps_reviews(
    query="ChIJrc9T9fpYwokRdvjYRHT8nI4",  # 検索結果の場所ID
    reviews_limit=20,
    sort="newest"
)

例2: エンリッチメントを使用したリード生成

# 強化された連絡先情報を持つ企業を検索する
businesses = google_maps_search(
    query="digital marketing agencies chicago",
    limit=20,
    enrichment=["domains_service", "emails_validator_service"]
)

# センチメント分析のために詳細なレビューを取得する
for business in businesses:
    if business.get('place_id'):
        reviews = google_maps_reviews(
            query=business['place_id'],
            reviews_limit=10,
            sort="newest"
        )

例3: 市場調査

# 特定の地域の競合他社を調査する
competitors = google_maps_search(
    query="coffee shops downtown portland",
    limit=50,
    region="US"
)

# 最近の顧客フィードバックを分析する
recent_reviews = google_maps_reviews(
    query="coffee shops downtown portland",
    reviews_limit=100,
    sort="newest"
)

🔄 MCPクライアントとの統合

このサーバーは、以下を含む任意のMCPクライアントと互換性があります。

• Claude Desktop
• Cursor AI
• Raycast
• MCP拡張機能を備えた VS Code
• カスタムMCPクライアント

📊 レート制限と価格

• 現在の料金については、Outscraper Pricing を確認してください。
• APIキーの使用状況はリクエストごとに追跡されます。
• 頻繁にアクセスするデータにはキャッシュを実装することを検討してください。

🐛 トラブルシューティング

一般的な問題

1. インポートエラー: パッケージが正しくインストールされていることを確認してください。

   pip install --upgrade outscraper-mcp
   

2. APIキーエラー: APIキーが正しく設定されていることを確認してください。

   echo $OUTSCRAPER_API_KEY
   

3. 結果がない: クエリパラメータが有効であることを確認してください。

4. レート制限: 必要に応じて、リクエスト間に遅延を実装してください。

デバッグログの有効化

import logging
logging.basicConfig(level=logging.DEBUG)

🤝 コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. テストを追加します。
5. プルリクエストを送信します。

📄 ライセンス

実験的ソフトウェアライセンス - 詳細はLICENSEファイルを参照してください。

注意: このソフトウェアは実験的なもので、すべての目的で無料で使用できます。Jay Ozerによって作成されました。

🔗 リンク

• Outscraper APIドキュメント
• FastMCPドキュメント
• Model Context Protocol
• Smitheryレジストリ

Built with Blu Goldens