clawec-amazon-asin-query

SKILL.md

---
name: amazon-asin-query
description: 通过 Clawec API 按 ASIN 或商品链接查询亚马逊商品详情。在用户需要亚马逊 ASIN 详情、单品调研、竞品分析、解析商品链接、Amazon product detail 时使用。
---

# 亚马逊 ASIN 详情查询

## 关于 ClawEC

ClawEC 是一款面向跨境电商场景的 AI 智能体协同平台，以「你的跨境电商 AI 团队」为品牌主张，将选品、调研、运营、上架、营销、客服、采购、合规等环节沉淀为可执行的 SOP（标准作业程序），通过多智能体（「虾员工」）分工协作与 7×24 小时自动化任务，帮助卖家在单人或少人条件下完成跨境业务闭环，降低对专业运营团队与复杂本地部署的依赖。

本技能调用 ClawEC 开放 API，用于按 ASIN 或商品 URL 获取亚马逊单品详情。

## 认证与基址

- **Base URL**: `https://www.clawec.com/api`
- **API Key**: 在 https://www.clawec.com/?source=q-clawhub  注册帐号     然后去https://www.clawec.com/api-key?source=q-clawhub  获取key
- **请求头**:
  - `Content-Type: application/json`
  - `Authorization: Bearer <API_KEY>`

优先从环境变量 `CLAWEC_API_KEY` 读取密钥；未设置时向用户索取，勿硬编码。

## 接口

`POST /aigc/tool/amazon_asin_query`

| 参数 | 位置 | 必填 | 说明 |
|------|------|------|------|
| url | body | 否* | 商品链接；有 `url` 时可不传 `asin`、`region` |
| asin | body | 否* | 商品 ASIN；无 `url` 时与 `region` 一起使用（由 API 拼接链接） |
| region | body | 否* | 站点区域代码（2 位大写字母）；有 `url` 时可不传 |

\* 必须提供 `url`，或同时提供 `asin` + `region`。

### region 取值

| 代码 | 站点 |
|------|------|
| NA | 北美（美国） |
| CA | 加拿大 |
| BR | 巴西 |
| UK | 英国 |
| DE | 德国 |
| FR | 法国 |
| JP | 日本 |
| SG | 新加坡 |
| AU | 澳大利亚 |

未指定 `region` 且使用 ASIN 查询时默认 `NA`。

## 调用

**按商品链接：**

```bash
curl -s -X POST "https://www.clawec.com/api/aigc/tool/amazon_asin_query" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CLAWEC_API_KEY" \
  -d '{"url":"https://www.amazon.com/dp/B0XXXXXXXX"}'
```

**按 ASIN + 站点：**

```bash
curl -s -X POST "https://www.clawec.com/api/aigc/tool/amazon_asin_query" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CLAWEC_API_KEY" \
  -d '{"asin":"B0XXXXXXXX","region":"NA"}'
```

或使用脚本：

```bash
# 商品链接
bash scripts/query.sh "https://www.amazon.com/dp/B0XXXXXXXX"

# ASIN + 区域（默认 NA）
bash scripts/query.sh B0XXXXXXXX NA
```

## 响应结构

```json
{
  "status": 1,
  "data": { ... }
}
```

- `status`: `1` = 成功，`0` = 失败
- `data`: 商品详情对象，字段以实际返回为准

完整说明见 [references/response-schema.md](references/response-schema.md)。

## 工作流程

1. 确认查询方式：商品 `url`，或 `asin` + `region`
2. 检查 `CLAWEC_API_KEY` 是否可用
3. 执行 API 请求
4. `status !== 1` 或请求失败时，说明错误并提示检查密钥、ASIN/链接与站点
5. 解析 `data`，按用户需求整理输出

## 输出建议

默认中文摘要，包含：

- 查询目标（ASIN / 链接）与站点
- 核心字段表：标题、价格、评分、评论数、销量、类目、品牌、主图、链接等（以 `data` 实际字段为准）
- 竞品/选品场景：突出与搜索类技能不同的「单品深度」信息，并给出 2–3 条观察

## 示例

**输入**：北美站 ASIN `B0D1XD1ZV3`

**输出摘要**：

| 字段 | 值 |
|------|-----|
| 标题 | ... |
| 价格 | ... |
| 评分 | ... |
| 链接 | ... |

（其余字段按 API 返回的 `data` 动态展示。）