1688 → TikTok Shop 搜索选品
概述
自动完成从 1688 平台批量关键词搜索、商品抓取、四维评分（利润/市场/趋势/供应链）、AI 评估，最终输出适合 TikTok Shop 销售的选品报告。
触发条件
当用户输入或提到以下任一关键词时触发：
- 1688
- 选品
- TikTok
- 跨境电商
- 商品搜索
- 爆款潜力
工作流
关键词输入 → 1688 搜索 → 商品抓取 → 四维评分 → AI 评估 → 报告输出
文件结构
product_search/
├── SKILL.md # 技能定义
├── skill.json # SkillHub 元数据
├── README.md # 对外说明
├── package.json # npm 兼容包信息
├── requirements.txt # Python 依赖
├── main.py # 主入口
├── get_1688_cookie.py # Cookie 获取工具
├── config/ # 配置模块
│ ├── __init__.py
│ └── settings.py
├── crawlers/ # 爬虫模块
│ ├── __init__.py
│ ├── c1688_crawler.py # 1688 爬虫
│ └── cproxy_pool.py # 代理池
├── analyzers/ # 分析器模块
│ ├── __init__.py
│ ├── product_scorer.py # 商品评分器
│ ├── blue_ocean.py # 蓝海分析
│ └── niche_analyzer.py # 细分市场分析
├── ai/ # AI 模块
│ ├── __init__.py
│ └── openai_client.py # AI 评估客户端
├── models/ # 数据模型
│ ├── __init__.py
│ └── product.py # 商品数据模型
└── services/ # 服务模块
├── __init__.py
├── data_store.py # 数据存储
├── exporter.py # 数据导出
├── scheduler.py # 任务调度
└── niche_reporter.py # 细分市场报告
核心脚本说明
main.py
主入口脚本，提供以下命令：
- python main.py search <keyword> - 搜索关键词
- python main.py analyze <keyword> - 搜索并分析
- python main.py export <keyword> - 导出结果
crawlers/c1688_crawler.py
1688 商品爬虫，支持：
- 关键词搜索
- 商品详情抓取
- 价格/销量/店铺信息提取
analyzers/product_scorer.py
商品评分器，四维评分：
- 利润：30%
- 市场：25%
- 趋势：20%
- 供应链：25%
ai/openai_client.py
AI 评估客户端，调用 DeepSeek API 进行：
- 营销潜力评估
- 合规风险评估
- 商品卖点分析
services/exporter.py
数据导出服务，支持：
- Markdown 报告
- Excel 导出
- JSON 导出
环境要求
- Python 3.8+
- Playwright (Chromium)
DEEPSEEK_API_KEY环境变量1688_COOKIE环境变量
安装依赖
pip install -r requirements.txt
playwright install chromium
使用方式
方式 1: 命令行
python main.py search 家居装饰
python main.py analyze 户外运动
python main.py export 宠物用品
方式 2: 作为 Skill 使用
在 Claude Code 中触发关键词：
- "帮我选品"
- "1688 搜索 家居装饰"
- "TikTok Shop 选品"
注意事项
- 1688 搜索页使用
s.1688.com/selloffer/offer_search.htm - Cookie 缺失
login_token时无法抓取，需要先运行get_1688_cookie.py wait_for_selector优于networkidle，后者容易导致超时- AI 评分失败不影响主流程
.env文件包含敏感信息，不应提交到 git
