配置

环境变量

需要配置 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. 重新运行命令

商品搜索API SKILL

通过 AlphaShop REST API 调用1688遨虾AI选品系统的商品搜索服务，支持关键词搜索，覆盖Amazon和TikTok平台。

CRITICAL: 参数收集策略

当用户请求搜索但未提供必需参数（platform 和 region）时，必须使用 AskUserQuestion 工具引导用户选择。禁止使用任何默认值。

必需参数检查

关键词搜索 (scripts/search.py)：

• --keyword: 必填（从用户输入提取）
• --platform: 必填 ⚠️ 如果缺失→询问用户
• --region: 必填 ⚠️ 如果缺失→询问用户

参数询问流程

Step 1: 询问平台（如果用户未指定 platform）

使用 AskUserQuestion 提供选项：

• Amazon - 描述：覆盖美国、英国、日本、德国、法国、意大利、西班牙、加拿大8个市场
• TikTok - 描述：覆盖西班牙、菲律宾、法国、印尼、墨西哥、越南、德国、日本、泰国、新加坡、巴西、意大利、美国、英国、马来西亚15个市场

Step 2: 询问区域（如果用户未指定 region）

根据选择的平台，使用 AskUserQuestion 提供对应区域选项：

Amazon 区域：

• US - 美国
• UK - 英国
• JP - 日本
• DE - 德国
• FR - 法国
• IT - 意大利
• ES - 西班牙
• CA - 加拿大

TikTok 区域：

• ES - 西班牙
• PH - 菲律宾
• FR - 法国
• ID - 印尼
• MX - 墨西哥
• VN - 越南
• DE - 德国
• JP - 日本
• TH - 泰国
• SG - 新加坡
• BR - 巴西
• IT - 意大利
• US - 美国
• GB - 英国
• MY - 马来西亚

Step 3: 执行搜索

收集完所有必需参数后，构建完整命令执行。

执行示例

❌ 错误示例

用户: "搜索 yoga pants"
Claude: 直接执行 python3 scripts/search.py --keyword "yoga pants" --platform amazon --region US
问题: 未询问用户，擅自使用默认值

✅ 正确示例

用户: "搜索 yoga pants"
Claude: 使用 AskUserQuestion 询问平台 (Amazon/TikTok)
用户: 选择 Amazon
Claude: 使用 AskUserQuestion 询问区域 (US/UK/JP...)
用户: 选择 US
Claude: 执行 python3 scripts/search.py --keyword "yoga pants" --platform amazon --region US

✅ 部分参数已提供

用户: "在 Amazon 搜索 phone"
Claude: 识别到 platform=amazon，使用 AskUserQuestion 询问区域
用户: 选择 JP
Claude: 执行 python3 scripts/search.py --keyword "phone" --platform amazon --region JP

✅ 所有参数齐全

用户: "在 Amazon 美国市场搜索 phone"
Claude: 识别到所有必需参数，直接执行搜索
Claude: python3 scripts/search.py --keyword "phone" --platform amazon --region US

功能说明

核心功能

关键词搜索 (scripts/search.py)

• 关键词搜索：根据关键词搜索目标平台的商品
• 多维度筛选：支持价格、销量、评分、上架时间等筛选条件
• 多平台支持：Amazon（美国、英国、日本等）、TikTok（印尼、泰国等）
• 丰富商品信息：返回商品详情、供应商信息、规格参数、物流选项等

支持的平台和区域

Amazon平台：

• 美国 (US)
• 英国 (UK)
• 日本 (JP)
• 德国 (DE)
• 法国 (FR)
• 意大利 (IT)
• 西班牙 (ES)
• 加拿大 (CA)