京东商城 API

此技能封装了 JustOneAPI 提供的 3 个京东商城操作。在获取商品详情、商品评论和店铺商品列表方面表现最佳。常见输入参数包括 itemId、page、shopId。

何时使用

• 用户需要查询京东商城的商品详情或商品评论。
• 任务场景适合于店铺商品列表，而非跨平台通用流程。
• 用户可提供标识符或筛选条件，如 itemId、page、shopId。
• 用户希望获得基于 API 的精确结果，而非自由形式的摘要。

典型操作

• getJdItemDetailV1：商品详情 — 获取京东商品详情数据，包含价格、图片及店铺信息，适用于商品分析、监控与电商研究
• getItemCommentsV1：商品评论 — 获取京东商品评论数据，包含评分、时间戳及用户特征信号，适用于客户反馈分析与产品研究
• getJdShopItemListV1：店铺商品列表 — 获取京东店铺商品列表数据，包含商品标题、价格与图片，适用于商品目录追踪与卖家研究

请求模式

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

使用方法

1. 在选择端点前，请先阅读 generated/operations.md。
2. 当用户需求匹配时，从以下操作中选择其一：getJdItemDetailV1、getItemCommentsV1、getJdShopItemListV1。
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_jd&utm_content=project_link)。
• 认证说明：[Just One API 使用指南](https://docs.justoneapi.com/en/?utm_source=clawhub.ai&utm_medium=referral&utm_campaign=justoneapi_jd&utm_content=project_link)。

输出规则

• 回答应以与用户请求相关的自然语言开头。
• 在输出原始 JSON 前，列出所选端点中最关键的字段。
• 使用 getJdItemDetailV1 时，解释返回字段如何回应用户问题。
• 若用户提供过 itemId、page、shopId 等筛选条件，请原样回显，明确范围。
• 若后端返回错误，需包含后端响应内容及确切的操作 ID。