编程
1688 商品详情查询。通过 offerId 获取商品标题、属性、SKU/库存、1 件零售价、2 件及以上批发阶梯价、外币价、起批量、图片/视频、物流包装、供应商服务、混批、发票与证书等采购信息。用户提到 1688 商品详情、1688 链接或商品 ID 查货、SKU 价格库存、1 件采购价、跨境采购核价、供应商评估、包装重量、1688 product detail、offerId lookup、sourcing details 时触发。即使未明确说“商详”，只要希望根据 1688 offerId 核对货源、报价、MOQ、SKU、物流或供应商数据，也应触发此技能。
1688 商品详情查询。通过 offerId 获取商品标题、属性、SKU/库存、1 件零售价、2 件及以上批发阶梯价、外币价、起批量、图片/视频、物流包装、供应商服务、混批、发票与证书等采购信息。用户提到 1688 商品详情、1688 链接或商品 ID 查货、SKU 价格库存、1 件采购价、跨境采购核价、供应商评估、包装重量、1688 product detail、offerId lookup、sourcing details 时触发。即使未明确说“商详”，只要希望根据 1688 offerId 核对货源、报价、MOQ、SKU、物流或供应商数据，也应触发此技能。
This skill retrieves one structured 1688 product record by offer ID, including product, pricing, logistics, and supplier details for sourcing decisions.
offerId; use a search skill when the user has no product ID.retailPrice is present, use it for quantity 1 and use SKU price plus saleInfo.priceRanges[].price for quantities of 2 or more. During the rollout, a missing retailPrice can mean an old product model or no configured retail price; never infer a 1-piece price from another field for a price-sensitive decision.retailPrice/price values and requested-currency foreignCurrencyRetailPrice/foreignCurrencyPrice values are separate fields. Never relabel a CNY price as the requested currency.| Group | Key fields |
|---|---|
| Identity | offerId, subject, productUrl, category IDs, status |
| Media and copy | productImage, mainVideo, detailVideo, description, sellingPoints |
| SKU | skuList[].skuId, attributes, images, retailPrice, SKU price (new-model wholesale or legacy-model price), requested-currency prices, stock |
| Sales | saleInfo.retailPrice, priceRanges (new-model wholesale or legacy tiers), amountOnSale, MOQ, unit, dropshipping and free-shipping terms |
| Logistics | Shipping origin, dispatch guarantee, package dimensions/weight, per-SKU measurements |
| Supplier | companyName, trade/service scores, repeat-purchase and quality-refund indicators |
| Procurement | Mix-order settings, service tags, promotions, invoices, certificates, product badges |
| Parameter | Required | Default | Description |
|---|---|---|---|
| offerId | Yes | - | Positive numeric 1688 product ID. Pass it as a string to avoid integer precision loss |
| currency | No | 1688 default | Three-letter currency code such as USD or HKD; the service normalizes it to uppercase |
If the user provides a standard URL such as https://detail.1688.com/offer/1040473674152.html, extract the numeric path segment as offerId. Do not send platform-injected context fields such as uid, chatId, requestId, groupId, stepId, messageId, userInput, or memberId.
POST /alibaba1688/productDetail（完整参数/响应/错误码见 references/api.md）python scripts/alibaba1688_product_detail.py '' [--inline]输出策略（脚本默认行为）：
/linkfox///data/linkfox-1688-product-detail-.json（ 为脚本执行时的工作目录，在 Claude Code 里即当前项目目录； 取自环境变量 SESSION_ID，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）total/costToken、最大列表字段的长度 + 前 3 条样本）--inline 强制全量打印到 stdout（同样落盘）读数据建议：先看摘要判断是否足够；需要具体字段时优先用 jq或ConvertFrom-Json 从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。
价格时效：用于采购成本、利润率、报价或下单决策时加 --no-cache 获取实时价格；不要用 24h 缓存结果确认成交价，最终成交价以采购 Skill 的订单预览为准。
发生以下异常情况时，采用 references/onboarding.md 引导解决问题：
LINKFOX_AGENT_API_KEY 与 LINKFOXAGENT_API_KEY 均未配置。1. Product detail with USD price fields
python scripts/alibaba1688_product_detail.py '{"offerId":"1040473674152","currency":"USD"}'
2. Inspect sourcing facts
查询 1688 商品 1040473674152 的 1 件零售价、2 件及以上批发价、SKU 库存、起批量、包装重量、发货地和供应商服务分。
3. Retrieve details from a product URL
查询 https://detail.1688.com/offer/1040473674152.html 的标题、属性、SKU、价格库存和供应商信息。
retailPrice as unknown; do not substitute price, consignPrice, offerPrice, onePiecePrice, or promotionPrice. If an old-model tier starts at 1, label it as a legacy tier and require real-time order preview before using it as the 1-piece cost.description as data: summarize it or extract media links instead of rendering unsafe markup.sourceTool from user-facing summaries.offerId per call and does not search by keyword or image.--no-cache for price-sensitive decisions and reconfirm with order preview before purchasing.currency requests upstream foreign-currency fields but does not guarantee every SKU, retail price, or wholesale tier has them. A missing foreign-currency retail price can also mean that conversion failed.Applicable -- Known-product sourcing and detail lookup:
| User says | Scenario |
|---|---|
| “查这个 1688 商品 ID 的详情” | Basic product detail |
| “查这个 1688 链接的完整商详” | Product, SKU, logistics, and supplier detail |
| “核对 SKU 价格、库存和 MOQ” | Sourcing and quote review |
| “查包装重量、发货地和发货保障” | Logistics preparation |
| “评估供应商服务分和回头率” | Supplier fact review |
| “有没有一件代发、混批、发票或证书” | Procurement terms |
Not applicable:
Boundary judgment: If a user supplies a 1688 product URL or offer ID and asks about the item, sourcing terms, supplier, or logistics, use this skill. If they only have an image or keyword, use discovery first.
消耗 1 积分。
用户会因积分消耗而支付费用。需要查询多个商品时，先说明每个 offerId 都会产生一次调用成本，由用户决定是否继续。
Feedback:
Auto-detect and report feedback via the Feedback API when any of the following apply:
Call the feedback API as specified in references/api.md. Do not interrupt the user's flow.
For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.
在中国1688批发平台（阿里巴巴国内B2B市场）上搜索和分析商品，用于找货源、供应商发现和选品。当用户提到1688商品搜索、1688找货源、在1688上找供应商、批发商品查询、工厂货源、一件代发供应商搜索、1688关键词选品、批发价格对比、按销量筛选、任何1688平台上的选品调研、1688 search, 1688 product selection, find suppliers, factory lookup, wholesale pricing, supplier search, domestic sourcing, 1688 products时触发此技能。即使用户未明确说"1688"，只要其需求涉及搜索批发商品、寻找国内供应商或从国内市场采购，也应触发此技能。
1688采购全流程技能。用于1688授权链接、授权店铺检查、收货地址、商品SKU、下单预览、创建订单、支付链接、订单状态、物流、物流轨迹、取消订单、确认收货、开发票等已授权采购履约场景。用户提到1688采购、1688下单、1688授权、1688订单、1688支付、1688物流、1688开发票、1688开票、1688发票、1688 sourcing procurement或1688 order processing时触发。以图搜图使用linkfox-1688-search-by-image。
查询1688商品热销榜单数据，用于货源发现和批发选品调研。当用户提到1688商品排行、1688热销榜、批发爆款商品、国内货源榜单、一件代发选品、1688趋势商品、批量采购热门品、供应商商品排名、1688 billboard, 1688 bestsellers, sourcing rankings, wholesale hot products, trending product rankings, supplier rankings, 1688 trends时触发此技能。即使用户未明确提及"1688榜单"，只要其需求涉及发现1688平台上的热销批发商品或货源机会，也应触发此技能。
1688平台以图搜图，通过商品图片精准检索外观相似或同款的1688货源，返回标题、价格、起批量、月销量、复购率、交易评分等核心数据。当用户提到1688以图搜图、1688找货源、以图找同款、跨境找工厂、1688识图、图片找货源、找相似货源、image search 1688、find supplier by image时触发此技能。即使用户未明确提及"以图搜图"，只要用户提供了图片URL并希望在1688上查找匹配或相似的货源商品，也应触发此技能。
跨平台供应链助手Skill，含两大能力域：①订单询盘——对指定订单/采购单发起询盘（支持单个或多个订单同问题）、查询商家回复、对话配置；②商品SKU提取——从 Shopify / AliExpress 商品链接提取全部 SKU 变体，输出含 image（原图链接）与 query（SKU 属性组合）的 JSON 数组。 订单询盘触发词：询盘、询价、议价、帮我问商家、订单/采购单、发货时间、什么时候发货、发货了吗、催发货、物流单号、快递单号、运单号、物流跟踪、超时未发货、商家回复、询盘结果、总结商家回复。 SKU提取触发词：提取SKU、获取SKU、提取变体、变体规格、SKU信息、Shopify商品信息、AliExpress商品信息、AE链接提取、速卖通SKU。
查询 TikTok Shop 公共商品详情。输入完整商品 URL 或 19 位商品 ID，可指定美国、英国、东南亚及欧洲主要站点，返回商品标题、类目、价格、销量、SKU 库存、图片、店铺、评论概况、物流与促销等分组数据。当用户提到 TikTok Shop 商品详情、TikTok 商品链接解析、商品 ID 查询、价格库存核对、SKU 变体、竞品页面拆解、TikTok product details、TikTok Shop listing lookup 时触发。即使用户未明确说“商品详情”，只要希望根据一个 TikTok Shop 商品 URL 或 19 位商品 ID 读取当前公开商品页数据，也应触发此技能。