What problem does it solve?
Automate retrieval and analysis of Google Search Console data for SEO insights.
Core Features & Use Cases
- SEO analytics: Retrieve top queries and top pages to identify optimization opportunities.
- Indexing health: Inspect and monitor site indexing status and URL-level issues.
- Sitemap monitoring: List and analyze sitemaps to ensure proper submission and visibility.
Quick Start
Set up credentials in your environment (GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN) and run basic queries to fetch data:
python scripts/gsc_query.py sites --site "https://example.com"
python scripts/gsc_query.py top-queries --site "https://example.com" --days 28 --limit 20
python scripts/gsc_query.py top-pages --site "https://example.com" --days 28 --limit 20
python scripts/gsc_query.py sitemaps --site "https://example.com"