get_ai_referrals
ChatGPTReferral traffic from AI assistants, classified only by exact GA4 session source host (ChatGPT/OpenAI, Perplexity, Copilot/Bing Chat, Gemini, Claude); raw source/medium kept, unknown sources not classified. Also returns GA4's own 'AI Assistant' channel for comparison (may overlap). Referral traffic only — not an AI visibility measure. Zero is a normal result. Stored data only.
get_alerts
ChatGPTStored alerts of a site (read-only; the tool never runs an evaluation). Alerts come from fixed, conservative rules on stored GSC, URL-inspection and GA4 data (see docs/alerts-and-weekly-reports.md): indexing problems, GSC clicks/impressions drops (7 final days vs. the 7 before), query position loss / top-10 exit / top-10 entry, CTR opportunities and URL allocation (28 days), GA4 organic-session and key-event drops, GA4 data missing. One row per episode: a condition that disappears is 'resolved'; if it comes back, a new alert starts. Texts describe measured values only; no causes, no recommendations. title/summary are English (textLanguage 'en'), rendered from the structured fields; only very old rows without these fields fall back to the stored German text (textLanguage 'de'). No alert does not mean SEO is fine — only that no rule fired.
get_analytics_overview
ChatGPTGoogle Analytics 4 website usage from STORED imports (no live Google request): sessions, engaged sessions, engagementRate (engaged ÷ sessions, 0–1), averageSessionDuration (seconds, session-weighted mean of daily values), newUsers, keyEvents, page views — total and for the GA4 default channel 'Organic Search' (sessionDefaultChannelGroup; all search engines, includes Google AI Overviews/AI Mode). activeUsersDailySum is the sum of daily active users (user-days), NOT unique users. GA4 sessions are not GSC clicks and must not be reconciled with them. Days younger than meta.recentFrom are still being processed by GA4 and excluded unless includeRecent=true.
get_content_group_performance
ChatGPTPerformance of the site's content groups (pages matched by URL rules). Without 'group': all groups. With 'group' (name or id): that group plus its top pages. Metrics are page-level.
get_ctr_opportunities
ChatGPTQueries with a good position and relevant impressions but few/no clicks (types: zero_click_top10, low_ctr_top10, high_impressions_low_ctr). Metrics are query-level; expectedCtr comes only from the site's own CTR curve (null if too little data); missedClicks = impressions × expectedCtr − clicks. Sorted by missedClicks. urlDimension.pages are the top ranking URLs from query×page rows; their impressionShare is relative to the URL dimension, not to the query impressions.
get_daily_series
ChatGPTOne data point per day (date, clicks, impressions, ctr 0–1, position, isFinal, hasData) for the whole site, one query, one page, one topic cluster or one content group. Days without data are explicit (hasData=false). Optional aligned comparison series.
get_event_performance
ChatGPTGA4 event counts by event name for ALL events GA4 reported (key events and ordinary events such as clicks), from STORED imports (no live Google request): eventCount in the range, previous-period eventCount and delta, daily series, observed key-event activity. eventCount = how often the event fired (not users, not sessions). Never add counts of different events: an interaction event (e.g. a click on a contact link) is not a confirmed conversion — only key events are conversions, and keyEvents here equals get_key_events for the same range (one number per event, never counted twice). keyEventActivityObserved = keyEvents > 0 in the range: measured activity, NOT whether the event is configured as a key event in GA4 (a configured key event that did not fire, or was marked later — marking is not retroactive — is false). Event data exists only for days in eventData coverage: a series point with eventCount null means NO event data for that day (not zero); eventCount null on an item means no day of the range is covered. On a covered day an event without a GA4 row is 0. delta is null unless both ranges are completely covered. Days on/after ga4.recentFrom are still being processed by GA4 (recent: true) and excluded unless includeRecent=true. Event names are raw GA4 values, case-sensitive; requested names never reported on a covered day are listed in notFound (empty when no day has event data — then nothing is confirmed). Only event names and counts are stored — no event parameters or personal data.
get_indexing_issues
ChatGPTLists URLs by stored inspection classification, most severe first (then by GSC clicks/impressions of the last 28 days). Filters: problems (default), all (all inspected), indexed, not_indexed, blocked, canonical, fetch_error, stale, not_inspected. Severity is high only for important pages (homepage or GSC traffic); the same state on a page without traffic may be intentional. 'canonicalized' (redirects, declared or Google-chosen canonical to another URL) and 'unknown' (no usable verdict, or Google has no crawl data) are never high by themselves. Read-only, no Google request.
get_indexing_overview
ChatGPTTechnical index state of a site from STORED Search Console URL Inspection results and the sitemap import (never a live Google request). knownUrls = URLs from GSC performance data + inspected URLs + homepage; only inspected URLs have an index status. indexed/notIndexed/canonicalized describe the state at each URL's last inspection, not now. notIndexed counts only problems (not_indexed, blocked, fetch_error, canonical_mismatch); canonicalized (redirect or canonical to another URL) is expected and counted separately; criticalUrls = URLs with a high-severity issue. Sitemap counts are Google's reported numbers; a URL in a sitemap is not necessarily crawled or indexed.
get_key_events
ChatGPTGA4 key events (formerly 'conversions') by event name: keyEvents and eventCount in the range, previous-period keyEvents. Only events marked as key events in GA4. Not attributed to queries or topic clusters. Stored data only.
get_organic_landing_pages
ChatGPTGA4 landing pages of Organic Search sessions (sessionDefaultChannelGroup = 'Organic Search'), by normalized path (no host, no query; trailing slash removed): sessions, engaged sessions, engagementRate, keyEvents, activeUsersDailySum (user-days). '(not set)' = sessions without page_view, '(other)' = rows GA4 grouped for cardinality. Stored data only.
get_query_url_mapping
ChatGPTFor one exact query: queryMetrics (query dimension: the query's own Search Console totals), urlDimension (sum over the query×page rows) and all ranking URLs with clicks/impressions/ctr/position and impressionShare, the dominant URL, the URL-allocation classification (only when ≥ 2 URLs rank), a CTR-opportunity flag, and the configured preferred target/expected role if any. impressionShare is relative to urlDimension.impressions; the two dimensions do not reconcile (urlDimension can be larger than queryMetrics), so never divide URL impressions by queryMetrics.impressions. Answers 'which URL ranks for this keyword and is it the intended one?'.
get_ranking_changes
ChatGPTQueries whose impression-weighted position changed vs. the comparison period. positionDelta = previous − current (positive = improved). Only queries with enough impressions in both periods are compared (thresholds returned). 'new'/'lost' = no impressions in one period.
get_referral_sources
ChatGPTSources of GA4's default channel 'Referral' (sessionDefaultChannelGroup = 'Referral') by session source and medium (raw GA4 values, never reclassified; sourceMedium = 'source / medium' as in GA4's sessionSourceMedium): sessions, engagedSessions, engagementRate (0–1), keyEvents, sessionShare (0–1, share of all Referral sessions — not of all site sessions) and comparison. One item per source/medium pair, sorted by sessions (desc); page with limit/offset (total = number of pairs). referralChannel equals the 'Referral' row of get_traffic_channels (same import); it may differ slightly from site totals or the GA4 interface (separate report, thresholding, '(other)' rows). origin: domain | not_set ('(not set)', GA4 knew no source) | other ('(other)', rows GA4 grouped) | unknown. aiProvider is set for known AI assistant hosts (also counted in get_ai_referrals); GA4's own 'AI Assistant' channel is not included. Stored data only.
get_search_appearance_summary
ChatGPTPerformance per Search Console search appearance (how Google displayed the result, e.g. rich result types) for a date range. rawAppearance is Google's API value, unchanged; displayLabel is Google's documented UI name or the raw value if undocumented (labelKnown=false) — unknown values are normal, not errors. ctr is a 0–1 ratio (sum clicks / sum impressions); averagePosition is impression-weighted. Shares are relative to the sum over appearance rows. Google aggregates this dimension by page and a result can have several appearances, so these numbers must NOT be reconciled with site totals. status: new (impressions now, none before), lost (none now, some before), existing; null without comparison. An empty list means Google reported no appearance rows for the site.
get_search_appearance_trend
ChatGPTDaily series per search appearance (all appearances with data in the range, or one via 'appearance' = raw API value). One point per day: clicks, impressions, ctr (0–1), impression-weighted averagePosition, isFinal, hasData (false = Google reported no row for this appearance that day, i.e. 0). An appearance without data is not an error: found=false and an all-zero series. Same aggregation caveats as get_search_appearance_summary (aggregated by page, not reconcilable with site totals).
get_seo_landing_pages
ChatGPTPage-level side-by-side of GSC (Google Search: clicks, impressions, ctr 0–1, position) and GA4 Organic Search landing pages (all search engines: sessions, engagementRate, keyEvents), joined by normalized path on the site's domain. status: matched | gsc_only | ga4_only | unmatched (foreign host, '(not set)', '(other)'). GSC clicks and GA4 sessions measure different things and are never equal. Flags (transparent thresholds in the response): visibility_without_traffic, traffic_without_key_events, high_value_landing_page, gsc_only, ga4_only. No query-level or conversion estimation.
get_site_summary
ChatGPTSite-wide Search Console totals (clicks, impressions, ctr 0–1, impression-weighted average position) for a date range, with comparison deltas and business trends (for position lower is better), device breakdown and brand/non-brand split. Totals include anonymized queries.
get_top_pages
ChatGPTPages (URLs) of a site with clicks, impressions, ctr (0–1), impression-weighted position and comparison deltas. Page-level impressions are not a reconciliation total against site totals.
get_top_queries
ChatGPTSearch queries of a site with clicks, impressions, ctr (0–1) and impression-weighted position, optionally with comparison deltas. Anonymized queries are not listed by Google.
get_topic_performance
ChatGPTPerformance of the site's topic clusters (queries matched by explicit keywords, exact/contains). Without 'cluster': all clusters. With 'cluster' (name or id): that cluster plus its top queries. Anonymized queries cannot be attributed.
get_traffic_channels
ChatGPTGA4 sessions by session default channel group (e.g. Organic Search, Direct, Referral, Organic Social, Paid Search, AI Assistant, Unassigned) with engagement and keyEvents, share of sessions and comparison. Channel names are GA4's own values. Stored data only.
get_url_allocation
ChatGPTQueries where several own URLs get impressions, classified by the engine: dominant_url (not a problem), multi_url_visibility, split_visibility, url_switching, possible_allocation_issue (preferred target not dominant). 'ignored' = manually marked as intended. Several URLs alone are not a problem. All numbers are from the URL dimension (query×page rows); impressionShare is relative to urlDimension.impressions and must not be compared with query-level totals from other tools.
get_weekly_report
ChatGPTCurrent weekly report data of a site, computed on request from stored data (read-only; nothing is sent or stored): GSC performance of the last 7 final days vs. the 7 days before, top queries, pages with most click change, ranking changes (only queries with enough impressions in both weeks), alerts new/resolved in the last 7 days and active critical/warning alerts, GA4 block (settled days, sessions ≠ clicks), GSC×GA4 page highlights (small samples — describe, do not interpret as trend) and stored indexing counts. Alert title/summary and meta.subject are English (see get_alerts for textLanguage).
inspect_urls
ChatGPTReturns the STORED Search Console URL Inspection result for up to 20 URLs: classification, issues, Google verdict/coverage/indexing/robots/fetch states, canonicals, last crawl, sitemaps Google knows, and freshness. It never calls Google: a URL without stored inspection is returned as status 'not_inspected'. Results describe the state at inspectedAt (see ageDays/stale), not the current live state.
list_sites
ChatGPTLists the websites this token can read (only its own organization), with data freshness. Use the returned 'slug' as 'site' in other tools.