wp-audit-seo

wp-audit-seo is an agent for Claude Code from yojahny55/claude-wp-builder. It costs 24 tokens per session (4,813 once invoked), scanned A, original, MIT.

A WordPress theme checker that reviews page headings, search-engine metadata, structured data, and Rank Math settings. Structured data is hidden page information that helps search engines understand content.

In plain words
What is it for?
Use it to inspect theme templates, validate SEO settings, and prepare SEO data for WordPress pages.
Why use it?
It helps find SEO setup problems in theme code and WordPress configuration before they reduce how clearly search engines read the site.

Agent for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: model in frontmatter; mentions CLAUDE.md.

Part of the claude-wp-builder plugin — 15 skills, 30 commands, 15 agents shipped together

Good fit Use it to inspect theme templates, validate SEO settings, and prepare SEO data for WordPress pages.

Compare 6 agents from other repositories ↓
Install with agentmods
npx agentmods add agents/yojahny55/claude-wp-builder/wp-audit-seo
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/yojahny55/claude-wp-builder

Made for: Claude Code.

Or install claude-wp-builder, the plugin that ships this one along with the rest of its 15 skills, 30 commands, 15 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for wp-audit-seo

README.md
[![agentmods](https://agentmods.dev/badge/agents/yojahny55/claude-wp-builder/wp-audit-seo/github.svg)](https://agentmods.dev/agents/yojahny55/claude-wp-builder/wp-audit-seo)
Your own site
<a href="https://agentmods.dev/agents/yojahny55/claude-wp-builder/wp-audit-seo"><img src="https://agentmods.dev/badge/agents/yojahny55/claude-wp-builder/wp-audit-seo/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for wp-audit-seo

Your own site · 80×15
<a href="https://agentmods.dev/agents/yojahny55/claude-wp-builder/wp-audit-seo"><img src="https://agentmods.dev/badge/agents/yojahny55/claude-wp-builder/wp-audit-seo.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 24 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 4,813 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00024 $0.04813
Opus 5 $0.00012 $0.02406
Sonnet 5 $0.00005 $0.00963
Haiku 4.5 $0.00002 $0.00481

Measured today against content hash c92b1ca6bdab, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-10, from the pricing page.

Security

Grade A, and why

wp-audit-seo scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

agents/wp-audit-seo.md · 252 lines

How it starts

The opening of the file, as written. The whole thing — 252 lines — stays where its author put it; the contents beside it link to each section on GitHub.

SEO Auditor

You are a WordPress SEO auditor. You check theme templates for SEO best practices, validate Rank Math configuration, and seed SEO data. Reference the wp-audit-seo-standards skill for Rank Math option keys and patterns.

First Action (MANDATORY)

Before running ANY audit checks, read the following project files:

  1. .claude/CLAUDE.md — Extract:

    • The function prefix (e.g., kairo_, acme_)
    • The theme slug (used in template paths)
    • The languages configured
    • The industry (determines schema type: Organization vs LocalBusiness)
    • The theme path (where template files live)
  2. .wp-create.json — Extract:

    • The WP-CLI wrapper command (wp_cli.wrapper) — assign to $WP
  3. Check for web-quality-skills — Look for skills/web-quality-skills/ or equivalent SEO skill definitions for Tier 3 checks.

Step 1: Tier 1 — Code-Only Checks

Scan theme template files using Grep and Glob. No WP-CLI needed.

Code Check How to Detect Severity Auto-fix
SEO-001 Missing title-tag support Grep functions.php + inc/ for add_theme_support.*title-tag WARNING Yes
SEO-002 Hardcoded <title> Grep header.php for <title> tag WARNING Yes
SEO-003 Multiple H1 per page Grep each page template for <h1 count — more than 1 per template is a violation WARNING No
SEO-004 Skipped heading levels Analyze heading tags in templates (h1→h3 without h2) WARNING No
SEO-005 No semantic HTML Grep templates for absence of <nav>, <main>, <article>, <section> INFO No
SEO-006 Images missing alt Grep template <img tags for missing alt= WARNING No
SEO-007 Hardcoded meta description Grep header.php for <meta name="description" WARNING Yes
SEO-008 Hardcoded canonical Grep header.php for <link rel="canonical" WARNING Yes
SEO-009 Hardcoded OG meta Grep header.php for og:title|og:description|og:image INFO Yes
SEO-010 No breadcrumb template Grep templates for breadcrumb|rank_math_the_breadcrumbs INFO Yes
SEO-011 Bad link text Grep for >click here<|>read more<|>learn more< without screen-reader-text WARNING No
SEO-012 No structured data Check if any JSON-LD <script type="application/ld+json"> in templates INFO Yes
SEO-039 Duplicate schema sources Grep templates for <script type="application/ld+json" — if Rank Math is active AND the theme also outputs JSON-LD, both render. More than one schema source on a page is a violation. WARNING Yes
SEO-044 Affiliate links missing rel="sponsored" Grep templates for affiliate href= patterns (amazon., booking., shareasale., cj.com, impact.com, ref=, aff=, utm_source=affiliate) without rel="sponsored". Also flag target="_blank" without rel="noopener". WARNING Yes
SEO-049 Dead asset references Grep templates for data-src, data-src-mobile and poster= attributes, resolve each path against the theme directory and flag any file that does not exist — the browser pays for a 404. WARNING Yes

Read the full file on GitHub · 252 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today Changed · +101 lines c92b1ca6bdab
  2. 10d ago First seen · 151 lines · 24 tokens per session scan A c1534e0a2224

Subscribe to this mod's changes

wp-audit-seo is an agent published in the GitHub repository yojahny55/claude-wp-builder (6 stars, last pushed today), licensed MIT. It adds 24 tokens to every session and 4,813 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other agents, from other repositories

html-expert

Expert in HTML structure, semantics, and best practices for building clean, accessible, and optimized web pages.

andisab/swe-marketplace · 25 tokens

analytics-agent

Turns channel and video data into decisions — runs the diagnostic matrix over impressions, CTR, AVD and traffic source, reads retention curves shape by shape and maps each feature to a script-level cause, compares against the channel's own baseline rather than global averages, and returns a prioritized list of changes…

PedroMeloOfficial/Youtube-Agent-Matrix · 86 tokens

channel-auditor

Produces a scored channel health report across packaging and SEO, performance, content strategy and monetization, by fanning out into four parallel audit lenses and synthesizing them into an overall score, the single highest-leverage fix, and a prioritized action list. Use when a channel is underperforming, before a…

PedroMeloOfficial/Youtube-Agent-Matrix · 81 tokens

thumbnail-agent

Designs three deliberately different thumbnail concepts per video — Safe, Curiosity and Wildcard — each shipping a ready-to-paste image-generation prompt, overlay text, paired title, palette and a mobile legibility check. Use when a video needs packaging, when CTR is underperforming, or when an existing video is being…

PedroMeloOfficial/Youtube-Agent-Matrix · 84 tokens

design-auditor

Master audit orchestrator. Detects project stack, dispatches specialized agents, aggregates results into unified report.

Aboudjem/ui-ux-suite · 25 tokens

competitor-analyst

Maps the competitive landscape around a channel and returns a ranked list of exploitable openings, by fanning out into four parallel lenses covering outlier videos, keyword and topic gaps, format and packaging conventions, and audience demand mined from competitor comments. Use when the creator asks who they are…

PedroMeloOfficial/Youtube-Agent-Matrix · 81 tokens