К основному содержанию
скилл CX Codex

linkfox-google-trend-get-trend-by-keys — скилл для Claude Code

Скилл linkfox-google-trend-get-trend-by-keys для Claude Code анализирует интерес к ключевым словам в Google Trends. Сравнивает регионы и периоды, находит сезонность, пики, спады и рост спроса.

MIT 246 установок ★ 125 обновлён 2026-11-11

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add linkfox-ai/linkfox-skills --skill linkfox-google-trend-get-trend-by-keys -a claude-code
Открыть на GitHub

Что делает linkfox-google-trend-get-trend-by-keys

Скилл запрашивает данные Google Trends по одному или нескольким ключевым словам и регионам, затем помогает разобрать направление тренда, сезонность, резкие колебания и устойчивый рост или спад. Для запуска используются прямой вызов API или скрипт python scripts/google_trends_keyword.py '<JSON параметра>' [--inline].

Перед запросом задаются ключевое слово, рынок и диапазон дат. API-ключ хранится в LINKFOX_AGENT_API_KEY или LINKFOXAGENT_API_KEY. Скрипт сохраняет полный ответ в JSON и использует локальный кэш на 24 часа, чтобы не повторять тот же запрос. Один вызов расходует 6 единиц вычислительного ресурса, а Google Trends показывает относительный индекс 0–100, не абсолютное число поисков.

Отдельные запросы нормализуются по своим диапазонам, поэтому значения 100 нельзя считать равными объёмами спроса. Для повторного анализа можно извлекать данные из trendInfoForKeys[].trendValues[] через jq или ConvertFrom-Json, сохраняя исходные значения вроде "<1".

Какие задачи решает

  • сравнить интерес к ключевому слову в разных регионах
  • найти сезонные пики и провалы спроса
  • сопоставить тренд по месяцам или годам
  • выявить устойчивый рост или спад интереса
  • проверить влияние события на поисковый интерес

Примеры запросов агенту

  • Проанализируй тренд для wireless charger на рынке по умолчанию.
  • Сравни интерес к Ladekabel в Германии: используй {"keyword":"Ladekabel","region":"DE"}.
  • Проверь сезонность christmas gifts в США с dayRangeStart 2024-09-01 и dayRangeEnd 2025-01-31.

Как установить linkfox-google-trend-get-trend-by-keys

1Через Skills CLI (Vercel)

npx skills add linkfox-ai/linkfox-skills --skill linkfox-google-trend-get-trend-by-keys -a claude-code

2Вручную: положить файлы

~/.claude/skills/linkfox-google-trend-get-trend-by-keys/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/linkfox-google-trend-get-trend-by-keys/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о linkfox-google-trend-get-trend-by-keys

Как установить linkfox-google-trend-get-trend-by-keys в Claude Code?

Выполните npx skills add linkfox-ai/linkfox-skills --skill linkfox-google-trend-get-trend-by-keys -a claude-code, затем проверьте файл ~/.claude/skills/linkfox-google-trend-get-trend-by-keys/SKILL.md.

Что делает linkfox-google-trend-get-trend-by-keys?

Скилл получает данные Google Trends и разбирает относительный интерес к ключевым словам по регионам и периодам. Он помогает находить сезонность, пики, провалы и направление тренда.

Что нужно для работы скилла?

Нужен ключ LINKFOX_AGENT_API_KEY или LINKFOXAGENT_API_KEY. Для запуска рекомендованного скрипта требуется Python; повторные запросы с теми же параметрами берутся из локального кэша на 24 часа.

Исходный текст

SKILL.md · MIT
---
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`。
3. 检查已有响应文件和缓存,避免重复请求;通过脚本获取数据后,先看摘要,再从保存的 JSON 中提取趋势明细。
4. 根据实际数据识别峰值、谷值、突发波动及持续增长或下降。用表格或趋势曲线描述结果,说明关键词、地区、时间范围和可见模式。
5. 查询失败或数据稀疏时,按接口定义解释原因,提出核对拼写、语言或日期区间等调整建议;后续检索遵守成本约束。

## 执行方式

- **直接调用接口**:接口端点、完整参数、响应和错误码见 `references/api.md`。
- **脚本调用(推荐)**:`python scripts/google_trends_keyword.py '<JSON 参数>' [--inline]`。
- **成本约束**:本工具会消耗算力。同一会话、同一参数组合默认只调用一次,脚本提供 24 小时本地缓存。失败或空结果时,不得自动更换关键词、翻页或修改邮编连续试探;需要继续检索时,先向用户说明额外消耗。

### 输出策略

- 始终保存完整响应,目标路径为 `<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-google-trend-get-trend-by-keys-<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 使用 0–100 归一化兴趣量表,100 表示所选地区和时间范围内的峰值,50 表示相对峰值的一半,0 表示数据不足。它不能提供绝对搜索量,也不能由热度值反推出搜索次数。
- **谨慎比较**:分别查询的关键词或地区各有归一化范围,比较趋势形态、峰值时间和季节性时说明口径,不能把各自的 100 当作相等的绝对需求量。
- **保留原始数据**:读取保存响应中的 `trendInfoForKeys[].trendValues[]`,保留 `timeRange` 和 `"<1"` 等原始值,不将其强制转为零。
- **清晰展示趋势**:列出关键时间点、峰谷及明显变化;仅在数据支持时指出季节性、突发峰值或持续增长、下降。数据稀疏时明确说明分析局限。
- **利用图表信息**:响应包含 `chartOption` 时,说明已有可视化数据,并描述可见趋势形态。
- **按需提取本地数据**:优先使用 `jq` 或 `ConvertFrom-Json`。`_dataQuery_executeDynamicQuery` 查询的是 SLS 中存储的 LinkFox 会话数据,只有存在所需存储映射时才能使用,不能用它读取任意本地 JSON。

