back
loading skill details...
通过 Clawec API 按 ASIN 或商品链接查询亚马逊商品详情。在用户需要亚马逊 ASIN 详情、单品调研、竞品分析、解析商品链接、Amazon product detail 时使用。
---
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` 动态展示。)
don't have the plugin yet? install it then click "run inline in claude" again.