Audit Your Website With the Claude SEO Plugin

Claude SEO is a free plugin that turns Claude Code into a website audit tool. You will install it, check one page, run a full audit, and end with a short list of three fixes tied to the pages they affect.

What this helps you do

SEO tools usually hand you a long list of warnings with no order. This setup gives you a starting point instead.

Claude SEO looks for three kinds of problems:

• Technical problems: pages search engines cannot reach or index, broken redirects, missing sitemaps, and slow pages.
• Missing metadata: the title and description search engines show in results, plus structured data that helps them understand a page.
• Content that is hard to find: thin pages, weak topic coverage, and pages AI search tools are unlikely to quote.

Then you ask one question that turns the report into a short, ordered to-do list for your own site.

Before you start

• Claude Code, version 1.0.33 or newer, installed and signed in. New to it? Start with the Claude setup checklist.
• Python 3.11 to 3.14 on your computer. The plugin's setup command installs everything else it needs.
• A website you own or manage, and its address.
• A paid Claude plan or API usage. The plugin is free and MIT licensed, with no per-site fees. Audits use your Claude plan, and a full audit uses more of it than a single-page check.

Terms to know

• SEO (search engine optimization): making your pages easier for search engines to find, understand, and show.
• Plugin: an add-on for Claude Code that brings new commands and skills.
• Slash command: a command that starts with /, typed into Claude Code, such as /seo audit.
• Metadata: the title and description search engines show for a page. They live in the page's code, not in the visible text.
• Indexing: a search engine saving your page so it can appear in results.
• Structured data: extra labels in a page's code that tell search engines what the page is, such as a product, an article, or a local business.
• Core Web Vitals: Google's measures of how fast and stable a page feels to visitors.

Step-by-step

1. Open Claude Code. In Terminal, type claude and press Enter. You should see the Claude Code prompt.

2. Add and install the plugin. Type these two commands into Claude Code, one at a time:

   /plugin marketplace add AgriciDaniel/claude-seo
   /plugin install claude-seo@agricidaniel-claude-seo

3. Run setup. Type /seo setup. It creates the plugin's own Python environment and a headless browser (a browser with no window that the plugin uses to load your pages) without changing the rest of your system. Type /seo doctor any time to check it is ready.

4. Check one page first. Type /seo page followed by the address of one important page, such as /seo page https://yoursite.com/pricing. Read the findings so you know what the output looks like.

5. Run the full audit. Type /seo audit https://yoursite.com. A full audit takes about 10 to 15 minutes while several agents check different parts of the site. You get a report saved as Markdown files on your computer.

6. Ask for the top three. Paste the prompt from the Copy this section. You should get three fixes, each with the pages it affects and why it comes first.

7. Check each finding yourself. Before you change anything, open each listed page in your browser and confirm the problem is real.

The full command list is in the Claude SEO repository on GitHub. Type /seo in Claude Code to see it too.

Copy this

Paste this into Claude Code right after the audit finishes, in the same session. Replace the bracketed part with your site's address.

Using the Claude SEO audit you just ran on [YOUR WEBSITE], which three fixes would you do first, and show me the pages they affect? For each fix, give me: the problem in plain language, the exact pages affected, why it ranks in the top three, what to change, and how I can check that the fix worked. Base every point on what you found on my site, not on general SEO advice. Do not change any files yet.

Things to know

• Start small. One page first shows you the format and costs less of your plan than a full audit.
• The findings are a starting point, not a verdict. Pages that load content only after scrolling or clicking can give noisy results. Confirm each problem on the live page.
• Speed scores are estimates by default. Without Google API keys, Core Web Vitals are lab estimates and indexing is inferred. To use real data from Google's free tools, run /seo google setup. Your keys stay on your computer.
• Your pages go to Claude. The plugin runs inside Claude Code, so the pages it analyzes are sent to Claude like anything else you work on there. Reports stay on your computer.
• Optional extensions connect to paid services. Everything above works without them.
• Fix one thing at a time. Change one item, check it, then move to the next. That way you know which change helped.

Want more plugins worth trying? See Claude Code plugins and skills to review.

If something goes wrong

• The /plugin command is not recognized: update Claude Code to version 1.0.33 or newer, then try again.
• /seo commands do not appear after installing: close Claude Code, open it again with claude, and type /seo.
• Setup fails: check your Python version with python3 --version in Terminal. It needs to be 3.11 to 3.14. Then run /seo doctor for the exact missing piece.
• The audit misses content on your pages: the page may load content only after a click or scroll. Run /seo page on that page and compare the findings with what you see in your browser.
• You get a long generic list: paste the Copy this prompt again and add, "Only include fixes that name a specific page on my site."

Final check

Pass if you have three fixes, each tied to specific pages on your site, in the order you will do them, and you have opened every one of those pages to confirm the problem is real.