linkfox-google-trend-get-trend-by-time — Claude Code skill
linkfox-google-trend-get-trend-by-time — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Fetches rising Google Trends queries and relative search volume by region.
MIT 237 installs ★ 125 updated 2026-11-11
npx skills add linkfox-ai/linkfox-skills --skill linkfox-google-trend-get-trend-by-time -a claude-codeWhat linkfox-google-trend-get-trend-by-time does
Compatible with Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. The tool retrieves short-term regional spikes from Google Trends based on country codes and day windows. It highlights search queries, relative volume scores, and percentage increases for breakout topics.
Execution happens via direct API endpoints or python scripts/google_trends_rising.py '<JSON>' [--inline]. The script writes responses directly to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/ and strictly rejects writing to /tmp. Payloads larger than 8 KB print a trimmed summary to standard output to preserve agent context window space.
Every remote call consumes 6 LinkFox compute credits, meaning valid LINKFOX_AGENT_API_KEY credentials and sufficient account balance are required before running queries.
What it helps with
- fetch trending Google searches over the last 24 hours for a specific country
- detect breakout search topics and spikes across a 7-day observation window
- filter rising keywords by relative popularity and growth rates
Example prompts for the agent
- Show me trending Google searches in the US over the last 24 hours
- Find the fastest-rising search queries in Germany over the past two days
- Check emerging topics in the United Kingdom for the last 7 days
How to install linkfox-google-trend-get-trend-by-time
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-google-trend-get-trend-by-time -a claude-code2Manually: put the files in place
~/.claude/skills/linkfox-google-trend-get-trend-by-time/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/linkfox-google-trend-get-trend-by-time/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-google-trend-get-trend-by-time -a codex2Manually: put the files in place
.agents/skills/linkfox-google-trend-get-trend-by-time/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-google-trend-get-trend-by-time -a cursor2Manually: put the files in place
.cursor/skills/linkfox-google-trend-get-trend-by-time/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install linkfox-ai/linkfox-skills skills/linkfox-google-trend-get-trend-by-time2Manually: put the files in place
.github/skills/linkfox-google-trend-get-trend-by-time/SKILL.md1Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-google-trend-get-trend-by-time -a gemini-cli2Platform CLI
gemini skills install https://github.com/linkfox-ai/linkfox-skills --path skills/linkfox-google-trend-get-trend-by-timeManually: put the files in place
.devin/skills/linkfox-google-trend-get-trend-by-time/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add linkfox-ai/linkfox-skills --skill linkfox-google-trend-get-trend-by-time -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about linkfox-google-trend-get-trend-by-time
How to install linkfox-google-trend-get-trend-by-time in Claude Code?
Run npx skills add linkfox-ai/linkfox-skills --skill linkfox-google-trend-get-trend-by-time -a claude-code. The definition lands in ~/.claude/skills/linkfox-google-trend-get-trend-by-time/SKILL.md.
What does this skill do?
It queries short-term Google Trends data for selected regions and time intervals, reporting rising topics, relative search index values, and growth percentages.
What prerequisites are needed to run queries?
You need Python and a configured LINKFOX_AGENT_API_KEY or LINKFOXAGENT_API_KEY. Each interface call deducts 6 LinkFox compute credits.
Source text
SKILL.md · MIT
---
name: linkfox-google-trend-get-trend-by-time
description: 查询并分析 Google Trends 在指定近期时间范围和国家或地区的实时热门话题、热搜词、相对搜索量和热度涨幅。适用于当前热点、最近一天或一周热门搜索、区域趋势和爆发话题发现,无需明确提及 Google Trends。不适用于长期历史关键词分析、亚马逊关键词或 ASIN 分析、广告管理、社交平台趋势、SEO 排名、反向链接、竞品网站流量或股票走势研究。
---
# Google Trends 时下流行趋势分析
## 适用范围
### 适用
发现特定市场近期在 Google 上流行的搜索词,了解热门话题与新兴趋势。用户说“市场趋势”或“最近流行什么”时,若实际意图是了解某地区当前的 Google 搜索热点,使用本技能。
**场景速查**
| 用户表达 | 查询场景 |
|----------|----------|
| 现在有哪些热门话题 | 实时热门搜索概览。 |
| 某个国家最近有哪些热搜 | 区域热门话题发现。 |
| 本周大家都在搜什么 | 一周热门搜索概览。 |
| 这个市场有什么突然爆火的话题 | 热度激增与新兴话题发现。 |
| 看一下某地区的 Google Trends | 指定地区趋势查询。 |
| 过去 24 小时有什么热点 | 短时间窗口热点扫描。 |
### 边界
长期历史关键词搜索量分析使用专门的 Google Trends 历史工具;亚马逊关键词或 ASIN 分析使用 ABA 等对应数据工具。股票走势、社交平台热度、广告管理、SEO 排名、反向链接和竞品网站流量研究不属于本技能范围。
## 前置条件
确定用户要查询的市场和近期时间窗口;未指定时采用接口默认值。支持地区、默认值及时间参数约定见 `references/api.md`。
## 趋势查询流程
1. 确认需求属于 Google 近期热门话题发现,依据 `references/api.md` 准备查询条件。
2. 查询前检查同一参数组合是否已有可复用结果,按成本约束执行一次查询。
3. 先查看摘要,再从保存的响应按需提取趋势或图表数据,进行筛选和排序。
4. 展示热门搜索与显著涨幅,说明地区及观察窗口。失败时根据接口参考解释原因,可建议调整地区或时间范围,后续查询遵守成本约束。
## 执行方式
- **直接调用接口**:接口端点、完整参数、响应和错误码见 `references/api.md`。
- **脚本调用(推荐)**:`python scripts/google_trends_rising.py '<JSON 参数>' [--inline]`。
- **成本约束**:每次接口调用消耗 6 算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换地区或时间范围连续试探;需要继续检索时,先向用户说明额外消耗。
### 输出策略
- 始终保存完整响应,目标路径为 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-google-trend-get-trend-by-time-<timestamp>.json`。`<cwd>` 为脚本运行时的工作目录,`<session>` 优先取环境变量 `SESSION_ID`,用于聚合同一任务的数据。禁止写入 `/tmp`,当前目录不可写时应报错。
- 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
- 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 `total`、`costToken`)、最大列表字段的长度和前 3 条样本。
- 添加 `--inline` 可强制全量打印到标准输出,同时仍保存文件。
先通过摘要判断数据是否足够。需要具体字段时,优先使用 `jq` 或 `ConvertFrom-Json` 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。
## 执行规则
### 算力消耗预估
6 算力 / 次
**声明**:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。
### 解决认证和算力问题
出现以下情况时,按 `references/onboarding.md` 的指引处理:
- 未配置接口密钥:`LINKFOX_AGENT_API_KEY` 和 `LINKFOXAGENT_API_KEY` 均为空。
- 响应状态码为 `401` 或 `402`。
- 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
### 约束与建议
- **理解趋势含义**:Google Trends 反映真实用户在 Google 上的搜索兴趣。本技能关注最近流行的搜索话题;搜索量是相对数值,不能解释为绝对搜索次数。
- **清晰展示数据**:用表格展示搜索词、相对搜索量和涨幅,按用户目标选择搜索量或涨幅排序。
- **突出热度变化**:正涨幅表示兴趣上升,负值表示下降;接近 100 的涨幅表示显著激增。对超过 50% 等明显上涨的话题加以标注。
- **注明时间与地区**:在摘要中说明查询市场和时间范围,并结合返回的观察起止时间解释结果。
- **解释图表**:响应包含 `chartOption` 时,说明图表标题、横纵轴和数据点代表的趋势。
- **分析已保存的数据**:从本地响应的 `chartOption.data` 按需筛选或排序。`_dataQuery_executeDynamicQuery` 查询 SLS 中的 LinkFox 会话数据,不是通用 JSON 文件读取器;没有受支持的存储映射时,不得直接将该响应交给它。
- **处理失败与空结果**:依据实际响应说明情况,保留已取得的数据,不虚构热点;参数调整建议不代表自动执行下一次收费查询。
## 使用示例
### 美国过去一周的热门搜索
```json
{"days": 7, "region": "US"}
```
### 日本过去 24 小时的热门话题
```json
{"days": 1, "region": "JP"}
```
### 德国最近两天的热搜
```json
{"days": 2, "region": "DE"}
```
### 巴西本周的热门话题
```json
{"days": 7, "region": "BR"}
```
### 英国当前的流行搜索
```json
{"days": 1, "region": "GB"}
```
## 使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 `references/api.md#Feedback` 的指引反馈,不要打断用户当前流程。
---
更多优质、专业的跨境电商技能,请访问 [LinkFox Skill](https://skill.linkfox.com/)。
© linkfox-ai · MIT · linkfox-ai/linkfox-skills