google-trends-api-skills

Google Trends API Skills

Agent Skills for SEO keyword research using Google Trends data via SerpApi. Built for AI agents that generate tech and developer-focused blog content.

Install

npx "@opendirectory.dev/skills" install google-trends-api-skills --target claude

Video Tutorial

Watch this quick video to see how it's done:

install-skill-on-claude-compress.mp4

Step 1: Download the skill from GitHub

1. Copy the URL of this specific skill folder from your browser's address bar.
2. Go to download-directory.github.io.
3. Paste the URL and click Enter to download.

Step 2: Install the Skill in Claude

1. Open your Claude desktop app.
2. Go to the sidebar on the left side and click on the Customize section.
3. Click on the Skills tab, then click on the + (plus) icon button to create a new skill.
4. Choose the option to Upload a skill, and drag and drop the .zip file (or you can extract it and drop the folder, both work).

Note: For some skills (like position-me), the SKILL.md file might be located inside a subfolder. Always make sure you are uploading the specific folder that contains the SKILL.md file!

Skills

1. google-trends-api/

The API layer — knows how to query Google Trends through SerpApi, handle responses, manage rate limits, and cache results.

2. seo-keyword-research/

The SEO workflow — uses Google Trends data to find breakout keywords, build content structure, and generate SEO-optimized blog outlines.

Quick Start

# 1. Get a free API key (250 searches/month)
# https://serpapi.com/

# 2. Set your key
export SERPAPI_KEY="your_key_here"

# 3. Install dependency
pip install requests

# 4. Run keyword research for a blog topic
python seo-keyword-research/scripts/blog_seo_research.py "kubernetes deployment"

# 5. Or just discover trending keywords
python google-trends-api/scripts/discover_keywords.py "AI developer tools"

Directory Structure

google-trends-api/
├── SKILL.md                        # API skill (endpoints, params, usage)
├── scripts/
│   └── discover_keywords.py        # Keyword discovery script
└── references/
    └── api-responses.md            # Full API response structures

seo-keyword-research/
├── SKILL.md                        # SEO workflow skill (research -> outline)
├── scripts/
│   └── blog_seo_research.py        # Full blog SEO research script
└── references/
    ├── keyword-placement-guide.md  # Detailed keyword placement rules
    └── tech-blog-examples.md       # Real examples for tech/dev blogs

How It Works

User: "Write a blog about kubernetes deployment"
  |
  v
[google-trends-api] RELATED_QUERIES -> finds "kubernetes vs docker" (Breakout!)
[google-trends-api] RELATED_TOPICS  -> finds "Helm", "CI/CD", "Container Orchestration"
  |
  v
[seo-keyword-research] Selects primary keyword, builds outline
  |
  v
Output: SEO-optimized blog outline targeting trending keywords

Specification

These skills follow the Agent Skills specification. Each skill has:

• SKILL.md with YAML frontmatter (name, description, compatibility, metadata)
• scripts/ for executable code
• references/ for detailed documentation (loaded on demand)

License

MIT