> For the complete documentation index, see [llms.txt](https://oodlz-ai-studio.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://oodlz-ai-studio.gitbook.io/docs/reporting-agents/growth/seo-metrics.md).

# SEO Metrics

4 organic search metrics from Google Search Console every month — clicks, impressions, CTR, and average position — with month-over-month deltas.

> **Organic search performance, monthly — clicks, impressions, CTR, average position.**

The SEO Metrics workflow pulls organic search performance from Google Search Console once a month. 4 metrics flow into the workspace per period: total organic clicks, total impressions, click-through rate, and average ranking position. Each comes with a month-over-month delta and a colour-coded direction.

## How It Works

The workflow connects to GSC via OAuth2 with read-only Webmasters access. On the monthly cron — 06:00 UTC on the 2nd of each month — it queries GSC for the prior calendar month's totals and the month before that. The 4 totals are calculated for both periods, deltas computed, and the result upserted to the workspace. If the property has no GSC data for a period, the run logs a warning and writes 0 values rather than failing.

Average Position is treated specially in the dashboard. A lower position number is better (1 is the top of search results), so the delta colour-coding is inverted — when the number drops, the dashboard renders green; when it rises, the dashboard renders red.

## What You Get

* 4 SEO metrics per month — Clicks, Impressions, CTR (4 decimal places), Avg Position (2 decimal places).
* Month-over-month deltas on every metric — stored alongside the current values, never re-computed in the dashboard.
* Inverted colour direction for Avg Position — lower is better, the dashboard shows it correctly.
* Empty-period handling — properties with no GSC data for a month write 0 with a logged warning, never fail the run.