HasData Amazon

Amazon MCP 服务

一款托管的模型上下文协议（MCP）服务，为 Claude、Cursor、Windsurf 和任何其他 MCP 客户端提供四种只读 Amazon 工具。运行关键词搜索、按 ASIN 读取商品、查询卖家，以及分页查看该卖家的库存，所有数据均为结构化 JSON；无需 Amazon 开发者账号，也无需托管任何内容。

它读取已退出登录的访客可查看的 Amazon 公开页面，支持全部 23 个地区域名。

每月 1,000 个免费额度，无需信用卡，按每次 10 个额度计算，可调用 Amazon 100 次。

https://mcp.hasdata.com/mcp?apis=amazon

• 提示词和资源

目录

• 所需条件
• 快速开始
• 提示词示例
• 工具
• 错误和故障处理路径
• 定价、免费套餐和限制
• 工具选择
• 比较
• 常见问题
• HasData 链接
• 开发
• 贡献
• 许可证

所需条件

一个 MCP 客户端，以及一个从控制面板获取的 HasData API 密钥；创建密钥免费且无需信用卡，免费套餐按每次 10 个额度计算，每月约可调用 100 次。这是一个远程服务，因此最简单的接入方式是使用 URL 和 x-api-key 标头，无需运行容器。仅支持 stdio 的客户端可通过一个轻量启动器连接该服务；启动器已发布至 npm，名称为 @hasdata/amazon-mcp，也发布至 PyPI，名称为 hasdata-amazon-mcp，如下所示。

快速开始

所有客户端使用相同的服务 URL。我们在 Claude Code 和 Claude Desktop 中进行了实际运行。其他配置块遵循各客户端文档中针对远程服务的格式。

支持 OAuth 的客户端可以将相同的 URL 添加为连接器，然后登录，无需将密钥放入配置文件。

claude mcp add --transport http amazon "https://mcp.hasdata.com/mcp?apis=amazon" \
  --header "x-api-key: HASDATA_API_KEY"

