← Back to Skills Marketplace
terryds

Google Trends API

by Terry Djony · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
155
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install google-trends-api
Description
Fetches Google Trends data including daily trending topics, real-time trends, interest by region, related topics, related queries, and autocomplete suggestio...
README (SKILL.md)

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 \x3Ccommand> [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.

Usage Guidance
This skill appears to do what it says: a self-contained Node script that fetches and parses Google Trends endpoints and requires no API keys. Before installing or running it, review the full scripts/trends.mjs file locally (the provided manifest showed the file truncated), run it in an environment with Node.js 18+ and network access, and consider running it in a restricted environment if you are cautious about third-party code. Note the README references a GitHub project and an author; if provenance matters, verify the repository/source and maintainer before trusting the skill long-term.
Capability Analysis
Type: OpenClaw Skill Name: google-trends-api Version: 1.0.0 The skill provides a functional CLI tool for fetching Google Trends data (daily trends, autocomplete, interest by region, etc.) using only Node.js built-in modules. The script (scripts/trends.mjs) communicates exclusively with trends.google.com, handles retries/backoff, and parses Google's internal JSON format without any external dependencies, data exfiltration, or malicious execution patterns.
Capability Assessment
Purpose & Capability
Name/description match the included script and README: the code issues HTTPS requests to trends.google.com endpoints (autocomplete, explore, widget data, batchexecute) and parses the responses to produce trending/related data. No extra permissions, binaries, or unrelated services are requested.
Instruction Scope
SKILL.md instructs running the bundled Node script and parsing JSON output. The instructions do not ask the agent to read arbitrary files, environment variables, or send data to endpoints other than Google Trends. Error handling and retry behavior are described and consistent with the script.
Install Mechanism
No install spec is present (instruction-only install), and the skill ships a self-contained Node script that uses only built-in Node modules. No external downloads, package installs, or archive extraction are used.
Credentials
The skill requires no environment variables, no credentials, and no config paths. The script performs only outbound HTTPS calls to trends.google.com and does not attempt to access secrets or unrelated services.
Persistence & Privilege
always is false and the skill is user-invocable. It does not request persistent system-wide changes or modify other skills' configuration. Autonomous invocation is allowed by platform default but not coupled with extra privileges in this package.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install google-trends-api
  3. After installation, invoke the skill by name or use /google-trends-api
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial skill release with big functional update: - Adds a comprehensive Node.js script to fetch Google Trends data with multiple commands: daily trends, real-time trends, autocomplete, trend exploration, regional interest, related topics, and related queries. - Replaces previous shell scripts with a unified, script-based interface for running all trend queries. - Output is standardized as JSON for easy parsing and integration. - Includes basic error handling with retry logic for rate limiting. - All usage instructions and commands are documented in the new SKILL.md.
Metadata
Slug google-trends-api
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Google Trends API?

Fetches Google Trends data including daily trending topics, real-time trends, interest by region, related topics, related queries, and autocomplete suggestio... It is an AI Agent Skill for Claude Code / OpenClaw, with 155 downloads so far.

How do I install Google Trends API?

Run "/install google-trends-api" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Google Trends API free?

Yes, Google Trends API is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Google Trends API support?

Google Trends API is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Google Trends API?

It is built and maintained by Terry Djony (@terryds); the current version is v1.0.0.

💬 Comments