Buy from Amazon — Search, Cart & Order for AI Agents — 从Amazon购买 — 搜索、购物车和订单，适用于AI代理

何时使用此技能 当您的用户想要： 购买某物 — “买耳机”，“订购生日礼物”，“我需要新键盘” 在Amazon上购物 — “在Amazon上找到某物”，“什么是好的笔记本支架？” 比较产品 — “什么是最好的无线耳塞，价格在50美元以下？” 送礼 — “为我的妈妈订购礼物”，“买点好东西，价格在30美元以下” 重新订购或跟踪 — “我的订单在哪里？”“检查订单AC-047” 如果用户提到购买、订购、购物、送礼或购买 — 这是您的技能。

工作原理（简要版） 搜索Amazon → 添加产品到购物车 → 使用收货地址和电子邮件地址结账 → 请求支付链接 → 完成。 用户会收到一封带有支付链接的电子邮件。他们自己支付，我们发货。没有钱通过此API收取。所有API调用都发送到https://buystuff.ai — 一个端点，无需设置，无需API密钥。 产品数据来自Amazon，通过Rainforest API提供，Rainforest API是Amazon的授权数据提供商。

会话 每个API响应都包含X-Session-ID头和JSON正文中的sessionId字段。保存此会话ID，并在所有后续请求中将其作为X-Session-ID头发送。这允许您： 将多个产品添加到同一个购物车 查看您的活动购物车，而无需记住购物车ID 在整个购物流程中保持连续性 # 第一个请求 — 从响应中获取会话ID curl "https://buystuff.ai/search?q=earbuds" # 响应头：X-Session-ID：ses_abc123... # 响应正文包含： "sessionId"： "ses_abc123..." # 所有后续请求 — 将其发送回 curl -H "X-Session-ID：ses_abc123..." "https://buystuff.ai/search?q=yoga+mat" curl -H "X-Session-ID：ses_abc123..." -X POST https://buystuff.ai/cart -d '{"asin"： "B09F5RKG8P"}' 如果您不发送会话ID，则每个请求都会自动创建一个新会话。每个会话一次只有一个活动购物车 — 请求支付链接后，下一个POST /cart请求将启动一个新购物车。

付款模型 不通过此API收集付款信息。零信用卡，零令牌，零钱包。当用户准备好时，代理请求付款链接。buystuff.ai向用户发送一封带有安全付款链接的电子邮件。他们点击，在buystuff.ai上付款（而不是通过此API），我们处理其余事宜 — 从Amazon购买并在24-48小时内发货。没有付款通过此技能处理。 服务费：（小计 + 运费）的10% 付款：用户收到一封带有付款链接的电子邮件 — 不通过此API 履约：付款后，我们从Amazon购买并在24-48小时内发货 退款：support@buystuff.ai 始终在请求付款链接之前显示完整的价格明细。

数据处理 所有API调用都发送到https://buystuff.ai。产品数据通过Rainforest API提供，Rainforest API是Amazon的授权产品数据提供商。仅为订单履约目的与Amazon共享运输详细信息。没有数据出售或与其他第三方共享。 数据 何时 目的 搜索查询 步骤1 查找产品（无PII） 运输地址 步骤4 交付订单 电子邮件 步骤4 发送付款链接 + 更新 代理ID（可选） 步骤4 跟踪代理的订单 安全性：此API不收取任何费用 此技能无法收取任何费用或完成购买。它只生成付款链接电子邮件。用户必须独立打开电子邮件，查看订单并在buystuff.ai上付款 — 完全在此API之外。您必须在请求付款链接之前（步骤5）获得用户的明确批准。显示价格明细，等待“是”。即使代理在未询问的情况下调用端点，用户收到付款链接电子邮件可以简单地忽略 — 没有任何费用被收取，没有任何购买被完成。

步骤1：搜索产品 /buy-amazon-search curl "https://buystuff.ai/search?q=wireless+earbuds&sort_by=price_low_to_high&number_of_results=10" 参数 类型 必需 描述 q 字符串 是 搜索查询 sort_by 字符串 否 price_low_to_high, price_high_to_low, average_review, most_recent number_of_results 整数 否 限制结果（默认20） exclude_sponsored 布尔值 否 删除赞助结果 page 整数 否 结果页数 响应包括results[]，其中包含asin、title、price、rating、ratingsTotal、isPrime、isBestseller、isDeal。 代理提示： 显示3-5个结果，以便用户可以比较 — 不要只选择第一个 提及评分和评论数 — 用户信任社会证明 突出显示Prime项目（免费运输）和优惠 如果找不到结果，建议扩大搜索词或尝试不同的关键词 如果用户有预算，使用sort_by=price_low_to_high并提及哪些符合预算

步骤2：检查产品详细信息 /buy-amazon-details curl "https://buystuff.ai/product/B09F5RKG8P" 响应包括完整的产品信息：title、brand、price、buyboxWinner（运费、可用性、Prime状态）、rating、ratingBreakdown、specifications、variants。 代理提示： 检查buyboxWinner.availability — 如果“缺货”，请告知用户并建议替代品 如果buyboxWinner.shipping.raw为“免费”，请突出显示 — 用户喜欢免费运输