ThemeMiles SEO Agent

ThemeMiles SEO Agent – AI-Powered SEO Audit & Priority Scoring for WordPress Most WordPress sites are leaking organic traffic — not because of one big problem, but because of dozens of small SEO issues nobody notices until rankings drop. ThemeMiles SEO Agent fixes that. It scans every published post, page, and WooCommerce product for 12 of the most impactful SEO issues, then ranks them by estimated business impact — not just by severity. The result is an actionable priority list that tells you which issues to fix first, so you stop wasting time on low-value cleanup while high-traffic pages bleed rankings. Works Alongside the SEO Plugin You Already Have ThemeMiles SEO Agent detects whether you're running Yoast SEO, Rank Math, or All in One SEO and reads from the correct meta fields for each. Your existing SEO plugin stays in place — ThemeMiles SEO Agent is the audit and automation layer on top. You get the diagnosis; your SEO plugin handles the presentation. What You Can Do With the Free Plugin Right Now ➜ Run a full site-wide SEO audit across posts, pages, and WooCommerce products ➜ Detect missing or out-of-range meta titles (30–65 characters) and meta descriptions (50–160 characters) ➜ Find missing focus keywords, Open Graph tags, schema markup, and canonical URLs ➜ Catch thin content (under 300 words), duplicate meta descriptions, and H1/title conflicts ➜ Check up to 10 internal links per post for 404 broken URLs ➜ Spot focus keywords absent from the meta title ➜ See a 0–100 site health score that reflects your real SEO posture ➜ Score every issue 0–100 by the SEO Brain Priority Score — built from traffic weight, ranking opportunity, issue severity, and fix effort ➜ Issues grouped into four action tiers: Fix Immediately · Fix This Week · Fix When Possible · Low Priority ➜ Dashboard with health score gauge, SEO Brain summary, and top-priority issue cards ➜ Schedule weekly audits to run automatically at a time you choose ➜ Trigger a manual audit instantly from the dashboard ➜ Mark issues as ignored or manually resolved ➜ Fix up to 15 issues per month with AI — add your own OpenAI, Anthropic, or Groq API key and apply one-click AI-generated fixes to meta titles, descriptions, OG tags, and focus keywords The Free / Pro Model — What You Need to Know ThemeMiles SEO Agent (this plugin) is the free version. It does everything listed above — including 15 AI-generated fixes per month using your own API key (OpenAI, Anthropic, or Groq) — and costs nothing. When you use the AI fix feature, your post content is sent to the AI provider you choose; see the External Services section below for full details. ThemeMiles SEO Agent Pro is a separate premium plugin sold at thememiles.com. You install one or the other — not both simultaneously. Upgrading from free to Pro takes under two minutes, and all your audit data is preserved in the same database tables. What Pro Adds AI Fix Generation (Free: 15/month on 4 field types · Pro: unlimited on all field types) ✔ Unlimited AI fixes — no monthly cap; generate and apply fixes for every open issue ✔ All field types — extends AI fixes to alt text, schema, canonical, and every other field (free covers meta title, meta description, OG tags, focus keyword) ✔ Fix Queue — review, edit, approve, or reject every suggestion before anything touches your site (free applies immediately) ✔ Rollback — undo any fix at any time; every original value is snapshotted before the first change Traffic Intelligence ✔ Fix impact tracking — measures position, impressions, and CTR changes 7 and 14 days post-fix ✔ Google Search Console integration — feeds real traffic data into the SEO Brain for accurate prioritisation ✔ Google PageSpeed Insights — Core Web Vitals pulled per URL and factored into scoring Advanced Automation ✔ Autonomous nightly mode — generate and apply fixes overnight within your approved rules ✔ Schema markup generator — Article, FAQ, HowTo, and Product schemas auto-generated and injected ✔ GEO / AI Search optimisation — score and improve visibility in ChatGPT, Perplexity, and Google AI Overviews ✔ Content decay detection — flag ranking drops before they hit page 2 Growth & Agency ✔ Competitor gap analysis — DataForSEO integration (BYOK) for keyword gap detection ✔ Agency dashboard — manage multiple sites with white-label reporting (Business/Agency plans) How the BYOK model works: Both free and Pro connect to AI providers using your API key. You sign up with OpenAI, Anthropic, or Groq directly, control your own usage limits, and pay them directly. A typical fix costs $0.001–$0.003 on GPT-4o-mini. ThemeMiles SEO Agent never marks up AI credits. The free plugin allows up to 15 AI fixes per month; Pro removes that limit. Who Can Benefit From ThemeMiles SEO Agent? ThemeMiles SEO Agent is perfect for: ✔ Bloggers and content creators ✔ eCommerce store owners running WooCommerce ✔ Niche site builders ✔ Marketing teams and SEO professionals ✔ Web design and development agencies ✔ Local businesses managing their own site ✔ WordPress consultants who audit client sites ✔ Any WordPress site that wants more organic traffic External Services This plugin can connect to third-party AI APIs to generate SEO fix suggestions. These connections only occur when you enter your own API key in Settings and click "Fix with AI" on a specific issue — they are never made automatically or without your action. What data is sent to AI providers: The post title, a plain-text excerpt of the post content (approximately the first 200 words, HTML stripped), the site name, and the focus keyword. No visitor data, personal information, or data from other posts is ever transmitted. When connections occur: Only when a logged-in administrator explicitly triggers a fix by clicking the "Fix with AI" button in the Audit Results page. The free plugin allows up to 15 such fixes per month. 1. OpenAI API — free plugin (15 fixes/month) and Pro (unlimited) Used to generate meta titles, descriptions, OG tags, and other SEO field fixes when you select OpenAI as your provider and supply your own API key. Data sent: post title, content excerpt (~200 words), site name, focus keyword. When: only when an administrator clicks "Fix with AI" for a specific issue. Provider: OpenAI, L.L.C. Service home: https://openai.com/ Privacy policy: https://openai.com/policies/privacy-policy/ Terms of use: https://openai.com/policies/terms-of-use/ 2. Groq API — free plugin (15 fixes/month) and Pro (unlimited) An OpenAI-compatible inference API used as an alternative AI provider. Same data and trigger conditions as OpenAI above. Data sent: post title, content excerpt (~200 words), site name, focus keyword. When: only when an administrator clicks "Fix with AI" for a specific issue. Provider: Groq, Inc. Service home: https://groq.com/ Privacy policy: https://groq.com/privacy-policy/ Terms of use: https://groq.com/terms-of-service/ 3. Anthropic API — free plugin (15 fixes/month) and Pro (unlimited) Used to generate meta titles, descriptions, and other SEO field fixes when you select Anthropic as your provider and supply your own API key. Data sent: post title, content excerpt (~200 words), site name, focus keyword. When: only when an administrator clicks "Fix with AI" for a specific issue. Provider: Anthropic, PBC. Service home: https://www.anthropic.com/ Privacy policy: https://www.anthropic.com/privacy Terms of use: https://www.anthropic.com/legal/consumer-terms 4. Internal link checker — this free plugin During a site audit, the plugin uses WordPress's built-in wp_remote_head() to check links found in post content. Only URLs that begin with your own home_url() are ever requested — the checker is strictly limited to your site's own pages. No data leaves your server to any third party. 5. ThemeMiles.com — upgrade links in this free plugin The Upgrade to Pro page and admin banner contain standard HTML anchor tags pointing to https://thememiles.com/thememiles-seo-agent-pro/. No data is transmitted to ThemeMiles servers automatically. These links only activate when an administrator clicks them. Privacy policy: https://thememiles.com/privacy-policy/ 6. WordPress.org — review nudge link in this free plugin After sufficient usage, an admin notice contains an HTML link to the plugin's WordPress.org reviews page. No data is transmitted automatically. 7. Google Search Console API — ThemeMiles SEO Agent Pro only ThemeMiles SEO Agent Pro can connect to your own Google Search Console account via Google OAuth to import traffic metrics (position, impressions, clicks, CTR) for priority scoring. You authorise the connection; no data is shared with ThemeMiles. Google Privacy policy: https://policies.google.com/privacy 8. Google PageSpeed Insights API — ThemeMiles SEO Agent Pro only The Pro plugin can call the PageSpeed Insights v5 API to retrieve Core Web Vitals data for your URLs. Only your site's own public URLs are submitted. Results are cached for 48 hours. Google Privacy policy: https://policies.google.com/privacy 9. DataForSEO API — ThemeMiles SEO Agent Pro optional Competitor gap analysis in Pro uses the DataForSEO API. This is strictly opt-in and requires you to supply your own DataForSEO API key (BYOK). No calls are made without your key. Service home: https://dataforseo.com/ Privacy policy: https://dataforseo.com/privacy-policy/

