SuperAPI AI 工具集

ecommerce-1688-product-detail

营销与增长

查看项目

更新于 10-16 01:36

技能介绍

用途:查询 1688 公开商品详情,属于公开数据只读操作,不涉及卖家后台、店铺授权、收藏写入或账户变更。

主要能力:调用研究代理接口 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 充值。付费失败后未经用户同意不得探测其他商品、市场、页面或操作。

结果呈现:保留完整响应文件,区分 Nexscope 传输信封与内部业务响应;仅总结返回事实,缺失值标为未知,保留原始币种、单位、标识与日期,不虚构换算或默认值;错误时报告 traceId,并保留响应头中的 X-Cost-Token 与 X-Cost-Credit 作为计费元数据。

限制:HTTP 401 表示认证失败,检查 NEXSCOPE_API_KEY 与 NEXSCOPE_PROXY_BASE,不要让用户在聊天或操作 JSON 中粘贴凭证;HTTP 402 表示积分不足,停止流程并引导至上述帮助页;市场授权失败需续期对应平台账户或令牌,不得自动替换店铺、地区或创建者;网络失败需说明是读取还是变更操作,变更操作未核对上游状态前不得重试。每次调用仅一个明确请求,出错后不得静默更改实体、市场、日期、操作或页码。输出需脱敏凭证、签名 URL、Cookie 与内部账户标识。未在 references/testing.md 中找到对应证据时,不得声称已通过实时、ZIP 安装或生产验证。首次实时响应前具体扣费未知。