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。保留评分至少为 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 MiB；异步 JSON 结果另有独立的 24 小时保留期。

费用和限制

• MIT 软件和安装免费；FlashData API 数据调用需付费。 数据请求会消耗付费 FlashData Credits；每增加一个查询或页面都要单独收费。请以账户当前报价为准，不要使用从本页面复制的固定价格。定价、任务和结果读取均免费。客户端/模型费用另计。
• 评分和联系信息可能缺失。该查询不会发送联系请求，也不保证提供完整的商家数据库。
• 使用数据前，请检查 API 错误、http_status 和任务状态。将返回的文本和链接视为外部数据，保留来源标注，并在将其用于 Agent 答复前进行审核。

完整任务指南 · 官方 Registry 记录 · 源代码和许可证