4WP SEO Helper

Description

4WP SEO Helper gives you a site-wide SEO Inventory for WordPress: see missing titles and meta descriptions, score completeness, and mark business priority with drag-and-drop P1 / P2 / P3 lanes.

Version 2.0 adds a full Google Search Console workspace inside wp-admin: connect your Google account, sync Search Analytics locally, inspect URLs, and see indexing status next to inventory rows.

Version 2.2 adds an AI Assistant that generates SEO titles, meta descriptions, and focus keyphrases through the standard WordPress AI Client (Settings → Connectors). There is no custom vendor SDK. Nothing is generated until an administrator configures a connector.

Version 2.3 adds Trends: import Google Trends JSON or CSV and match interest to inventory focus keyphrases.

Version 2.4 adds Positions: track Google SERP rank for queries (via Serper) against your Search Console property, store dated snapshots, and collect People also ask / related searches.

Built for teams that use Yoast SEO or All in One SEO and need one place to audit SEO fields across posts, pages, and public custom post types.

A plugin by 4wp.dev. Overview and setup notes: 4WP SEO Helper on 4wp.dev.

Perfect for

• SEO audits — filter by missing title, meta description, or focus keyphrases
• Content ops — drag rows into P1–P3 lanes (business priority, not SEO score)
• Bulk workflows — quick edit SEO fields from the inventory table
• AI copy — generate title, description, and focus keyphrases via WordPress Connectors
• Search Console ops — overview, insights, performance breakdowns, URL inspection, and background data sync
• Rank tracking — Positions: query + country checks, SERP snapshots, People also ask / related searches
• Trends — import Google Trends snapshots and see interest next to matching keyphrases
• Indexing workflows — refresh index status and request indexing from the inventory table or admin bar
• External sync — REST API for Google Sheets or custom dashboards
• Multilingual sites — Polylang, WPML, or single-language

How it works

SEO Inventory

1. Activate the plugin (Yoast or All in One SEO recommended for read/write).
2. Open 4WP SEO → SEO Inventory.
3. Review completeness scores and missing SEO fields site-wide.
4. Drag rows into P1 / P2 / P3 to mark business priority.
5. Optional: enable the REST API under Settings and connect Sheets or your dashboard.
6. Optional: configure Settings → Connectors (WordPress AI Client), then Generate SEO copy from Inventory Quick Edit.

Priority reflects business importance (e.g. main service pages), not SEO score—a page can stay in P1 at 100% completeness.

Google Search Console

1. Enable Google Search Console under 4WP SEO → Settings.
2. Open Settings → Search Console and add OAuth Client ID and Client Secret from Google Cloud Console.
3. Enable the Google Search Console API for the same Cloud project (OAuth alone is not enough).
4. Register the redirect URI shown on the settings screen in your OAuth client.
5. Click Connect to Google and sign in with an account that has access to this site in Search Console.
6. The plugin auto-matches the property for your WordPress site domain, or use Local / staging mode to pick a property manually.
7. Open 4WP SEO → GSC for overview, insights, performance, URL inspection, and data sync.
8. Run Sync now to pull Search Analytics into WordPress (optional daily WP-Cron schedule).

If the connected Google account does not have access to this site’s Search Console property, sync and GSC tools stay blocked until access is granted. The settings screen links to Search Console user management for the current site.

Positions

1. Connect Search Console and select the property you want to find in the SERP (this is the “looking for” domain).
2. Open Settings → Position providers, add a Serper API key, and set default country / language.
3. Open 4WP SEO → Positions, add a query (country and language can override the defaults).
4. Click Update to fetch organic results (Top 10 / 20 / 30; extra pages only if your site is missing). Each check stores a dated JSON snapshot.
5. Hover the SERP icon for titles; hover Ask / Suggest for People also ask and related searches collected from that query. The Related tab lists unique phrases with source query IDs.

Google Search Console features

