Skip to content
Get packs

Guide · Open source

How to use claude-seo: install and run an SEO audit

Updated · written with AI from the project's own documentation and checked against our catalogue data

Claude SEO is a free, MIT-licensed SEO audit plugin for Claude Code, Anthropic's coding assistant. You point it at a website and it checks technical health, content quality, structured data and how likely AI search tools are to cite your pages. This guide shows you how to get it set up, run an audit and read the prioritized action plan it produces.

Claude SEOAgriciDaniel/claude-seo · ★ 25.8k · MIT

Quick start

  1. 1Check prerequisites. Make sure Claude Code is installed, since the README presents Claude SEO as a Claude Code plugin.
  2. 2Clone the repository. Run the git clone command from the README to download claude-seo from GitHub.
  3. 3Set up the runtime. Run /seo setup to create the isolated Python runtime and Chromium, then /seo doctor to check readiness.
  4. 4Run a full audit. Run /seo audit with your site URL and wait the 10 to 15 minutes the README describes.
  5. 5Review the action plan. Work through the prioritized recommendations, checking the reasons given before making changes.
  6. 6Re-check after changes. Run the relevant command again, such as /seo technical or /seo geo, to see whether the fix registered.

What you need before you install claude-seo

The README presents Claude SEO as a plugin for Claude Code, so Claude Code is the one prerequisite you need. The project is written in Python and is installed by cloning its repository, which is the method the README describes.

  • Claude Code installed and working
  • Git, to clone the repository
  • Access to the website you want to audit

Install claude-seo by cloning the repository

Clone the project from GitHub using the command in the README. This downloads the plugin source to a folder on your machine.

The README also lists a setup command, /seo setup, which creates or refreshes the isolated Python runtime and Chromium. Use /seo doctor to check runtime readiness without changing anything on the system.

git clone https://github.com/AgriciDaniel/claude-seo

Run your first SEO audit

Open Claude Code and type /seo to see every command. To audit a whole site, run /seo audit with the site URL. The README says a full audit takes 10 to 15 minutes and ends with a prioritized action plan, and that it runs parallel agents across the site.

For a narrower check, the README lists single-page analysis with /seo page <url>, and per-area audits such as /seo technical <url>, /seo content <url>, /seo schema <url> and /seo geo <url>.

  • /seo audit <url>: full website audit with parallel agents
  • /seo page <url>: deep single-page analysis
  • /seo technical <url>: technical SEO audit across 9 categories
  • /seo geo <url>: AI Overviews and Generative Engine Optimization
/seo audit <url>

Read the action plan

The audit output is designed to be a prioritized fix list rather than a raw data dump. The README says each recommendation explains why it matters and how you will know it worked.

Treat the output as advice. The README is clear that the audit is advisory and does not promise rankings, so check suggested changes against your own data before you make them.

  • Start with the highest-priority items in the plan
  • Check each recommendation's stated reason before acting
  • Re-run the relevant check after a fix to confirm the change

Use optional extensions for live SEO data

The README describes nine optional extensions for live SEO data. They are separate from the core audit, so you only need them if you want that data. The README lists Google APIs among the covered areas, including Search Console, PageSpeed, CrUX, Indexing and GA4, through /seo google.

For ongoing work, /seo drift baseline, /seo drift compare and /seo drift history <url> monitor changes over time using SQLite snapshots.

  • Google APIs via /seo google: GSC, PageSpeed, CrUX, Indexing, GA4, PDF reports
  • Change monitoring via /seo drift with SQLite snapshots
/seo drift baseline <url>

What people use it for

  • An SEO consultant running a first-call audit and sharing a prioritized fix list with a client
  • An in-house team getting a second review of a site before publishing or making changes
  • An agency running recurring audits and change monitoring with /seo drift for its clients
  • A developer who already uses Claude Code and wants SEO checks without leaving the tool

Frequently asked questions

Is claude-seo free?

Yes. The README describes Claude SEO as free and open source, and the repository is licensed under MIT. The README's pricing section is linked from the header, but the content provided here does not list any paid tiers.

What do I need to run claude-seo?

The README lists Claude Code as the prerequisite, since Claude SEO is a plugin for it. Installation is done by cloning the GitHub repository with git.

How long does a claude-seo audit take?

The README says a full audit takes 10 to 15 minutes and ends with a prioritized action plan. Narrower commands such as /seo page or /seo technical cover less ground.

Do I need extensions to use claude-seo?

No. The README describes the nine live-data extensions as separate and optional. The core audit runs without them.

Does claude-seo guarantee higher rankings?

No. The README makes no ranking promise and describes the audit as advisory, so treat the action plan as recommendations to test rather than guaranteed results.

How does claude-seo compare to Screaming Frog or Lighthouse?

Screaming Frog SEO Spider, Lighthouse and Ahrefs Webmaster Tools are comparable tools. Ahrefs Webmaster Tools is not open source, while claude-seo is MIT-licensed and runs inside Claude Code. Choose based on whether you want an AI-driven audit inside Claude Code or a standalone crawler or performance tool.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Claude SEO suits developers and SEO consultants who already use Claude Code and want a quick, prioritized first audit with AI search checks included. If you do not use Claude Code, or you need live search data without setting up the optional extensions, pick a standalone crawler or tool such as Screaming Frog, Lighthouse or Ahrefs Webmaster Tools instead.

Install options & downloads