Shopee热搜词查询
关于 clawEC
clawEC Work 是 AI 驱动的跨境电商工作台:说出要求、开始执行任务、交付完整成果。无缝连接 Amazon、TikTok、Shopee、Ozon 等主流平台,自主规划并调用工具生成选品报告与素材,你的跨境好搭子。
本技能调用 clawEC 开放 API,用于查询Shopee热搜词列表。
认证与基址
- 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/shopee/data/word/search
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
| site | body | 是 | 站点名称:tw=台湾, my=马来西亚, id=印度尼西亚, th=泰国, ph=菲律宾, sg=新加坡, vn=越南, br=巴西 |
| categoryId | body | 否 | 类目ID。一级类目对照:100001=保健, 100009=时尚配饰, 100010=家用电器, 100011=男装服饰, 100012=男士鞋, 100013=手机平板与配件, 100015=旅行&行李箱, 100016=女士包, … |
| categoryLocation | body | 否 | 产品地址:1=本土 2=跨境 0=全部(默认0);默认 0 |
| itemCountMin | body | 否 | 产品总数最小值 |
| itemCountMax | body | 否 | 产品总数最大值 |
| sales30dayMin | body | 否 | 近30天销量最小值 |
| sales30dayMax | body | 否 | 近30天销量最大值 |
| recPriceMin | body | 否 | 推荐出价最小值 |
| recPriceMax | body | 否 | 推荐出价最大值 |
| sortType | body | 否 | 列表排序:1=近30天销量 2=推荐出价 3=搜索指数 4=产品总数(默认1);默认 1 |
| pageNo | body | 否 | 当前页码;不传默认1;默认 1 |
| pageSize | body | 否 | 每页条数,最大100;不传默认10;默认 10 |
| timest | body | 否 | 查询账期,yyyy-MM-dd,只能选某一天;不传默认昨天 |
site / sites 取值
| 代码 | 站点 |
|---|---|
| tw | 台湾 |
| my | 马来西亚 |
| id | 印度尼西亚 |
| th | 泰国 |
| ph | 菲律宾 |
| sg | 新加坡 |
| vn | 越南 |
| br | 巴西 |
sites 为多选站点列表时,传 JSON 数组字符串,例如 ["tw","my"]。
调用
bashcurl -s -X POST "https://www.clawec.com/api/aigc/ec/shopee/data/word/search" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $CLAWEC_API_KEY" \ -d '{"site": "tw", "categoryLocation": "0", "sortType": "1", "pageNo": "1", "pageSize": "10"}'
筛选参数较多时,推荐直接传 JSON body(或 @payload.json)。
或使用脚本:
bashbash scripts/query.sh '{"site": "tw", "categoryLocation": "0", "sortType": "1", "pageNo": "1", "pageSize": "10"}' bash scripts/query.sh @payload.json
响应结构
json{ "status": 1, "data": { ... } }
status:1= 成功,0= 失败- 成功时解析
data按用户需求整理为中文摘要即可(无需卡片组件)
工作流程
- 确认 site;参数较多时用 JSON 传入
- 检查
CLAWEC_API_KEY是否可用 - 执行 API 请求
- 失败时说明错误并提示检查密钥与关键参数
- 解析返回数据,整理为中文摘要
输出建议
- 查询条件与关键参数
- Shopee热搜词查询核心指标摘要(以返回字段为准)
- 给出 1–2 条可行动观察


