trends-checker
Python CLI for Google Trends analysis with advanced rate limiting, cookie auth, and beautiful terminal output. Built on pytrends with enterprise features.
What is trends-checker?
Python CLI for Google Trends analysis with advanced rate limiting, cookie auth, and beautiful terminal output. Built on pytrends with enterprise features.
Overview of trends-checker
What it is
trends-checker is a Python CLI tool for Google Trends analysis. It provides advanced rate limiting, cookie authentication, and DataForSEO backend support. Built on pytrends, it normalizes interest scores (0–100) per keyword per region and renders output as ASCII charts or CSV exports.
Key features
- Cookie authentication — warm up sessions with browser cookies to avoid cold-start 429 errors - Exponential backoff with configurable sleep, jitter, and retry logic - DataForSEO backend — paid alternative with zero rate limits and real search volumes - Multi-region analysis — supports 50+ countries in a single run - CSV export — build historical datasets and track changes over time - Watch mode — continuous polling with configurable intervals and percentage-change alerts - Output formats — JSON, CSV, and ASCII charts with optional no-color mode
Use cases
- Market validation and demand analysis for new products or keywords - Tracking keyword opportunities and discovering trends before they peak - Automated pipelines, cron jobs, and AI agent workflows requiring trend data - Multi-region competitive research across Web, YouTube, Images, News, and Shopping
Getting started
bash pip install trends-checker # Basic usage trends-checker --keywords 'AI agents,vibe coding' --geo US # No 429s — use DataForSEO backend trends-checker --keywords 'AI agents,vibe coding' --dataforseo-key [email protected]:password
License and pricing
The project is open source under the MIT license. No pricing information is stated beyond the open-source nature.
Based on the project's public README and repository metadata.