shopdata

shopdata

shopdata 是一个小型本地桥接程序，用于连接托管的 HasData Amazon MCP 服务，该服务以 JSON 格式返回公开的 Amazon 数据。提供 ASIN，即可获取该商品的详情或客户 评论；提供关键词，即可在所选 Amazon 域名上执行搜索；提供卖家 ID，即可获取该卖家的 公开店铺资料或该卖家提供的商品目录。

该桥接程序不保留任何 Amazon 数据。它会在本地提供 上游服务的工具列表，内容与从实时端点捕获的内容完全一致， 并将每次工具调用转发到上游，原样返回结果。 捕获到的工具集为只读：其中没有 购买、结账或账户工具。

工具

• hasdata_amazon_product_getProductDetails — 通过 ASIN 获取 一个商品页面。必需：asin。 可选：domain、language、deliveryZip、 shippingLocation、otherSellers（同时收集 其他卖家的报价区块）。
• hasdata_amazon_reviews_getProductReviews — 获取某个 ASIN 的分页客户评论。必需：asin。 可选：domain、language、page、 searchTerm、reviewerType、stars、format、 mediaType、sortBy。
• hasdata_amazon_search_getSearchResults — 在所选 Amazon 域名上 按关键词搜索。必需：q。 可选：domain、language、page、 deliveryZip、shippingLocation、sortBy。
• hasdata_amazon_seller_getSellerDetails — 获取卖家的 公开店铺资料。必需：sellerId。可选：domain、language。
• hasdata_amazon_seller_products_getSellerProducts — 获取卖家提供的分页商品目录。 必需：sellerId。可选：domain、 language、page。

配置

• HASDATA_AMAZON_MCP_URL（可选）— 覆盖 上游端点。默认值为 https://mcp.hasdata.com/mcp?apis=amazon，包含查询字符串。 （此覆盖钩子是本次重建自行标注的还原内容。）
• HASDATA_API_KEY（可选）— 设置后，每个上游请求都会携带 x-api-key: <key> 标头，其中包含调用方自己的 HasData API 密钥。未设置时， 不会发送密钥标头；无论哪种情况，都不会发送 Authorization 标头。 （环境变量和标头名称由原始项目的注册记录确定；从此环境变量 转发密钥是明确标注的还原内容——原始工具集是在未提供密钥的情况下捕获的。）

转发机制

首次调用工具时，客户端会与上游建立可流式传输的 HTTP 会话：先发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26， clientInfo 名称为 shopdata），接着发送 notifications/initialized 通知，然后发送携带调用方参数且未经修改的 tools/call 请求。上游在 initialize 响应中返回 Mcp-Session-Id 标头时，该值会随会话后续的每个请求一同发送；此会话会在 进程的整个生命周期内重复使用。响应可能是 普通 JSON，也可能是服务器发送事件；两种格式都会读取。

成功的上游结果会原样传递，包括上游设置的任何 isError 标志。 失败情况——JSON-RPC 错误、非 2xx 状态、无法读取的响应，或 无法完成的请求——会作为 isError 结果返回，文本以 shopdata error: 开头（此错误呈现方式是本次重建自行标注的还原内容）。

CLI

每个工具也都是一个子命令，接收一个 JSON 参数字符串：

npx @reneturcios/shopdata hasdata_amazon_product_getProductDetails '{"asin":"B07FZ8S74R"}'
npx @reneturcios/shopdata hasdata_amazon_search_getSearchResults '{"q":"noise cancelling headphones","sortBy":"priceLowToHigh"}'
npx @reneturcios/shopdata --version

退出码：成功时为 0，结果包含 isError 时为 1， 用法错误时为 2。

MCP 服务

npx -y @reneturcios/shopdata mcp

MCP 客户端配置：

{
  "mcpServers": {
    "shopdata": {
      "command": "npx",
      "args": ["-y", "@reneturcios/shopdata", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/shopdata
docker run --rm ghcr.io/cloudcorprecords/shopdata --version

容器的默认命令为 mcp，因此第一种形式会启动 stdio MCP 服务；其他参数则按常规方式传递给 CLI。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全通过存根 JSON-RPC 上游运行，不会发起实时网络调用。

许可证

MIT — 参见 LICENSE。