Google Shopping — FlashData

Google Shopping — FlashData

搜索 Google Shopping 中的商品、商家和价格标签。收集可比较的商品报价快照，其中包含商品 ID 和来源链接。

API 文档和账户设置 · 获取 API 密钥 · 当前定价

试用任务

制作一份无线耳机报价对比表，包含商品名称、商家名称、链接和原始价格标签。不同货币分开列出，并标记缺少价格的商品。

安装并连接

1. 使用 22.18 或更高版本的 Node.js，以及支持本地 stdio 服务的 MCP 客户端。下载专用 MCPB 软件包；其 SHA-256 值记录在清单中。
2. 在兼容 MCPB 的客户端中导入软件包，并在 FlashData API Key 中输入你自己的密钥。授予该密钥访问 google_shopping 的权限。如需手动设置，请将软件包解压到一个固定文件夹，并使用以下配置，替换绝对路径和密钥占位符：

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

3. 重启或重新连接客户端，列出其工具，然后调用 get_pricing，并传入 {"source":"google_shopping","request_count":1}，再批准付费请求。此服务仅提供 google_shopping、get_pricing、get_job 和 get_result，且所有工具都仅限此数据源。

软件包中已包含依赖项。如果客户端找不到 node，请使用 Node 的绝对路径；在 Windows 上请使用转义路径。请将密钥保存在受保护的客户端设置中，不要放在聊天内容或已提交的配置中。直接下载此软件包无需 Smithery 账户。

示例请求

以下是 MCP tools/call 参数，使用扁平参数。执行数据请求会消耗付费 Credits。

{
  "name": "google_shopping",
  "arguments": {
    "query": "wireless headphones",
    "gl": "us",
    "hl": "en",
    "num": 10
  }
}

使用响应

读取 results[0].shopping。按 productId 或 link 与已存储的先前快照关联，然后比较原始价格字符串，并保留标题、来源和采集时间。

以下选取的响应字段为示例数据，不是实时结果，也不保证一定能获取到这些数据：

{
  "source": "google_shopping",
  "status": "done",
  "results": [
    {
      "shopping": [
        {
          "title": "wireless headphones",
          "link": "https://example.com/research",
          "snippet": "Search fixture",
          "position": 1,
          "productId": "product-1",
          "price": "$49.00",
          "source": "Example merchant"
        }
      ]
    }
  ],
  "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 记录 · 源代码和许可证