{"id":347369,"date":"2026-08-14T15:45:49","date_gmt":"2026-08-14T15:45:49","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/autoseo-agent\/"},"modified":"2026-08-14T15:45:11","modified_gmt":"2026-08-14T15:45:11","slug":"thememiles-seo-agent","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/thememiles-seo-agent\/","author":17156001,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.4","stable_tag":"1.0.4","tested":"7.0.4","requires":"6.3","requires_php":"8.1","requires_plugins":null,"header_name":"ThemeMiles SEO Agent","header_author":"ThemeMiles","header_description":"Automatically detect SEO issues across your WordPress site with AI-powered analysis. Works alongside Yoast SEO, Rank Math, and AIOSEO.","assets_banners_color":"4a2c82","last_updated":"2026-08-14 15:45:11","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/thememiles.com\/thememiles-seo-agent\/","header_author_uri":"https:\/\/thememiles.com\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":45,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.4":{"tag":"1.0.4","author":"thememiles","date":"2026-08-14 15:45:11"}},"upgrade_notice":{"1.0.4":"<p>Readme-only update: revises the Screenshots section to match the current 4 admin screenshots. No code or database changes.<\/p>","1.0.3":"<p>Readme-only update: corrects external services disclosure, Pro upgrade URLs, tagline, and FAQ copy to accurately reflect the free plugin&#039;s 15 AI fixes\/month feature. No code or database changes.<\/p>","1.0.2":"<p>Readme-only update: corrects Plugin URI. No code or database changes.<\/p>","1.0.1":"<p>Maintenance release: WordPress.org code-quality fixes. No new features or database changes.<\/p>","1.0.0":"<p>Initial release of ThemeMiles SEO Agent. Activate and run your first full site SEO audit in under two minutes \u2014 no API key or configuration required to get started.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3647661,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3647661,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3647661,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3647661,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.4"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3647661,"resolution":"1","location":"assets","locale":"","width":1852,"height":890},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3647661,"resolution":"2","location":"assets","locale":"","width":1866,"height":897},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3647661,"resolution":"3","location":"assets","locale":"","width":1780,"height":890},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3647661,"resolution":"4","location":"assets","locale":"","width":1669,"height":859}},"screenshots":{"1":"<strong>Dashboard<\/strong> \u2014 Site health score, SEO Brain onboarding checklist, open issues \/ fixes applied \/ pages tracked summary cards, and a one-click Run Audit button.","2":"<strong>SEO Audit \u2014 Health Score<\/strong> \u2014 Site health score gauge (0\u2013100), SEO Brain priority summary (Fix Immediately \/ Fix This Week \/ Fix When Possible counts), and audit run details.","3":"<strong>SEO Audit \u2014 Issue List<\/strong> \u2014 Priority-ranked issue table with severity filter pills (Critical \/ Major \/ Minor), content type \/ issue type \/ priority filters, live search, and per-issue actions (Edit, Ignore, Fix with AI).","4":"<strong>Settings \u2014 AI Configuration<\/strong> \u2014 Configure the AI provider (OpenAI \/ Anthropic \/ Groq), API key, model selection, and a Test Connection check."}},"plugin_section":[],"plugin_tags":[236374,2988,125621,186,476],"plugin_category":[55],"plugin_contributors":[182465],"plugin_business_model":[],"class_list":["post-347369","plugin","type-plugin","status-publish","hentry","plugin_tags-ai-seo","plugin_tags-meta-tags","plugin_tags-schema-markup","plugin_tags-seo","plugin_tags-seo-optimization","plugin_category-seo-and-marketing","plugin_contributors-thememiles","plugin_committers-thememiles"],"banners":{"banner":"https:\/\/ps.w.org\/thememiles-seo-agent\/assets\/banner-772x250.png?rev=3647661","banner_2x":"https:\/\/ps.w.org\/thememiles-seo-agent\/assets\/banner-1544x500.png?rev=3647661","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/thememiles-seo-agent\/assets\/icon-128x128.png?rev=3647661","icon_2x":"https:\/\/ps.w.org\/thememiles-seo-agent\/assets\/icon-256x256.png?rev=3647661","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/thememiles-seo-agent\/assets\/screenshot-1.png?rev=3647661","caption":"<strong>Dashboard<\/strong> \u2014 Site health score, SEO Brain onboarding checklist, open issues \/ fixes applied \/ pages tracked summary cards, and a one-click Run Audit button."},{"src":"https:\/\/ps.w.org\/thememiles-seo-agent\/assets\/screenshot-2.png?rev=3647661","caption":"<strong>SEO Audit \u2014 Health Score<\/strong> \u2014 Site health score gauge (0\u2013100), SEO Brain priority summary (Fix Immediately \/ Fix This Week \/ Fix When Possible counts), and audit run details."},{"src":"https:\/\/ps.w.org\/thememiles-seo-agent\/assets\/screenshot-3.png?rev=3647661","caption":"<strong>SEO Audit \u2014 Issue List<\/strong> \u2014 Priority-ranked issue table with severity filter pills (Critical \/ Major \/ Minor), content type \/ issue type \/ priority filters, live search, and per-issue actions (Edit, Ignore, Fix with AI)."},{"src":"https:\/\/ps.w.org\/thememiles-seo-agent\/assets\/screenshot-4.png?rev=3647661","caption":"<strong>Settings \u2014 AI Configuration<\/strong> \u2014 Configure the AI provider (OpenAI \/ Anthropic \/ Groq), API key, model selection, and a Test Connection check."}],"raw_content":"<!--section=description-->\n<h3>ThemeMiles SEO Agent \u2013 AI-Powered SEO Audit &amp; Priority Scoring for WordPress<\/h3>\n\n<p><strong>Most WordPress sites are leaking organic traffic \u2014 not because of one big problem, but because of dozens of small SEO issues nobody notices until rankings drop.<\/strong><\/p>\n\n<p>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 \u2014 not just by severity. The result is an actionable priority list that tells you <em>which<\/em> issues to fix <em>first<\/em>, so you stop wasting time on low-value cleanup while high-traffic pages bleed rankings.<\/p>\n\n<h3>Works Alongside the SEO Plugin You Already Have<\/h3>\n\n<p>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 \u2014 ThemeMiles SEO Agent is the audit and automation layer on top. You get the diagnosis; your SEO plugin handles the presentation.<\/p>\n\n<h3>What You Can Do With the Free Plugin Right Now<\/h3>\n\n<p>\u279c Run a full site-wide SEO audit across posts, pages, and WooCommerce products\n\u279c Detect missing or out-of-range meta titles (30\u201365 characters) and meta descriptions (50\u2013160 characters)\n\u279c Find missing focus keywords, Open Graph tags, schema markup, and canonical URLs\n\u279c Catch thin content (under 300 words), duplicate meta descriptions, and H1\/title conflicts\n\u279c Check up to 10 internal links per post for 404 broken URLs\n\u279c Spot focus keywords absent from the meta title\n\u279c See a 0\u2013100 site health score that reflects your real SEO posture\n\u279c Score every issue 0\u2013100 by the <strong>SEO Brain Priority Score<\/strong> \u2014 built from traffic weight, ranking opportunity, issue severity, and fix effort\n\u279c Issues grouped into four action tiers: <strong>Fix Immediately \u00b7 Fix This Week \u00b7 Fix When Possible \u00b7 Low Priority<\/strong>\n\u279c Dashboard with health score gauge, SEO Brain summary, and top-priority issue cards\n\u279c Schedule weekly audits to run automatically at a time you choose\n\u279c Trigger a manual audit instantly from the dashboard\n\u279c Mark issues as ignored or manually resolved\n\u279c Fix up to <strong>15 issues per month with AI<\/strong> \u2014 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<\/p>\n\n<h3>The Free \/ Pro Model \u2014 What You Need to Know<\/h3>\n\n<p>ThemeMiles SEO Agent (this plugin) is the <strong>free version<\/strong>. It does everything listed above \u2014 including <strong>15 AI-generated fixes per month<\/strong> using your own API key (OpenAI, Anthropic, or Groq) \u2014 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.<\/p>\n\n<p><strong>ThemeMiles SEO Agent Pro<\/strong> is a <strong>separate premium plugin<\/strong> sold at <a href=\"https:\/\/thememiles.com\/thememiles-seo-agent-pro\/\">thememiles.com<\/a>. You install one <em>or<\/em> the other \u2014 not both simultaneously. Upgrading from free to Pro takes under two minutes, and <strong>all your audit data is preserved<\/strong> in the same database tables.<\/p>\n\n<h3>What Pro Adds<\/h3>\n\n<p><strong>AI Fix Generation (Free: 15\/month on 4 field types \u00b7 Pro: unlimited on all field types)<\/strong>\n\u2714 Unlimited AI fixes \u2014 no monthly cap; generate and apply fixes for every open issue\n\u2714 All field types \u2014 extends AI fixes to alt text, schema, canonical, and every other field (free covers meta title, meta description, OG tags, focus keyword)\n\u2714 Fix Queue \u2014 review, edit, approve, or reject every suggestion before anything touches your site (free applies immediately)\n\u2714 Rollback \u2014 undo any fix at any time; every original value is snapshotted before the first change<\/p>\n\n<p><strong>Traffic Intelligence<\/strong>\n\u2714 Fix impact tracking \u2014 measures position, impressions, and CTR changes 7 and 14 days post-fix\n\u2714 Google Search Console integration \u2014 feeds real traffic data into the SEO Brain for accurate prioritisation\n\u2714 Google PageSpeed Insights \u2014 Core Web Vitals pulled per URL and factored into scoring<\/p>\n\n<p><strong>Advanced Automation<\/strong>\n\u2714 Autonomous nightly mode \u2014 generate and apply fixes overnight within your approved rules\n\u2714 Schema markup generator \u2014 Article, FAQ, HowTo, and Product schemas auto-generated and injected\n\u2714 GEO \/ AI Search optimisation \u2014 score and improve visibility in ChatGPT, Perplexity, and Google AI Overviews\n\u2714 Content decay detection \u2014 flag ranking drops before they hit page 2<\/p>\n\n<p><strong>Growth &amp; Agency<\/strong>\n\u2714 Competitor gap analysis \u2014 DataForSEO integration (BYOK) for keyword gap detection\n\u2714 Agency dashboard \u2014 manage multiple sites with white-label reporting (Business\/Agency plans)<\/p>\n\n<p><strong>How the BYOK model works:<\/strong> Both free and Pro connect to AI providers using <em>your<\/em> 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\u2013$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.<\/p>\n\n<h3>Who Can Benefit From ThemeMiles SEO Agent?<\/h3>\n\n<p>ThemeMiles SEO Agent is perfect for:<\/p>\n\n<p>\u2714 Bloggers and content creators\n\u2714 eCommerce store owners running WooCommerce\n\u2714 Niche site builders\n\u2714 Marketing teams and SEO professionals\n\u2714 Web design and development agencies\n\u2714 Local businesses managing their own site\n\u2714 WordPress consultants who audit client sites\n\u2714 Any WordPress site that wants more organic traffic<\/p>\n\n<h4>External Services<\/h4>\n\n<p>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 \u2014 they are never made automatically or without your action.<\/p>\n\n<p><strong>What data is sent to AI providers:<\/strong> 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.<\/p>\n\n<p><strong>When connections occur:<\/strong> 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.<\/p>\n\n<p><strong>1. OpenAI API \u2014 free plugin (15 fixes\/month) and Pro (unlimited)<\/strong>\nUsed 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.\nData sent: post title, content excerpt (~200 words), site name, focus keyword.\nWhen: only when an administrator clicks \"Fix with AI\" for a specific issue.\nProvider: OpenAI, L.L.C.\nService home: https:\/\/openai.com\/\nPrivacy policy: https:\/\/openai.com\/policies\/privacy-policy\/\nTerms of use: https:\/\/openai.com\/policies\/terms-of-use\/<\/p>\n\n<p><strong>2. Groq API \u2014 free plugin (15 fixes\/month) and Pro (unlimited)<\/strong>\nAn OpenAI-compatible inference API used as an alternative AI provider. Same data and trigger conditions as OpenAI above.\nData sent: post title, content excerpt (~200 words), site name, focus keyword.\nWhen: only when an administrator clicks \"Fix with AI\" for a specific issue.\nProvider: Groq, Inc.\nService home: https:\/\/groq.com\/\nPrivacy policy: https:\/\/groq.com\/privacy-policy\/\nTerms of use: https:\/\/groq.com\/terms-of-service\/<\/p>\n\n<p><strong>3. Anthropic API \u2014 free plugin (15 fixes\/month) and Pro (unlimited)<\/strong>\nUsed to generate meta titles, descriptions, and other SEO field fixes when you select Anthropic as your provider and supply your own API key.\nData sent: post title, content excerpt (~200 words), site name, focus keyword.\nWhen: only when an administrator clicks \"Fix with AI\" for a specific issue.\nProvider: Anthropic, PBC.\nService home: https:\/\/www.anthropic.com\/\nPrivacy policy: https:\/\/www.anthropic.com\/privacy\nTerms of use: https:\/\/www.anthropic.com\/legal\/consumer-terms<\/p>\n\n<p><strong>4. Internal link checker \u2014 this free plugin<\/strong>\nDuring a site audit, the plugin uses WordPress's built-in <code>wp_remote_head()<\/code> to check links found in post content. Only URLs that begin with your own <code>home_url()<\/code> are ever requested \u2014 the checker is strictly limited to your site's own pages. No data leaves your server to any third party.<\/p>\n\n<p><strong>5. ThemeMiles.com \u2014 upgrade links in this free plugin<\/strong>\nThe 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.\nPrivacy policy: https:\/\/thememiles.com\/privacy-policy\/<\/p>\n\n<p><strong>6. WordPress.org \u2014 review nudge link in this free plugin<\/strong>\nAfter sufficient usage, an admin notice contains an HTML link to the plugin's WordPress.org reviews page. No data is transmitted automatically.<\/p>\n\n<p><strong>7. Google Search Console API \u2014 ThemeMiles SEO Agent Pro only<\/strong>\nThemeMiles 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.\nGoogle Privacy policy: https:\/\/policies.google.com\/privacy<\/p>\n\n<p><strong>8. Google PageSpeed Insights API \u2014 ThemeMiles SEO Agent Pro only<\/strong>\nThe 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.\nGoogle Privacy policy: https:\/\/policies.google.com\/privacy<\/p>\n\n<p><strong>9. DataForSEO API \u2014 ThemeMiles SEO Agent Pro optional<\/strong>\nCompetitor 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.\nService home: https:\/\/dataforseo.com\/\nPrivacy policy: https:\/\/dataforseo.com\/privacy-policy\/<\/p>\n\n<h3>Source Code<\/h3>\n\n<p>The unminified JavaScript source files and webpack build configuration for this plugin are publicly available at:\nhttps:\/\/bitbucket.org\/thememile\/plugin-autoseo-agent<\/p>\n\n<p>To rebuild the compiled assets from source:\n1. Clone the repository\n2. Run <code>npm install<\/code>\n3. Run <code>npm run build<\/code><\/p>\n\n<!--section=installation-->\n<h4>Method 1: Install directly from WordPress Admin (recommended)<\/h4>\n\n<ol>\n<li>Log in to your WordPress admin dashboard.<\/li>\n<li>Navigate to <strong>Plugins &gt; Add New Plugin<\/strong>.<\/li>\n<li>Type <strong>ThemeMiles SEO Agent<\/strong> in the search box.<\/li>\n<li>Click <strong>Install Now<\/strong> next to the ThemeMiles SEO Agent result by ThemeMiles.<\/li>\n<li>Click <strong>Activate Plugin<\/strong>, then go to <strong>ThemeMiles SEO Agent &gt; Dashboard<\/strong> and click <strong>Run Audit Now<\/strong> to scan your site.<\/li>\n<\/ol>\n\n<h4>Method 2: Manual upload via FTP or cPanel<\/h4>\n\n<ol>\n<li>Download <code>thememiles-seo-agent.zip<\/code> from the WordPress.org plugin repository.<\/li>\n<li>Log in to your WordPress admin dashboard.<\/li>\n<li>Go to <strong>Plugins &gt; Add New Plugin &gt; Upload Plugin<\/strong>.<\/li>\n<li>Click <strong>Choose File<\/strong>, select the downloaded zip, then click <strong>Install Now<\/strong>.<\/li>\n<li>Click <strong>Activate Plugin<\/strong>, then go to <strong>ThemeMiles SEO Agent &gt; Dashboard<\/strong> and click <strong>Run Audit Now<\/strong> to scan your site.<\/li>\n<\/ol>\n\n<h4>After Activation<\/h4>\n\n<ol>\n<li>The onboarding wizard detects your active SEO plugin (Yoast SEO, Rank Math, or All in One SEO) automatically.<\/li>\n<li>Optionally enter your AI provider API key (OpenAI, Anthropic, or Groq) to unlock 15 free AI-generated fixes per month.<\/li>\n<li>Choose a weekly audit schedule, or click <strong>Run Audit Now<\/strong> to start immediately.<\/li>\n<li>Review your SEO Brain priority tiers \u2014 start with <strong>Fix Immediately<\/strong> issues for the highest impact.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20thememiles%20seo%20agent%20replace%20yoast%20seo%2C%20rank%20math%2C%20or%20all%20in%20one%20seo%3F\"><h3>Does ThemeMiles SEO Agent replace Yoast SEO, Rank Math, or All in One SEO?<\/h3><\/dt>\n<dd><p>No \u2014 it works <em>alongside<\/em> your existing SEO plugin, not instead of it. ThemeMiles SEO Agent detects which SEO plugin you have active and reads from its meta fields. With an API key configured it writes AI-generated fixes directly to those same meta fields (15\/month free, unlimited in Pro). Your SEO plugin handles how tags appear on the front end; ThemeMiles SEO Agent tells you what's wrong and fixes it. You must keep your SEO plugin active.<\/p><\/dd>\n<dt id=\"how%20does%20the%20two-plugin%20model%20work%3F\"><h3>How does the two-plugin model work?<\/h3><\/dt>\n<dd><p>ThemeMiles SEO Agent (this plugin, free on WordPress.org) handles site auditing, priority scoring, and reporting. It is fully functional on its own \u2014 no Pro licence required.<\/p>\n\n<p>ThemeMiles SEO Agent Pro is a <strong>separate premium plugin<\/strong> available at thememiles.com. It removes the 15-fix monthly cap, adds a Fix Queue (review every suggestion before it is applied), rollback, unlimited field types, Google Search Console integration, schema generation, and more. The two plugins share the same database tables, so you install one <em>or<\/em> the other \u2014 not both. Switching from free to Pro (or back) preserves all your audit history and issues data completely.<\/p><\/dd>\n<dt id=\"what%20exactly%20does%20the%20free%20version%20detect%20and%20report%3F\"><h3>What exactly does the free version detect and report?<\/h3><\/dt>\n<dd><p>The free plugin runs a 12-check audit on every published post, page, and WooCommerce product:<\/p>\n\n<ol>\n<li><strong>Meta title<\/strong> \u2014 missing, or outside the 30\u201365 character range<\/li>\n<li><strong>Meta description<\/strong> \u2014 missing, or outside the 50\u2013160 character range<\/li>\n<li><strong>Duplicate meta description<\/strong> \u2014 same description text used on multiple posts<\/li>\n<li><strong>Missing focus keyword<\/strong> \u2014 no focus keyword set in your SEO plugin<\/li>\n<li><strong>Image alt text<\/strong> \u2014 images in post content or attached to the post with no alt attribute<\/li>\n<li><strong>Schema markup<\/strong> \u2014 no JSON-LD or SEO plugin schema detected on the post<\/li>\n<li><strong>Open Graph tags<\/strong> \u2014 missing OG title or OG description for social sharing<\/li>\n<li><strong>Thin content<\/strong> \u2014 post word count below 300 words<\/li>\n<li><strong>Duplicate Title \/ H1<\/strong> \u2014 the post title and the first H1 in the content are identical<\/li>\n<li><strong>Missing canonical URL<\/strong> \u2014 no canonical set in your SEO plugin<\/li>\n<li><strong>Broken internal links<\/strong> \u2014 up to 10 internal URLs per post checked for 404 responses<\/li>\n<li><strong>Keyword absent from title<\/strong> \u2014 the focus keyword does not appear in the meta title<\/li>\n<\/ol>\n\n<p>Every issue gets a 0\u2013100 priority score and a tier label (Fix Immediately \/ Fix This Week \/ Fix When Possible \/ Low Priority). You also get a site-wide health score from 0 to 100.<\/p><\/dd>\n<dt id=\"how%20much%20does%20the%20ai%20cost%20to%20use%3F\"><h3>How much does the AI cost to use?<\/h3><\/dt>\n<dd><p>Both the free plugin and Pro use a <strong>BYOK (Bring Your Own Key)<\/strong> model \u2014 you sign up directly with OpenAI, Anthropic, or Groq, supply your own API key in Settings, and pay the provider directly for any usage. ThemeMiles SEO Agent never marks up or resells API credits.<\/p>\n\n<p>The <strong>free plugin<\/strong> allows up to <strong>15 AI-generated fixes per month<\/strong> at no cost from ThemeMiles. Each fix sends a small amount of post content to your chosen AI provider. A typical fix \u2014 meta title or meta description \u2014 costs roughly <strong>$0.001\u2013$0.003<\/strong> using GPT-4o-mini. Groq's free tier makes fixes effectively <strong>$0.00<\/strong>. The monthly counter resets on the 1st of each month.<\/p>\n\n<p><strong>ThemeMiles SEO Agent Pro<\/strong> removes the monthly cap and unlocks all field types (alt text, schema, OG tags, focus keyword, and more) with no per-fix limit.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20woocommerce%20products%3F\"><h3>Does it work with WooCommerce products?<\/h3><\/dt>\n<dd><p>Yes. The audit engine scans WooCommerce product post types alongside posts and pages. If you use Yoast SEO for WooCommerce, Rank Math, or AIOSEO alongside WooCommerce, ThemeMiles SEO Agent reads from and writes AI-generated fixes to the correct meta keys for each SEO plugin automatically (15 fixes\/month free, unlimited in Pro).<\/p><\/dd>\n<dt id=\"can%20i%20undo%20an%20ai%20fix%20if%20i%20don%27t%20like%20the%20result%3F\"><h3>Can I undo an AI fix if I don't like the result?<\/h3><\/dt>\n<dd><p>Rollback is a <strong>ThemeMiles SEO Agent Pro<\/strong> feature. Pro takes a snapshot of the original field value before applying any fix; you can roll back a single fix, every fix from an entire audit run, or all fixes on a specific post \u2014 at any time from the Fix History page. The free plugin applies fixes immediately without a snapshot, so rollback is not available in the free version.<\/p><\/dd>\n<dt id=\"will%20thememiles%20seo%20agent%20slow%20down%20my%20website%3F\"><h3>Will ThemeMiles SEO Agent slow down my website?<\/h3><\/dt>\n<dd><p>No. ThemeMiles SEO Agent is entirely an admin-side tool. It adds zero JavaScript, CSS, or hooks to your public-facing site. Audits run in the background using WP-Cron, processing posts in batches of 50. Front-end visitors see no impact whatsoever.<\/p><\/dd>\n<dt id=\"what%20happens%20to%20my%20pro%20licence%20when%20it%20expires%3F\"><h3>What happens to my Pro licence when it expires?<\/h3><\/dt>\n<dd><p>When a ThemeMiles SEO Agent Pro licence expires, AI fix generation and auto-apply are disabled until you renew. You can still view all audit results and fix history. All your data \u2014 issues, fixes, snapshots, audit runs \u2014 stays intact in the database. If you switch back to the free plugin instead of renewing, it continues reading from the same tables, so your audit history is fully preserved.<\/p><\/dd>\n<dt id=\"how%20is%20thememiles%20seo%20agent%20different%20from%20alli%20ai%20or%20other%20ai%20seo%20tools%3F\"><h3>How is ThemeMiles SEO Agent different from Alli AI or other AI SEO tools?<\/h3><\/dt>\n<dd><p>A few key differences: ThemeMiles SEO Agent integrates natively with Yoast SEO, Rank Math, and AIOSEO \u2014 fixes are written to those plugins' own meta keys, not to a separate meta layer. The BYOK model means you pay the AI provider directly with no per-fix mark-up. In Pro, every generated fix goes through a Fix Queue so you can review it before it is applied. The free tier includes a full audit engine, priority scoring, and 15 AI fixes per month at no cost from ThemeMiles \u2014 most comparable tools require a paid subscription just to see detected issues.<\/p><\/dd>\n<dt id=\"is%20it%20beginner-friendly%3F\"><h3>Is it beginner-friendly?<\/h3><\/dt>\n<dd><p>Yes. The audit results page puts Fix Immediately issues at the top, so you always know where to start. No API key is required to run your first audit \u2014 just activate and click <strong>Run Audit Now<\/strong>. An onboarding wizard walks you through SEO plugin detection and schedule setup step by step. Once you have results, add a free Groq API key in Settings to unlock the <strong>Fix with AI<\/strong> button and apply fixes in one click (15\/month free). Audit results show the current field value and the recommended range in plain language.<\/p><\/dd>\n<dt id=\"does%20it%20work%20on%20wordpress%20multisite%3F\"><h3>Does it work on WordPress Multisite?<\/h3><\/dt>\n<dd><p>The plugin is designed for standard single-site installations. While it may function on individual network sites within a Multisite setup, a network-wide dashboard and centralised scanning are not included in the current version. ThemeMiles SEO Agent Pro's Business and Agency plans include an agency-style dashboard for managing multiple separate single-site installations.<\/p><\/dd>\n<dt id=\"will%20my%20audit%20data%20be%20preserved%20when%20i%20upgrade%20from%20free%20to%20pro%3F\"><h3>Will my audit data be preserved when I upgrade from free to Pro?<\/h3><\/dt>\n<dd><p>Yes, completely. Both plugins use identical database table names \u2014 <code>wp_autoseo_issues<\/code>, <code>wp_autoseo_fixes<\/code>, <code>wp_autoseo_snapshots<\/code>, and <code>wp_autoseo_audit_runs<\/code>. When you install ThemeMiles SEO Agent Pro (which deactivates and replaces the free plugin), it reads from and writes to the exact same tables. Every detected issue, audit run, manually resolved item, and ignored issue is preserved with no migration needed.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.4<\/h4>\n\n<ul>\n<li>Updated: readme Screenshots section revised to reflect the 4 current admin screenshots (Dashboard, SEO Audit health score, SEO Audit issue list, Settings AI Configuration).<\/li>\n<\/ul>\n\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>Fixed: Pro upgrade URL corrected to https:\/\/thememiles.com\/thememiles-seo-agent-pro\/ throughout readme.<\/li>\n<li>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) \u2014 all three providers listed with terms and privacy policy links.<\/li>\n<li>Updated: readme description, tagline, FAQ, and BYOK model explanation corrected to reflect that AI fix generation (15\/month) is included in the free plugin.<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Fixed: Plugin URI updated from \/autoseo-agent\/ to \/thememiles-seo-agent\/ in plugin header and readme.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Fixed: all admin scripts and styles now enqueued via <code>wp_add_inline_script()<\/code> \/ <code>wp_add_inline_style()<\/code> instead of raw HTML tags, per WordPress.org guidelines.<\/li>\n<li>Fixed: all <code>$wpdb<\/code> queries use <code>%i<\/code> placeholder for table names instead of variable interpolation.<\/li>\n<li>Fixed: non-prefixed variables renamed in view and uninstall files.<\/li>\n<li>Removed: <code>load_plugin_textdomain()<\/code> call (deprecated since WordPress 4.6).<\/li>\n<li>Changed: background audit job uses WP-Cron instead of Action Scheduler.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<p>Initial release.<\/p>\n\n<p><strong>Audit engine<\/strong><\/p>\n\n<ul>\n<li>12-check site-wide SEO audit: meta title (30\u201365 chars), meta description (50\u2013160 chars), duplicate meta descriptions, missing focus keyword, image alt text (post content + attached media), schema \/ JSON-LD markup, Open Graph tags, thin content (&lt;300 words), duplicate Title\/H1, missing canonical URL, broken internal links (404 check, up to 10 per post), focus keyword in title.<\/li>\n<li>Auto-detects active SEO plugin: Yoast SEO, Rank Math, All in One SEO. Falls back to Yoast meta keys.<\/li>\n<li>Audits published posts, pages, and WooCommerce products in one pass.<\/li>\n<li>Batch processing (50 posts per batch) via WP-Cron \u2014 no server timeout on large sites.<\/li>\n<li>Auto-resolves open issues on re-audit when the underlying problem is corrected.<\/li>\n<\/ul>\n\n<p><strong>SEO Brain Priority Scoring<\/strong><\/p>\n\n<ul>\n<li>0\u2013100 priority score per issue: traffic weight (post type proxy; GSC data in Pro) + ranking opportunity (positions 4\u201310 score highest) + issue severity (critical\/major\/minor) + fix effort (AI-fixable issues score highest).<\/li>\n<li>Four priority tiers: Fix Immediately (&gt;=75), Fix This Week (&gt;=50), Fix When Possible (&gt;=25), Low Priority (&lt;25).<\/li>\n<li>Site-wide rescore job runs automatically after every audit and can be triggered manually.<\/li>\n<li>Brain summary transient cached for 1 hour for instant dashboard loads.<\/li>\n<\/ul>\n\n<p><strong>Admin UI<\/strong><\/p>\n\n<ul>\n<li>Dashboard: 0\u2013100 health score SVG gauge (stroke-dasharray), SEO Brain summary bar, top-issue cards, last audit timestamp, run-audit button with live polling.<\/li>\n<li>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.<\/li>\n<li>Fix Queue: free upgrade-preview page showing real issue values alongside blurred Pro suggestions, feature comparison, estimated AI cost, and upgrade CTA.<\/li>\n<li>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.<\/li>\n<li>Upgrade to Pro: three-plan pricing grid (Pro \/ Business \/ Agency), per-plan feature checklists, FAQ section, 7-day money-back notice.<\/li>\n<li>Onboarding wizard: multi-step modal on first activation \u2014 SEO plugin detection, API key setup, audit schedule, first audit trigger.<\/li>\n<li>Dismissible free upgrade banner on all AutoSEO admin pages (per-user, 15-minute cool-down after dismissal).<\/li>\n<li>Review nudge: shown to admins after 5+ applied fixes and 14+ days active, with \"Remind me in 30 days\" option.<\/li>\n<\/ul>\n\n<p><strong>Data and infrastructure<\/strong><\/p>\n\n<ul>\n<li>Four database tables created on activation: <code>wp_autoseo_issues<\/code>, <code>wp_autoseo_fixes<\/code>, <code>wp_autoseo_snapshots<\/code>, <code>wp_autoseo_audit_runs<\/code>.<\/li>\n<li>DB version check on every load via <code>maybe_upgrade()<\/code> \u2014 runs <code>dbDelta()<\/code> only when needed.<\/li>\n<li>WP-Cron used for reliable background job processing.<\/li>\n<li>Weekly scheduled audit with configurable time of day (settings-driven).<\/li>\n<li>REST API: 11 endpoints under <code>autoseo\/v1\/<\/code> \u2014 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.<\/li>\n<li>License controller is a pure stub in the free plugin \u2014 returns <code>plan: free<\/code> with zero HTTP requests.<\/li>\n<li>PSR-4 autoloader with <code>vendor\/autoload.php<\/code> fallback to manual <code>spl_autoload_register<\/code>.<\/li>\n<li>Full uninstall cleanup via <code>uninstall.php<\/code>: drops all four tables, deletes all plugin options, removes all <code>_transient_autoseo_*<\/code> and <code>_transient_timeout_autoseo_*<\/code> entries.<\/li>\n<\/ul>","raw_excerpt":"Full site SEO audit with priority scoring and 15 free AI fixes\/month. Find broken meta, thin content, missing schema \u2014 no API key needed to audit.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/347369","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=347369"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/thememiles"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=347369"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=347369"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=347369"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=347369"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=347369"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=347369"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}