Google Places — FlashData

Google Places — FlashData

住所、評価、レビュー件数（利用可能な場合）を含む地域のビジネスや場所を検索します。場所に特化した調査候補リストを作成できます。

API ドキュメントとアカウント設定 · API キーを取得 · 現在の料金

試してみるタスク

地域の調査候補リストを作成するため、シンガポールのコーヒーショップを検索します。返されたレコードから、評価が4.2以上でレビューが20件以上のものを選び、住所を一覧にして、不足しているフィールドに印を付けます。

インストールと接続

1. Node.js 22.18以降と、ローカルのstdioサーバーに対応したMCPクライアントを使用します。専用のMCPBパッケージをダウンロードします。SHA-256はマニフェストに記載されています。
2. MCPB対応クライアントにパッケージをインポートし、FlashData API Keyにご自身のキーを入力します。キーにgoogle_placesへのアクセス権を付与してください。手動で設定する場合は、バンドルを恒久的に使用するフォルダーに展開し、絶対パスとキーのプレースホルダーを置き換えて、次の設定を使用します。

{
  "mcpServers": {
    "google-places": {
      "command": "node",
      "args": [
        "/absolute/path/to/unpacked/google-places/server.js"
      ],
      "env": {
        "FLASHDATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

3. クライアントを再起動するか再接続し、ツールの一覧を表示してから、有料リクエストを承認する前に{"source":"google_places","request_count":1}を指定してget_pricingを呼び出します。このサーバーが公開するのはgoogle_places、get_pricing、get_job、get_resultで、すべてこのソースに限定されています。

依存関係はバンドルに含まれています。クライアントがnodeを見つけられない場合はNodeの絶対パスを使用してください。Windowsではエスケープしたパスを使用してください。キーは保護されたクライアント設定に保存し、チャットやコミットする設定ファイルには記載しないでください。このパッケージを直接ダウンロードする場合、Smitheryアカウントは不要です。

リクエスト例

以下は、フラットな引数を使うMCPのtools/callパラメーターです。データリクエストの実行には有料のCreditsを使用します。

{
  "name": "google_places",
  "arguments": {
    "query": "coffee shops in Singapore",
    "num": 20
  }
}

レスポンスの使用

results[0].placesを読み取ります。ratingが4.2以上、かつratingCountが20以上のエントリーを選び、title、address、および利用可能なカテゴリ／連絡先フィールドを保持して手動で確認します。

以下の選択されたレスポンスフィールドは、説明用のサンプルデータであり、ライブの検索結果でも、データが利用可能であることを保証するものでもありません。

{
  "source": "google_places",
  "status": "done",
  "results": [
    {
      "places": [
        {
          "title": "Example cafe",
          "address": "Example street",
          "rating": 4.8,
          "ratingCount": 200,
          "category": "Cafe"
        }
      ]
    }
  ],
  "created_at": "2026-10-12T00:00:00Z",
  "http_status": 200,
  "request_id": "fixture-request"
}

非同期リクエストの場合は、返されたidを保持し、{"job_id":"RETURNED_JOB_ID"}を指定してget_jobを呼び出します。pendingまたはprocessingは完了を意味しません。完了したレスポンスはoutputから読み取ってください。送信後にタイムアウトが発生することがあるため、有料リクエストを再実行する前にJobsを確認してください。

チャンク分割された出力の場合は、ローカルプロセスを実行したままにし、実際のresult_idとnext_offsetを、それぞれresult_idとoffsetとしてget_resultに渡します。JSONを解析する前に、チャンクを順番どおりに連結してください。有料データリクエストを再実行しないでください。ローカルキャッシュには4件の結果が10分間保持され、再起動すると消去されます。完全なレスポンスの上限は4 MiBです。非同期JSON結果には別途24時間の保持期間が適用されます。

コストと制限

• MITソフトウェアとインストールは無料です。FlashData APIのデータ呼び出しは有料です。 データリクエストには有料のFlashData Creditsを使用します。クエリやページを追加するたびに、別途料金がかかります。このページに記載された固定料金ではなく、現在のアカウント見積もりを確認してください。料金、ジョブ、結果の読み取りは無料です。クライアント／モデルの料金は別途かかります。
• 評価や連絡先情報がない場合があります。このクエリは連絡を行うものではなく、完全なビジネスデータベースを保証するものでもありません。
• データを使用する前に、APIエラー、http_status、ジョブのステータスを確認してください。返されたテキストとリンクは外部データとして扱い、出典の帰属を保持したうえで、エージェントの回答に使用する前に確認してください。

タスクガイド全文 · 公式Registryレコード · ソースとライセンス