SWG Ultimate SEO Tool

• 6-step client onboarding wizard capturing services, service areas, goals, target keywords and competitors per client
• Per-client Google OAuth (analytics.readonly + webmasters.readonly + adwords) with the token stored on the client row, plus property/site/account pickers
• Page evaluation engine: crawler extracting SEO signals through 16 builder-aware content selectors, then per-step OpenAI calls for an 11-section audit, FAQs, schema, intent/E-E-A-T/semantic/snippet/competitor-gap and a ranking plan
• Branded PDF reports via bundled DOMPDF with QuickChart-rendered chart images, saved to uploads/sust-reports/ and emailed on a daily cron schedule per client
• Google Ads campaign creation and control: AI keyword suggestions, ad-group grouping, ad copy, then real campaignBudgets:mutate and campaigns:mutate calls to launch, pause and enable
• AI content pipeline: keyword clustering from GSC data, calendar generation, and blog drafts written straight into wp_posts as drafts with _sust_* meta
• Rank, health-score, CWV and competitor snapshots taken on WP-Cron and charted as trends
• Third-party SEO data: DataForSEO backlinks, disavow file, keyword difficulty and SERP features; Bing Webmaster data with Bing-vs-Google position comparison
• Agency intelligence layer: upsell detection, churn risk, MRR, client LTV, share of voice, content decay, cannibalization, internal-link suggestions and a task kanban
• OpenAI usage panel with lifetime and today's spend, per-model cost pricing, reset, and a hard-failing configurable daily spend cap

Who it is for

An SEO or web agency owner (or the one account manager who does reporting) running several client sites from a single WordPress install. Everything is behind `manage_options`, so it is an admin-only back-office tool, not something you hand to staff or clients. Day to day it gives you one place to store client records, pull Google Search Console / GA4 / Google Ads numbers per client, run AI page audits, generate branded PDF reports, and build AI content calendars and Google Ads campaigns.

Onboard a client and connect their Google account

1. SWG SEO Tool > Clients > Add New Client (opens the 6-step wizard).
2. Step 1 Business Info: Name and Website URL are required; domain goes in bare, no http:// and no trailing slash. Industry, business type, contact, logo (WP media picker) and brand colors are optional.
3. Step 2 Services & Location: Services and Service Areas are comma-separated single-line fields. Physical address and Google Business Profile URL are free text.
4. Step 3 Goals & KPIs: primary goal radio, monthly lead target, current traffic, current ad spend, Target Keywords and Top Competitors (one per line or comma-separated).
5. Step 4 Google Connections: SKIP IT on a new client. The Connect Google Account button aborts with 'Please save the client first before connecting Google services,' and Fetch/Test Connection are rendered disabled until the client exists and has a token.
6. Step 5 Report Preferences: set Report Frequency, and fill Report Recipients – the Email button on the Reports page reads this field and errors with 'No recipients configured for this client' if it is blank. Tick the report sections you want.
7. Step 6 Review & Create > Create Client.
8. Now reopen the client: Clients list > Edit. Go to Step 4 and click Connect Google Account, complete Google's consent screen, and you land back on the client with &tab=connections&oauth_success=1.
9. Back in Edit > Step 4, click Fetch Properties (GA4), Fetch Sites (Search Console) and Fetch Accounts (Ads), choose one in each dropdown, then click each Test Connection.
10. Advance to Step 6 and click Update Client – the property/site/customer selections are only persisted by that submit.

Pull the month's data and produce a client report

1. Clients > click the client name > Organic (GSC) tab > Pull Search Console Data. Wait for the queries/pages/countries tables to fill.
2. Traffic (GA4) tab > Pull GA4 Data.
3. Paid (Ads) tab > Pull Google Ads Data (the tab shows a 'No Google Ads account connected' notice instead if ads_customer_id is empty).
4. SWG SEO Tool > Reports. In Generate Report pick the Client, pick Date Range (7 / 28 / 90 days), and untick any of the 12 sections you do not want.
5. Click Generate PDF Report. On success the status line shows the filename and the page reloads after 2 seconds. Files land in wp-content/uploads/sust-reports/ (the folder gets an Options -Indexes .htaccess).
6. In Report Archive, use Email on the new row to send it to the client's Report Recipients with the PDF attached – the row's Status badge flips to Sent. Download gives you the file; Delete asks for an inline confirm.

Run an SEO evaluation on a single page

1. SWG SEO Tool > Run Evaluation.
2. Pick a Client (or leave '— Internal (no client) —'). Page URL is the only required field.
3. Fill Target Keyword, Page Type, City, Service. Competitor URL is optional but it is the switch for the Competitor Gap step – leave it blank and that step is skipped even if the Intelligence Suite box is ticked.
4. Under 'What to generate', SEO Report / FAQs / Schema Markup are pre-ticked; SEO Intelligence Suite and Ranking Plan are not – tick them if you want them.
5. Click Run Evaluation. The form hides and a progress bar walks the steps: crawl, then one AJAX call per AI step, then Finalizing at 100%.
6. Read the result cards, then click Run Another Evaluation. Evaluated URLs show up under Pages Library, filtered by client, with a Re-evaluate button and a ranking-plan completion pill.

Build a content calendar and turn it into WordPress drafts

