宠物用品爆款挖掘工具 — 整合1688-source-suppliers搜索、筛选、分析推荐、HTML报告生成和上传功能。 一键完成:搜索供应商 → 按月订单数排序 → 推荐TOP N → 生成可视化报告 → 上传公网链接。 适用于宠物用品(猫砂、狗粮、宠物玩具等)的供应商筛选和爆款挖掘。
---
name: 1688-pet-product-mining
version: "1.0.0"
description: |
宠物用品爆款挖掘工具 — 整合1688-source-suppliers搜索、筛选、分析推荐、HTML报告生成和上传功能。
一键完成:搜索供应商 → 按月订单数排序 → 推荐TOP N → 生成可视化报告 → 上传公网链接。
适用于宠物用品(猫砂、狗粮、宠物玩具等)的供应商筛选和爆款挖掘。
metadata:
openclaw:
emoji: "🐾"
requires:
bins: ["python3"]
primaryEnv: "ALI_1688_AK"
tags: [1688, 宠物用品, 供应商筛选, 爆款挖掘, 报告生成]
trigger:
- 宠物用品爆款挖掘
- 1688供应商筛选
- 猫砂供应商
- 狗粮供应商
- 宠物用品供应商
- 宠物用品找工厂
- 宠物用品供应商报告
- 1688宠物用品分析
---
# 宠物用品爆款挖掘工具
## 功能概述
本工具整合了1688平台供应商搜索、数据分析、可视化报告生成和公网分享功能,实现一键式宠物用品爆款挖掘工作流。
### 核心能力
- **智能搜索**:基于关键词搜索1688平台供应商
- **数据筛选**:按月订单数等关键指标排序筛选
- **智能推荐**:基于数据推荐优质供应商
- **可视化报告**:生成专业HTML分析报告
- **公网分享**:自动上传报告到公网,可直接分享
## 使用方法
### 命令行调用
```bash
python3 scripts/pet_product_mining.py "猫砂 豆腐猫砂"
python3 scripts/pet_product_mining.py "狗粮 幼犬粮" --limit 15 --top 5
```
### 参数说明
| 参数 | 说明 | 默认值 |
|------|------|--------|
| `keyword` | 搜索关键词(必需) | - |
| `--limit` | 筛选数量限制 | 10 |
| `--top` | 推荐数量 | 3 |
| `--output` | 输出JSON文件路径 | 无(仅控制台输出) |
### 输出示例
```json
{
"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:基础猫砂供应商挖掘
```bash
python3 scripts/pet_product_mining.py "猫砂 豆腐猫砂"
```
### 示例2:狗粮供应商深度筛选
```bash
python3 scripts/pet_product_mining.py "狗粮 幼犬粮" --limit 20 --top 5
```
### 示例3:保存结果到JSON文件
```bash
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`方法实现自定义筛选:
```python
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未配置**
```bash
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\n`(不是 `\\r\\n`)。详见 `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 其他平台)
- 历史数据跟踪和趋势分析don't have the plugin yet? install it then click "run inline in claude" again.