用途:按已知 1688 商品 offerId 查询单个商品的结构化记录,用于采购与报价决策;不支持按关键词或图片发现商品,发现商品需用搜索类技能。
主要能力:返回商品身份(offerId、subject、productUrl、类目、状态)、媒体与文案(图片、主视频、详情视频、描述、卖点)、SKU(skuId、属性、图片、零售价、SKU 价、指定币种价、库存)、销售(零售价、价格阶梯、销量、MOQ、单位、代发与包邮条款)、物流(发货地、发货保障、包装尺寸重量、各 SKU 度量)、供应商(公司名、交易/服务分、回头率、质量退款指标)、采购(混批设置、服务标签、促销、发票、证书、商品标识)。
价格语义:retailPrice 用于 1 件;2 件及以上使用 SKU 价加 priceRanges 价格阶梯。缺失 retailPrice 可能表示旧版商品模型或未配置零售价,不得由其他字段推断 1 件价。CNY 价格与请求币种的外币价格是独立字段,不得混标。
调用方式:API 端点 POST /alibaba1688/productDetail;Python 脚本 python scripts/alibaba1688_product_detail.py '{"offerId":"1040473674152","currency":"USD"}'。offerId 为必填的正整数,建议按字符串传入避免精度丢失;currency 为可选三位币种代码。可从 https://detail.1688.com/offer/1040473674152.html 提取路径中的数字作为 offerId。不要传 uid、chatId、requestId、groupId 等平台注入字段。单价 1 算力。
输出:脚本默认将完整响应写入 <cwd>/linkfox/<日期>/<session>/data/ 下的 JSON 文件;响应≤8 KB 全量打印到 stdout,超过则只打印摘要,可用 --inline 强制全量。建议先用摘要判断,再按需从文件抽取字段。价格敏感决策加 --no-cache,最终成交价以采购流程的订单预览为准。
显示规则:先展示标题与 offerId,SKU 用表格展示属性、库存、1 件零售价、2 件以上批发价、外币价与代发价;CNY 与外币分列;保留缺失为未知;说明 MOQ、单位、混批、代发/包邮、发货地、发货保障与包装尺寸;供应商指标按原始值与百分比呈现,不引申质量结论。
限制:每次调用只接受一个 offerId;不支持关键词或图片搜索、下单、付款、物流跟踪、开票与账户操作,也不提供历史价格趋势、评价或数据库分析;价格库存物流供应商数据实时变动,视频、证书、促销和部分物流字段可能缺失;外币字段不保证每个 SKU 或价格层级都有,缺失也可能是换算失败。