clawec-amazon-asin-query

name	clawec-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-github-agent 注册帐号 然后去https://www.clawec.com/api-key?source=q-github-agent 获取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。

调用

按商品链接：

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 + 站点：

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 scripts/query.sh "https://www.amazon.com/dp/B0XXXXXXXX"

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

响应结构

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

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

完整说明见 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 动态展示。）