{
  "markdown": "# E-Commerce Skills 选品系统 \n\n## 📝 开发说明\n\n本系统是一个基于 Skills 模块的跨境电商选品工具，通过多维度数据分析，帮助卖家快速筛选高利润产品。\n\n---\n\n## 🎯 快速开始\n\n```bash\n# 1. 克隆项目\ngit clone https://github.com/zhuhongyin/global-ecom-skills.git\n\n# 2. 进入目录\ncd global-ecom-skills\n\n# 3. 安装依赖\n./start.sh\n\n# 使用claude 进行测试 跨境电商选品智能体\nclaude\n用跨境电商选品智能体skill挑选3款产品\n\n# 4. 单独使用 Skills\npython3 skills/amazon-movers-shakers/scripts/scrape_amazon.py --site us --category home-garden --limit 5\n```\n\n---\n\n## 📋 功能介绍\n\n本系统通过多个独立的 Skills 模块，提供完整的选品分析功能：\n\n| 功能模块 | 说明 |\n|---------|------|\n| Amazon 飙升榜数据获取 | 抓取 Amazon 热销产品，发现市场趋势 |\n| Temu 竞品分析 | 分析 Temu 平台竞品价格，确定市场定价上限 |\n| 1688 供应链查询 | 查询 1688 工厂批发价，确定采购成本 |\n| V4.1 核价计算 | 自动计算净利润，判断产品是否值得做 |\n\n---\n\n## 📁 目录结构\n\n```\nlgskill3/\n├── skills/                     # Skills 模块\n│   ├── amazon-movers-shakers/\n│   │   └── scripts/\n│   │       └── scrape_amazon.py      # Amazon 飙升榜爬取\n│   ├── temu-competitor-search/\n│   │   └── scripts/\n│   │       └── scrape_temu.py         # Temu 竞品分析\n│   ├── ali1688-sourcing/\n│   │   └── scripts/\n│   │       └── scrape_1688.py          # 1688 供应链查询\n│   └── temu-pricing-calculator/\n│       └── scripts/\n│           └── calculate_pricing.py      # V4.1 核价计算\n└── README.md                   # 本文档\n```\n\n---\n\n## 🔧 核心模块说明\n\n### 1. Amazon 飙升榜爬取 (`scrape_amazon.py`)\n\n**功能**：获取 Amazon 热销产品数据\n\n**数据源优先级**：\n1. 卖家精灵 API（需 API Key）\n2. 真实爬取（requests + BeautifulSoup4）\n3. Mock 数据（兜底方案）\n\n**输出字段**：\n```json\n{\n  \"metadata\": {\n    \"site\": \"amazon.com\",\n    \"data_source\": \"scrape/mock/sellersprite\",\n    \"total_products\": 10\n  },\n  \"products\": [\n    {\n      \"asins\": \"B06WWRCZXX\",\n      \"title\": \"Queen Size 4 Piece Sheet Set\",\n      \"price\": 24.99,\n      \"rating\": 4.5,\n      \"rank\": 1,\n      \"rank_change\": \"+256\"\n    }\n  ]\n}\n```\n\n**支持类目**（10 个）：\n- Home & Kitchen (家居用品)\n- Electronics (电子产品)\n- Sports & Outdoors (户外用品)\n- Office Products (办公用品)\n- Beauty & Personal Care (美妆个护)\n- Toys & Games (玩具游戏)\n- Clothing & Accessories (服装配饰)\n- Jewelry & Watches (珠宝手表)\n- Automotive (汽车用品)\n- Pet Supplies (宠物用品)\n\n**使用方法**：\n```bash\npython3 skills/amazon-movers-shakers/scripts/scrape_amazon.py \\\n  --site us \\\n  --category home-garden \\\n  --limit 10 \\\n  --source auto        # auto/mock/scrape/sellersprite\n```\n\n---\n\n### 2. Temu 竞品分析 (`scrape_temu.py`)\n\n**功能**：分析 Temu 平台竞品，获取「卷王价」\n\n**数据源优先级**：\n1. 真实爬取（requests + BeautifulSoup4）\n2. Mock 数据（兜底方案）\n\n**输出字段**：\n```json\n{\n  \"metadata\": {\n    \"keyword\": \"Standing Desk\",\n    \"site\": \"temu.com (US)\",\n    \"data_source\": \"scrape/mock\"\n  },\n  \"king_price\": {\n    \"price\": 29.99,\n    \"currency\": \"USD\",\n    \"product_id\": \"temu_123456\",\n    \"title\": \"Height Adjustable Standing Desk Converter\",\n    \"rating\": 3.8,\n    \"sold_count\": \"1k+\"\n  },\n  \"competitors\": [\n    {\n      \"product_id\": \"temu_234567\",\n      \"title\": \"Premium Standing Desk with Ergonomic Design\",\n      \"price\": 45.99,\n      \"discount\": \"49% off\"\n    }\n  ],\n  \"market_insights\": {\n    \"price_distribution\": [...],\n    \"common_features\": [...],\n    \"gap_opportunities\": [...]\n  }\n}\n```\n\n**使用方法**：\n```bash\npython3 skills/temu-competitor-search/scripts/scrape_temu.py \\\n  --keyword \"Standing Desk\" \\\n  --limit 10 \\\n  --site us\n```\n\n---\n\n### 3. 1688 供应链查询 (`scrape_1688.py`)\n\n**功能**：查询 1688 工厂批发价\n\n**数据源优先级**：\n1. 真实爬取（requests + BeautifulSoup4）\n2. Mock 数据（兜底方案）\n\n**输出字段**：\n```json\n{\n  \"metadata\": {\n    \"keyword\": \"Standing Desk\",\n    \"search_time\": \"2026-02-27T14:00:00\",\n    \"total_results\": 1256,\n    \"data_source\": \"scrape/mock\"\n  },\n  \"wholesale_price\": {\n    \"min_price\": 105.0,\n    \"max_price\": 105.0,\n    \"recommended_price\": 105.0,\n    \"currency\": \"CNY\",\n    \"unit\": \"件\",\n    \"note\": \"建议以 ¥105 作为核价参考价\"\n  },\n  \"factories\": [\n    {\n      \"rank\": 1,\n      \"company_name\": \"安吉县宏达家具有限公司\",\n      \"location\": {\"province\": \"浙江\", \"city\": \"安吉\"},\n      \"verified\": true,\n      \"verification_type\": \"深度验厂\",\n      \"rating\": 4.8,\n      \"products\": [\n        {\n          \"title\": \"站立式办公桌 可折叠\",\n          \"price_tiers\": [\n            {\"quantity\": \"1-9\", \"price\": 25.0},\n            {\"quantity\": \"10-49\", \"price\": 20.0},\n            {\"quantity\": \"50+\", \"price\": 18.0}\n          ],\n          \"starting_price\": 18.0,\n          \"moq\": 10,\n          \"material\": \"冷轧钢+环保板材\"\n        }\n      ]\n    }\n  ],\n  \"summary\": {\n    \"lowest_price\": 105.0,\n    \"highest_price\": 105.0,\n    \"average_price\": 105.0,\n    \"main_production_areas\": [\"浙江\", \"广东\", \"江苏\"]\n  }\n}\n```\n\n**使用方法**：\n```bash\npython3 skills/ali1688-sourcing/scripts/scrape_1688.py \\\n  --keyword \"Standing Desk\" \\\n  --limit 10\n```\n\n---\n\n### 4. V4.1 核价计算 (`calculate_pricing.py`)\n\n**功能**：计算产品净利润，判断是否值得做\n\n**核价公式**：\n```\n回款预估 = Temu 卷王价 × 平台费率 (45%) × 汇率 (7.2)\n总成本 = 1688 批发价 + 履约费 (¥3.5)\n净利润 = 回款 - 总成本\n```\n\n**决策规则**：\n| 净利润 (¥) | 状态 | 说明 |\n|-----------|------|------|\n| > 10 | STRONG GO | 高利润，优先上架 |\n| > 5 | GO | 利润达标，建议上架 |\n| > 3 | MARGINAL | 利润边缘，需优化 |\n| ≤ 3 | PASS | 利润不足，直接淘汰 |\n\n**使用方法**：\n```bash\n# 默认阈值：¥5.0\npython3 skills/temu-pricing-calculator/scripts/calculate_pricing.py \\\n  --temu-price 29.99 \\\n  --ali1688-price 20.0 \\\n  --profit-threshold 5.0\n\n# 自定义阈值\npython3 skills/temu-pricing-calculator/scripts/calculate_pricing.py \\\n  --temu-price 29.99 \\\n  --ali1688-price 20.0 \\\n  --profit-threshold 1.0\n```\n\n---\n\n## 📊 选品流程\n\n```\n┌─────────────────────────────────────────────────────────────┐\n│                                                         │\n│  Step 1: Amazon 飙升榜                              │\n│  ├─ 获取产品列表（ASIN/标题/价格/排名）            │\n│                                                         │\n│  Step 2: Temu 竞品分析（对每个候选产品）          │\n│  ├─ 用产品标题关键词搜索 Temu                           │\n│  ├─ 获取最低价竞品（卷王价）                          │\n│  └─ 返回竞品数据（价格/评分/销量）                    │\n│                                                         │\n│  Step 3: 1688 供应链查询（对每个候选产品）          │\n│  ├─ 用相同关键词搜索 1688                             │\n│  ├─ 获取工厂批发价（阶梯价）                           │\n│  └─ 返回供应链数据（最低价/推荐价）                │\n│                                                         │\n│  Step 4: V4.1 核价计算（对每个候选产品）          │\n│  ├─ 输入：Temu 卷王价 + 1688 批发价                    │\n│  ├─ 计算：回款 = 卷王价 × 45% × 7.2                  │\n│  ├─ 计算：总成本 = 批发价 + ¥3.5                    │\n│  ├─ 计算：净利润 = 回款 - 总成本                        │\n│  └─ 返回：GO / PASS / MARGINAL / STRONG GO            │\n│                                                         │\n└─────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## 🔍 核心业务逻辑\n\n### 选品流程\n\n```python\nfor each candidate_product in amazon_products:\n    keyword = extract_keyword(candidate_product.title)\n    \n    # Step 2: Temu 竞品分析\n    temu_data = search_temu(keyword)\n    king_price = temu_data.king_price.price\n    \n    # Step 3: 1688 供应链查询\n    ali1688_data = search_1688(keyword)\n    ali1688_price = ali1688_data.wholesale_price.recommended_price\n    \n    # Step 4: V4.1 核价计算\n    pricing_data = calculate_pricing(\n        temu_price=king_price,\n        ali1688_price=ali1688_price,\n        profit_threshold=5.0\n    )\n    \n    if pricing_data.decision.status in ['GO', 'STRONG GO']:\n        go_products.append({\n            amazon: candidate_product,\n            temu: temu_data,\n            ali1688: ali1688_data,\n            pricing: pricing_data\n        })\n\nreturn go_products\n```\n\n### 核价决策矩阵\n\n| Temu 卷王价 | 1688 批发价 | 回款 (45%) | 总成本 | 净利润 | 决策 |\n|-----------|-------------|-------------|----------|--------|--------|------|\n| $29.99 | ¥20.0 | ¥97.17 | ¥23.5 | ¥73.67 | STRONG GO |\n| $45.99 | ¥25.0 | ¥148.87 | ¥28.5 | ¥120.37 | STRONG GO |\n| $19.99 | ¥18.0 | ¥71.91 | ¥21.5 | ¥50.41 | STRONG GO |\n| $12.99 | ¥15.0 | ¥46.75 | ¥18.5 | ¥28.25 | STRONG GO |\n| $8.99 | ¥12.0 | ¥32.38 | ¥15.5 | ¥16.88 | STRONG GO |\n| $6.99 | ¥10.0 | ¥25.27 | ¥13.5 | ¥11.77 | GO |\n| $4.99 | ¥8.0 | ¥17.96 | ¥11.5 | ¥6.46 | MARGINAL |\n| $2.99 | ¥6.0 | ¥10.79 | ¥9.5 | ¥1.29 | PASS |\n\n---\n\n## ⚙️ 配置说明\n\n### 环境要求\n\n- Python 3.9+\n- requests\n- beautifulsoup4\n\n### 依赖安装\n\n```bash\npip install requests beautifulsoup4 -i https://pypi.org/simple/\n```\n\n---\n\n**文档版本**：v2.0  \n**最后更新**：2026-02-27\n",
  "bytes": 7936,
  "sha": "4971a87cc161ffaa8703aae63efe50e29a73f1de8b1849d6ecce808c30d79623",
  "repo_slug": "zhuhongyin/global-ecom-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://api.agentalog.com/api/listings/skl_zhuhongyin_global_ecom_skills_ecom_produ_0d0aa67f/readme"
}