The Claude Code SEO Skill is a custom slash-command integration that runs SEO Score API audits directly in your terminal — no browser tabs, no copy-pasting URLs, no context switching. It supports single-URL audits, batch checks, site comparisons, and specific signal inspections.
Built as a wrapper around SEO Score API, the skill translates natural-language requests into API calls and formats results as readable terminal output. Type /seo-score, describe what you want, and get structured scores and priorities in seconds.
<div style="position:relative;padding-bottom:56.25%;height:0;overflow:hidden;max-width:100%;margin:2rem 0;border-radius:8px;"> <iframe style="position:absolute;top:0;left:0;width:100%;height:100%;border:0;border-radius:8px;" src="https://www.youtube.com/embed/C6LbxQ6pcvM" title="Claude Code SEO Skill Demo" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe> </div>
What Is the Claude Code SEO Skill?
The Claude Code SEO skill is a custom slash-command integration that lets you run SEO audits directly inside Claude Code sessions. The skill is a wrapper around the SEO Score API — it translates natural language requests into API calls and formats the results as readable terminal output, without requiring you to leave your coding environment.
The skill supports auditing individual URLs, batch-checking multiple pages, comparing two sites side by side, and inspecting specific SEO signals like meta tags, heading structure, and canonical configuration. It's designed for developers who want SEO data inline with their workflow, not as a separate tool to manage.
How Do You Install the SEO Score Skill in Claude Code?
Installing the skill takes under two minutes. Clone or download the skill files into your Claude Code skills directory:
mkdir -p ~/.claude/skills/seo-score/scripts
curl -sL https://seoscoreapi.com/skills/seo-score/SKILL.md \
-o ~/.claude/skills/seo-score/SKILL.md
curl -sL https://seoscoreapi.com/skills/seo-score/seo_audit.py \
-o ~/.claude/skills/seo-score/scripts/seo_audit.py
chmod +x ~/.claude/skills/seo-score/scripts/seo_audit.py
Then set your API key as an environment variable:
export SEO_SCORE_API_KEY="your_key_here"
The API key is optional for single URL audits — the skill uses the demo endpoint if no key is present, which allows a few free audits without signup. For batch audits, comparisons, and higher volume use, you'll need a key. Get one free at seoscoreapi.com.
Once installed, restart Claude Code and the /seo-score command becomes available in any session.
What Commands Does the SEO Score Skill Support?
The skill responds to natural language, so you don't need to memorize a command syntax. These phrasings all work:
Audit a URL:
"Audit https://example.com""Check the SEO score for my homepage""What's the SEO score for this URL?"
Batch check multiple pages:
"Audit these five URLs: [list]""Check SEO for all pages in my sitemap""Run a batch audit on these pages"
Compare two sites:
"Compare https://mysite.com vs https://competitor.com""Which site scores better for SEO?""Show me the SEO difference between these two domains"
Inspect specific signals:
"What meta tags does example.com use?""Check if this page has a canonical tag""Show me the heading structure for this URL"
The skill formats output as structured terminal text — score, grade, top issues, and a list of passing and failing checks. For batch runs, it displays a summary table so you can spot weak pages at a glance.
How Does the Skill Connect to the SEO Score API?
The skill calls the SEO Score API over HTTPS. When you make a request, Claude Code invokes the seo_audit.py script in the background, which sends a GET request to the /audit endpoint (or /audit/batch for multi-URL requests) with your API key in the X-API-Key header.
The API response — a JSON object containing score, grade, up to 82 individual check results, and fix recommendations — is passed back to Claude, which formats and summarizes it for you. On Starter plan and above, the response also includes SXO (Search Experience), AEO (Answer Engine), and AIO (AI Optimization) scores, each with their own grade and check breakdown. No data is stored locally; the skill is a thin client that calls the API and displays the results.
Request flow:
Claude Code → seo_audit.py → SEO Score API → JSON response → Claude formats output
The skill respects the rate limits of your plan. If you hit a limit mid-session, it will tell you and suggest when to retry. For high-volume use cases like auditing a full site during a build, the Pro or Ultra plan is recommended.
Which SEO Score API Plan Works with the Claude Code Skill?
All plans work with the skill, including the free tier:
| Plan | Audits | Best For |
|---|---|---|
| Free | 2/day | Quick checks during development |
| Starter | 200/month | Regular audits on personal or small client projects |
| Basic | 1,000/month | Teams running audits across multiple projects |
| Pro | 5,000/month | Agencies or CI/CD pipelines with high audit volume |
| Ultra | 25,000/month | Enterprise use or large-scale automated workflows |
For individual developers, the Starter plan at $5/month covers most use cases — 200 audits is enough for daily checks across several projects with headroom to spare. If you're using the skill in a CI/CD pipeline or running audits automatically on each deploy, Pro gives you the rate limits to handle that without throttling.
Why Use the Skill Instead of the API Directly?
The skill adds value in specific developer scenarios:
- During active development — check SEO signals on a staging URL without switching context to a browser or API client
- When reviewing PRs — ask Claude to audit a preview deployment URL as part of your code review
- While writing content — confirm a page's meta tags and heading structure are correct before publishing
- For quick comparisons — benchmark your score against a competitor while you're already in a session working on something else
If you prefer scripting directly against the API — for example, in a CI pipeline, a Python script, or an n8n workflow — the skill is not the right tool for that. Use the API or one of the official SDKs (Python, Node.js) instead. The skill is optimized for interactive, in-session use inside Claude Code.
What Does the Skill Output Look Like?
After running an audit, you'll see output structured like this:
SEO Audit: https://example.com
Score: 78/100 (B)
Top Issues:
- [CRITICAL] Missing Open Graph image tag
- [HIGH] H1 tag not found
- [MEDIUM] Page load time exceeds 3s threshold
SXO: 81/100 (A-) AEO: 52/100 (C+) AIO: 68/100 (B)
Report: https://seoscoreapi.com/report/example.com
The SXO, AEO, and AIO scores appear automatically on Starter plan and above — no extra flags needed. The full report link is shareable and can be pasted into a PR comment, Slack message, or client email without any additional setup.