native-google-analytics
от codeninja23
Web & Frontend DevelopmentКратко
Query Google Analytics 4 (GA4) data directly via the Analytics Data API.
Описание
Что делает этот навык
Queries Google Analytics 4 data directly via the Analytics Data API. Supports metrics like pageviews, sessions, users, bounce rate, and conversions across custom date ranges, dimensions, and filters. Calls the API directly without a third-party proxy.
Queries GA4 directly via the official API without requiring the Analytics UI or a third-party data connector.
Когда его использовать
- Check which blog posts got the most traffic last month
- Compare sessions by traffic source after a campaign launch
- Find landing pages with high bounce rates
- Break down visitors by country or device type
- Pull conversion data by campaign name for a report
Пример сценария
User asks: What were my top 10 pages by pageviews this January?
- 1
Reads GA4_PROPERTY_ID from environment
- 2
Calls ga4_query.py with --metrics screenPageViews --dimension pagePath --start 2026-01-01 --end 2026-01-31 --limit 10
- 3
Authenticates using GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_REFRESH_TOKEN
- 4
Sends request to analyticsdata.googleapis.com
- 5
Returns formatted table of pages and their pageview counts
A ranked table of page paths with pageview totals for January 2026
Требования
- Google Cloud project with Analytics Data API enabled
- OAuth 2.0 client credentials (Client ID and Client Secret) from Google Cloud Console
- GA4 property ID from Google Analytics Admin settings
- OAuth refresh token generated via local browser login flow
- google-auth-oauthlib Python package installed
Установка
clawhub install codeninja23/native-google-analyticsВыполните команду CLI или вставьте промпт в Claude Code, Cursor, Codex — любой кодинг-агент, которым пользуетесь.