productsearch

"""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

注意事项

1. 需要有效的 1688_COOKIE 才能抓取商品 (run get_1688_cookie.py 获取)
2. AI 评估可选: 如果 DEEPSEEK_API_KEY 缺失或 API 失败, 仍会完成商品评分
3. .env 文件包含敏感信息, 不应提交到 Git
4. 1688 搜索使用 s.1688.com/selloffer/offer_search.htm
5. 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