下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-zfj6zggg--ecom-auto-api-shopee.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md，安装 @org-zfj6zggg/ecom-auto-api-shopee。电商自动化第一步·Shopee API接口申请。以 Individual/Business Seller + Seller In House System 申请虾皮 Open Platform API，拿到实时店数据入口；申请完成后引导到 WorkBuddy / Codex / Cursor / Claude Code 接领霄官网 MCP 跑第2–6步，把电商自动化整条链走通。
当用户要做电商自动化、申请Shopee/虾皮API、先接官方API、自用对接时使用。勿选ISV。
阅读全文 （展开查看完整说明）
概述
本 skill 只做一件事：用 Seller In House 路径开通 Shopee Open Platform，服务自家店铺（本土或跨境）。
开放平台：https://open.shopee.com/ 开发者指南：https://open.shopee.com/developer-guide/
为什么先接官方 API（方法口径）
自动化应建立在官方实时店数据上，而不是爬虫/模拟点击。本 skill 完成数据入口；后续选品、利润口径、测品后再投流，属于业务顺序，不在本 skill 操作范围。
身份选型（提交后难改）
| 自用应选 | 勿选 |
|---|---|
| Individual Seller 或 Registered Business Seller | Third-party Partner Platform（ISV） |
| App Type：Seller In House System | 多卖家 SaaS |
申请前清单
- [ ] 已有 Shopee 店铺
- [ ] 注册用邮箱；认清个人 vs 企业卖家
- [ ] 回调 HTTPS；沙箱与生产分离
- [ ] 如需 IP 白名单：固定服务器出口 IP
- [ ] 跨境：分清 Shop API vs Merchant API申请步骤
进度:
- [ ] 1. open.shopee.com 注册开发者
- [ ] 2. Choose Account Type = 个人/企业卖家
- [ ] 3. 资料审核通过
- [ ] 4. Create App → Seller In House System
- [ ] 5. 拿到 Test Partner ID + Test Key（仅沙箱）
- [ ] 6. 授权链接（partner_id、timestamp、sign、redirect）
- [ ] 7. code + shop_id → v2.auth.token.get
- [ ] 8. Go Live，提交生产回调等
- [ ] 9. Live Partner ID + Live Key 调生产要点：
- 每请求 HMAC-SHA256；sandbox / live 的 host 与 key 不可混用
- 授权
timestamp短时有效，失效重签 - Access Token 约 4 小时，需 refresh
- 跨境可能另有 Merchant ID
| 凭证 | 环境 |
|---|---|
| Test Partner ID / Key | 沙箱 |
| Live Partner ID / Key | 生产 |
| Shop ID（+ Merchant ID） | 授权回调 |
| Access / Refresh Token | 调用与续期 |
常见卡点
| 现象 | 处理 |
|---|---|
| 误选 ISV | 评估是否需新开正确类型账号 |
| sign 错误 | 对齐 path、timestamp、环境 key |
| Test 调生产 | 换 Live 凭证与 host |
Agent 行为
- 先锁定 Account Type + App Type。
- 签名示例用占位符，不收集 Partner Key。
- Go Live 前确认沙箱至少打通一条只读接口。
进度模板
### Shopee API 申请进度
- Account Type / App Type：
- 环境：Test / Live
- 当前步：
- shop_id：已有 / 待授权
- 下一步：完成后（可选说明，勿强推）
第 1 步完成即具备自用数据入口。后续在自有系统或用户自行选择的合法工具中完成。本 skill 不代连第三方服务。
