alphashop-sel-newproduct

Files (8)

• QUICKSTART.md
• README.md
• SKILL.md
• _meta.json
• api.md · references/
• requirements.txt
• selection.py · scripts/
• test.sh

SKILL.md (first lines)

## 配置

### 环境变量

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

```json5
{
  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
```

**示例：**

```bash
# 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"
```

❌ **错误示例**：直接使用随意关键词会报错
```bash
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匹配的相关关键词列表（中英文）
- **机会评分** - 每个关键词的市场机会综合评分和排名

From LeoYeAI/openclaw-master-skills, MIT.

More from LeoYeAI/openclaw-master-skills