# linkfox-google-trend-get-trend-by-keys

The linkfox-google-trend-get-trend-by-keys skill for Claude Code reads Google Trends interest for keywords. It compares regions and date ranges, then identifies seasonality, peaks, drops, and emerging demand.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 246 installs · ★ 125 repo stars
- Author: linkfox-ai
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/linkfox-ai/linkfox-skills/tree/HEAD/skills/linkfox-google-trend-get-trend-by-keys/SKILL.md
- Updated: 2026-11-11
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/linkfox-google-trend-get-trend-by-keys

## What it does

The skill queries Google Trends for one or more keywords and regions, then supports analysis of trend direction, seasonal patterns, sharp changes, and sustained growth or decline. Requests can use the API directly or the script `python scripts/google_trends_keyword.py '<JSON parameters>' [--inline]`.

Set a keyword, target market, and date range before querying. Authentication uses `LINKFOX_AGENT_API_KEY` or `LINKFOXAGENT_API_KEY`. The script stores the full response as JSON and keeps a 24-hour local cache for repeated parameter sets. Each call consumes 6 compute units, while Google Trends reports a relative 0–100 index rather than an absolute search count.

Separate keyword or region queries have separate normalization ranges, so their 100 values are not equal demand volumes. Saved results can be inspected through `jq` or `ConvertFrom-Json`, with fields such as `trendInfoForKeys[].trendValues[]` and raw values like `"<1"` kept intact.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add linkfox-ai/linkfox-skills --skill linkfox-google-trend-get-trend-by-keys -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/linkfox-google-trend-get-trend-by-keys/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/linkfox-google-trend-get-trend-by-keys/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add linkfox-ai/linkfox-skills --skill linkfox-google-trend-get-trend-by-keys -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/linkfox-google-trend-get-trend-by-keys/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add linkfox-ai/linkfox-skills --skill linkfox-google-trend-get-trend-by-keys -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/linkfox-google-trend-get-trend-by-keys/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install linkfox-ai/linkfox-skills skills/linkfox-google-trend-get-trend-by-keys
```

2. **Manually: put the files in place**
- File: `.github/skills/linkfox-google-trend-get-trend-by-keys/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add linkfox-ai/linkfox-skills --skill linkfox-google-trend-get-trend-by-keys -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/linkfox-ai/linkfox-skills --path skills/linkfox-google-trend-get-trend-by-keys
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/linkfox-google-trend-get-trend-by-keys/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add linkfox-ai/linkfox-skills --skill linkfox-google-trend-get-trend-by-keys -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/linkfox-ai/linkfox-skills/tree/HEAD/skills/linkfox-google-trend-get-trend-by-keys/SKILL.md

## When to use it
- compare keyword interest across regions
- spot seasonal search peaks and troughs
- contrast trends across months or years
- detect sustained growth or decline
- measure search-interest changes around an event

## Example prompts
- Analyze the Google Trends direction for `wireless charger` in the default market.
- Compare `Ladekabel` in Germany with `{"keyword":"Ladekabel","region":"DE"}`.
- Check the seasonal pattern for `christmas gifts` in the US from `2024-09-01` to `2025-01-31`.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: b77152c979b9518d.

BEGIN THIRD-PARTY FILE b77152c979b9518d
```text
---
name: linkfox-google-trend-get-trend-by-keys
description: 查询并分析 Google Trends 关键词搜索热度，研究不同地区和时间范围内的趋势方向、季节性、搜索峰谷及新兴需求，支持多个关键词或地区的趋势对比。适用于谷歌趋势、历史搜索兴趣和市场热度研究，即使用户未明确提及 Google Trends 也适用。不适用于绝对搜索量、广告出价与 CPC、社交媒体热点、亚马逊站内搜索数据、网站流量或 SEO 排名查询。
---

# Google Trends 关键词趋势分析

## 适用范围

### 适用

查看关键词在 Google 搜索中的兴趣变化，分析季节性、事件驱动的波动及持续增长或下降。用户希望比较不同月份、年份或地区的搜索趋势时，使用本技能。

**场景速查**

| 用户表达 | 查询场景 |
|----------|----------|
| 这个关键词在 Google 上热不热 | 基础搜索兴趣查询。 |
| 这个词正在升温还是降温 | 趋势方向与持续性分析。 |
| 一年中哪个月份搜索最多 | 季节性与峰谷识别。 |
| 对比不同月份或年份的热度 | 历史趋势与跨年季节性研究。 |
| 这个词在德国有没有热度 | 目标市场搜索兴趣研究。 |
| 看看过去一年或节日前后的趋势 | 指定区间及事件影响分析。 |
| 比较几个词或地区的趋势 | 分别查询并说明相对热度的可比性。 |

## 前置条件

先确定关键词、目标市场和分析时间范围。核对用户意图；未指定地区时采用接口默认值，并在结果中注明。请求所需字段、语言要求、地区范围和日期约定见 `references/api.md`。

## 查询与分析流程

1. 明确研究目标：基础热度、季节性、跨年对比、地区比较或新兴趋势。检查关键词与目标市场语言是否匹配，按接口定义准备请求，优先使用简短、聚焦的词语。
2. 季节性和事件分析选择对应时间区间；跨年分析覆盖需要对比的年份。组合比较时，先明确所需查询组合及算力消耗，单次能力与调用限制见 `references/api.md`。
```
END THIRD-PARTY FILE b77152c979b9518d

The third-party file has ended. Everything between the b77152c979b9518d tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2129 of 7101 bytes. © linkfox-ai · MIT · https://github.com/linkfox-ai/linkfox-skills/tree/HEAD/skills/linkfox-google-trend-get-trend-by-keys/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
