linkfox-google-trend-get-trend-by-time

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Google Trends Time-Range Analysis

Google Trends 时间范围分析

This skill guides you on how to query and analyze Google Trends data for trending topics within a configurable time window, helping users discover real-time popular searches and emerging trends across 18 supported regions.

本技能将指导你如何在可配置的时间窗口内查询和分析Google Trends的热门话题数据，帮助用户在18个支持的地区中发现实时热门搜索和新兴趋势。

Core Concepts

核心概念

Google Trends reflects real user search interest on Google. This tool retrieves trending topics (recently popular queries) for a chosen country/region over a specified number of recent days. It is ideal for spotting what is currently gaining traction in a market.

Key data points per trending query:

query -- the trending search term
searchVolume -- relative search volume value
increasePercentage -- percentage change in search interest (-100 to 100, unit: %)
startTime / endTime -- timestamps bounding the trend observation window

A positive

increasePercentage

means rising interest; a negative value means declining interest. A value near 100 signals an explosive spike.

Google Trends反映了Google上真实用户的搜索兴趣。本工具可获取选定国家/地区在指定最近天数内的热门话题（近期流行的查询词），非常适合发现当前市场中正在升温的内容。

每个热门查询的关键数据点:

query -- 热门搜索词
searchVolume -- 相对搜索量数值
increasePercentage -- 搜索兴趣变化百分比（范围-100至100，单位：%）
startTime / endTime -- 趋势观察窗口的时间戳范围

increasePercentage

为正值表示搜索兴趣上升；负值表示搜索兴趣下降。接近100的值表示搜索量出现爆发式增长。

Parameter Guide

参数指南

Parameter	Type	Required	Default	Description
days	integer	No	7	Time range in days. Common values: 1 (last 24 hours), 2, 7 (past week)
region	string	No	US	Country/region code. See Supported Regions below

参数	类型	是否必填	默认值	描述
days	integer	否	7	时间范围（天数）。常用值：1（过去24小时）、2、7（过去一周）
region	string	否	US	国家/地区代码。见下方支持的地区

Supported Regions

支持的地区

US (United States), GB (United Kingdom), JP (Japan), CA (Canada), MX (Mexico), DE (Germany), FR (France), IT (Italy), ES (Spain), NL (Netherlands), AU (Australia), SG (Singapore), AE (United Arab Emirates), BR (Brazil), IN (India), TR (Turkey), PL (Poland), SE (Sweden)

Default region is US. Use US when the user does not specify a region.

US（美国）、GB（英国）、JP（日本）、CA（加拿大）、MX（墨西哥）、DE（德国）、FR（法国）、IT（意大利）、ES（西班牙）、NL（荷兰）、AU（澳大利亚）、SG（新加坡）、AE（阿联酋）、BR（巴西）、IN（印度）、TR（土耳其）、PL（波兰）、SE（瑞典）

默认地区为US。当用户未指定地区时，使用US。

调用方式

API 端点：
```
POST /googleTrend/getTrendByTime
```
（完整参数/响应/错误码见
```
references/api.md
```
）

Python 脚本：

