Audit site SEO is a WordPress ability from Rank Math SEO — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →Audit site SEO
Read-onlyRun Rank Math's site-wide SEO audit and get back a structured score with per-test findings and fix hints.
Requires the Rank Math SEO plugin on WordPress 6.9+ for the Abilities API. AI Visibility abilities require the 'manage_options' capability; Link Genius abilities require 'rank_math_link_builder'; Post SEO abilities require 'rank_math_onpage_general'; Schema abilities require 'rank_math_onpage_snippet'; SEO Analysis abilities require 'rank_math_site_analysis'; Analytics abilities require 'rank_math_analytics'; Content Analysis abilities require 'rank_math_onpage_analysis'. Some outputs (broken-link audit data in get-link-report, extra schema types in get-post-schema) are only populated when Rank Math PRO is active.
What it does
This ability runs Rank Math's built-in site-wide SEO audit, combining local WordPress checks with remote tests from the rankmath.com API, and returns an overall score (0-100), a grade (good/average/bad), counts of tests by status, and a findings array where each entry has a test_id, category, status, score, title, description, fix_text/fix_html, an optional structured fix_hint, a knowledge-base link, and any supporting data. The refresh input (default true) re-runs the audit rather than using a stale cache, and an optional url can scope remote-only tests to a URL other than the site's home page. Each finding's test_id is designed to be passed straight into rank-math/fix-site-seo for one-click remediation. Requires the 'rank_math_site_analysis' capability.
See it in action
You ask your AI assistant
"Run a full site SEO audit and list every failing test along with its fix hint."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| refresh | boolean | No | Re-run the audit. Defaults to true (always fresh when called by an AI host). |
| url | string | No | Optional URL to audit. Defaults to this site's home URL. When provided, only remote API tests run (local checks are site-wide). |
Returns
An object with url, score (0-100), grade (good/average/bad), a statuses breakdown (ok/fail/warning/info counts), total_tests, last_run_at, remote_api_status, a findings array (test_id, category, status, score, title, description, fix_text, fix_html, fix_hint, kb_link, data), and an optional error object.
Permission
Requires the 'rank_math_site_analysis' capability.
More Rank Math SEO abilities
Analyze post content
Gather a post's raw content, metadata, and list of on-page SEO tests so an AI agent can run Rank Math's full on-page analysis itself.
Create AI Visibility brand
Add a new brand to AI Visibility monitoring and automatically kick off its first analysis.
Fix site SEO
Apply an automatic fix for a single failing Rank Math SEO audit test.
Get AI Visibility brand insights
Pull the full AI Visibility analysis for a single brand — score, rank, sentiment, mentions, citations, competitor breakdown, and raw per-query AI responses.
Get AI Visibility brand queries
List the search queries being monitored for a brand's AI Visibility tracking, including which are enabled or auto-generated baselines.
Get AI Visibility overview
Retrieve the site-level AI Visibility summary and every tracked brand's current score, rank, sentiment, and analysis status.