google-trends

Fetches Google Trends data including daily trends, regional interest, and related queries.

Updated Aug 10, 2026
One-click install
npx skills add https://github.com/narr07/permadi --skill google-trends-narr07
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: google-trends
Source: https://github.com/narr07/permadi/tree/main/.agents/skills/google-trends
Command: npx skills add https://github.com/narr07/permadi --skill google-trends-narr07

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Accessing Google Trends data programmatically normally requires an API key or manual dashboard exports. This Skill retrieves trending searches, keyword interest, and related topics directly from Google Trends endpoints with no API key and no external dependencies. ## Core Features & Use Cases - Trending Topics: Fetch daily and real-time trending search stories by country, including traffic volume and related news articles. - Keyword Analysis: Explore search interest by region, related topics, and related queries for any keyword with configurable time ranges and categories. - Autocomplete Suggestions: Retrieve Google Trends autocomplete suggestions for keyword research. - Use Case: A content marketer asks which topics are trending in the US today, then checks regional interest and related queries for "electric vehicles" to plan localized articles. ## Quick Start Ask the agent to show today's trending Google searches in the US, or to fetch related queries for a keyword like "machine learning".

Frequently Asked Questions about google-trends

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get Google Trends data without an API key?▼

Run the bundled Node.js script with commands like daily-trends, explore, or related-queries to query Google Trends endpoints directly. No API key or external npm packages are required, and results are returned as JSON on stdout.

How to check trending searches by country with Google Trends?▼

Use the daily-trends or realtime-trends command with the --geo option set to a country code such as US, GB, or JP. Real-time trends also accept an --hours window of 4, 24, 48, or 168.

What are the requirements to run this Google Trends script?▼

The script requires Node.js 18 or later and uses only built-in modules like https and querystring. There are no npm dependencies to install and no credentials to configure.

Why does a Google Trends request fail or return an error?▼

Google may rate-limit requests, returning HTTP 429 or redirects. The script automatically retries with exponential backoff up to three times; if it still fails, wait before retrying or reduce request frequency.

Can I get search interest by city or region for a keyword?▼

Yes, the interest-by-region command supports COUNTRY, REGION, CITY, and DMA resolutions via the --resolution option. You can also set custom start and end dates with --start-time and --end-time.