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/shop/search
| 参数 | 位置 | 必填 | 说明 |
|---|---|---|---|
| site | body | 是 | 站点名称:tw=台湾, my=马来西亚, id=印度尼西亚, th=泰国, ph=菲律宾, sg=新加坡, vn=越南, br=巴西 |
| categoryId | body | 否 | 类目ID。一级类目对照:100001=保健, 100009=时尚配饰, 100010=家用电器, 100011=男装服饰, 100012=男士鞋, 100013=手机平板与配件, 100015=旅行&行李箱, 100016=女士包, … |
| shopType | body | 否 | 产品类型:1=虾皮优选 2=虾皮商城 3=其他 0=全部(默认0);默认 0 |
| isBorder | body | 否 | 店铺类型:1=本土店铺 2=跨境店铺 0=全部(默认0);默认 0 |
| sortField | body | 否 | 排序字段:1=近30天销量 2=近30天销售额 3=产品均价(默认1);默认 1 |
| sortOrder | body | 否 | 排序方向:asc=升序 desc=降序(默认desc);默认 desc |
| pageNo | body | 否 | 分页页码,从1开始,最大100000;不传默认1;默认 1 |
| pageSize | body | 否 | 分页大小,最大10;不传默认10;默认 10 |
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/shop/search" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $CLAWEC_API_KEY" \ -d '{"site": "tw", "shopType": "0", "isBorder": "0", "sortField": "1", "sortOrder": "desc", "pageNo": "1", "pageSize": "10"}'
筛选参数较多时,推荐直接传 JSON body(或 @payload.json)。
或使用脚本:
bashbash scripts/query.sh '{"site": "tw", "shopType": "0", "isBorder": "0", "sortField": "1", "sortOrder": "desc", "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 条可行动观察


