核心用法
1688-product-find 是一款面向电商从业者和跨境采购者的智能选品 Skill，提供文本搜索、以图搜图、链接找同款及多维度比价四大核心能力。用户可通过自然语言描述商品需求（如"黑色连帽卫衣宽松款"）、上传商品图片、或粘贴1688/淘宝商品链接触发搜索。系统支持复杂筛选条件组合，包括价格区间、销量排序、材质属性、起订量等多维度过滤，并能一键生成比价报告，自动对比同款商品的价格、销量、服务保障等关键指标。
执行流程遵循"先读 reference → 再执行命令"的严格规范，Agent 需先查阅对应能力的 reference 文档，再按标准示例构造 CLI 命令调用。输出结果以 Markdown 表格形式完整呈现，包含商品名称、价格、供应商、核心卖点及详情链接等全部字段，严禁截断或重新格式化。
显著优点
官方数据直连：直接调用 1688 官方 API（skills-gateway.1688.com），商品数据实时、准确、覆盖全网最大批发货源，杜绝信息滞后或第三方爬虫的数据失真问题。
多模态搜索能力：支持文本、图片、链接三种输入方式，特别是「以图搜图」和「链接找同款」功能，可快速定位 1688 站内同款或相似款，大幅降低选品的时间成本。
智能比价与选品：compare 命令内置图片解析和同款聚合逻辑，可纵向对比多供应商的价格、销量、服务评分，并支持按「最便宜」「销量最高」等维度自动推荐，适合批量采购决策。
安全合规设计：OAuth 凭证采用系统 Keychain 优先存储，fallback 至本地加密文件（权限 0o600），符合企业级安全标准；网络通信全程 TLS 加密，无数据外泄风险。
钉钉生态集成：搜索结果支持一键导出为钉钉表格，字段覆盖商品 ID、主图、价格、库存、促销标签等 16 个核心维度，便于团队协作和后续采购流程。
潜在缺点与局限性
AK 配置门槛：首次使用需配置 1688 开放平台 AK（Access Key），虽然提供 get_ak 自动获取命令，但对非技术用户仍存在一定上手门槛。
平台依赖性：数据完全依赖 1688 官方 API，若遇到平台限流（429）、服务维护或 API 策略调整，搜索能力将受限；不支持淘宝、拼多多等其他货源平台的直接搜索。
比价深度有限：compare 功能主要对比 1688 站内同款，对于跨平台（如 1688 vs 拼多多批发 vs 义乌购）的全网比价仍需人工辅助。
中文语境优化：触发词和意图判断针对中文自然语言优化，英文或其他语言的商品描述识别准确率可能下降。
埋点上报强制：每次调用默认上报统计信息至 1688 网关，虽无隐私数据且已文档化，但对极端敏感环境用户缺乏一键禁用选项。
适合的目标群体
- 跨境电商卖家：亚马逊、速卖通、Shopee 等平台卖家，需快速寻找 1688 源头工厂和稳定供应链
- 国内电商运营：淘宝、京东、拼多多店主，用于竞品调研、爆款跟款、供应链拓展
- 直播带货选品团队：需要批量筛选高性价比货源、对比供应商服务能力的内容电商从业者
- 小型批发采购者：服装店、礼品店、便利店等实体店主，用于小额多品类采购比价
- 代发货（Dropshipping）从业者：寻找支持一件代发、发货快、评分高的优质供应商
使用风险
性能与稳定性：API 限流（429）可能在高峰期触发，建议重要选品任务预留重试时间；依赖自动安装机制使用 subprocess 调用 pip，虽风险可控，但建议在受控环境（如 Docker、虚拟环境）中首次运行。
AK 安全生命周期：AK 凭证长期有效，若泄露可能导致账号被滥用；建议定期轮换（如每 90 天）并使用 configure --clear 及时清理废弃凭证。
数据准确性：商品价格、库存信息存在实时变动可能，Skill 返回数据仅代表查询时刻状态，实际下单前需再次确认；部分供应商可能存在刷单提升销量数据的行为，需结合「严选指数」等指标综合判断。
功能边界认知：本 Skill 仅提供「找货/选品/比价」能力，不包含下单、支付、物流跟踪、库存管理等交易闭环功能，用户需自行跳转至 1688 官网或 App 完成后续操作。