## 使用示例

### 默认市场的基础趋势

```json
{"keyword": "wireless charger"}
```

### 德国市场的本地语言关键词

```json
{"keyword": "Ladekabel", "region": "DE"}
```

### 圣诞礼物的季节性趋势

```json
{"keyword": "christmas gifts", "region": "US", "dayRangeStart": "2024-09-01", "dayRangeEnd": "2025-01-31"}
```

### 澳大利亚防晒需求的跨年对比

```json
{"keyword": "sunscreen", "region": "AU", "dayRangeStart": "2023-01-01", "dayRangeEnd": "2025-12-31"}
```

### 英国市场的区域研究

```json
{"keyword": "yoga mat", "region": "GB"}
```

### 新兴关键词趋势

```json
{"keyword": "AI glasses", "region": "US", "dayRangeStart": "2024-01-01", "dayRangeEnd": "2025-12-31"}
```

## 使用反馈

当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 `references/api.md#Feedback` 的指引反馈,不要打断用户当前流程。

---

更多优质、专业的跨境电商技能,请访问 [LinkFox Skill](https://skill.linkfox.com/)。

© linkfox-ai · MIT · linkfox-ai/linkfox-skills

Похожие скиллы

Все скиллы по теме «Данные и базы» →
google-trends-research PostPlusAI Скилл google-trends-research для Claude Code собирает данные Google Trends о динамике ключевых слов, регионах и связанных запросах. Проверяет поисковый интерес перед дальнейшим исследованием. CX Codex +1 1 200установок HasData Google Trends HasData Сервер HasData Google Trends запрашивает динамику поисковых запросов в Google Trends и разбивку по регионам без прямого парсинга и аккаунта Google. CX Codex +1 ★ 5звёзд репо Google Trends API trendsapi-ai MCP-сервер Google Trends API для запроса динамики интереса к поисковым фразам и процента их роста через Trends API. Помогает оценивать популярность запросов в Google прямо в чате с ассистентом. CX Codex +1 Google Trends google Отдаёт агенту данные Google Trends: как меняется интерес к запросу, где его ищут и что стоит рядом. Ключ API не нужен. CX Codex +1 411установок trendspyg aahl Скилл подключает агента к библиотеке trendspyg: тренды сейчас, динамика запроса, связанные запросы и интерес по регионам. CX Codex +1 1 100установок Google News & Trends MCP AKzar1el MCP-сервер Google News & Trends MCP для Claude Code ищет новости через Google News и анализирует динамику поискового интереса в Google Trends. Используется для проверки тем и сравнения ключевых слов. CX Codex +1 ★ 7звёзд репо

Из того же набора74

Весь набор →
linkfox-echotik-product-video Скилл linkfox-echotik-product-video для Claude Code собирает метрики и продажи рекламных видео по товарам TikTok Shop. Запускается при разборе конверсий и креативов у блогеров. CX Codex +1 329установок linkfox-temu-fulfillment-eu Скилл linkfox-temu-fulfillment-eu для Claude Code управляет отгрузкой заказов авторизованных магазинов Temu в Европе. Он подключается к задачам по покупке ярлыков, передаче посылок и проверке доставки. CX Codex +1 326установок linkfox-temu-fulfillment-global Скилл linkfox-temu-fulfillment-global для Claude Code управляет фулфилментом заказов Temu Global. Помогает купить этикетку, передать заказ на склад, оформить отправку и отследить посылку. CX Codex +1 324установок linkfox-amazon-policy-feed Скилл linkfox-amazon-policy-feed для Claude Code и Codex запрашивает официальные обновления правил, тарифов и требований Amazon для продавцов. Запускается при мониторинге регуляторных новостей по маркетплейсам. CX Codex +1 317установок linkfox-amazon-opportunity-report-by-keyword Скилл linkfox-amazon-opportunity-report-by-keyword для Claude Code формирует отчёт по ключевым словам Amazon US с оценкой рыночного спроса, конкуренции и цен. Запускается при проверке товарных ниш на американском маркетплейсе. CX Codex +1 243установок linkfox-amazon-opportunity-search-by-metrics Скилл linkfox-amazon-opportunity-search-by-metrics для Claude Code и Codex находит ниши на американском Amazon по заданным бизнес-метрикам. Отбирает поисковые запросы по темпам роста, конкуренции, ценовым сегментам и демографии покупателей. CX Codex +1 243установок linkfox-sellersprite-competitor-lookup Скилл linkfox-sellersprite-competitor-lookup для Claude Code и Codex ищет и сравнивает товары-конкуренты Amazon по ASIN, ключевым словам, продавцу, бренду или категории. Показывает продажи, BSR, цены и динамику. CX Codex +1 241установок linkfox-seerfar-ozon-keyword-mining Скилл linkfox-seerfar-ozon-keyword-mining для Claude Code, Codex и Cursor собирает поисковые запросы Ozon и Wildberries вокруг заданного слова через базу Seerfar. Находит длинные хвосты и низкоконкурентные ниши с фильтрами по метрикам. CX Codex +1 238установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой