linkfox-1688-product-detail
查询已知 1688 商品的完整详情,核对标题、属性、图片视频、SKU 库存、1 件零售价、2 件及以上批发阶梯价、外币价、起批量、物流包装和供应商指标,并查看代发、混批、发票及证书等采购信息。适用于提供 1688 商品链接或商品编号后的商详查询、采购核价和供应商事实核验。不用于关键词或图片找品、历史价格和评论分析,也不执行授权、下单、支付、物流追踪或开票。
SKILL.mdskills/linkfox-1688-product-detail/SKILL.md
GitHub1688 商品详情
适用范围
适用
用户已有 1688 商品链接或商品编号,希望核对商品、SKU、价格库存、物流或供应商信息时使用,无需明确说“商详”。
场景速查
| 用户表达 | 查询场景 |
|---|---|
| 查这个 1688 商品 ID 或链接的完整详情 | 商品标题、属性、媒体和规格。 |
| 核对 SKU 价格、库存和起批量 | 采购及报价核验。 |
| 查 1 件采购价和批发阶梯价 | 零售价与批发价分开核对。 |
| 查包装重量、发货地和发货保障 | 物流准备。 |
| 看供应商服务分和回头率 | 供应商事实核验。 |
| 有没有一件代发、混批、发票或证书 | 采购条款查询。 |
边界
- 只有图片或关键词、尚无商品编号时,先使用 1688 搜索或以图搜图技能发现商品。
- 账号授权、创建订单、支付链接、物流追踪、确认收货及开票使用 1688 采购流程。
- 历史价格趋势、评论和数据库分析不在本技能范围内。
前置条件
先确定商品:取得用户提供的 1688 商品链接或商品编号,明确需要核对的 SKU、采购数量、币种和采购信息。完整参数约定见 references/api.md。
查询流程
- 确认目标商品;用户提供标准链接(如
https://detail.1688.com/offer/1040473674152.html)时,提取路径中的数字作为商品编号。 - 根据用户关注的规格、数量和币种,按
references/api.md准备业务参数并查询。避免重复查询同一商品的同一组参数。 - 用于采购成本、利润率、报价或下单决策时,添加
--no-cache获取实时价格;最终成交价以采购流程的实时订单预览为准。 - 按接口参考判断响应,核对返回商品编号与请求一致;保留完整原始响应,从落盘文件按需提取字段。失败或空结果遵守执行方式中的成本约束。
- 先展示商品标题与编号,再按用户需求展示 SKU 价格库存、采购条款、物流和供应商信息。
执行方式
- 直接调用接口:接口端点、完整参数、响应和错误码见
references/api.md。 - 脚本调用(推荐):
python scripts/alibaba1688_product_detail.py '<JSON 参数>' [--inline] [--no-cache]。 - 成本约束:每次接口调用消耗 1 算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动修改参数连续试探或重复请求;需要继续查询时,先向用户说明额外消耗。
输出策略
- 始终保存完整响应,目标路径为
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-1688-product-detail-<timestamp>.json。<cwd>为脚本运行时的工作目录,<session>优先取环境变量SESSION_ID,用于聚合同一任务的数据。禁止写入系统临时目录(含/tmp),当前目录不可写时应报错。 - 响应序列化为 JSON 后的 UTF-8 大小不超过 8000 字节:保存后,将完整 JSON 打印到标准输出。
- 响应序列化为 JSON 后的 UTF-8 大小超过 8000 字节:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如
total、costToken)、最大列表字段的长度和前 3 条样本。 - 添加
--inline可强制全量打印到标准输出,同时仍保存文件。
先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。
执行规则
算力消耗预估
1 算力/次。需要查询多个商品时,先说明每个商品查询都会产生一次调用成本,由用户决定是否继续。
声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。
解决认证和算力问题
出现以下情况时,按 references/onboarding.md 的指引处理:
- 未配置接口密钥:
LINKFOX_AGENT_API_KEY和LINKFOXAGENT_API_KEY均为空。 - 响应状态码为
401或402。 - 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
约束与建议
- 保留完整事实:按返回数据说明标题、属性、图片视频、SKU、销量、物流、供应商和采购信息;缺失字段保持未知,不补造值,也不把缺失解释为
false、0或空字符串。 - 区分零售价与批发价:新零售价模型下,1 件读取匹配 SKU 的
skuList[].retailPrice,无 SKU 商品读取saleInfo.retailPrice;2 件及以上读取匹配 SKU 的price,并结合saleInfo.priceRanges[]选择数量所在批发阶梯。最小起批量为 1 不代表批发价可用作 1 件价。 - 不推定缺失零售价:
retailPrice缺失可能是旧商品模型或未设置零售价;不得用price、consignPrice、jxhyPrice、pfJxhyPrice、offerPrice、onePiecePrice或promotionPrice代替。旧模型阶梯从 1 件起时,标明“旧模型阶梯”,涉及成本、利润或下单仍需实时订单预览确认。营销价不能代替零售价,最终可购性、优惠、运费及成交价以订单预览为准。 - SKU 用表格展示:列出规格属性、库存、1 件零售价、2 件及以上批发价、可用外币价和代发价格;不要把代发兼容字段当作零售价。
- 人民币与外币分列:人民币
retailPrice、price、offerPrice不得直接标成请求币种。请求币种对应foreignCurrencyRetailPrice、fenxiaoPriceInfo.foreignCurrencyPrice等返回字段,未返回的外币价格保持未知。 - 列明采购与物流条款:展示起批量、单位、混批、代发、包邮、发货地、发货保障和件重尺;商品与 SKU 的重量、尺寸单位按接口参考原样区分,不混用 g 与 kg。
- 供应商指标保持原义:展示供应商名称、交易与服务分、回头率、揽收率和品质退款率的原值及百分比,不据此作无数据支持的质量承诺。
- 按需展示媒体:图片有助于比较时,内联展示商品和 SKU 图片。商品详情中的 HTML 作为数据摘要或提取媒体链接,不直接渲染不安全标记;内部来源标签
sourceTool不进入面向用户的摘要。
使用示例
查询带外币价格字段的商品详情
python scripts/alibaba1688_product_detail.py '{"offerId":"1040473674152","currency":"USD"}'
核对采购和物流事实
用户:查询 1688 商品 1040473674152 的 1 件零售价、2 件及以上批发价、SKU 库存、起批量、包装重量、发货地和供应商服务分。
获取实时数据,分别展示零售价、批发阶梯、币种、规格、采购条款和供应商原始指标。
从商品链接读取详情
用户:查询 https://detail.1688.com/offer/1040473674152.html 的标题、属性、SKU、价格库存和供应商信息。
提取商品编号后查询,按需从保存的完整响应中读取所需信息。
使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。
更多优质、专业的跨境电商技能,请访问 LinkFox Skill。