淘宝和天猫 API

此技能封装了 JustOneAPI 提供的 10 个淘宝和天猫操作。在获取商品详情、商品评价、店铺商品列表和商品搜索方面表现最佳。常见输入参数包括 itemId、page、sort、userId、shopId。

何时使用

• 用户需要查询淘宝或天猫的商品详情或商品评价。
• 任务与店铺商品列表相关，而非跨平台通用流程。
• 用户可提供标识符或筛选条件，如 itemId、page、sort、userId。
• 用户希望获得基于 API 的精确结果，而非自由形式的摘要。

典型操作

• getTaobaoItemDetailV1：商品详情 —— 获取淘宝和天猫商品的详细数据，包括价格、图片、店铺信息等，适用于商品研究、商品目录监控和电商分析。
• getItemCommentV3：商品评价 —— 获取淘宝和天猫商品的评价数据，包括评分、时间戳、用户特征等，适用于反馈分析和商品研究。
• getTaobaoShopItemListV1：店铺商品列表 —— 获取淘宝和天猫店铺的商品列表数据，包括商品标题、价格、图片等，适用于卖家研究和商品目录追踪。
• searchItemListV1：商品搜索 —— 获取淘宝和天猫的商品搜索结果数据，包括标题、价格、图片等，适用于商品发现。

请求模式

• 本技能共提供 10 个可用操作。
• 使用的 HTTP 方法为 GET。
• 最常见的非令牌参数包括 itemId、page、sort、userId、shopId。
• 本技能中所有操作均为参数驱动请求，无需请求体。

如何使用

1. 在选择接口前，请先阅读 generated/operations.md。
2. 当用户请求匹配以下任一操作时，优先使用：getTaobaoItemDetailV1、getItemCommentV3、getTaobaoShopItemListV1、searchItemListV1。
3. 选择最符合需求的最小操作，避免猜测。
4. 若缺少必需参数，请向用户询问，不得自行编造值。
5. 调用助手时使用如下命令：

node {baseDir}/bin/run.mjs --operation "<operation-id>" --token "$JUST_ONE_API_TOKEN" --params-json '{"key":"value"}'

环境要求

• 必需项：JUST_ONE_API_TOKEN
• 本技能仅使用 JUST_ONE_API_TOKEN 进行 Just One API 的身份验证请求。
• 请妥善保管 JUST_ONE_API_TOKEN，切勿将其粘贴至聊天消息、截图或日志中。
• 可通过 [Just One API 控制台](https://dashboard.justoneapi.com/en/login?utm_source=clawhub.ai&utm_medium=referral&utm_campaign=justoneapi_taobao&utm_content=project_link) 获取令牌。
• 认证说明详见：[Just One API 使用指南](https://docs.justoneapi.com/en/?utm_source=clawhub.ai&utm_medium=referral&utm_campaign=justoneapi_taobao&utm_content=project_link)。

输出规则

• 以与用户所提淘宝和天猫任务直接相关的通俗语言回答开始。
• 在输出原始 JSON 前，优先展示所选接口中最关键的字段。
• 使用 getTaobaoItemDetailV1 时，解释返回字段为何能回答用户问题。
• 若用户提供了如 itemId、page、sort 等筛选条件，请原样回显，以明确查询范围。
• 若后端返回错误，请包含后端响应内容及确切的操作 ID。