trendspyg — Claude Code skill: Google Trends data
A skill that wires your agent to the trendspyg library: trending now, interest over time, related queries and interest by region.
npx skills add aahl/skills --skill trendspyg -a claude-codeWhat trendspyg does
trendspyg is an open-source Python library for Google Trends data. The skill tells the agent how to reach it through its MCP server and which tools to call: trending searches right now, interest in a keyword over time, related queries, and a regional breakdown. The author bills it as a maintained pytrends alternative.
Inside is guidance for mcporter. The agent lists the available tools and their schemas first, then calls one with arguments. The MCP server starts with uvx --from "trendspyg[mcp]" trendspyg-mcp, so you need uvx on the machine and network access to Google Trends. For compatibility the author suggests npx -y mcporter rather than a bare mcporter.
The skill installs into Claude, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. If you want fresh search trends inside the chat instead of a separate dashboard, this is a direct route to them.
What it helps with
- check what is trending on Google right now
- compare interest in two keywords over time
- pull related queries for a keyword
- break interest down by region
- swap pytrends out of a data pipeline
Example prompts for the agent
- show me what's trending on Google right now
- compare interest in these two keywords over the past year
- what related queries does this keyword have
How to install trendspyg
1Skills CLI (Vercel)
npx skills add aahl/skills --skill trendspyg -a claude-code2Manually: put the files in place
~/.claude/skills/trendspyg/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/trendspyg/
1Skills CLI (Vercel)
npx skills add aahl/skills --skill trendspyg -a codex2Manually: put the files in place
.agents/skills/trendspyg/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add aahl/skills --skill trendspyg -a cursor2Manually: put the files in place
.cursor/skills/trendspyg/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install aahl/skills trendspyg2Manually: put the files in place
.github/skills/trendspyg/SKILL.md1Skills CLI (Vercel)
npx skills add aahl/skills --skill trendspyg -a gemini-cli2Platform CLI
gemini skills install https://github.com/aahl/skills --path skills/trendspygManually: put the files in place
.devin/skills/trendspyg/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add aahl/skills --skill trendspyg -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about trendspyg
How do I install trendspyg in Claude?
Run npx skills add aahl/skills --skill trendspyg -a claude-code. The skill lands in ~/.claude/skills/trendspyg/SKILL.md.
What does trendspyg do?
It gives the agent access to Google Trends data: trending now, interest over time, related queries and interest by region. It works through the library's MCP server.
What do I need for the skill to work?
The MCP server runs via uvx --from "trendspyg[mcp]" trendspyg-mcp, so uvx is required. The author suggests npx -y mcporter instead of mcporter for compatibility.
Source text
SKILL.md · MIT
---
name: trendspyg
description: Free Google Trends data - real-time trending topics and keyword analysis over time (interest over time, related queries, interest by region).
---
# trendspyg
Free, open-source Python library for Google Trends data: trending now plus keyword interest over time, related queries, and interest by region. A maintained pytrends alternative with CLI and API.
```bash
export UVX_TRENDSPYG='uvx --from "trendspyg[mcp]" trendspyg-mcp'
```
## List available tools
```bash
alias trendspyg-list="npx -y mcporter list --stdio '$UVX_TRENDSPYG'"
trendspyg-list --all-parameters
# Get the schema of the specified tool
trendspyg-list --json | jq '.tools[] | select(.name == "<tool_name>")'
```
## Call specified tool
```bash
alias trendspyg-call="npx -y mcporter call --stdio '$UVX_TRENDSPYG'"
trendspyg-call --tool <tool_name> --args '{"key":"val"}'
```
## About `mcporter`
To improve compatibility, use `npx -y mcporter` instead of `mcporter` when executing commands.
© aahl · MIT · aahl/skills
