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/
Source Code
The unminified JavaScript source files and webpack build configuration for this plugin are publicly available at: https://bitbucket.org/thememile/plugin-autoseo-agent
To rebuild the compiled assets from source:
1. Clone the repository
2. Run npm install
3. Run npm run build