用途:该技能用于查询 1688 公开商品详情,属于公开数据、只读操作,不涉及卖家后台、店铺授权、收藏写入或账户变更。
主要能力:通过 Nexscope 研究代理调用接口 POST /api/v1/tools/research/alibaba1688/productDetail。必填参数为 offerId(正整数字符串),可选参数为 currency(三字母代码);仅发送文档中列出的字段,未知字段在联网前拒绝。
使用方式:先阅读 references/api.md 了解完整参数、响应与错误约定,再执行 python scripts/alibaba1688_product_detail.py '<JSON参数>' --no-cache,每次调用只处理一个明确请求。最小示例:{"offerId":"1040473674152"}。需设置环境变量 NEXSCOPE_API_KEY;凭证缺失或过期时访问 https://www.nexscope.ai/help/skills-external-access?co-from=skillNS 充值。
结果处理:要求外层 code 为 0 才使用数据,非零为平台失败,展示外层 msg 但不将其措辞当作重试指令;HTTP 200 与嵌套业务状态不能替代平台校验。保留完整响应文件,区分 Nexscope 传输信封与内部业务响应,出错时报告 traceId。保留源货币、单位、标识、日期与缺失值,不虚构换算或默认值。
计费与错误:该操作消耗 Nexscope 积分,首次实时响应前确切费用未知;保留响应头 X-Cost-Token 与 X-Cost-Credit 作为服务端计费元数据。HTTP 401 表示认证失败,检查 NEXSCOPE_API_KEY 与 NEXSCOPE_PROXY_BASE,不要让用户在聊天或操作 JSON 中粘贴凭证;HTTP 402 表示积分不足,停止流程并引导用户访问上述帮助页。付费失败后未经用户批准,不得探测其他商品、市场、页面或操作。
限制:仅限公开数据只读;一次调用一个明确请求,出错后不得静默更改实体、市场、日期、操作或页码;输出中须脱敏凭证、签名 URL、Cookie 与内部账户标识;除非 references/testing.md 中有对应证据,不得声称已实时、ZIP 安装或生产验证。