Google Trends#

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

Quick start#

Run the script from the skill directory:

bash

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

Available commands#

CommandDescriptiondaily-trendsGet daily trending search topicsrealtime-trendsGet real-time trending topicsautocompleteGet autocomplete suggestions for a keywordexploreExplore trend data for a keywordinterest-by-regionGet search interest breakdown by regionrelated-topicsGet topics related to a keywordrelated-queriesGet queries related to a keyword

Usage examples#

Daily trending topics in the US:

bash

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

Real-time trends (last 4 hours):

bash

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

Autocomplete suggestions:

bash

node scripts/trends.mjs autocomplete "artificial intelligence"

Explore a keyword:

bash

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

Interest by region:

bash

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

Related topics:

bash

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

Related queries:

bash

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.