1. SWG SEO Tool > Content Calendar. Choose a client in the dropdown – changing it auto-submits the form and reloads the page with ?client_id=N.
2. Click Generate Keyword Clusters. This reads that client's stored Search Console data plus their target keywords, so pull GSC data first or the clusters will be thin. The page reloads and renders one card per cluster.
3. Pick Posts per week (1/2/3) and click Generate Calendar. That button stays disabled until at least one cluster exists.
4. Use Write Next Post for the oldest pending row, or the per-row Write button in the 90-Day Content Calendar table. Each one creates a WordPress draft post.
5. Once a row's status flips to Written, its action button becomes Edit Draft, which opens the post in the WordPress editor.
6. Optional: paste a URL into 'Content URL to promote' and click Generate Outreach Drafts to get 5 AI outreach emails rendered as cards at the bottom of the page.

Create and launch a Google Ads campaign

1. SWG SEO Tool > Campaigns > Create Campaign.
2. Step 1: choose the Client (required to advance), Campaign Type (Search / Display / Performance Max) and Campaign Name.
3. Step 2: click Suggest Keywords for AI suggestions from the client's SEO data, and/or type your own one-per-line into the manual box.
4. Step 3: click Organize into Ad Groups. Step 4: click Generate Ad Copy. Both are AI calls against your OpenAI key.
5. Step 5: set Daily Budget and Bid Strategy. The warning box repeats the safety cap from Settings > Google Ads; a launch above that cap is rejected server-side.
6. Step 6: review, then either Save as Draft, or Launch Campaign – which shows an inline 'This will create a live campaign spending ~$X/day. Confirm?' bar, saves the draft, and then creates the budget and campaign through the Google Ads API.
7. Back on the Campaigns list, drafts get an Edit button, active campaigns get Pause, paused ones get Enable.

How it works

Single-file bootstrap (swg-ultimate-seo-tool.php) defines SUST_* constants, registers an spl_autoload mapping SUST_Foo_Bar to includes/class-foo-bar.php, wires activation/deactivation, and on plugins_loaded builds the SUST_Plugin singleton. SUST_Plugin is a service-locator god object: it compares sust_db_version against SUST_DB_VERSION and re-runs SUST_Activator::create_tables() on drift, instantiates roughly 100 service and repository objects across 106 class files (grouped by build phase 1-19), then calls register() on the 17 that hook WordPress. Admin is thin: SUST_Admin_Menu adds one top-level menu plus 8 submenus that each require() a view in admin/views/, and every render method re-checks manage_options before including the file; all interactivity goes through SUST_Ajax_Handler (4,175 lines, 141 unique wp_ajax_sust_* actions, no nopriv variants) plus two admin_post download endpoints. Data lives in 40 custom sust_-prefixed tables created by dbDelta, one wp_options row (sust_settings) holding all configuration, and transients for API response caching (SUST_Data_Cache) and mid-evaluation state. The front-end surface is separate and tiny: two shortcodes and two rewrite-rule token routes registered by SUST_Client_Portal, SUST_Self_Service_Reports and SUST_Approval_Workflow.

Where the data lives

Talks to

OpenAI Chat Completions (gpt-4o, gpt-4o-mini, gpt-4-turbo) SEO audits, FAQs, schema, intent and E-E-A-T analysis, ranking plans, ad copy, blog drafts, briefs, executive summaries and digests Google OAuth 2.0 One per-client consent covering analytics.readonly, webmasters.readonly and adwords; tokens stored on the client row and refreshed Google Search Console API (searchconsole.googleapis.com/v1) Site list plus searchAnalytics queries, pages, countries and devices; source for rank history and opportunity keywords GA4 Data API (analyticsdata.googleapis.com/v1beta) and Analytics Admin API Sessions, users, traffic sources, landing pages, conversions; account and property discovery Google Ads API v22 (googleads.googleapis.com) googleAds:searchStream reads for campaigns, keywords and search terms, plus campaignBudgets:mutate and campaigns:mutate writes for launch, pause and enable Google Business Profile API (mybusiness / mybusinessbusinessinformation) Reviews, ratings, posts, Q&A and photos per client location PageSpeed Insights API v5 Core Web Vitals for evaluations and the weekly CWV monitor; no key required DataForSEO Backlinks and disavow input, keyword difficulty, keyword volume and SERP features; HTTP basic auth with login plus API password Bing Webmaster Tools API Bing rankings, clicks and impressions, and Bing-vs-Google position comparison QuickChart.io Server-side rendering of chart PNGs embedded in PDF reports; no key SERP provider (DataForSEO, ValueSERP or SerpAPI) People Also Ask questions during evaluations; skipped silently when unconfigured Looker Studio / Data Studio API Optional per-client template cloning and report link management; returns null when unconfigured SMTP or wp_mail Scheduled report delivery, weekly digests, monthly client emails and health alerts

Public surface

Small and optional. Two shortcodes: [sust_client_portal] renders a logged-in client dashboard (28-day GSC KPIs with month-over-month deltas, top keywords, recent report links) for whichever client id is stored in that user's sust_client_id user meta, and [sust_report_builder] lets the same user pick a date range plus sections and generate a PDF. Two rewrite routes give tokenized, no-login access: /sust-report-download/{token} streams a generated PDF and increments a download counter, and /sust-preview/{token} shows a blog draft with Approve / Request changes buttons that POST back and fire a webhook. An opt-in white-label login skins wp-login with the agency logo and colors. There is no public data-entry form and no nopriv AJAX.

History