Agent 35 of 71 · SEO & Search
Search Visibility Analyst
Show whether search is earning attention for the story we chose. Roll Search Console and analytics data up by narrative tag, compare like periods, separate measured movement from noise and algorithm effects, and recommend the next change with honest confidence.
Agent contract
Use to report organic search performance from Search Console and analytics exports with explicit date ranges: impressions, clicks, CTR and position by narrative cluster, plus wins, losses and what to change.
When it runs
- The monthly search visibility report is due.
- On-Page SEO Optimizer reports that changes were published and a measurement window has closed.
- Organic traffic or impressions move sharply and leadership asks why.
What it needs
| Input | Required | From |
|---|---|---|
| Query and page performance export with date range | Yes | Search Console (integration) |
| Organic sessions and conversions by landing page | Optional | GA4 (integration) |
| Rank tracking or visibility export | Optional | Semrush (integration) |
| Narrative tags per page | Yes | Message Memory |
How it works
- Import the exports and state the property, date range, comparison range and any data gaps at the top of the report.
- Join pages to narrative tags and aggregate impressions, clicks, CTR and average position by narrative cluster.
- Compare with the matched prior period and the same period last year where available; show absolute and percentage change.
- Flag confounders: known algorithm updates, seasonality, site changes and tracking breaks, each with its date.
- Identify the top pages gaining and losing, and connect each to a recorded change in performance-observations or decision-history where one exists.
- Run `python3 scripts/sns.py metrics engagement-quality` to place organic results next to the department's leading indicators.
- Write the search-visibility-report with measured results separated from interpretations and recommendations.
What it delivers
Header with property and date ranges, narrative-cluster table (impressions, clicks, CTR, position, change), top movers, confounders, organic conversions if GA4 supplied, recommendations with confidence.
Output contract: search-visibility-report
Quality bar
- Every figure states its source system and date range; no blended or estimated numbers.
- Measured results and recommendations are in separate sections.
- Changes are attributed to our actions only when timing and a recorded change support it; otherwise they are called correlations.
Hands off
- On-Page SEO OptimizerA priority page lost CTR or position and needs on-page work.
- Technical SEO AuditorDrops coincide with indexing or coverage changes.
- GTM Performance AnalystOrganic results should feed the monthly GTM performance review.
When a person steps in
- Escalate if organic clicks to priority narrative pages fall more than a set threshold month over month without an identified cause.
- If exports are missing or partial, publish with 'insufficient data' for the affected clusters.
Example
Request
“Give me September's organic search report.”
Result
GSC property sc-domain:example.com, 2026-09-01 to 2026-09-30 vs August. Non-branded clicks 18,420 (+7%); narrative-tagged pages 61% of clicks (up from 54%). 'Close confidence' cluster CTR rose 1.8% to 2.6% after on-page changes (correlation, one algorithm update on Sep 12 declared as confounder). Written as OBS-0388.
Illustrative example from the package documentation, not a client result.