excrtx-source-google-trends

Queries the public Google Trends Explore API for interest-over-time, regional interest, and related queries.

1|Updated May 26, 2026
One-click install
npx skills add https://github.com/elderbernardi/exocortex.saas --skill excrtx-source-google-trends-elderbernardi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: excrtx-source-google-trends
Source: https://github.com/elderbernardi/exocortex.saas/tree/main/skills/excrtx-source-google-trends
Command: npx skills add https://github.com/elderbernardi/exocortex.saas --skill excrtx-source-google-trends-elderbernardi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx.

What problem does it solve? It gives executives access to Google search behavior data—interest over time, geographic distribution, and related queries—without needing API credentials, returning everything in a normalized JSON envelope for downstream analysis. ## Core Features & Use Cases - Interest Over Time: Retrieve normalized (0-100) search interest series for one or more terms over custom periods (e.g., 5 years, 3 months, or explicit date ranges). - Regional & Related Query Analysis: Get geographic distribution of interest by region and rising/top related queries for keyword expansion and consumer intent inference. - Multi-Term Comparison: Compare brands or products side by side (e.g., "Girando Sol, Ypê, Omo") with geo filtering such as Brazil (BR). - Use Case: A brand manager wants to measure awareness of a product line in Brazil over five years and discover rising related searches to inform a campaign—run the CLI with the term, period, and geo, then read the structured JSON output. ## Quick Start Ask the agent to run the Google Trends collector for your brand term over the last five years in Brazil and return the normalized JSON results.

Frequently Asked Questions about excrtx-source-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?▼

This skill calls the public Google Trends Explore endpoint directly via httpx, which requires no credentials or API key. You run the CLI with a search term, period, and optional geo parameter, and receive normalized JSON output.

How to compare multiple search terms in Google Trends?▼

Pass a comma-separated list of terms to the CLI, for example "Girando Sol, Ypê, Omo", along with a period and geo code like BR. The output contains a time series and regional interest breakdown for each term.

Does Google Trends data show absolute search volume?▼

No, Google Trends returns relative values normalized on a 0-100 scale, not absolute search counts. Values cannot be summed across different periods, so it suits trend comparison rather than market-size estimation.

Why does a Google Trends request fail with 429 or 403 errors?▼

The public endpoint has no SLA and can rate-limit (429) or block (403) requests, especially under frequent querying or geo-restrictions. When failures persist, document the error in the output's errors array and retry later.

What are the limitations of the public Google Trends API?▼

Long periods return monthly granularity while short periods may return daily data, and historical depth via the public endpoint is roughly five years. Values are relative only, and there is no guaranteed availability or authentication support.