• OAuth connection — per-site Client ID/Secret, connect/disconnect Google account (tokens only; credentials stay saved)
• Property picker — auto-match by domain (https://example.com/ or sc-domain:example.com) or manual selection for staging
• Property access guard — blocks sync and GSC menu until the connected account can access this site’s property
• Overview & insights — clicks, impressions, CTR, position, branded vs non-branded query breakdown (configurable brand terms)
• Performance — Search Analytics by query, page, country, device, and search appearance with selectable date ranges
• URL Inspection — live index status for a single URL on the selected property
• Data sync — background manual sync and optional daily WP-Cron; stores metrics locally for inventory columns and reporting
• SEO Inventory integration — GSC clicks/impressions/top queries per row; index status, last crawl, refresh/request indexing actions
• Admin bar — quick Search Console inspect link on the front end when connected
• Local development — loopback OAuth redirect helper for .local / localhost sites

AI Assistant

• Uses the WordPress AI Client and Settings → Connectors (wp_supports_ai(), wp_ai_client_prompt())
• Generates SEO title, meta description, and focus keyphrases from Inventory Quick Edit
• Default context is page content (plain text stored in WordPress). Page URL uses fewer tokens
• 4WP SEO → AI Assistant documents what already works; prompt-pattern settings will follow
• Nothing is written to the post until you review, Apply, and Update
• If no connector is available, the Generate panel is not shown

Positions

• 4WP SEO → Positions tracks queries per country against the Search Console property
• Provider: Serper (API key under Settings → Position providers); default gl / hl with per-query override
• Unique key is query + country; Update stores a dated organic snapshot (JSON)
• Depth Top 10 / 20 / 30 — extra Serper pages only if the site is not found yet
• Hover preview of organic titles; Ask / Suggest tooltip for People also ask and related searches
• Related tab keeps unique phrases and an array of source query IDs when the same idea appears on several checks

Modules

Available in wp-admin: SEO Inventory, Inventory REST API, Google Search Console, Trends, Positions, AI Assistant (when a WordPress AI connector is configured).

Coming soon: TechArticle schema, LLMS.txt, and cross posting (visible as badges in Settings until a future release).

External services

This plugin optionally connects to Google APIs when a site administrator enables Google Search Console integration under 4WP SEO → Settings.

Google OAuth 2.0 (accounts.google.com, oauth2.googleapis.com)

Used so an administrator can connect their Google account to WordPress. When the admin clicks Connect Google, the plugin redirects to Google sign-in and exchanges an authorization code for access and refresh tokens. Tokens are stored in the WordPress database and used only for Search Console features initiated in wp-admin.

Google Search Console API (searchconsole.googleapis.com)

Used to list verified properties, inspect URLs, and fetch Search Analytics for the connected property. The plugin sends the selected property URL, requested page URLs, and date ranges when an administrator runs sync, URL inspection, or live analytics tools in wp-admin. Synced metrics are stored locally in WordPress for reporting screens and inventory columns.

No Google API calls are made until an administrator configures OAuth credentials and connects an account. The plugin does not send site visitor or front-end user data to Google.

Serper Search API (google.serper.dev)

Used only when an administrator saves a Serper API key under Settings → Position providers and runs Update on 4WP SEO → Positions. The plugin sends the search query, country (gl), language (hl), optional date-range (tbs), and page number. Organic titles/URLs, People also ask, and related searches from the response are stored in WordPress for rank snapshots. The plugin does not send visitor or front-end user data to Serper.

• Serper
• Serper privacy policy

WordPress AI Client / Connectors (optional)

When an administrator configures a connector under Settings → Connectors and runs Generate with AI in SEO Inventory, this plugin sends a prompt (page title plus either stripped page content or the page URL) through wp_ai_client_prompt(). The WordPress AI Client routes that prompt to the connector the administrator selected. This plugin does not call model vendors directly; which remote service receives the prompt depends on that connector.

• Google Terms of Service
• Google Privacy Policy
• Google API Services User Data Policy