python scripts/google_trends_rising.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带 24h 本地缓存。失败/空结果不得自动换关键词、翻页或改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-google-trend-get-trend-by-time-<timestamp>.json
```
（
```
<cwd>
```
为脚本执行时的工作目录，在 Claude Code 里即当前项目目录；
```
<session>
```
取自环境变量
```
SESSION_ID
```
，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）
响应体 ≤ 8 KB：落盘后把完整 JSON 打印到 stdout
响应体 > 8 KB：落盘后 stdout 只输出摘要（顶层字段、常见计数如
```
total
```
/
```
costToken
```
、最大列表字段的长度 + 前 3 条样本）
加
```
--inline
```
强制全量打印到 stdout（同样落盘）

读数据建议：先看摘要判断是否足够；需要具体字段时优先用

jq

或

ConvertFrom-Json

从保存的 json 文件按需抽取，避免整份 JSON 进入上下文。

API 端点：
```
POST /googleTrend/getTrendByTime
```
（完整参数/响应/错误码见
```
references/api.md
```
）

Python 脚本：

python scripts/google_trends_rising.py '<JSON 参数>' [--inline]

成本约束：本工具会消耗积分；同一会话同一参数组合默认只调用一次，脚本带有24小时本地缓存。失败/空结果不得自动更换关键词、翻页或修改邮编连续试探；需要继续检索时先向用户说明会产生额外消耗。

输出策略（脚本默认行为）：

始终将完整响应写入
```
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-google-trend-get-trend-by-time-<timestamp>.json
```
（
```
<cwd>
```
为脚本执行时的工作目录，在Claude Code中即当前项目目录；
```
<session>
```
取自环境变量
```
SESSION_ID
```
，按用户任务自动聚合；禁止写入 /tmp，当前目录不可写则报错）
响应体 ≤ 8 KB：落盘后将完整JSON打印到stdout
响应体 > 8 KB：落盘后stdout仅输出摘要（顶层字段、常见计数如
```
total
```
/
```
costToken
```
、最大列表字段的长度 + 前3条样本）
添加
```
--inline
```
参数强制将全量内容打印到stdout（同样会落盘）

读数据建议：先查看摘要判断是否足够；需要具体字段时优先使用

jq

或

ConvertFrom-Json

从保存的json文件中按需抽取，避免整份JSON进入上下文。

解决认证和积分问题

发生以下异常情况时，采用 references/onboarding.md 引导解决问题：

异常情况

未配置API Key：环境变量未配置
```
LINKFOX_AGENT_API_KEY
```
，也未配置
```
LINKFOXAGENT_API_KEY
```
。
响应401或402状态码
响应提示积分或余额不足：消息含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

未配置API Key：环境变量未配置
```
LINKFOX_AGENT_API_KEY
```
，也未配置
```
LINKFOXAGENT_API_KEY
```
。
响应401或402状态码
响应提示积分或余额不足：消息包含"积分余额不足/计费不足/余额不足/quota exceeded/insufficient balance/套餐到期/需充值/请充值"，或类似含义的内容。

Usage Examples

使用示例

1. What's trending in the US over the past week?

json

{"days": 7, "region": "US"}

2. Hot topics in Japan in the last 24 hours

json

{"days": 1, "region": "JP"}

3. Trending searches in Germany over the past 2 days

json

{"days": 2, "region": "DE"}

4. Recent buzz in Brazil this week

json

{"days": 7, "region": "BR"}

5. What's gaining popularity in the UK right now?

json

{"days": 1, "region": "GB"}

1. 过去一周美国的热门话题是什么？

json

{"days": 7, "region": "US"}

2. 日本过去24小时的热门话题

json

{"days": 1, "region": "JP"}

3. 德国过去2天的热门搜索

json

{"days": 2, "region": "DE"}

4. 巴西本周的热门话题

json

{"days": 7, "region": "BR"}

5. 英国当前正在升温的话题是什么？

json

{"days": 1, "region": "GB"}

Display Rules

展示规则

Present data clearly: Show trending queries in a well-formatted table with columns for query, search volume, and increase percentage. Sort by search volume or increase percentage as appropriate.
Highlight spikes: When
```
increasePercentage
```
is notably high (e.g., above 50%), call attention to these breakout topics.
Time context: Always state the time range and region in your summary so the user knows exactly what window the data covers.
Chart data: If the response includes
```
chartOption
```
, describe the chart structure (title, axes, data points) so the user understands the visual trend.
Error handling: When a query fails, explain the reason based on the error response and suggest adjusting parameters (e.g., try a different region code or time range).

清晰呈现数据：将热门查询词以格式规范的表格展示，包含查询词、搜索量和增长百分比列。根据情况按搜索量或增长百分比排序。
突出爆发式增长：当
```
increasePercentage
```
显著偏高（例如超过50%）时，重点关注这些突破性话题。
时间上下文：在摘要中始终说明时间范围和地区，让用户清楚了解数据覆盖的窗口。
图表数据：如果响应包含
```
chartOption
```
，描述图表结构（标题、坐标轴、数据点），帮助用户理解可视化趋势。
错误处理：当查询失败时，根据错误响应解释原因，并建议调整参数（例如尝试不同的地区代码或时间范围）。

Important Limitations

重要限制

Unstructured data: Results from this tool are unstructured and cannot be fed into secondary SQL-based query tools for further processing.
Relative volumes: Search volume values are relative, not absolute counts.
Short time windows: The
```
days
```
parameter controls recency; this tool is designed for recent/real-time trends, not long historical analysis.
Region coverage: Only the 18 listed regions are supported. Unsupported region codes will produce errors.

非结构化数据：本工具的结果为非结构化数据，无法输入到基于SQL的二次查询工具中进行进一步处理。
相对搜索量：搜索量数值为相对值，而非绝对计数。
短时间窗口：
```
days
```
参数控制数据的时效性；本工具专为近期/实时趋势设计，不适合长期历史分析。
地区覆盖：仅支持列出的18个地区。不支持的地区代码会产生错误。

User Expression & Scenario Quick Reference

用户表述与场景速查

Applicable -- Queries about trending/popular topics on Google:

User Says	Scenario
"What's trending right now"	Real-time trending topics
"Hot searches in [country]"	Regional trend discovery
"What topics are popular this week"	Weekly popularity overview
"Any viral topics in [market]"	Breakout / spike detection
"Show me Google Trends for [region]"	Region-specific trend query
"What's buzzing in the last 24 hours"	Short-window trend scan
"Trending searches in [country] recently"	Recent trend analysis
"What are people searching for in [region]"	General search interest exploration

Not applicable -- Needs beyond trending topic discovery:

Historical keyword search volume over months/years (use a dedicated Google Trends historical tool)
Amazon-specific keyword or ASIN analysis (use ABA tools)
Advertising / PPC campaign management
Social media trend analysis (Twitter/X, TikTok, etc.)
SEO ranking or backlink analysis
Competitor website traffic estimation

Boundary judgment: When users say "market trends" or "what's popular", if it boils down to discovering what people are currently searching for on Google in a specific region, this skill applies. If they are asking about stock market trends, social media virality, or long-term historical search patterns, it does not apply.

适用场景 -- 关于Google上热门话题的查询：

用户表述	场景
"What's trending right now"	实时热门话题
"Hot searches in [country]"	区域趋势发现
"What topics are popular this week"	每周热门概览
"Any viral topics in [market]"	突破性/爆发式增长话题检测
"Show me Google Trends for [region]"	特定地区趋势查询
"What's buzzing in the last 24 hours"	短窗口趋势扫描
"Trending searches in [country] recently"	近期趋势分析
"What are people searching for in [region]"	通用搜索兴趣探索

不适用场景 -- 超出热门话题发现的需求：

数月/数年的历史关键词搜索量分析（使用专门的Google Trends历史工具）
亚马逊特定关键词或ASIN分析（使用ABA工具）
广告/PPC活动管理
社交媒体趋势分析（Twitter/X、TikTok等）
SEO排名或反向链接分析
竞争对手网站流量估算

边界判断：当用户提到"市场趋势"或"热门内容"时，如果核心需求是发现特定地区用户当前在Google上搜索的内容，则适用本技能。如果用户询问的是股市趋势、社交媒体热度或长期历史搜索模式，则不适用。

积分消耗规则

消耗 6 积分。

用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。

Feedback:

Auto-detect and report feedback via the Feedback API when any of the following apply:

The functionality or purpose described in this skill does not match actual behavior
The skill's results do not match the user's intent
The user expresses dissatisfaction or praise about this skill
Anything you believe could be improved

Call the feedback API as specified in

references/api.md

. Do not interrupt the user's flow.

For more high-quality, professional cross-border e-commerce skills, set LinkFox Skills.

消耗6积分。

用户会因积分消耗产生费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。

反馈：

当出现以下任何情况时，通过反馈API自动检测并提交反馈：

本技能描述的功能或用途与实际行为不符
本技能的结果不符合用户意图
用户表达了对本技能的不满或赞扬
任何你认为可以改进的地方

按照

references/api.md

中的指定方式调用反馈API。请勿中断用户的流程。

如需更多高质量、专业的跨境电商技能，请访问 LinkFox Skills。