Method 1: Install directly from WordPress Admin (recommended)

1. Log in to your WordPress admin dashboard.
2. Navigate to Plugins > Add New Plugin.
3. Type ThemeMiles SEO Agent in the search box.
4. Click Install Now next to the ThemeMiles SEO Agent result by ThemeMiles.
5. Click Activate Plugin, then go to ThemeMiles SEO Agent > Dashboard and click Run Audit Now to scan your site.

Method 2: Manual upload via FTP or cPanel

1. Download thememiles-seo-agent.zip from the WordPress.org plugin repository.
2. Log in to your WordPress admin dashboard.
3. Go to Plugins > Add New Plugin > Upload Plugin.
4. Click Choose File, select the downloaded zip, then click Install Now.
5. Click Activate Plugin, then go to ThemeMiles SEO Agent > Dashboard and click Run Audit Now to scan your site.

After Activation

1. The onboarding wizard detects your active SEO plugin (Yoast SEO, Rank Math, or All in One SEO) automatically.
2. Optionally enter your AI provider API key (OpenAI, Anthropic, or Groq) to unlock 15 free AI-generated fixes per month.
3. Choose a weekly audit schedule, or click Run Audit Now to start immediately.
4. Review your SEO Brain priority tiers — start with Fix Immediately issues for the highest impact.

