宠物用品爆款挖掘工具

功能概述

本工具整合了1688平台供应商搜索、数据分析、可视化报告生成和公网分享功能，实现一键式宠物用品爆款挖掘工作流。

核心能力

• 智能搜索：基于关键词搜索1688平台供应商
• 数据筛选：按月订单数等关键指标排序筛选
• 智能推荐：基于数据推荐优质供应商
• 可视化报告：生成专业HTML分析报告
• 公网分享：自动上传报告到公网，可直接分享

使用方法

命令行调用

python3 scripts/pet_product_mining.py "猫砂 豆腐猫砂"
python3 scripts/pet_product_mining.py "狗粮 幼犬粮" --limit 15 --top 5

参数说明

输出示例

{
  "success": true,
  "keyword": "猫砂 豆腐猫砂",
  "total_suppliers": 10,
  "filtered_suppliers": 10,
  "recommended_suppliers": 3,
  "top_suppliers": [...],
  "html_report_path": "/tmp/1688_pet_mining_猫砂_豆腐猫砂_20260519_143022.html",
  "dinzee_url": "https://report.dinzee.ai/1688-pet-mining-猫砂_豆腐猫砂-20260519.html",
  "timestamp": "2026-05-19T14:30:22.123456"
}

工作流程

完整工作流

1. 搜索阶段：调用1688-source-suppliers搜索供应商
2. 筛选阶段：按月订单数降序排序，取前N条数据
3. 推荐阶段：基于排序结果推荐TOP N供应商
4. 报告生成：创建包含供应商卡片、数据表格、分析摘要的HTML报告
5. 上传分享：自动上传报告到Dinzee服务器，获取公网链接

数据字段说明

返回的供应商数据包含以下关键字段：

• companyName：公司名称
• companyUrl：1688店铺链接
• monthlyOrders：近30天月订单数（核心排序指标）
• satisfiedRate：好评率
• location：所在地区
• factoryLevel：工厂等级
• supportProofing：是否支持打样
• cooperationMode：合作方式（OEM/ODM/OBM等）
• services：服务能力

报告特性

HTML报告内容

1. 分析摘要：总供应商数、筛选结果、推荐数量
2. 推荐供应商卡片：TOP N供应商详细信息卡片
3. 完整数据表格：所有筛选供应商的完整数据
4. 推荐理由：数据驱动的推荐逻辑说明
5. 注意事项：数据限制和进一步建议

报告设计

• 响应式设计，支持手机和电脑查看
• 专业配色方案（深蓝#0f3460 + 红#e94560）
• 交互式卡片设计，鼠标悬停有效果
• 清晰的数据可视化展示

依赖环境

必需组件

1. 1688-source-suppliers：供应商搜索功能

   • 路径：~/.agents/skills/1688-source-suppliers
   • 需要配置AK：python3 cli.py configure YOUR_AK

2. Dinzee上传服务：报告上传功能

   • 默认配置，无需额外设置
   • 上传地址：https://report.dinzee.ai/report/upload

Python依赖

• Python 3.6+
• 标准库（json, os, sys, subprocess, tempfile, urllib.request, uuid, argparse）

使用示例

示例1：基础猫砂供应商挖掘

python3 scripts/pet_product_mining.py "猫砂 豆腐猫砂"

示例2：狗粮供应商深度筛选

python3 scripts/pet_product_mining.py "狗粮 幼犬粮" --limit 20 --top 5

示例3：保存结果到JSON文件

python3 scripts/pet_product_mining.py "宠物玩具" --output /tmp/pet_toys_result.json

注意事项

数据限制

1. 价格信息：1688-source-suppliers API不返回价格数据
2. 一件代发：API不返回一件代发包邮信息
3. 数据量限制：单次搜索最多返回10家供应商
4. 数据时效：月订单数为近30天数据

📖 详细 API 限制见 references/1688-api-limitations.md

进一步操作建议

1. 询盘联系：通过1688平台链接直接联系供应商
2. 价格谈判：询问具体价格、起批量、一件代发政策
3. 样品测试：要求打样测试产品质量
4. 扩展搜索：可尝试多个相关关键词获取更多供应商

扩展开发

自定义筛选逻辑

可修改pet_product_mining.py中的filter_and_sort方法实现自定义筛选：

def filter_and_sort(self, limit: int = 10) -> List[Dict[str, Any]]:
    # 添加自定义筛选条件
    filtered_data = [
        supplier for supplier in self.suppliers_data
        if supplier.get('monthlyOrders', 0) > 50  # 月订单大于50
        and supplier.get('supportProofing', False)  # 支持打样
    ]
    # 然后按月订单数排序
    sorted_data = sorted(filtered_data, key=lambda x: x.get('monthlyOrders', 0), reverse=True)
    return sorted_data[:limit]

添加更多分析维度

可在HTML报告中添加更多分析维度，如：

• 地域分布分析
• 合作方式分布
• 工厂等级统计
• 历史趋势对比

故障排除

常见问题

1. AK未配置

   cd ~/.agents/skills/1688-source-suppliers
   python3 cli.py configure YOUR_AK
   

2. 上传失败 (HTTP 400)

   • 可能是文件名包含中文或特殊字符
   • 使用 --verbose 查看详细错误
   • 检查网络连接

3. 搜索无结果

   • 尝试更通用的关键词
   • 检查关键词是否正确
   • 确认1688平台有相关供应商

已知陷阱

Dinzee 上传 CRLF 问题

如果上传返回 HTTP 400，检查 multipart boundary 是否使用了正确的 \r\ （不是 \\r\\ ）。详见 dinzeeagent-fileupload skill 的 pitfalls 部分。

1688 搜索结果上限

单次搜索最多返回 10 家供应商，这是 API 限制。如需更多结果，需使用多个关键词扩展搜索。

更新日志

v1.0.0 (2026-05-19)

• 初始版本发布
• 整合1688-source-suppliers搜索功能
• 实现供应商筛选和排序
• 生成HTML可视化报告
• 集成Dinzee上传功能
• 支持命令行参数配置

相关技能

专用版本

• 1688-pet-cat-litter-mining：猫砂豆腐猫砂专用版本，包含更精细的7维度评分体系

配套使用

• 1688-product-find：商品维度搜索，可补充商品信息
• 1688-product-sourcing：出厂价溯源，用于利润测算
• inquiry-1688：供应商询盘，用于进一步联系

扩展方向

• 添加价格区间筛选（需配合商品搜索）
• 添加一件代发筛选（需获取更多信息）
• 多平台对比（1688 vs 其他平台）
• 历史数据跟踪和趋势分析