Introduction#
This guide teaches SEO professionals how to build a trustworthy AI-powered analyst that reviews data from multiple SEO platforms, identifies meaningful changes, investigates likely causes, and recommends the highest-priority next actions.
The emphasis is decision support, not autonomous optimisation. The workflow you build here reads data and writes a brief; a person decides what to change.
Every factual product capability in this guide is backed by the vendor's own documentation. Any suggested workflow, threshold, or implementation pattern is presented as a recommendation, not a platform requirement — where we recommend something, we say so explicitly.
What You'll Build#
A Daily AI SEO Analyst is a repeatable workflow that combines structured SEO data with a large language model to answer four questions every day.
Unlike a dashboard, which primarily reports metrics, an AI analyst investigates relationships across multiple data sources before presenting prioritised findings. The output is a short daily brief: what moved, whether the movement is material, the most likely explanation, and the checks a human should run next.
This guide deliberately does not describe an autonomous agent. The analyst does not publish content, edit metadata, deploy code, change redirects, submit URLs, modify analytics configuration, or make any production decision without review.
Explicitly out of scope
- Publishing or editing content
- Editing metadata, redirects or robots directives
- Deploying code or submitting URLs for indexing
- Changing analytics configuration
- Any production change without human review
The four daily questions
- What changed?
- Does it matter?
- What most likely caused it?
- What should we investigate or do next?
Before you build: readiness checklist
0/6 done
How an AI SEO Analyst Thinks#
Before you connect anything, decide how the analyst reasons. A model with excellent data and no reasoning discipline produces confident nonsense; a model with modest data and a strict evidence loop produces briefs a senior SEO can act on.
Everything in this chapter is Connector Scout editorial guidance. It is not a vendor requirement, and no platform documents an "investigation loop", an "evidence layer" or a confidence band. What the vendors document is what their APIs return; how you reason across those returns is a house style, and this is ours. Sections that cite official documentation are labelled as official documentation throughout the guide, so the difference is always visible on the page.
The mindset has four moving parts: a repeatable investigation loop, a layered view of what each evidence source can and cannot prove, an explicit separation of facts from hypotheses with a confidence score attached, and a prioritisation framework that decides what the reviewer should look at first.
The investigation loop
Every flagged change runs through the same six steps, in the same order. The order matters more than any single step: skipping validation produces false alarms, and skipping corroboration produces confident hypotheses dressed up as findings.
Observe the change, validate that it is real, localize where it is concentrated, explain it with competing hypotheses, corroborate against a second source, then prioritize what the reviewer sees first.
Step 1Observe
What actually changed, in numbers?
Read the metric, the window and the magnitude straight from the source API. No interpretation, no adjectives — a click count against a stated baseline.
OutputA labelled verified fact with source, window and magnitude.
Step 2Validate
Is the change real, or an artefact of measurement?
Rule out reporting latency, partial days, tagging changes, sampling, thresholding and low-volume noise before treating a delta as a finding. Most false alarms die here.
OutputA pass or fail on data quality, with the reason recorded.
Step 3Localize
Where is the change concentrated?
Slice by page, query, country, device and date until the change stops being site-wide. A drop isolated to one template is a different problem from a drop spread evenly across the site.
OutputThe narrowest segment that still contains the change.
Step 4Explain
What could plausibly cause this segment to move this way?
Generate competing explanations rather than one. Every explanation is written as a hypothesis, and each one names the evidence that would confirm or kill it.
OutputTwo or more labelled hypotheses, each with a test.
Step 5Corroborate
Does a second, independent source agree?
Test the surviving hypotheses against a different evidence layer — search data against analytics, analytics against behaviour, on-site against off-site. Agreement raises confidence; disagreement is itself a finding.
OutputA confidence score with the corroborating sources named.
Step 6Prioritize
What should the reviewer look at first?
Rank surviving findings on impact, confidence, effort, reversibility and urgency, then hand the top few to a human with the checks to run. The loop stops here — the analyst never acts.
OutputA ranked shortlist of recommended checks for human review.
It is a loop, not a checklist: corroboration that fails sends the analyst back to Explain, and a failed validation sends it back to Observe with a wider window.
Five layers of SEO evidence
Each layer answers a different question, and none of them answers all four daily questions alone. Naming the layer a number came from is what stops the analyst from arguing that a session drop proves a ranking loss.
What each evidence layer can and cannot prove
Layer 1 · Before the click
Search visibility
Google's own record of impressions, clicks, CTR and position. Proves whether search demand and visibility changed. Cannot tell you what happened after the click.
Related tools
- Google Search Console
Layer 2 · After the click
Session and outcome data
Sessions, engagement and conversions by landing page and channel. Proves whether arriving visitors behaved differently. Cannot prove a ranking change, and will not match search-side click counts.
Related tools
- Google Analytics 4
Layer 3 · On the page
Behavioural evidence
Session recordings, heatmaps and interaction signals for the specific pages a brief flags. Explains why a page underperforms once you already know it does. Not a sampling-free source of truth.
Related tools
- Microsoft Clarity
Layer 4 · Off-site and competitive
Third-party market estimates
Backlink change, competitor movement and keyword landscape. Useful for corroboration and context — and always an estimate, so it must never be presented in a brief as a verified fact.
Related tools
- Ahrefs
- Semrush
Layer 5 · Delivery
Field and lab performance
Real-user field data and synthetic lab data for page experience. Field evidence and lab evidence answer different questions and must stay separate in the brief.
Related tools
- Chrome UX Report
- PageSpeed Insights
Evidence chains
An evidence chain is how a finding is presented: each link is labelled as a verified fact, a calculated metric, a hypothesis or a recommended check, so a reviewer can see exactly where observation ends and inference begins. Two worked examples follow.
Clicks to a pricing page fall while impressions and position hold steady, CTR falls, and the decline is concentrated on desktop, supporting a snippet or SERP-feature hypothesis rather than a ranking hypothesis.
- 01
Organic clicks to /pricing fell 18% week over week
Search ConsoleVerified fact. Read from Search Analytics for the last 7 days against the previous 7-day baseline.
- 02
Impressions were flat at +1%
Search ConsoleVerified fact. Demand and visibility did not fall, so this is not a lost-impressions story.
- 03
Average position moved from 4.1 to 4.3
DerivedCalculated metric. Too small to account for an 18% click loss on its own; the ranking hypothesis weakens.
- 04
CTR fell from 6.4% to 5.2%, concentrated on desktop
DerivedCalculated metric. Mobile CTR was broadly unchanged, which localises the change to one device class.
- 05
A desktop SERP-feature or snippet change is suppressing clicks
UnprovenHypothesis. Competing hypothesis considered and retained as weaker: a title rewrite shipped in the same window.
Ask a human to inspect the live desktop SERP and the page's title and description before anyone edits content.
Analytics sessions drop sharply while search clicks are unchanged, and the drop starts on a deployment date, supporting a tracking hypothesis rather than an SEO hypothesis.
- 01
Organic sessions fell 41% day over day
GA4Verified fact. Read from the Data API for organic search sessions by landing page.
- 02
Search clicks for the same pages were unchanged
Search ConsoleVerified fact. Two independent sources disagree. Because they measure different stages, the disagreement is the signal.
- 03
The drop begins exactly on a release date and affects only two templates
DerivedCalculated metric. A step change on a single date rarely reflects search behaviour.
- 04
Analytics tagging on those templates changed during the release
UnprovenHypothesis. Alternative hypotheses — consent-banner changes and bot filtering — are retained until the tag check returns.
Ask a human to verify tag firing on the affected templates for the deployment date before any SEO work is scheduled.
Confidence scoring
Every hypothesis carries a score from 0 to 100 and the band that score falls in. The bands are our editorial convention — they exist so “probably” means the same thing in every brief.
| Score | Band | What it means |
|---|---|---|
| 90–100 | Very high | Two or more independent primary sources agree, and no plausible alternative explanation survives. |
| 75–89 | High | One primary source plus corroborating evidence; alternatives were checked and ruled out. |
| 50–74 | Moderate | A single primary source, or corroboration that is directional rather than conclusive. |
| 25–49 | Low | Pattern-consistent but unconfirmed; competing explanations remain open. |
| 0–24 | Speculative | A hypothesis worth testing only. Never act on it without validation. |
Connector Scout confidence bands. Editorial convention, not a vendor specification.
90–100
- Band
- Very high
- What it means
- Two or more independent primary sources agree, and no plausible alternative explanation survives.
75–89
- Band
- High
- What it means
- One primary source plus corroborating evidence; alternatives were checked and ruled out.
50–74
- Band
- Moderate
- What it means
- A single primary source, or corroboration that is directional rather than conclusive.
25–49
- Band
- Low
- What it means
- Pattern-consistent but unconfirmed; competing explanations remain open.
0–24
- Band
- Speculative
- What it means
- A hypothesis worth testing only. Never act on it without validation.
| Label | What it means | What it must carry | Can it justify action? |
|---|---|---|---|
| Verified fact | Read directly from a source API. | Source, metric, window. | Yes, as evidence. |
| Calculated metric | Derived from stored source data. | The derivation and its inputs. | Yes, if the derivation is stated. |
| Hypothesis | The model's candidate explanation. | A confidence score and a test. | No — it justifies a check. |
| Recommended check | The action a human should take next. | The source that would settle it. | It is the action. |
How the brief labels every statement. Compact by design — a reviewer should read it in seconds.
Verified fact
- What it means
- Read directly from a source API.
- What it must carry
- Source, metric, window.
- Can it justify action?
- Yes, as evidence.
Calculated metric
- What it means
- Derived from stored source data.
- What it must carry
- The derivation and its inputs.
- Can it justify action?
- Yes, if the derivation is stated.
Hypothesis
- What it means
- The model's candidate explanation.
- What it must carry
- A confidence score and a test.
- Can it justify action?
- No — it justifies a check.
Recommended check
- What it means
- The action a human should take next.
- What it must carry
- The source that would settle it.
- Can it justify action?
- It is the action.
Prioritization framework
Five inputs decide what reaches the top of the brief. They are deliberately not collapsed into one score: reviewers need to see why something was ranked first, and a hidden weighting is impossible to argue with.
What the analyst weighs before it hands anything to a human
Impact
How much value is at stake if this is real?
Size it in the currency the business uses — revenue, leads, or clicks on commercially important templates — not in percentage change on a low-volume URL.
High / medium / low
Confidence
How well is the diagnosis evidenced?
Use the band the finding earned. A speculative finding with large impact is a research task; a very-high-confidence finding with modest impact may still be the better first move.
0–100 band
Effort
What will it cost to validate and to fix?
Score validation effort separately from remediation effort. Cheap validation on an uncertain finding often beats expensive work on a certain one.
Hours / days / weeks
Reversibility
How easily can the change be undone?
Title and metadata edits are near-reversible; redirect maps, template rewrites and URL migrations are not. Irreversible work needs a higher confidence bar.
Reversible / partial / one-way
Urgency
Does waiting make the outcome worse?
Compounding problems — deindexation, broken canonicals, a spreading regression — outrank stable ones of equal size. A flat decline can wait a day for better evidence.
Now / this week / backlog
Architecture#
The pipeline is the same whichever build you choose: collect read-only data on a schedule, normalise it, detect material change, diagnose it with evidence attached, brief a human, and stop there.
Three principles keep the output trustworthy. Evidence before explanation: every recommendation should be traceable to one or more verified data sources. Facts before hypotheses: the brief must separate verified facts, calculated metrics, hypotheses and recommended validation steps, and never blur them. Multiple sources beat one: a finding supported by two independent sources deserves higher confidence than a finding from a single API.
Useful pairings in practice are Search Console with GA4, Search Console with Ahrefs, GA4 with Clarity, and Search Console with Clarity and Semrush. Corroboration is what makes the difference between an analyst and a chart.
Every claim in a brief carries a label
- Verified fact — read directly from a source API
- Calculated metric — derived from stored source data
- Hypothesis — the model's explanation, marked as unproven
- Recommended validation — the check a human should run to confirm it
Collect read-only data from each source, normalize it into one comparable shape, detect material change against stored baselines, diagnose flagged deltas with evidence attached, brief a human, and stop for review.
01Collect
Read-only pulls from each official API or MCP server on a fixed schedule.
- Search Console
- GA4
- CrUX
02Normalize
Map every source into one dated, comparable metric shape.
- Shared schema
03Detect
Compare against stored baselines and apply validation rules.
- Thresholds
04Diagnose
The model investigates flagged deltas across sources before explaining them.
- MCP
- System prompt
05Brief
A short daily brief separates facts, metrics, hypotheses and checks.
- Daily brief
06Human review
A person approves anything that would change the site.
- Read-only by default
Choose Your Build#
There are two recommended architectures. Option A is an interactive AI workspace; Option B is a scheduled AI analyst. Both are legitimate — the choice depends on how repeatable and auditable the output has to be.
Option A — Interactive AI workspace suits independent consultants, small teams, experimentation and ad hoc analysis. You work in an AI chat interface, use official MCP servers where the vendor provides one, and add custom read-only tools for platforms that do not. Investigations are human-driven. It is fast to set up, flexible and needs almost no infrastructure, but it is less repeatable, depends on manual prompting, and handles historical processing poorly.
Option B — Scheduled AI analyst suits agencies, enterprise SEO, large content libraries and recurring executive reporting. Data sources feed a scheduled extraction step, then a normalised data store, then validation rules, then the LLM investigation, then the daily brief, then human review. It is repeatable, easier to audit, better at historical analysis, cheaper in API cost over time, and easier to govern.
| Criterion | Option A — Interactive workspace | Option B — Scheduled analyst |
|---|---|---|
| Best for | Consultants, small teams, experimentation, ad hoc analysis | Agencies, enterprise SEO, large content libraries, recurring reporting |
| How it runs | AI chat interface, human-driven investigations | Scheduled extraction, normalised store, validation rules, then the model |
| Setup effort | Fast; low infrastructure | Higher; a store and a scheduler |
| Repeatability | Lower — depends on manual prompting | Higher — same inputs every run |
| Auditability | Harder to reconstruct a past answer | Easier; runs and outputs are logged |
| Historical analysis | Limited historical processing | Better; baselines are stored |
| API cost over time | Grows with ad hoc querying | Lower; scheduled pulls are deduplicated |
| Write access | None — read-only tools only | None — read-only end to end |
The two recommended architectures compared.
Best for
- Option A — Interactive workspace
- Consultants, small teams, experimentation, ad hoc analysis
- Option B — Scheduled analyst
- Agencies, enterprise SEO, large content libraries, recurring reporting
How it runs
- Option A — Interactive workspace
- AI chat interface, human-driven investigations
- Option B — Scheduled analyst
- Scheduled extraction, normalised store, validation rules, then the model
Setup effort
- Option A — Interactive workspace
- Fast; low infrastructure
- Option B — Scheduled analyst
- Higher; a store and a scheduler
Repeatability
- Option A — Interactive workspace
- Lower — depends on manual prompting
- Option B — Scheduled analyst
- Higher — same inputs every run
Auditability
- Option A — Interactive workspace
- Harder to reconstruct a past answer
- Option B — Scheduled analyst
- Easier; runs and outputs are logged
Historical analysis
- Option A — Interactive workspace
- Limited historical processing
- Option B — Scheduled analyst
- Better; baselines are stored
API cost over time
- Option A — Interactive workspace
- Grows with ad hoc querying
- Option B — Scheduled analyst
- Lower; scheduled pulls are deduplicated
Write access
- Option A — Interactive workspace
- None — read-only tools only
- Option B — Scheduled analyst
- None — read-only end to end
Option B data flow
- SEO data sources
- Scheduled extraction
- Normalized data store
- Validation rules
- LLM investigation
- Daily brief
- Human review
Connection Options#
This guide classifies every integration with one of four labels, so you always know whether a capability is vendor-supported or something you are building yourself.
The labels matter for governance as much as for setup. An official MCP server is maintained by the vendor and documented publicly. A custom pipeline over an official API is your code, your credentials and your responsibility — which is fine, provided the distinction is recorded rather than assumed.
A minimum viable analyst does not need all six sources. Search Console, GA4 and Core Web Vitals data are enough to answer the four daily questions for most sites; the rest add off-site and behavioural context.
| Label | Meaning |
|---|---|
| Official MCP | Vendor-supported Model Context Protocol integration. |
| Official API | Vendor-supported API requiring your own application or pipeline. |
| Custom MCP / pipeline | Your implementation exposing official APIs to an AI client. |
| Optional | Helpful, but not required for a minimum viable analyst. |
How this guide labels every integration.
Official MCP
- Meaning
- Vendor-supported Model Context Protocol integration.
Official API
- Meaning
- Vendor-supported API requiring your own application or pipeline.
Custom MCP / pipeline
- Meaning
- Your implementation exposing official APIs to an AI client.
Optional
- Meaning
- Helpful, but not required for a minimum viable analyst.
| Platform | Classification | In a minimum build? |
|---|---|---|
| Google Search Console | Official API + custom MCP/pipeline | Yes |
| Google Analytics 4 | Official API + custom MCP/pipeline | Yes |
| Ahrefs | Official MCP | Optional |
| Semrush | Official MCP | Optional |
| Microsoft Clarity | Official MCP + official API | Optional |
| Core Web Vitals | Official API | Yes |
Data sources covered by this guide and how each one is reached.
Google Search Console
- Classification
- Official API + custom MCP/pipeline
- In a minimum build?
- Yes
Google Analytics 4
- Classification
- Official API + custom MCP/pipeline
- In a minimum build?
- Yes
Ahrefs
- Classification
- Official MCP
- In a minimum build?
- Optional
Semrush
- Classification
- Official MCP
- In a minimum build?
- Optional
Microsoft Clarity
- Classification
- Official MCP + official API
- In a minimum build?
- Optional
Core Web Vitals
- Classification
- Official API
- In a minimum build?
- Yes
Google Search Console
Query, page, country and device performance from the Search Analytics API. The primary answer to "what changed in search".
Setup: moderate effort
Search Console API — Search Analytics: query (opens in a new tab)Google Analytics 4
Behavioural context for search deltas — sessions, engagement and conversions by landing page — via the Data API.
Setup: moderate effort
Google Analytics Data API (GA4) (opens in a new tab)Ahrefs
Off-site and backlink signals through the vendor's own MCP server, subject to plan-level API access.
Setup: moderate effort
Ahrefs MCP — introduction (opens in a new tab)Semrush
Competitive and keyword datasets through the vendor's MCP server, subject to plan-level API access.
Setup: moderate effort
Semrush MCP documentation (opens in a new tab)Microsoft Clarity
On-page behaviour signals for pages the brief flags, through the Clarity MCP server or the Data Export API.
Setup: low effort
Microsoft Clarity MCP server (opens in a new tab)Core Web Vitals
Field data from the Chrome UX Report API and lab data from PageSpeed Insights, kept separate in the brief.
Setup: low effort
Chrome UX Report API (opens in a new tab)Google Search Console#
Search Console is the foundation of the analyst because it is Google's own reporting on how your site performs in Google Search. It is the primary "before the click" data source in this guide.
If the analyst only reads analytics data, it cannot tell a demand problem from a ranking problem, a CTR problem or a tracking problem. Search Console fills that gap by showing what happened in Google Search before the visitor ever reached the site, which makes it the primary evidence source whenever organic visibility changes.
Google documents three API surfaces for this work: Search Analytics for performance reporting, the URL Inspection API for the indexing and rich-results state of a single URL, and the Sitemaps API for sitemap submission and status. Treat those references as the authoritative description of what the platform provides.
Questions the analyst should be able to answer from Search Console alone
- Which pages gained or lost clicks?
- Which queries changed?
- Did impressions change?
- Did average position change?
- Did CTR change?
- Which devices were affected?
- Which countries were affected?
- Is the change isolated to a few URLs or site-wide?
Recommended metrics and dimensions
Capture clicks, impressions, CTR and average position for every run, and request the page, query, country, device and date dimensions so a change can be sliced without a second round trip. The metric set is fixed by the Search Analytics API; which dimensions you store daily is our recommendation.
Daily workflow
Each daily run compares the current reporting window with an appropriate historical baseline. The investigations below are editorial recommendations, not Google requirements, and each one is a ranked list rather than a single number.
Suggested daily investigations
- Largest click declines
- Largest click gains
- Largest impression declines
- Largest CTR declines
- Largest ranking changes
- Emerging queries
- Declining queries
Investigation pattern
Never start a traffic investigation in GA4. Establish first whether search visibility changed; if impressions and clicks are stable, the root cause is probably elsewhere.
When a page loses traffic
- Confirm the click decline against the stored baseline.
- Check impressions to separate lost demand from lost visibility.
- Check average position for a ranking shift.
- Check CTR for a snippet or SERP-feature effect.
- Compare the affected queries, not just the page total.
- Escalate to GA4, Ahrefs, Semrush or Clarity for corroboration before recommending anything.
Common mistakes
Each of these skips a step. Gather evidence from more than one source before the analyst recommends an action.
Assumptions the brief must not make
- Fewer sessions automatically means rankings dropped.
- Average position alone explains a traffic change.
- A CTR decline always calls for rewriting titles.
Data quality notes
Account for reporting latency, for the aggregation and anonymisation characteristics Google documents for the Performance report, and for the fact that Search Console and analytics tools measure different stages of the journey. Do not expect Search Console clicks to match GA4 sessions, and do not let the analyst treat the difference as a finding.
What a good finding looks like
Finding: organic clicks to /pricing declined 18% week over week. Evidence: impressions remained stable, average position changed minimally, CTR declined, and desktop saw the largest drop. Recommendation: review search snippets, title tags and recent SERP changes before considering content revisions.
The shape matters as much as the content — a labelled fact, the corroborating evidence behind it, and a recommendation that names a check rather than a change.
| Metric | Why it matters |
|---|---|
| Clicks | Organic traffic from Google Search. |
| Impressions | Search demand and visibility. |
| CTR | Snippet performance. |
| Average position | Ranking trend indicator. |
Metrics to capture on every Search Console run.
Clicks
- Why it matters
- Organic traffic from Google Search.
Impressions
- Why it matters
- Search demand and visibility.
CTR
- Why it matters
- Snippet performance.
Average position
- Why it matters
- Ranking trend indicator.
Recommended dimensions
- Page
- Query
- Country
- Device
- Date
Google Analytics#
This section is outlined but not yet researched. It is published as an outline so the structure is reviewable; nothing here should be treated as guidance until it carries citations.
In research
This section will cover
- Data API property access and credentials
- Report definitions for landing-page and channel analysis
- Sampling, thresholding and cardinality limits as documented
- How GA4 corroborates or contradicts a Search Console delta
Ahrefs#
This section is outlined but not yet researched. It is published as an outline so the structure is reviewable; nothing here should be treated as guidance until it carries citations.
In research
This section will cover
- Official MCP server setup and plan-level access
- Which off-site datasets are exposed to an AI client
- How backlink change is used as corroborating evidence
Semrush#
This section is outlined but not yet researched. It is published as an outline so the structure is reviewable; nothing here should be treated as guidance until it carries citations.
In research
This section will cover
- Official MCP setup and API-unit consumption
- Competitive and keyword datasets worth pulling daily versus weekly
- Where third-party estimates must not be presented as facts
Microsoft Clarity#
This section is outlined but not yet researched. It is published as an outline so the structure is reviewable; nothing here should be treated as guidance until it carries citations.
In research
This section will cover
- Official MCP server and Data Export API setup
- Behavioural signals for pages flagged by the brief
- Documented query limits and retention
Halfway
PDF download
Get the PDF version of this guide
Get the full Daily AI SEO Analyst guide as a PDF: the architecture, the connector classifications and the official sources, for SEO leads building a read-only AI workflow.
Core Web Vitals#
This section is outlined but not yet researched. It is published as an outline so the structure is reviewable; nothing here should be treated as guidance until it carries citations.
In research
This section will cover
- Chrome UX Report API for field data
- PageSpeed Insights API for lab data
- Keeping field and lab evidence separate in a brief
Normalize Your Data#
This section is outlined but not yet researched. It is published as an outline so the structure is reviewable; nothing here should be treated as guidance until it carries citations.
In research
This section will cover
- One dated, comparable record shape across every source
- Property, source and metric naming rules
- Baseline windows and comparison periods
{ "date": "2026-07-30", "property": "sc-domain:example.com", "source": "search-console", "metrics": { "clicks": 0, "impressions": 0, "ctr": 0, "position": 0 }, "baseline": { "window": "previous-28d", "clicks": 0 }, "flags": []}Schemas#
This section is outlined but not yet researched. It is published as an outline so the structure is reviewable; nothing here should be treated as guidance until it carries citations.
In research
This section will cover
- The normalised metric record
- The flag record produced by validation rules
- The brief record stored for audit
{ "date": "2026-07-30", "property": "sc-domain:example.com", "source": "search-console", "metrics": { "clicks": 0, "impressions": 0, "ctr": 0,Alert Thresholds#
This section is outlined but not yet researched. It is published as an outline so the structure is reviewable; nothing here should be treated as guidance until it carries citations.
In research
This section will cover
- Recommended starting thresholds and why they are recommendations
- Minimum volume gates that suppress noise
- Quiet periods and seasonality handling
# Draft shape only — thresholds are researched in a later part.thresholds: clicks: drop_pct: 0 min_volume: 0 position: worsen_by: 0schedule: cron: "0 6 * * *" timezone: "UTC"Diagnostic Workflow#
This section is outlined but not yet researched. It is published as an outline so the structure is reviewable; nothing here should be treated as guidance until it carries citations.
In research
This section will cover
- The order in which sources are consulted
- Ruling out measurement causes before ranking causes
- How confidence is assigned and expressed
Detect the change, diagnose it across sources, brief the reviewer, and stop for human review.
01Detect
Compare against stored baselines and apply validation rules.
- Thresholds
02Diagnose
The model investigates flagged deltas across sources before explaining them.
- MCP
- System prompt
03Brief
A short daily brief separates facts, metrics, hypotheses and checks.
- Daily brief
04Human review
A person approves anything that would change the site.
- Read-only by default
System Prompt#
This section is outlined but not yet researched. It is published as an outline so the structure is reviewable; nothing here should be treated as guidance until it carries citations.
In research
This section will cover
- Read-only operating rules
- Citation requirements for every number
- The output contract the brief must satisfy
# RoleDraft outline only. The researched instruction set lands in a later part.# Operating rules1. Read-only: never call a tool that changes the site or its analytics.2. Cite the source and window for every number.3. Label each statement as fact, calculated metric, hypothesis or recommended check.4. Escalate to a human before any change.Daily Prompt#
This section is outlined but not yet researched. It is published as an outline so the structure is reviewable; nothing here should be treated as guidance until it carries citations.
In research
This section will cover
- Inputs supplied to each run
- The comparison and diagnosis instruction
- Length and structure limits
# Daily runDraft outline only.Inputs: {{date}}, {{property}}, {{normalized_metrics}}, {{thresholds}}Task: compare today's metrics with the stored baseline, then diagnose flagged deltas.Output: brief with summary, flagged changes, evidence, recommended checks.Prompt Library#
This section is outlined but not yet researched. It is published as an outline so the structure is reviewable; nothing here should be treated as guidance until it carries citations.
In research
This section will cover
- Query-level click drops
- Indexation changes
- Core Web Vitals regressions
# Draft outlineDiagnose a click drop for {{query}} between {{window_a}} and {{window_b}} using only the supplied data.# Draft outlineExplain an indexation change for {{url_set}} and list the checks a human should run.# Draft outlineSummarise a field-data regression for {{page_group}} and keep lab evidence separate from field evidence.Example Daily Brief#
This section is outlined but not yet researched. It is published as an outline so the structure is reviewable; nothing here should be treated as guidance until it carries citations.
In research
This section will cover
- A worked brief with labelled facts, metrics and hypotheses
- What a good brief omits
# Draft brief shape — 2026-07-30## SummaryOne paragraph, no hypotheses.## Flagged changes- Change, with source, window and magnitude.Automation#
This section is outlined but not yet researched. It is published as an outline so the structure is reviewable; nothing here should be treated as guidance until it carries citations.
In research
This section will cover
- Scheduling, time zones and run windows
- Retries, quota handling and quiet failures
- Where the run should stop rather than guess
$ # Draft shape only — the researched command set lands in a later part.$ collect --source search-console --property "sc-domain:example.com" --range 28d$ # Output is written to the normalized store, never to the siteAutomation
Scheduling
Automation
Failure handling
Security#
This section is outlined but not yet researched. It is published as an outline so the structure is reviewable; nothing here should be treated as guidance until it carries citations.
In research
This section will cover
- Least-privilege scopes per platform
- Secret storage and rotation
- Retention and audit logging
Security checklist
0/5 done
Troubleshooting#
This section is outlined but not yet researched. It is published as an outline so the structure is reviewable; nothing here should be treated as guidance until it carries citations.
In research
This section will cover
- Authentication failures after setup
- Empty result sets
- Sources that disagree
- Quota exhaustion and noisy briefs
FAQ#
Questions this guide can already answer from Part 1.
Official Sources#
Sources used in Part 1. Each is the vendor's own documentation for the integration surface described above, and each will be cited inline in the per-platform sections as they are researched.
Next Steps#
Part 2 covers Google Search Console in depth: authentication, API setup, recommended MCP tools, schema design, daily extraction strategy, documented limitations, investigation workflows and prompt examples. In the meantime, these pages cover the connector and permission groundwork this workflow depends on.