Agent skill · linkfox-ai
linkfox-1688-sourcing
1688 货源一站式 AI 工具集，整合商品搜索、热销榜单、以图搜图与已授权采购履约，覆盖找货、选品、比价、图搜同款与下单全流程。
What it needs
About 4k tokens when loaded.
What this skill does
Linkfox 1688货源（1688 Sourcing） 1688 货源一站式 AI 工具集，整合 3 类底层工具、4 项子能力，覆盖货源搜索与热销榜单、以图搜图、已授权采购履约。各子能力完整参数、响应字段与错误码见 references/ 下对应文件，可执行脚本见 scripts/。 能力边界 ✅ 能力范围 货源搜索与榜单（1688sourcing）：商品搜索（linkfox-dld-product-search，按关键词/商品链接/商品 ID 检索 1688 批发商品，近 7 天/30 天销量周期，按价格/销量/销售额/上架时间排序，按公司类型/卖家会员/发货时间/代发权益/面单支持等筛选）、商品热销榜单（linkfox-dld-product-billboard，周榜/月榜，按销售笔数/销售额/销量排序，发现爆款与趋势货源）。返回批发价、代发价、销售笔数/件数、预估销售额、起批量、供应商资质、店铺与商品链接等。 以图搜图（1688searchbyimage）：1688 以图搜图（linkfox-1688-search-by-image，通过图片 URL/Base64/imageId 视觉检索外观相似或同款货源），返回标题、批发价、代发价、月销量、起批量、复购率、交易评分、商家身份（超级工厂/实力商家/诚信通）等；支持价格/筛选（1688 严选/认证工厂/发货时效/品质退款率等）/排序/分页；本地图片先用 uploadimage.py 上传获取公网 URL（有效期 24h）。 采购履约（1688procurement）：1688 采购全流程（linkfox-1688-procurement），覆盖 OAuth 授权检查与发起授权、SKU/规格与收货地址查询、下单预览、创建订单、获取支付链接、订单状态、物流概览与物流轨迹、取消订单、确认收货。除授权类操作外每个 endpoint 前自动校验当前用户 ACTIVE 且未过期的 1688 授权；高风险写操作（创建订单/支付链接/取消订单/确认收货）需用户单独中文确认后由 Agent 注入对应 boolean 安全字段。 数据平台均为中国大陆 1688 批发平台（阿里巴巴国内 B2B 市场），无多站点概念。 ❌ 边界与限制 API Key 必需：所有工具均需环境变量 LINKFOXAGENTAPIKEY（或 LINKFOXAGENTAPIKEY）；各工具独立计费、独立限频。 计费约束：商品搜索/热销榜单固定计费（成功约 9 积分/18000 token），以图搜图固定计费（约 4.5 积分/9000 token），采购履约各操作消耗积分；同一会话同一参数组合默认只调用一次（搜索/榜单/图搜脚本带 24h 本地缓存）；失败、空结果、参数不全或授权不足不得自动换关键词、翻页或连续试探；需继续检索时先向用户说明会产生额外消耗（各工具计费规则见 skills-version.json 对应条目与 references 内 api.md）。 采购授权前置：采购类操作依赖当前用户已授权的 1688 OAuth；无 ACTIVE 授权时不调用目标 endpoint；高风险写操作失败不自动重试；不向用户索要 1688 token/refresh token/callback code/app secret。 不在范围内：Amazon/TikTok/沃尔玛等其他平台选品（用对应平台技能）；Alibaba.com 国际站数据；1688 店铺级分析（店铺流量/排名/评分）；商品评论分析；价格历史与趋势分析；图片生成或编辑；物流成本计算与货代；实时库存与订单系统对接；与供应商或平台的直接沟通。 数据时效：商品搜索/榜单为店雷达分析数据（7 天/30 天/周榜近 90 天/月榜近 12 个月）；以图搜图为实时搜索、不入库、无法二次 SQL 处理；采购履约为依赖 OAuth 的实时接口。 工具选择指南 按需求在下表定到子能力，再跳到【业务需求路由速查】查端点/脚本/references 取参执行。 需求 / 用户说 默认推荐（子能力） 何时换用其他 --- --- --- 关键词找 1688 货源 / 找供应商（"1688 上找 XX 货源"） linkfox-dld-product-search（关键词搜索，7/30 天销量） 要看周/月排行榜用 linkfox-dld-product-billboard；有图片找同款用 linkfox-1688-search-by-image 1688 什么好卖 / 趋势 / 热销榜（"1688 热销榜""什么火"） linkfox-dld-product-billboard（周榜/月榜排名） 要按关键词实时搜 + 销量筛选用 linkfox-dld-product-s …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills linkfox-ai/linkfox-1688-sourcing