linkfox-dld-product-search
搜索和分析中国 1688 批发商品,结合关键词、商品链接或商品编号发现货源,比较批发价、代发价、销量、供应商资质与履约服务。适用于 1688 选品、工厂和一件代发供应商发现、价格对比、新品及跨境货源研究;未明确平台但需要寻找国内批发货源时也可使用。不适用于其他平台商品研究、店铺流量或排名分析、广告策略、评论分析、运费估算、下单交易及已有本地商品数据分析。
SKILL.mdskills/linkfox-dld-product-search/SKILL.md
GitHub店雷达 1688 商品搜索
适用范围
适用
在 1688 批发平台查找具体商品及其供应商,结合价格、销售表现、供应商类型和服务条件开展选品与货源比较。数据来自店雷达(DianLeiDa),包含实时商品信息及近 7 天、近 30 天销售指标。 用户说“找货源”“找供应商”或“批发商品”时,只要目标是国内 1688 商品检索,也适用。
场景速查
| 用户表达 | 查询场景 |
|---|---|
| 在 1688 找某类商品的供应商 | 关键词商品与货源发现。 |
| 1688 上什么卖得好 | 按销量、订单数或预估销售额发现热销商品。 |
| 找价格便宜的工厂货源 | 工厂筛选及批发价格对比。 |
| 找支持一件代发的供应商 | 对比代发价格及代发权益。 |
| 比较不同供应商的报价 | 同类商品的批发价、代发价和价格阶梯比较。 |
| 找最近上架的新品 | 新品发现及上架时间排序。 |
| 找适合跨境销售的商品 | 跨境商品货源检索。 |
| 找能在 24 小时内发货的供应商 | 按履约速度筛选。 |
| 找超级工厂或实力商家 | 按供应商资质筛选。 |
| 查这个 1688 商品链接或商品编号 | 定位指定商品。 |
边界
本技能仅做 1688 商品搜索及基于返回数据的货源比较。不用于 Amazon 等其他平台选品、1688 店铺流量与排名、广告推广、评论与评分分析、物流成本或运费估算、下单及交易处理;已有本地商品数据文件的分析也不属于本技能范围。
前置条件
确定待找商品或已有的商品链接、编号,以及用户关心的价格、统计周期、供应商和服务条件。具体字段、枚举、组合限制及脚本选项见 references/api.md。
商品检索流程
- 明确找品目标,选择关键词检索或指定商品定位;英文商品词先译为中文,并在结果中说明实际采用的译词。
- 根据用户需求整理统计周期、排序、价格、销量、供应商资质、上架时间及履约条件;按
references/api.md核对参数后检索,不擅自扩大检索范围。 - 先查看返回摘要,再按需从已保存的完整响应提取商品与供应商数据;按下方展示规则整理结果。空结果或报错时解释原因,后续检索遵守成本约束。
执行方式
- 直接调用接口:接口端点、完整参数、响应和错误码见
references/api.md。 - 脚本调用(推荐):
python scripts/dld_product_search.py '<JSON 参数>' [--inline]。 - 成本约束:每次接口调用消耗 9 算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改筛选条件连续试探;需要继续检索时,先向用户说明额外消耗。
输出策略
- 始终保存完整响应,目标路径为
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-dld-product-search-<timestamp>.json。<cwd>为脚本运行时的工作目录,<session>优先取环境变量SESSION_ID,用于聚合同一任务的数据。禁止写入/tmp,当前目录不可写时应报错。 - 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
- 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如
total、costToken)、最大列表字段的长度和前 3 条样本。 - 添加
--inline可强制全量打印到标准输出,同时仍保存文件。
先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。
执行规则
算力消耗预估
9 算力 / 次
声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。
解决认证和算力问题
出现以下情况时,按 references/onboarding.md 的指引处理:
- 未配置接口密钥:
LINKFOX_AGENT_API_KEY和LINKFOXAGENT_API_KEY均为空。 - 响应状态码为
401或402。 - 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
约束与建议
- 区分价格口径:批发价是在起批数量下的单位价格;代发价是单件代发的单位价格,通常更高。两种价格都有时同时展示,并结合价格阶梯和起批量比较,金额以人民币(CNY)标明。
- 理解供应商资质:诚信通年限(TrustPass years,
tpYear)表示供应商持有阿里巴巴诚信通会员的年数,可辅助了解经营持续时间,不把它当作当前响应必然包含的字段。 - 区分销售指标:销量是销售件数,订单数是独立订单笔数,预估销售额是所选周期的估算收入,三者不可混用;明确标注本次为 7 天或 30 天数据。
- 清晰展示商品与供应商:用表格呈现商品标题、两种价格、销量指标、供应商及履约信息,附商品链接;有商品图片时展示图片,并展示可用的店铺链接、价格阶梯、起批量、类目和上架时间。
- 说明翻译:用户使用英文商品词时,说明中文检索词,方便核对语义是否准确;关键词规范见接口定义。
- 说明分页情况:总记录数超过本页返回数量时,告知总数和可继续查看其他页;不要隐瞒仅返回当前页,也不要自动连续翻页。
- 解释空结果与错误:根据实际消息说明问题,可建议核对译词、关键词拼写或放宽筛选;按接口定义处理认证、算力和其他错误,后续调用遵守成本约束。
使用示例
找近一个月热销的瑜伽垫
用户:找 1688 最近一个月销量高的瑜伽垫。
按近 30 天销售件数降序查询,展示批发价、代发价、起批量、销量及供应商。
按条件找工厂或代发货源
用户:找 10 到 50 元的蓝牙耳机工厂,或者支持一件代发包邮的跨境手机壳。
分别按用户指定的商品与供应商、价格或服务条件准备查询,不将两类检索条件混为一组。具体请求组合见 references/api.md。
找新品或高销量供应商
用户:找最近上架的夏季连衣裙,或近一个月销量至少 1000 件的数据线超级工厂。
根据任务选择新品与上架时间排序,或供应商资质与销量筛选,展示实际返回的数据及统计周期。
定位指定商品
用户:查一下这个 1688 商品链接的近一个月销售情况。
按链接定位商品,展示所选统计周期内的销售指标、价格和供应商信息。
使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。
更多优质、专业的跨境电商技能,请访问 LinkFox Skill。