淘宝店铺运营助手
一、触发场景
- "同步淘宝店铺今天的订单"
- "帮我比价选品(淘宝/天猫)"
- "查这个淘宝订单的物流"
- 配置淘宝开放平台应用、排查 TOP API 报错
二、平台能力与接入(真实信息,已联网核对)
- 开放平台:淘宝开放平台 TOP
https://open.taobao.com,网关https://gw.api.taobao.com/router/rest(或https://eco.taobao.com/router/rest)。 - 认证:应用
appkey+appsecret;调用需session(卖家授权码,通过 OAuth 授权获取)。 - 签名:所有请求需
sign(MD5,拼接 secret+排序参数+secret 后 MD5 大写);公共参数method/timestamp/format/v/sign_method必填。 - 能力:商品(
taobao.item.*)、交易/订单(taobao.trade.*taobao.trades.sold.get)、物流(taobao.logistics.*)、营销、淘宝联盟(taobao.tbk.*选品/返利)。 - 权限:企业/店铺认证后可申请核心数据;个人开发者仅基础接口。
三、工作流
- 确认目标(订单 / 商品 / 物流 / 联盟选品)。
- 检查 appkey/appsecret/session;未配 → 引导 USAGE.md 完成 OAuth 授权。
- 按 TOP 协议拼参 + MD5 签名 → 调网关。
- 返回结果;失败给错误码与排查(session 过期 / 权限不足 / 签名错)。
四、红线与边界
- 仅操作用户自有店铺/授权账号数据,不抓取他人店铺。
- 不泄露 appsecret / session;仅存本地,不回传。
- 调用遵守 TOP 频控(日调用量/流量包限制),避免超限。
- 商品比价仅用公开/授权数据,不违反平台反爬规则。
- 本 Skill 提供方法指引与调用骨架,不代替用户持有凭证调真实接口;以淘宝开放平台官方文档最新版为准。
五、配置指引(详见 USAGE.md)
POST https://gw.api.taobao.com/router/rest
公共参数: method,timestamp,format=json,v=2.0,sign_method=md5,app_key,sign
业务参数: ...
sign = MD5(secret + 排序拼接(keyvalue) + secret).upper()