Skip to content
RAY BEHARRY

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

InputRequiredFrom
Query and page performance export with date rangeYesSearch Console (integration)
Organic sessions and conversions by landing pageOptionalGA4 (integration)
Rank tracking or visibility exportOptionalSemrush (integration)
Narrative tags per pageYesMessage Memory

How it works

  1. Import the exports and state the property, date range, comparison range and any data gaps at the top of the report.
  2. Join pages to narrative tags and aggregate impressions, clicks, CTR and average position by narrative cluster.
  3. Compare with the matched prior period and the same period last year where available; show absolute and percentage change.
  4. Flag confounders: known algorithm updates, seasonality, site changes and tracking breaks, each with its date.
  5. Identify the top pages gaining and losing, and connect each to a recorded change in performance-observations or decision-history where one exists.
  6. Run `python3 scripts/sns.py metrics engagement-quality` to place organic results next to the department's leading indicators.
  7. 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

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.