谷歌趋势#

关于 ClawEC#

ClawEC 是一款面向跨境电商场景的 AI 智能体协同平台，以「你的跨境电商 AI 团队」为品牌主张，将选品、调研、运营、上架、营销、客服、采购、合规等环节沉淀为可执行的 SOP（标准作业程序），通过多智能体（「虾员工」）分工协作与 7×24 小时自动化任务，帮助卖家在单人或少人条件下完成跨境业务闭环，降低对专业运营团队与复杂本地部署的依赖。

本技能调用 ClawEC 开放 API，用于查询 Google Trends 关键词兴趣趋势。

认证与基址#

• 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/ec/google_trend

参数位置必填说明keywordbody是关键词；多个词用 英文逗号 分隔，如 phone case,phone holderregionbody否地区，ISO 3166-1 alpha-2 两位大写国家代码（见下表）

region 常用取值#

代码市场US美国UK英国JP日本DE德国FR法国IT意大利ES西班牙CA加拿大

理论上支持 Google Trends 覆盖的全部国家/地区，使用标准两位大写代码。未指定 region 时由 API 按默认范围返回（以实际行为为准）。

调用#

单词 + 美国：

bash

curl -s -X POST "https://www.clawec.com/api/aigc/ec/google_trend" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CLAWEC_API_KEY" \
  -d '{"keyword":"wireless earbuds","region":"US"}'

多词对比：

bash

curl -s -X POST "https://www.clawec.com/api/aigc/ec/google_trend" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $CLAWEC_API_KEY" \
  -d '{"keyword":"phone case,phone holder","region":"US"}'

或使用脚本：

bash

# 关键词 + 地区（默认 US）
bash scripts/query.sh "wireless earbuds" US

# 多词对比（逗号分隔，脚本内原样传入 keyword）
bash scripts/query.sh "phone case,phone holder" UK

响应结构#

json

{
  "status": 1,
  "code": 0,
  "msg": "",
  "data": { ... },
  "extra": "",
  "pointInfo": { "type": 0, "point": 0 }
}

• status: 1 = 成功， 0 = 失败
• code / msg: 业务状态码与说明（以实际返回为准）
• data: 趋势数据对象，字段以实际返回为准
• extra: 附加信息字符串（若有）
• pointInfo: 积分/扣点信息 { type, point }

常见趋势字段（ data 内，以实际返回为准）#

字段说明keyword / keywords查询词或词列表region地区代码timeline / interest_over_time时间序列兴趣指数related_queries相关搜索（上升/热门）related_topics相关主题averages / comparison多词对比时的相对热度

完整说明见 references/response-schema.md。

工作流程#

1. 确认关键词（单词或多词逗号分隔）与目标 region
2. 检查 CLAWEC_API_KEY 是否可用
3. 执行 API 请求
4. status !== 1 或请求失败时，说明错误并提示检查密钥、关键词格式与地区代码
5. 解析 data，对比多词趋势并给出中文解读

输出建议#

默认中文摘要，包含：

• 查询关键词、地区、时间范围（若 data 含时间轴）
• 趋势概览：各词相对热度、近期升降（结合时间序列）
• 多词对比：指出当前更高/更稳的词及可能原因（季节性、品类差异等）
• 相关发现：摘录 related_queries / related_topics 中有选品价值的词
• 选品场景：2–5 条可行动观察；说明趋势为搜索兴趣而非销量

示例#

输入：美国市场对比 phone case 与 phone holder

输出摘要：

关键词近期趋势相对热度备注phone case平稳略升较高...phone holder季节性波动较低...

相关搜索（示例）：…

观察：（结合趋势与相关词给出选品建议）