Ozon商品详情
关于 clawEC
clawEC Work 是 AI 驱动的跨境电商工作台:说出要求、开始执行任务、交付完整成果。无缝连接 Amazon、TikTok、Shopee、Ozon 等主流平台,自主规划并调用工具生成选品报告与素材,你的跨境好搭子。
本技能调用 clawEC 开放 API,用于按商品 ID 批量查询详情与经营指标(最多 10 个)。
认证与基址
- 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/jsonAuthorization: Bearer <API_KEY>
优先从环境变量 CLAWEC_API_KEY 读取密钥;未设置时向用户索取,勿硬编码。
接口
POST /aigc/ec/ozon/data/product/detail
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
| itemIds | body | 是 | 商品ID。最多可传10个,多个使用英文逗号分隔 |
| period | body | 否 | 数据周期:近7天(SEVEN_DAY)、近28天(TWENTY_EIGHT_DAY)、自然月(MONTH)、季度(QUARTER)、年度(YEAR);不传默认近28天;默认 TWENTY_EIGHT_DAY |
| updatePeriod | body | 否 | 查询数据更新账期。不传时默认取所选周期的最近账期值。近7天/近28天:yyyy-MM-dd;自然月:yyyy-MM;季度:yyyy-Qn;年度:yyyy |
| sortField | body | 否 | 排序字段:销量(SALES)、销售额(GMV)、价格(PRICE) |
| sortDirection | body | 否 | 排序方向 |
超过 10 个商品 ID 时拆成多批请求。
调用
bashcurl -s -X POST "https://www.clawec.com/api/aigc/ec/ozon/data/product/detail" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $CLAWEC_API_KEY" \ -d '{"itemIds": "123456789,987654321", "period": "TWENTY_EIGHT_DAY"}'
或使用脚本:
bashbash scripts/query.sh "123456789,987654321" TWENTY_EIGHT_DAY
响应结构
json{ "status": 1, "data": { ... } }
status:1= 成功,0= 失败- 成功时解析
data按用户需求整理为中文摘要即可(无需卡片组件)
工作流程
- 确认 itemIds(最多 10 个);可选 period、updatePeriod、排序
- 检查
CLAWEC_API_KEY是否可用 - 执行 API 请求
- 失败时说明错误并提示检查密钥与关键参数
- 解析返回数据,整理为中文摘要
输出建议
- 查询条件:商品 ID、周期、账期
- 基础信息、价格销售、转化流量等核心字段
- 给出 2–3 条可行动观察