1.0.4

• Updated: readme Screenshots section revised to reflect the 4 current admin screenshots (Dashboard, SEO Audit health score, SEO Audit issue list, Settings AI Configuration).

1.0.3

• Fixed: Pro upgrade URL corrected to https://thememiles.com/thememiles-seo-agent-pro/ throughout readme.
• Updated: readme External Services section now accurately documents that the free plugin can call OpenAI, Groq, and Anthropic APIs (up to 15 fixes/month with BYOK) — all three providers listed with terms and privacy policy links.
• Updated: readme description, tagline, FAQ, and BYOK model explanation corrected to reflect that AI fix generation (15/month) is included in the free plugin.

1.0.2

• Fixed: Plugin URI updated from /autoseo-agent/ to /thememiles-seo-agent/ in plugin header and readme.

1.0.1

• Fixed: all admin scripts and styles now enqueued via wp_add_inline_script() / wp_add_inline_style() instead of raw HTML tags, per WordPress.org guidelines.
• Fixed: all $wpdb queries use %i placeholder for table names instead of variable interpolation.
• Fixed: non-prefixed variables renamed in view and uninstall files.
• Removed: load_plugin_textdomain() call (deprecated since WordPress 4.6).
• Changed: background audit job uses WP-Cron instead of Action Scheduler.

1.0.0 Initial release. Audit engine

• 12-check site-wide SEO audit: meta title (30–65 chars), meta description (50–160 chars), duplicate meta descriptions, missing focus keyword, image alt text (post content + attached media), schema / JSON-LD markup, Open Graph tags, thin content (<300 words), duplicate Title/H1, missing canonical URL, broken internal links (404 check, up to 10 per post), focus keyword in title.
• Auto-detects active SEO plugin: Yoast SEO, Rank Math, All in One SEO. Falls back to Yoast meta keys.
• Audits published posts, pages, and WooCommerce products in one pass.
• Batch processing (50 posts per batch) via WP-Cron — no server timeout on large sites.
• Auto-resolves open issues on re-audit when the underlying problem is corrected.

SEO Brain Priority Scoring

• 0–100 priority score per issue: traffic weight (post type proxy; GSC data in Pro) + ranking opportunity (positions 4–10 score highest) + issue severity (critical/major/minor) + fix effort (AI-fixable issues score highest).
• Four priority tiers: Fix Immediately (>=75), Fix This Week (>=50), Fix When Possible (>=25), Low Priority (<25).
• Site-wide rescore job runs automatically after every audit and can be triggered manually.
• Brain summary transient cached for 1 hour for instant dashboard loads.

Admin UI

• Dashboard: 0–100 health score SVG gauge (stroke-dasharray), SEO Brain summary bar, top-issue cards, last audit timestamp, run-audit button with live polling.
• Audit Results: priority-ranked issue table, severity / issue type / priority tier / status / search filters, paginated 25 per page, expandable rows with current value and recommended range.
• Fix Queue: free upgrade-preview page showing real issue values alongside blurred Pro suggestions, feature comparison, estimated AI cost, and upgrade CTA.
• Settings: API provider selector, API key field (never exposed to browser after save), model selector, audit schedule (frequency + time of day), auto-fix rules per field type (disabled in free), email report settings.
• Upgrade to Pro: three-plan pricing grid (Pro / Business / Agency), per-plan feature checklists, FAQ section, 7-day money-back notice.
• Onboarding wizard: multi-step modal on first activation — SEO plugin detection, API key setup, audit schedule, first audit trigger.
• Dismissible free upgrade banner on all AutoSEO admin pages (per-user, 15-minute cool-down after dismissal).
• Review nudge: shown to admins after 5+ applied fixes and 14+ days active, with "Remind me in 30 days" option.

Data and infrastructure

• Four database tables created on activation: wp_autoseo_issues, wp_autoseo_fixes, wp_autoseo_snapshots, wp_autoseo_audit_runs.
• DB version check on every load via maybe_upgrade() — runs dbDelta() only when needed.
• WP-Cron used for reliable background job processing.
• Weekly scheduled audit with configurable time of day (settings-driven).
• REST API: 11 endpoints under autoseo/v1/ — issues (paginated, filterable, JOIN with wp_posts for post titles), issues/summary, issues/rescore, audit/run, audit/status, brain/summary, settings (GET/POST), settings/test-connection, license/status, license/activate, license/deactivate.
• License controller is a pure stub in the free plugin — returns plan: free with zero HTTP requests.
• PSR-4 autoloader with vendor/autoload.php fallback to manual spl_autoload_register.
• Full uninstall cleanup via uninstall.php: drops all four tables, deletes all plugin options, removes all _transient_autoseo_* and _transient_timeout_autoseo_* entries.