Google trends skill

Skill terryds/google-trends-skill

Fetches Google Trends data including daily trending topics, real-time trends, interest by region, related topics, related queries, and autocomplete suggestions. Use when the user asks about trending searches, search popularity, keyword trends, or Google Trends data.From its SKILL.md

Install

npx -y skills add terryds/google-trends-skill

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

2.2 KB, 458 tokens by cl100k_base, as published. Nobody here has run it

Google Trends

Fetch Google Trends data using the bundled script. No API key required.

Quick start

Run the script from the skill directory:

node scripts/trends.mjs <command> [options]

Available commands

Command	Description
`daily-trends`	Get daily trending search topics
`realtime-trends`	Get real-time trending topics
`autocomplete`	Get autocomplete suggestions for a keyword
`explore`	Explore trend data for a keyword
`interest-by-region`	Get search interest breakdown by region
`related-topics`	Get topics related to a keyword
`related-queries`	Get queries related to a keyword

Usage examples

Daily trending topics in the US:

node scripts/trends.mjs daily-trends --geo US

Real-time trends (last 4 hours):

node scripts/trends.mjs realtime-trends --geo US --hours 4

Autocomplete suggestions:

node scripts/trends.mjs autocomplete "artificial intelligence"

Explore a keyword:

node scripts/trends.mjs explore "machine learning" --geo US --time "now 7-d"

Interest by region:

node scripts/trends.mjs interest-by-region "bitcoin" --geo US --resolution REGION

Related topics:

node scripts/trends.mjs related-topics "python programming" --geo US

Related queries:

node scripts/trends.mjs related-queries "python programming" --geo US

Options reference

For full option details per command, see reference.md.

Output

All commands output JSON to stdout. Parse the output to extract relevant data for the user. Present results in a readable format (tables, lists, summaries) based on context.

Error handling

If Google rate-limits the request, the script retries with exponential backoff (up to 3 retries). If it still fails, inform the user and suggest waiting before retrying.

What ships with it: 3 files

21.0 KB alongside SKILL.md, 1 of them executable

scripts/

trends.mjsruns16.2 KB

README.md2.0 KB
reference.md2.8 KB