Google Search Console (GSC) is Google’s free tool that shows you how your site actually performs in search results — which keywords bring traffic, where you rank, how many clicks you get, and what technical issues Google found when crawling your site. SEO Forge PRO integrates directly with GSC, bringing this data into your WordPress dashboard so you can see everything in one place without switching between tools. This integration transforms SEO Forge from an optimization tool into a performance monitoring platform.
Why You Need Google Search Console Data
Without GSC, you are optimizing in the dark. You can set perfect focus keywords, write compelling titles, and score 100 on every page — but without real search data, you do not know:
- Which pages are actually ranking in Google
- Which keywords bring visitors to your site
- Whether your optimizations are working (are rankings going up or down?)
- Which pages have high visibility but low clicks (opportunity to improve titles)
- What technical problems Google found when crawling your site
Step-by-Step: Full GSC Setup
SEO Forge now uses one-click Google OAuth — no more creating OAuth clients in Google Cloud Console. A single Connect Google click covers Search Console, Google Analytics 4, and Google Indexing at once.
- Go to SEO Forge > Settings in WordPress and scroll to the Google Search Console card.
- Click Connect Google — you are redirected to
api.avakode.com/integrations/google/auth, which immediately forwards you to Google’s consent screen. - Choose the Google account that owns your Search Console property.
- On the consent screen you see the requested scopes: See and download your Search Console data, See Analytics data, Submit URLs for indexing. Click Allow.
- Google returns you to the SEO Forge settings page. The card now shows ✓ Connected with the property it auto-detected.
- If your site’s domain doesn’t match any verified property (e.g. you have multiple properties or haven’t verified yet), a picker lets you choose manually.
- Data begins syncing — the initial sync may take a few minutes for sites with substantial history.
[Screenshot: SEO Forge Settings page showing the Google Search Console card with a single “Connect Google” button and “✓ Connected” state after consent]
> What happens behind the scenes. OAuth tokens are stored in our backend (api.avakode.com, a Cloudflare Worker), not in your WordPress database. Your site never holds a Google access token or refresh token — only its Avakode license key. All Google API calls are made server-side by our backend on your behalf. See avakode.com/privacy/ section 3.9 for the full data-handling description.
Viewing Your Search Performance
Once connected, go to SEO Forge > Rankings to see your data:
The Big Four — site-wide KPIs (2026-04-23, SF-117): the top of the Rankings page now shows four KPI cards at a glance for the last 28 days — Total Clicks, Total Impressions, Average CTR, Average Position. Each card carries a delta vs the previous 28 days with a colour arrow. Green = better, red = worse. For Position specifically, a green “↓ 1.7” means your average position improved by 1.7 (lower number = higher rank). Striking Distance Keywords (2026-04-23, SF-117): below the Big Four sits a focused table of queries currently ranking at positions 11–15 — the quickest wins. Sorted by impressions so the highest-opportunity keyword is at the top. A single content tweak or a better title can push these onto page 1, where the click share jumps dramatically. Top tracked keywords — the original detailed table stays at the bottom:| Column | What It Tells You | Why It Matters |
|---|---|---|
| Keyword | The search term people used to find your site | Tells you what topics drive traffic |
| Page | Which page appeared in search results | Shows which content Google considers relevant for each keyword |
| Position | Your average ranking position (1 = top result) | Tracks how well you rank for each keyword |
| Clicks | How many people clicked through to your site | Measures actual traffic from search |
| Impressions | How many times your result was shown | Measures visibility even without clicks |
| CTR | Click-through rate (clicks / impressions) | Tells you how compelling your title and description are |
Smart Insights — phase 2 (2026-04-23, SF-117 phase 2)
Below the Big Four and Striking Distance tables, the Rankings page now carries four additional insight blocks that turn raw GSC data into concrete actions:
- Keyword cannibalization — queries where two or more of your pages rank simultaneously. Per-query breakdown lists each competing page with its position, clicks, and impressions. The fix is usually to consolidate content onto one authoritative page and either redirect the weaker one or link internally from it — Google then stops splitting the signal.
- CTR anomalies (top-3 with low CTR) — pages ranked at positions 1-3 with click-through rate at least 40% below the industry benchmark for that position (pos 1 ≈ 28%, pos 2 ≈ 15%, pos 3 ≈ 10%). Your ranking is great but the snippet isn’t compelling enough — rewrite the meta title and description to earn the clicks you’re leaving on the table.
- Winners & Losers (last 7 days vs prior 7) — two side-by-side lists showing your 5 biggest click gainers and 5 biggest click losers for the current 7-day window compared to the previous 7-day window. Winners tell you what’s working so you can double down; losers flag content decay early (see Content Decay Detection for the 28-day version).
- Queries by intent — AI classifies your top 30 queries into informational / commercial / transactional / navigational buckets. Opt-in — a single “Classify my top queries” button spends one credit for the whole batch, cached for 6 hours. Useful for balancing your content calendar: if 80% of your queries are informational, you’re probably under-indexed on bottom-of-funnel commercial intent.
Primary sync on Connect
As of 2026-04-23 (SF-117 phase 2), clicking Connect Google no longer leaves you staring at an empty Rankings page for up to 24 hours. After the plugin auto-detects the right property, a 90-day primary sync fires immediately — Big Four / Striking Distance / the full keyword table are populated the next time you open Rankings. The daily cron continues to refresh the 28-day window going forward.
Google index status in the post editor (URL Inspection API)
Every published post now has a Google index status panel inside the SEO Forge metabox, below the SERP preview. Click Check status and the plugin calls Google’s URL Inspection API through the Worker proxy; in about a second you see a set of verdict pills: Coverage (PASS / NEUTRAL / FAIL), Indexing state, Mobile usability verdict, Rich-results verdict. Below the pills: the Last crawled timestamp, a Canonical mismatch warning if Google picked a different canonical than you declared, and a deep link to open the page in Search Console.
The call is cached per-URL for 6 hours to stay well under Google’s 2000 inspections/day/property quota.
How to Interpret and Act on Ranking Data
Here is a practical framework for using the data:
| Scenario | What to Do |
|---|---|
| Position 1 — 3, high CTR | Performing well. Monitor to catch any decline. |
| Position 4 — 10, decent CTR | You are on page 1 but not at the top. Strengthen the content — add depth, update information, improve internal links. |
| Position 11 — 20, low clicks | Just off page 1 — a “quick win.” Small optimizations (better title, more content, a few internal links) can push you onto page 1. |
| High impressions, low CTR | People see your result but do not click. Your title and description are not compelling enough. Rewrite them. |
| Position dropping over time | Content may be decaying. See the Content Decay Detection section for how to identify and fix declining pages. |
Data Sync Schedule
GSC data syncs automatically once per day. Google’s data typically has a 2 — 3 day delay, so today’s dashboard shows data from about three days ago. This is a Google-side limitation, not an SEO Forge limitation. For trending analysis, look at weekly and monthly patterns rather than day-to-day fluctuations.
> Good to know: Connect takes about 30 seconds. One click + Allow on the Google consent screen = done. No Google Cloud Console account needed, no OAuth client to create, no credentials to paste.
> Tip: Check the Rankings page weekly. Look specifically for keywords where your position has dropped by 3+ spots — these are early warnings of content decay. Catching them early makes recovery much easier.
Common Mistakes
- Not connecting GSC at all. This is the most common mistake. Without real data, you are guessing about what works. Connect it as soon as you activate PRO.
- Checking rankings daily and panicking over small fluctuations. Rankings naturally fluctuate by a few positions day to day. Look at weekly trends instead.
- Ignoring keywords you rank for accidentally. You may discover keywords bringing traffic that you never targeted. Create or optimize dedicated pages for these keywords to capture even more traffic.
—