linkfox-1688-product-detail

查询已知 1688 商品的完整详情,核对标题、属性、图片视频、SKU 库存、1 件零售价、2 件及以上批发阶梯价、外币价、起批量、物流包装和供应商指标,并查看代发、混批、发票及证书等采购信息。适用于提供 1688 商品链接或商品编号后的商详查询、采购核价和供应商事实核验。不用于关键词或图片找品、历史价格和评论分析,也不执行授权、下单、支付、物流追踪或开票。

SKILL.md

GitHub

1688 商品详情

适用范围

适用

用户已有 1688 商品链接或商品编号,希望核对商品、SKU、价格库存、物流或供应商信息时使用,无需明确说“商详”。

场景速查

用户表达 查询场景
查这个 1688 商品 ID 或链接的完整详情 商品标题、属性、媒体和规格。
核对 SKU 价格、库存和起批量 采购及报价核验。
查 1 件采购价和批发阶梯价 零售价与批发价分开核对。
查包装重量、发货地和发货保障 物流准备。
看供应商服务分和回头率 供应商事实核验。
有没有一件代发、混批、发票或证书 采购条款查询。

边界

  • 只有图片或关键词、尚无商品编号时,先使用 1688 搜索或以图搜图技能发现商品。
  • 账号授权、创建订单、支付链接、物流追踪、确认收货及开票使用 1688 采购流程。
  • 历史价格趋势、评论和数据库分析不在本技能范围内。

前置条件

先确定商品:取得用户提供的 1688 商品链接或商品编号,明确需要核对的 SKU、采购数量、币种和采购信息。完整参数约定见 references/api.md。

查询流程

  1. 确认目标商品;用户提供标准链接(如 https://detail.1688.com/offer/1040473674152.html)时,提取路径中的数字作为商品编号。
  2. 根据用户关注的规格、数量和币种,按 references/api.md 准备业务参数并查询。避免重复查询同一商品的同一组参数。
  3. 用于采购成本、利润率、报价或下单决策时,添加 --no-cache 获取实时价格;最终成交价以采购流程的实时订单预览为准。
  4. 按接口参考判断响应,核对返回商品编号与请求一致;保留完整原始响应,从落盘文件按需提取字段。失败或空结果遵守执行方式中的成本约束。
  5. 先展示商品标题与编号,再按用户需求展示 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。