这是什么
Amazon Selling Partner API 是 Amazon 给卖家的官方 API, 接通后可以:
- 拉真实订单 (Order API)
- 看 FBA 库存 (Fulfillment Inventory)
- 拉广告报表 (Sponsored Products / Brands / Display)
- 看月度财报 (Finances API)
- 自动同步 Listing (Listings Items API)
FastOpenAI SP-API 接入完整后端 (W7.B), AI 在对话中直接调真实数据.
5 步上手
1. 注册 SP-API 开发者账号
去 https://developer-docs.amazon.com/sp-api/ → 注册 Amazon Developer 账号.
如果你已经在 Seller Central 有店铺, 用同 email 注册.
2. 创建 LWA (Login with Amazon) App
Developer Console → "Apps & Services" → "Create new app":
- App name: FastOpenAI Integration
- App type: SP-API (Public)
- 需要的角色 (Roles): Pricing / Inventory / Orders / Finance / Reports
3. 拿凭证
注册成功 Amazon 会给你:
- LWA Client ID
- LWA Client Secret
- Refresh Token (一次性授权后拿到)
4. 进 FastOpenAI 配置
侧栏 我的数据 → 找 📦 Amazon SP-API → 进配置页 → 填:
- LWA Client ID
- LWA Client Secret
- Refresh Token
- 选 Marketplace (US / DE / UK 等)
5. 测试 + 激活
点 "测试连接" → 看到 "已成功拉 5 个最近订单" 即可激活.
之后在对话里问:
- "看下我昨天卖了多少单"
- "拉过去 7 天 ACOS 给我"
- "我现在 FBA 库存覆盖天数最少的 5 个 SKU"
接入的难点 (诚实告知)
- ⚠️ 审核严格: Amazon 对 SP-API 审核严, 个体卖家可能等 1-2 周
- ⚠️ 凭证流程复杂: 5 步以上, 第一次会卡 OAuth flow
- ⚠️ 限流明显: 1 个店铺一天能拉的报表有限
- ⚠️ 多站点麻烦: 美国 / 欧洲 / 日本各自单独 refresh_token
推荐: 如果你年销 500w 以下, 用 sheets-local 上传 Excel 替代, 体验差不多.
真实例子
KitchenPro 厨具旗舰店 (W10 Case 01): 接入 SP-API 后:
- PPC 优化向导自动拉 Search Term Report (省了手动导出)
- 库存补货自动看实时 FBA 库存
- 6 个月 ACOS 30% → 18%, 省广告费 ¥34,000
- 核心收益: AI 看到的是真实当下数据, 不是隔夜的 Excel
SP-API 能调的关键工具
| 工具组 | 用途 |
|---|---|
| Orders | 订单查询 / 状态跟踪 |
| Inventory | FBA 库存 + 在途 + 可售 |
| Reports | 14 种报表 (Business / Returns / Search Terms 等) |
| Sponsored Ads | 广告投放数据 (核心配合 PPC skill) |
| Finances | 月度 P&L (核心配合 finance skill) |
| Listings | 修改 Listing (谨慎用) |
FAQ
Q: 配置失败怎么办? A: 90% 是 Refresh Token 过期或 scope 不全. 重新走一遍 LWA OAuth flow.
Q: 国内能用吗? A: 能, SP-API 在 AWS 全球 region, 不需翻墙 (Amazon 没被墙).
Q: 用了 SP-API 还需要 sheets-local 吗? A: 不需要. SP-API 实时同步比 Excel 上传强. 但有些自定义数据 (例如成本价 / 内部 SKU 编码) 还得 Excel 维护.
Q: 多少钱? A: SP-API 免费 (Amazon 不收费), FastOpenAI 包含在 basic 套餐及以上.
隐私 / 安全
- LWA 凭证加密存 (AES-256-GCM)
- AI 只读, 不会修改你的 Listing / 订单
- 如果想让 AI 修改 (例: 改广告出价), 需在 dashboard 显式开启写权限 (默认关)
- 凭证可随时撤销 (Amazon Developer Console)
下一步
- 注册 Amazon Developer: https://developer-docs.amazon.com/sp-api/
- 配置 FastOpenAI:
/dashboard/integrations/sp-api - 配合用: PPC 优化 / 库存补货 / Listing 优化