Many WordPress SEO problems are not in your posts at all. They come from thousands of thin tag archives, attachment pages, paginated duplicates or plugin-generated URLs. This agent is read-only and scoped to that WordPress-specific layer.
When to use the WordPress SEO Auditor agent
- Search Console shows many crawled-but-not-indexed or duplicate pages
- Traffic dropped after a theme or plugin change
- Before a migration or redesign, to know what WordPress generates today
- A site with years of tags, categories and archives
What is in the agent file
| Name | wordpress-seo-auditor |
|---|---|
| Tools | Read, Grep, Glob, WebFetch, WebSearch. No write or edit tools, so it reports and does not change files. |
| Model | sonnet, up to 35 turns per task |
| Kit | Platform kit, 97 lines |
How it works. Beyond its role statement, the file sets out 4 rules it follows: What WordPress generates that you must inventory; Sampling requirement; Severity rubric; Prioritization.
What it reports. Every run ends in the same structure: WordPress context, Generated page inventory, Sampling, Findings, Prioritization, Out of scope.
Excerpt from the agent file
The settings and opening instructions, as they appear in .claude/agents/wordpress-seo-auditor.md:
---
name: wordpress-seo-auditor
description: Audits a WordPress site for SEO issues arising from WordPress itself — taxonomies, archives, pagination, plugin-generated pages and theme output — and prioritizes fixes by impact. Invoke by name for a WordPress-specific SEO review. For general SEO diagnosis, prefer the Claude SEO plugin.
model: sonnet
maxTurns: 35
tools: Read, Grep, Glob, WebFetch, WebSearch
---
You are a WordPress SEO Auditor. Your scope is **what WordPress generates** — the pages, URLs and metadata that exist because of WordPress, not general SEO analysis.
> **Scope note.** If the Claude SEO plugin is installed, use it for general technical SEO, content quality, schema and AI-search analysis — it has deeper tooling and verified thresholds. This agent covers what it does not: the WordPress-specific origin of a problem, and the WordPress-side fix.
1. Establish the WordPress context — theme, SEO plugin, page builder, key plugins, multisite.
2. Inventory what WordPress is generating (table below). This is where WordPress-specific SEO problems live.
3. Sample representative URLs per template type, not one URL.
4. Check indexability, duplication and crawl waste across those types.
5. Prioritize by impact, confidence and effort.
6. Give the WordPress-side fix, with its validation step.The full file continues with the rules above and the exact report format. It is included in the Agentsforce kit.
Example requests
Name the agent to be sure Claude uses it, or describe the task and let its description trigger it:
- "Use wordpress-seo-auditor to inventory every page type this site generates."
- "Our tag archives may be thin. Sample them and tell me whether to noindex them."
- "Use wordpress-seo-auditor to check pagination and canonical tags on the blog."
- "Find which plugin creates these /?attachment_id URLs and how to stop them being indexed."
When to use a different agent
| If you need | Use instead |
|---|---|
| General SEO strategy and keyword research | Its own file points to a general SEO plugin or marketing-strategist for that |
| Rewriting a page that lost traffic | Use wordpress-content-refresh |
| Fixing the code that causes the problem | Use wordpress-technical-seo, which edits and tests |
Works well with
- WordPress Plugin Engineer: builds plugins that are safe on a shared, global codebase
- Code Reviewer: checks what a change did, not whether a file looks fine
- Tech Lead: plans work instead of writing it
Related playbooks in the kit, which Claude loads when the task calls for them: wp-performance-tuning, wp-hooks-filters.
How to get it
- Write your own: the free Subagent Generator drafts a starter wordpress seo auditor file you can edit and save in
.claude/agents/. - Use the tested version: Agentsforce includes this agent with 54 other specialists and 89 playbooks for a one-time $49, installed with one command.
Frequently asked questions
Can Claude Code do an SEO audit of a WordPress site?
It can analyze what you give it: the theme code, crawl exports and URLs it can fetch. This agent reads and fetches pages but has no write tools, so it reports problems and their WordPress-side fixes without changing the site.
What tools does it use?
Read, Grep and Glob for your theme and plugin code, and WebFetch and WebSearch to look at live pages. It cannot edit files or run shell commands.
Does it replace an SEO plugin like Yoast or Rank Math?
No. Those plugins set titles, sitemaps and meta on the site. This agent audits what WordPress produces, including problems those plugins can create, and tells you what to change.