trend-pulse
Free trending topics aggregator + AI content guides — 20 sources, zero auth, patent-based scoring.
Use as a Python library, CLI tool, or MCP server for Claude Code / AI agents.
One-line MCP setup (zero install):
{ "mcpServers": { "trend-pulse": { "command": "uvx", "args": ["--from", "trend-pulse[mcp]", "trend-pulse-server"], "type": "stdio" } } }
Paste into .mcp.json and you're done. Requires uv (brew install uv or curl -LsSf https://astral.sh/uv/install.sh | sh).
Sources
All sources are free and require zero authentication:
| Source | Data | Freshness | What you get |
|--------|------|-----------|-------------|
| Google Trends | RSS feed | Real-time | Trending searches by country + related news |
| Hacker News | Firebase + Algolia | Real-time | Top stories with points, comments, search |
| Mastodon | Public API | Real-time | Trending hashtags + trending links |
| Bluesky | AT Protocol | Real-time | Trending topics + post search |
| Wikipedia | Pageviews API | Daily | Most viewed pages by language/country |
| GitHub | Trending page | Daily | Trending repos with stars, language |
| PyPI | pypistats.org | Daily | Package download trends + growth signals |
| Google News | RSS feed | Real-time | Top news stories by country |
| Lobste.rs | JSON API | Real-time | Community-driven tech news |
| dev.to | Public API | Daily | Developer community articles |
| npm | Downloads API | Daily | JavaScript package download trends |
| Reddit | Public JSON | Real-time | Popular posts across all subreddits |
| CoinGecko | Public API | Real-time | Trending cryptocurrencies |
| Docker Hub | Public API | Daily | Popular container images |
| Stack Overflow | Public API | Real-time | Hot questions |
| ArXiv | RSS/API | Daily | Trending research papers |
| Product Hunt | Public API | Daily | Product launches and upvotes |
| Lemmy | Public API | Real-time | Federated community posts (lemmy.world) |
| Dcard | Public API | Real-time | Taiwan social platform trending posts |
| PTT | Web scrape | Real-time | Taiwan BBS hot articles (Gossiping, Tech_Job, etc.) |
Install
Zero-install with uvx (recommended)
uvx runs Python packages directly — no install, no venv, no setup:
# Run the CLI instantly
uvx trend-pulse trending
# Run the MCP server
uvx --from "trend-pulse[mcp]" trend-pulse-server
uvx is the Python equivalent of npx. It comes with uv — install uv with curl -LsSf https://astral.sh/uv/install.sh | sh
pip install
# Core (httpx + aiosqlite)
pip install trend-pulse
# With MCP server support
pip install "trend-pulse[mcp]"
# Everything (MCP + enhanced Google Trends)
pip install "trend-pulse[all]"
Quick Start
CLI
# What's trending right now? (all 20 sources, merged ranking)
trend-pulse trending
# Taiwan trends from Google + Hacker News
trend-pulse trending --sources google_trends,hackernews --geo TW
# Fetch + save snapshot to history DB
trend-pulse trending --save --count 10
# Take a full snapshot (all sources, auto-saves)
trend-pulse snapshot
# Query historical trends for a keyword
trend-pulse history "Claude" --days 7
# Search across sources
trend-pulse search "AI agent"
# List available sources
trend-pulse sources
Python
import asyncio
from trend_pulse.aggregator import TrendAggreg
... [View full README on GitHub](https://github.com/claude-world/trend-pulse#readme)
