配置

环境变量

需要配置 AlphaShop API 凭证。在 OpenClaw config 中设置：

{
  skills: {
    entries: {
      "alphashop-sel-newproduct": {
        env: {
          ALPHASHOP_ACCESS_KEY: "你的AccessKey",
          ALPHASHOP_SECRET_KEY: "你的SecretKey"
        }
      }
    }
  }
}

如何获取 API Key

获取途径

本 skill 使用 AlphaShop/遨虾平台的 API 服务，需要申请以下凭证：

• ALPHASHOP_ACCESS_KEY - API 访问密钥
• ALPHASHOP_SECRET_KEY - API 密钥

申请步骤

1. 联系平台方

   • 如果您是 1688 或阿里内部用户，请联系 AlphaShop/遨虾 平台管理员
   • 平台可能需要您提供：
     • 公司信息
     • 使用场景说明
     • 预期调用量

2. 获取凭证

   • 平台审核通过后会提供：
     • Access Key（访问密钥）
     • Secret Key（密钥）

3. 配置到环境

   • 按照上面的配置方式设置环境变量

缺少凭证时的提示

如果运行 skill 时未配置凭证，会看到详细的配置指南：

🔐 需要 AlphaShop API 凭证

本 skill 需要以下凭证才能使用：
  • ALPHASHOP_ACCESS_KEY  - API 访问密钥
  • ALPHASHOP_SECRET_KEY  - API 密钥

📋 如何获取凭证：
1. 联系 AlphaShop/遨虾 平台获取 API 凭证
2. 配置环境变量或 OpenClaw 配置
3. 重新运行命令

AlphaShop新品选品SKILL

通过遨虾AI选品API进行跨境电商市场分析和新品推荐，一次调用即可获得完整的市场洞察和选品建议。

快速开始

⚠️ 使用前必读：本 skill 包含两个 API，且有先后依赖关系！

正确的使用顺序

第一步：关键词搜索 (search)
   ↓ 返回合法的关键词列表（带 keyword 字段）
   ↓
第二步：从返回结果中选择一个 keyword 字段的值
   ↓
第三步：新品报告 (report) - 使用第一步返回的 keyword

示例：

# 1️⃣ 先搜索关键词
python3 scripts/selection.py search --keyword "phone" --platform "amazon" --region "US"

# 输出：返回关键词列表，例如：
#   1. phone (手机) - keyword: "phone"
#   2. phone case (手机壳) - keyword: "phone case"

# 2️⃣ 使用返回的 keyword 生成报告
python3 scripts/selection.py report --keyword "phone case" --platform "amazon" --country "US"

❌ 错误示例：直接使用随意关键词会报错

python3 scripts/selection.py report --keyword "随便的关键词" --platform "amazon" --country "US"
# 错误：KEYWORD_ILLEGAL - 关键词不合法

功能说明

本Skill封装了遨虾AI选品API，提供两大核心功能：

⚠️ 重要提示：这两个功能有先后顺序依赖关系！

1. 第一步：必须先调用 关键词搜索 (search) 获取合法的关键词列表
2. 第二步：从返回结果中选择一个 keyword 字段的值
3. 第三步：使用该关键词作为 新品报告 (report) 的 --keyword 参数

1. 关键词搜索 (search)

通过AI关键词查询API，根据用户输入的关键词匹配并返回相关关键词列表及市场数据：

• 关键词推荐 - AI匹配的相关关键词列表（中英文）
• 机会评分 - 每个关键词的市场机会综合评分和排名
• 市场趋势 - 近12个月搜索排名/达人数趋势
• 销售数据 - 30天销量、销售额及环比增长
• 雷达分析 - 市场需求、供给、销售、新品、评价五维评分

2. 新品报告 (report)

⚠️ 前置依赖：此功能依赖"关键词搜索"的返回结果！

• 必须先执行 search 命令获取关键词列表
• --keyword 参数必须使用 search 返回的 keyword 字段值
• 随意填写关键词会报错 KEYWORD_ILLEGAL

通过AI新品报告执行API生成深度市场分析和新品推荐：

• 市场分析 - 市场评级、供需情况、销售表现、竞争态势
• 关键指标 - 搜索排名趋势、销量趋势、价格分析、雷达图
• 新品推荐 - AI筛选的机会新品及详细数据
• 竞品对比 - 新品与同类目热销品的深度对比分析

支持的平台和国家

Amazon 平台

支持国家：US, UK, ES, FR, DE, IT, CA, JP

TikTok 平台

支持国家：ID, VN, MY, TH, PH, US, SG, BR, MX, GB, ES, FR, DE, IT, JP

使用方法

功能1：关键词搜索 (search)

基础用法

搜索关键词并获取相关关键词列表及市场数据：

python3 scripts/selection.py search \
  --keyword "yoga pants" \
  --platform "amazon" \
  --region "US"

带上架时间筛选

指定商品上架时间范围：

python3 scripts/selection.py search \
  --keyword "yoga pants" \
  --platform "amazon" \
  --region "US" \
  --listing-time "90"

参数说明