{
  "mcpServers": {
    "amazon": {
      "command": "npx",
      "args": ["-y", "@hasdata/amazon-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "amazon": {
      "command": "uvx",
      "args": ["hasdata-amazon-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "amazon": {
      "url": "https://mcp.hasdata.com/mcp?apis=amazon",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "amazon": {
      "serverUrl": "https://mcp.hasdata.com/mcp?apis=amazon",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "servers": {
    "amazon": {
      "type": "http",
      "url": "https://mcp.hasdata.com/mcp?apis=amazon",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

提示词示例

以下每条提示词都会调用一个工具；如果第二个工具需要第一个工具返回的标识符，则会依次调用两个工具。

• 在 Amazon 上查找价格低于 $40 的笔记本电脑支架，并按平均客户评价排序。
• ASIN B0DHJ7SBDR 现在的价格是多少？还有多少其他卖家在售？
• 比较此 ASIN 在 amazon.com 和 amazon.de 上的价格。
• ASIN B0DHJ7SBDR 的卖家是谁？其终身评分是多少？
• 翻查卖家 ATQQBVXK188KS 的所有商品，并找出打折商品。
• 搜索可配送到 10001 的无线耳机，并告诉我哪些送达最快。

如果提示词提到的是产品而非 ASIN，就会进行两次调用：先搜索以确定 ASIN，再查询产品以获取信息。如果提示词提到的是品牌而非卖家 ID，就会以相同方式进行两次调用：先查询产品以找到卖家 ID，再查询卖家以获取资料。

工具

五个工具，每次成功调用消耗 10 个积分。每个工具都接受 domain 参数来切换商城，共有 23 个取值，从 www.amazon.com 到欧洲、亚洲和其他地区的商城；如果商城提供多种语言，还可使用 language 参数。

获取 Amazon 搜索结果

hasdata_amazon_search_getSearchResults

某个关键词的一页搜索结果。

返回 productResults、包含赞助展示位的 ads 数组，以及包含 totalResults、currentPage、nextPageUrl 和 otherPageUrls 的 pagination。每条结果都包含 position、asin、title、url、isSponsored、price 对象、image、包含 rating 和 totalReviews 的 reviews、badges 对象、boughtInPastMonth 和 deliveryInfo。

搜索结果有意保持精简。这里不包含品牌、功能、变体、图片和卖家信息；这些信息由下方的商品工具提供。先确定 ASIN，再读取商品详情。

{
  "position": 1,
  "asin": "B077B9W343",
  "title": "Nulaxy Ergonomic Adjustable Laptop Stand for Desk, Dual Foldable Computer Riser...",
  "isSponsored": false,
  "price": { "symbol": "$", "currentPrice": 15.99, "beforePrice": 17.99 },
  "image": "https://m.media-amazon.com/images/I/61jtA8kHq9L.jpg",
  "reviews": { "totalReviews": 16800, "rating": 4.7 },
  "badges": { "amazonChoice": true, "amazonPrime": false, "bestSeller": false },
  "boughtInPastMonth": "10K+",
  "deliveryInfo": { "freeDelivery": "Join Prime", "fastestDelivery": "Mon, Sep 14" },
  "url": "https://www.amazon.com/dp/B077B9W343"
}

获取 Amazon 商品详情

hasdata_amazon_product_getProductDetails

通过 ASIN 获取单个商品的完整信息。

返回一个 product 对象，包含 asin、url、title、brand、isAvailable、condition、price 对象、primaryFeatures 和更全面的 features 映射、featureBullets、description、variants、breadcrumbs、whatIsInTheBox、图片和视频集合、specification、reviewsInfo、送达预估，以及当前的 seller 和 sellerUrl。

price 对象包含 currentPrice、商品打折时的 beforePrice、discount、priceFrom 和 otherOfferQuantity。最后一个字段表示竞品报价的数量；基础调用会报告该数量，但不会获取这些报价。只有在需要查看报价本身时才请求 otherSellers，因为这会使费用增加一半。

{
  "asin": "B0DHJ7SBDR",
  "title": "Apple iPhone 16 Pro Max, 1TB, Desert Titanium",
  "brand": "Apple",
  "condition": "Refurbished - Excellent",
  "price": {
    "symbol": "$",
    "currentPrice": 974,
    "beforePrice": 949.99,
    "discount": "-11%",
    "otherOfferQuantity": 11
  },
  "seller": "WirelessSource",
  "deliveryIsoDate": "2026-09-11T00:00:00.000Z"
}

获取 Amazon 卖家详情

hasdata_amazon_seller_getSellerDetails

某个卖家的公开店铺资料。

返回一个 seller 对象，包含 sellerId、url、storefrontUrl、name、businessName、businessAddress、about 内容块，以及四个评分时间段：oneMonthRatings、threeMonthRatings、twelveMonthRating 和 lifetimeRating。每个时间段都包含 totalVotes、averageRating，以及按星级划分的明细，其中同时列出 votes 和 percent。

这四个时间段正是这个工具值得调用的原因。终身平均评分为 4.5、基于 2,701 票，与一个月平均评分为 2、基于 4 票，描述的是截然不同的卖家；只有结合这两项，才能看出评分正在下滑。

{
  "sellerId": "ATQQBVXK188KS",
  "name": "Expercom - Apple Premier Partner",
  "businessName": "Expercom of Utah, Inc",
  "lifetimeRating": { "totalVotes": 2701, "averageRating": 4.5 },
  "oneMonthRatings": { "totalVotes": 4, "averageRating": 2 }
}

获取 Amazon 卖家商品

hasdata_amazon_seller_products_getSellerProducts

某个卖家所售商品的分页列表。

返回 productResults 和 pagination，结构与搜索工具的输出相同。每个条目包含 position、asin、title、url、price、image、reviews、badges、boughtInPastMonth、deliveryInfo 和 colorUrls。请通过遍历 pagination 获取目录中的其他商品，而不是猜测页码。

提示词和资源

该服务提供一个提示词，即一个现成的工作流，客户端可以直接提供给用户，而不必让用户自行编写工具调用。

此外，该服务还提供 9 个资源，每个资源对应一个取值为固定列表的参数。读取资源比因调用被拒而学习相关词汇更省事，而且不消耗额度。每个 URI 的格式为 hasdata://amazon/<parameter>。

两份列表均无需 API 密钥即可获取，因此客户端可以在用户注册前读取它们。

错误和失败情况

请针对以下情况做好准备，不要假设请求总能成功。

搜索无匹配结果时，会成功返回一个空的 productResults 数组，而不是报错。requestMetadata.status 仍为 ok。请先检查数组长度，再进行迭代。

所选 Marketplace 上不存在的 ASIN 会返回错误，而不是空商品。 同一个 ASIN 往往在某个域名上存在、在另一个域名上不存在，因此在 www.amazon.de 上失败并不意味着 ASIN 有误。

卖家 ID 也受 Marketplace 限制。 从 www.amazon.com 上某件商品返回的 ID 无法在其他域名上解析。

在售商品可能没有价格。 缺货、仅由其他卖家销售或受促销限制的商品，返回时可能没有可用的 currentPrice。比较价格前，请先读取 isAvailable。

deliveryZip 和 shippingLocation 不只会改变配送信息，也会改变查询结果。 可售情况、价格和卖家构成都可能随目的地变化，因此跨邮编比较时必须保持其他所有参数不变。

包含数据的结果也会包含 requestMetadata.id，在联系支持时可引用该 ID。

定价、免费额度和限制

每次成功调用 Amazon 工具会消耗 10 个积分。开启 otherSellers 会让产品调用额外消耗 5 个积分，即 15 个而不是 10 个，除非你关注的是竞品报价，否则请保持关闭。响应大小不会影响价格。

免费额度为每月 1,000 个积分，无需绑定银行卡，按基础费率可调用 Amazon 100 次。额度会随计费周期续期，因此低调用量的 Agent 可以一直使用免费额度。

付费套餐起价为每月 $59，包含 200,000 个积分，可调用 20,000 次。调用量越大，单价越低：入门套餐为每 1,000 次调用 $1.48，Basic 为 $0.60，Growth 各档为 $0.41。最新价格请查看定价页面。

套餐还决定并发数。免费额度允许同时发起 1 个请求，Startup 为 5 个，Basic 为 15 个，Growth 各档则为 50 到 500 个。对于无人值守的任务，遇到 429 时请使用退避策略重试，因为会分散查询多个 ASIN 的 Agent 会比你更早触及上限。

未返回 200 状态码的请求不会计费。成功调用但未找到任何结果，仍会计为一次调用。

工具选择

大多数情况下，遵循两条规则即可。

根据提示词提供的信息选择工具。关键词使用搜索工具，ASIN 直接使用产品工具，卖家 ID 则使用两个卖家工具之一。已有 ASIN 时再花费一次搜索调用来查找它，是最常见的浪费。

然后根据所需深度选择。搜索和卖家商品工具返回相同的精简商品信息，适合对多个商品进行排序、筛选和价格扫描。只有产品工具会返回品牌、特性、变体、图片和卖家信息，因此只有在问题涉及单个商品时才值得调用。

对比

Amazon 自己的 Product Advertising API 是获取这些数据的官方途径，但它是另一种工具。

决定性因素是资格要求。Product Advertising API 面向联盟营销者，其访问权限取决于你已经完成的销售额，因此不适用于研究、监控以及 Agent 代表你执行的任何任务。如果你符合资格且只需要可推广的商品，官方 API 会更合适。

常见问题

Amazon 有官方 MCP 服务吗？

Amazon 没有发布官方服务。此服务由 HasData 维护，并读取 Amazon 的公开页面。

什么是 Amazon MCP 服务？

MCP 服务会提供 AI 客户端可调用的工具。此服务会将 Amazon 搜索结果、商品页面和卖家店铺转换为 JSON，供 Agent 分析，无需在你的技术栈中使用浏览器或抓取库。

我需要 Amazon 账户或 API 密钥吗？

不需要。唯一需要的凭证是你的 HasData 密钥。

覆盖哪些站点？

API 支持的全部 23 个域名，从 www.amazon.com 到欧洲和亚洲站点。传入 domain 即可切换。不同站点的价格、库存情况和卖家构成都不同，因此跨域名比较是实质性的比较，而不仅仅是货币换算。

为什么搜索结果没有品牌或特性？

Amazon 不会在搜索结果页面上显示这些信息。搜索工具会返回页面上展示的内容，产品工具则会返回商品页面的信息。这种划分正是两个工具价格相同但返回的信息深度不同的原因。

otherOfferQuantity 是什么意思？

商品页面所报告的、提供同一商品的其他卖家数量。它会随基础调用一起返回。获取具体报价需要使用 otherSellers，这会额外消耗 10 个额度。

我可以将它与其他 HasData API 一起使用吗？

可以。一个密钥即可访问所有 API，并且通过 apis 参数即可使用同一个端点。将客户端指向 ?apis=amazon,google_serp，即可在一个连接中获取两组工具；也可以指向 mcp.hasdata.com/mcp 获取完整目录。

HasData 是否隶属于 Amazon？

不隶属于。HasData 是一项独立服务，与 Amazon 没有关联，也未获得 Amazon 的认可或赞助。Amazon 是其各自所有者的商标。这些工具仅处理公开可用的数据，你有责任按照 Amazon 的条款和适用法律使用结果。

合规与个人数据

卖家资料包含企业名称和企业地址，这些信息由 Amazon 发布在店铺页面上。请将其视为企业记录，而不是自由格式数据；存储这些信息前，请先确认自身的义务。

HasData 链接

• Amazon Scraper API，这些工具背后的 REST 端点
• API 文档
• MCP 服务文档
• 定价
• 控制台

其他 HasData MCP 服务：Google Search、Google Maps、Google Trends、Google Flights、DuckDuckGo、YouTube、TikTok、Instagram、Zillow、Airbnb、Booking.com、Indeed。

开发

启动器是连接到远程服务的轻量级 stdio 桥接，因此无需构建。

npm install
HASDATA_API_KEY=your_key_here npm test

test/ 中的测试会验证工具契约，也就是可能在本仓库未提交任何更改时发生变动的部分。测试会检查 ?apis=amazon 是否返回预期的工具数量、名称是否有变、每个工具是否仍声明了必需参数并附带描述，以及正在使用的密钥是否确实有效。最后一项检查会实际调用一个工具，并消耗 10 个额度；这是为了一次可能因正确原因而失败的探测所付出的代价。

还有一项测试涵盖了本文档未介绍的工具。服务还会列出一个评论工具，但其上游端点已停用并会返回错误，因此介绍它只会让读者陷入死胡同。该测试会固定这一状态，而不是忽略它；如果端点恢复，或服务移除该工具，测试就会失败，届时本文档也需要做出相应决定。

契约测试套件还会按计划每周运行一次，因为上游工具列表可能在无人改动此仓库的情况下发生变化。

贡献

如果工具表、响应示例或文档描述的行为与实际情况不符，欢迎提交 issue。我们提供了专门用于此类问题的模板。也欢迎针对这些内容以及启动器的任何部分提交拉取请求。

许可证

MIT，详见 LICENSE。