Claude Code · APR 14, 2026

How to run a full SEO audit in Claude Code and get a hosted report link

Install the SEO audit skill from GitHub, run one slash command, and get a hosted dashboard back instead of a messy terminal dump. Includes the exact install commands and the other SEO workflows worth using on your site.

@atareh

APR 14, 2026 · 5 min read

Claude CodeSEOAI Workflow

What this skill actually does

This is a Claude Code SEO skill that crawls your website, scores the important categories, writes a full audit, builds an action plan, and then publishes the result to a hosted dashboard instead of dumping everything into the terminal.

The version I set up lives on GitHub and ships with a hosted report flow, which means the handoff is much cleaner: you run one command, wait for the audit, then get a link you can bookmark or send to a client.

If you want the repo first, here it is: github.com/atareh/SEO-audit

Step 1: install it from GitHub

The fastest path is to install it straight from the GitHub repo.

Clone the repo

Prompt

git clone --depth 1 https://github.com/atareh/SEO-audit.git

This pulls down the hosted-report version of the SEO skill, including the scripts that package the audit and publish the dashboard link.

Run the installer

Prompt

bash SEO-audit/install.sh

The installer drops the skill into Claude's command/skill system so you can call the SEO commands directly inside Claude Code.

Step 2: run the SEO audit

Once the skill is installed, the main command is just one line. Point it at your homepage and let it crawl, score, and summarize the site.

Run the full audit

Prompt

/seo-audit https://yourwebsite.com

This runs the full-site audit. It checks technical SEO, content quality, on-page SEO, structured data, performance, AI search readiness, and image issues.

Let the audit finish

The audit creates local backup files too, but the normal handoff is not supposed to be a giant terminal readout anymore.

FULL-AUDIT-REPORT.md for the detailed findings
ACTION-PLAN.md for the prioritized fixes
hosted-audit-report.json for the published dashboard payload

Step 3: open the hosted report

After the audit finishes, the skill publishes the results to the hosted app and gives you a link. That link is the real deliverable.

Expect a website link back

Prompt

View your report: https://www.myseoaudit.xyz/reports/...

The audit is designed to return the hosted report URL as the main handoff, with the local markdown files acting as backups or implementation docs.

Use the dashboard for the summary

The hosted page gives you the high-level story: overall score, category breakdown, quick wins, biggest blockers, first-sprint recommendations, and a cleaner dashboard view for clients or teammates.

Use the markdown files for implementation

The full markdown report is still useful. Download or hand those files to an agent and tell it to work through the critical and week-one items first.

Step 4: use the other commands on your site

The full audit is the headline command, but the skill also ships with a bunch of smaller workflows you can run on the same website depending on what you're trying to improve.

Single-page and technical checks

/seo page https://yourwebsite.com/page — deep page analysis
/seo technical https://yourwebsite.com — crawlability, canonicals, redirects, security, CWV
/seo images https://yourwebsite.com — alt text, image weight, formats, lazy loading

Content, schema, and AI search

/seo content https://yourwebsite.com — E-E-A-T and thin content checks
/seo schema https://yourwebsite.com — structured data detection and recommendations
/seo geo https://yourwebsite.com — AI search readiness, llms.txt, citability, entity clarity

Sitemaps, planning, and growth workflows

/seo sitemap https://yourwebsite.com/sitemap.xml — validate an existing sitemap
/seo sitemap generate — generate a new sitemap structure
/seo plan saas — strategic roadmap for a site type
/seo competitor-pages generate — create comparison-page ideas
/seo hreflang https://yourwebsite.com — international SEO audit

Google and backlink extensions

/seo google [command] — Search Console, PageSpeed, CrUX, GA4, indexation data
/seo backlinks https://yourwebsite.com — referring domains, anchors, authority, toxic links
/seo local https://yourwebsite.com — local SEO and map pack checks

What to do next

If you just want the fastest path, do this in order:

Install the skill from the GitHub repo
Run /seo-audit https://yourwebsite.com
Open the hosted report link it gives you
Hand the markdown files to an agent to implement the critical fixes

That's the whole loop: install once, audit any site, get a dashboard, then use the smaller commands when you want to go deeper on one part of the website.

Written by

@atareh

AI architect & creator. Writing, designing, and producing in AI and tech. Previously head of product at a healthtech SaaS; background in molecular science. Founded gogray.today in 2017.

x / twitter instagram email

Keep reading.

01 · 2026-04-25

HyperFrames: turn any website into an MP4 video

5 min read

02 · 2026-03-30

I designed 4 website concepts in 2 prompts using Claude Code + Paper Design

6 min read

03 · 2026-03-28

Use Claude Code as your CMS: turn a cloned site into a dynamic one

7 min read

Made by @atareh · x / twitter · instagram