"""1688 选品分析系统 - Claude Code Skill
作者: autoget 版本: 1.0.0 日期: 2026-09-17
简介
1688 → TikTok Shop 选品助手,实现自动商品搜索、抓取、评分和分析功能。
安装
# 从 SkillHub 安装
skillhub install product_search --dir ~/.claude/skills
# 或克隆整个仓库
git clone https://github.com/liuqiz/autoget
cp -r .claude/skills/product_search ~/.claude/skills/
使用
基本用法
在 Claude Code 中使用关键词触发:
- "帮我选品 宠物"
- "1688 搜索 宠物"
- "TikTok Shop 选品 宠物"
或者命令行:
python main.py search 宠物
python main.py analyze 宠物
python main.py export 宠物
支持的命令
--search, -s <keyword>: 搜索关键词--pages, -p <N>: 搜索页数 (默认: 1)--dash, -d: 显示选品看板--ui, -u: 启动 Web 界面 (requires streamlit)
环境要求
- Python 3.8+
- Playwright (Chromium)
DEEPSEEK_API_KEY环境变量 (DeepSeek API 密钥)1688_COOKIE环境变量 (1688 会话 Cookie)
安装依赖
pip install -r requirements.txt
playwright install chromium
注意事项
- 需要有效的
1688_COOKIE才能抓取商品 (runget_1688_cookie.py获取) - AI 评估可选: 如果 DEEPSEEK_API_KEY 缺失或 API 失败, 仍会完成商品评分
.env文件包含敏感信息, 不应提交到 Git- 1688 搜索使用
s.1688.com/selloffer/offer_search.htm - Playwright 浏览器缓存: 安装在
/c/Users/25786/AppData/Local/ms-playwright
功能特点
- ✅ 支持关键词搜索
- ✅ 四维评分 (利润/市场/趋势/供应链)
- ✅ AI 评估 (营销潜力/合规风险/利润率)
- ✅ SQLite 本地存储
- ✅ 导出 Excel/XLSX 报告
- ✅ Web 看板展示
文件结构
product_search/
├── main.py # 主入口脚本
├── get_1688_cookie.py # Cookie 获取工具
├── requirements.txt # Python 依赖
├── README.md # 说明文档 (本文件)
├── SKILL.md # SkillHub 技能定义
├── skill.json # SkillHub 元数据
├── config/ # 配置模块
│ └── 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 # 细分市场报告
├── ui/ # Web 界面
│ ├── app.py # Streamlit Web 应用
└── playwright-browsers/ # Playwright 浏览器缓存 (可选)
许可
MIT
微信扫一扫