The Claude SEO skills MCP is a free, read-only MCP server that holds two open-source SEO skill packs from two different authors: Claude SEO by AgriciDaniel and Illyism SEO Skills by Ilias Ism, both MIT licensed. We added both packs to one NoteSupreme MCP with built-in search (RAG), so Claude Code, Cursor or any AI coding app can find the right skill and follow it. Connect it, and your AI can audit a site, fix technical SEO, add schema, write content and work on AI search citations.
It is for people who build or market websites with AI coding tools. There is no sign-in, no API key and nothing to install. You paste one URL into your AI app. Below we cover what is inside, how we built it, how we used it to plan this blog, and which skill fits each job.
The two packs hold 56 skills between them:
- Claude SEO by AgriciDaniel: 26 skills and 19 specialist agents. Full-site and single-page audits, technical SEO, schema, content quality and E-E-A-T, backlinks, sitemaps, images, hreflang, Google APIs, and local SEO with Google Maps.
- Illyism SEO Skills by Ilias Ism: 30 skills that produce outputs instead of reports. Comparison and alternatives pages, title rewrites, blog refreshes, Reddit threads that rank, directory submissions, AI search citations, draft clean-up and copywriting. It has no local SEO.
Each skill is a main page your AI follows, plus the reference pages that main page tells it to load. Once the MCP is connected, you can ask things like:
- "Using the Claude SEO skills MCP, run a local SEO audit for my plumbing business site and fix what you can in the code."
- "Find the skill for competitor comparison pages and follow it to write our page against Notion."
Paste this URL into Claude, Claude Code, ChatGPT, Cursor or any MCP app:
Connect this MCP to your AI
https://notesupreme.com/p/claude-seo-skills?token=nsp_9_aGgxEI87BKDjSVUU8Zfg- Claude: Settings → Connectors → Add custom connector → paste the URL.
- ChatGPT: Settings → Connectors → Advanced → Developer mode → Create → paste the URL.
- Cursor: Settings → MCP → Add new MCP server → type
url, paste the URL.
Free and read-only. No sign-in or API key.
Setup steps for each app are in the GitHub repo, and the server is listed on Glama. More posts like this live under SEO and MCP.
The short version
Ask your AI for the job and it finds the skill. It searches the library's tags, opens the matching main skill page and follows it. The main ones are seo-audit for a whole site, seo-page for one URL, seo-local and seo-maps for a local business, seo-schema for structured data, seo-geo and unslop-seo for AI search, and vs-and-alternatives for comparison pages. Six Illyism skills need the author's paid tools, and the MCP tells your AI to check with you before it relies on them.
How we built this
We built the library in three steps.
1. Picking two open packs. We took two MIT-licensed skill packs from GitHub: Claude SEO by AgriciDaniel and Illyism SEO Skills by Ilias Ism. Both are written as instructions an AI agent follows, and the licenses let anyone share them with the notice kept.
2. Importing and tagging. Claude imported both packs into a NoteSupreme Ship (one project's vault of markdown notes) through its MCP. Each page in the Ship holds one file from a pack: a skill's main instructions, an agent, a reference, a template or a prompt. The folders mirror the original repos, and the skill text is unchanged. We added a title, a one-line description and tags to every page so search works:
- a pack tag, so your AI can stay inside one author's pack
- a kind tag: main-skill, agent, reference, template or prompt
- a skill tag such as seo-local
- topic tags such as local-seo, ai-search, schema or backlinks
- uses-paid-service on the six Illyism skills that need the author's paid tools
A note called "How this Ship is organized" tells every AI how to search: use two or more tags, read a skill's main page first, and load the references that page names. File paths inside the skills point at the original repo layout, so the note also tells the AI to search the file name instead. The Illyism pack came from its main branch in November 2026, with its last upstream commit on 16 November. The finished Ship has 296 pages.
3. Publishing. One click on Publish turned the Ship into a free read-only MCP that anyone can connect. The Ship holds the instruction files only. Claude SEO's Python scripts and installers stay in AgriciDaniel's repo, so for its script-backed audits you still install the plugin from there.
The VPS and app security checklist is built and published the same way, as a Ship with its own free read-only MCP.
Why it is cheap for your AI to use
Your AI does not read 296 pages on every question. Each page carries a type, a one-line description and tags in Google's Open Knowledge Format, so the AI searches first and opens only the skills it needs. A local SEO question opens the seo-local main skill and the references it names, and leaves the e-commerce and hreflang files closed. In your own NoteSupreme projects, Code Mode goes a step further. The AI writes a few lines of code, a sandbox walks the Ship, and only the answer comes back. In our tests, Code Mode used about 97% fewer tokens than the Notion MCP.
How we used these skills to plan this blog
The writing rules for this blog came from four pages in this library. Each one changed how we write a post.
- seo-content (Claude SEO). Its Who, How and Why test comes from Google's helpful-content guidance. It is the reason every post carries a byline and a "How we built this" section like the one above. The same page gave us our target of 3 to 5 internal links per 1,000 words.
- The Google AI optimization guide page (Claude SEO). It summarizes Google's position that you do not need llms.txt, content chunking or AI-specific rewrites, and that unique first-hand content is what counts. So we left llms.txt and AI-only formatting out of the plan and made one rule instead. Every post has to carry something only we can say, such as our own process or test results. A post that could run unchanged on a competitor's site gets rewritten.
- intro (Illyism). It keeps intros short and asks for a roadmap of what the reader will get. That is why each post opens with what the thing is, who it is for and what comes next, before the first heading.
- unslop-seo (Illyism). It puts the direct answer in the first 40 words. It also asks for sentence-case headings, 5 or more H2s on long posts, and at least one H2 phrased as the question people search, with a 1 to 2 sentence answer under it. Its check script runs on every post before we publish, and a draft needs 0 hits. The script flags em and en dashes, curly quotes, a list of words that read as AI filler, and chatbot openers. This post passed it with 0 hits.
Which skill to use for each SEO job
Each job below names the skills to ask for, what each one does and when to use it.
Site audits
- seo-audit (Claude SEO) runs a full-site audit. It crawls up to 500 pages and sends each area to a specialist agent: technical, content, schema, sitemap, performance, AI search and more. It returns a 0 to 100 health score and an action plan sorted into Critical, High, Medium and Low. Use it for a whole site. With the plugin installed, the author puts a full audit at 10 to 15 minutes.
- seo-page (Claude SEO) checks one URL across on-page SEO, content, metadata, schema, images and performance. Use it before you publish or rework a single page.
- seo-technical (Claude SEO) covers crawlability, indexability, security, URLs, mobile, Core Web Vitals, rendering and IndexNow. Use it for a technical-only review.
- seo-roast (Illyism) is a revenue-first teardown. It fixes fatal blockers in a pull request and ships a roadmap ordered by revenue. Use it when you want merged fixes instead of a report.
- seo-autopilot (Illyism) runs daily on a repo with saved state. It does health checks, fact-checks commits, pushes page-2 pages up and writes comparison pages.
Local SEO and Google Maps
The local skills are all in Claude SEO. The Illyism pack has none.
- seo-local audits a local business site on six weighted areas: Google Business Profile signals, reviews, local on-page SEO, NAP consistency and citations, local schema, and local links. It detects whether the business is brick-and-mortar, service-area or hybrid, and spots six industries (restaurant, healthcare, legal, home services, real estate, automotive) to change its checks to match. Use it for any business that wants calls from the map pack.
- seo-maps adds geo-grid rank tracking, a Google Business Profile audit through an API, review data from Google, Tripadvisor and Trustpilot, and competitor radius mapping. The full audit only calls it when DataForSEO is connected.
- seo-flow holds the FLOW prompt library, with ready local prompts for GBP categories, services and descriptions, title tags, meta descriptions and service page rewrites.
Schema and structured data
- seo-schema (Claude SEO) detects, validates and generates Schema.org JSON-LD for a page or entity. Its type list was checked in October 2026 and sorts types into active, no rich result and deprecated, so your AI stops adding markup Google has retired. Use it when you want rich results or need to check what a page already has.
- seo-local picks the right LocalBusiness subtype per industry, for example LegalService instead of the deprecated Attorney.
- youtube-seo (Illyism) adds VideoObject schema to the blog post that embeds a video, along with titles and a chapters description.
Content and blog writing
- seo-content (Claude SEO) scores a page for E-E-A-T, readability, thin content and AI citation readiness. With the plugin installed, it can also strip AI-typical phrasing and invisible Unicode characters from your own drafts.
- seo-content-brief writes a brief with target keywords, per-section word counts and keyword placement. seo-cluster groups keywords by SERP overlap into hub-and-spoke plans.
- blog-refresher (Illyism) updates an old post to outrank competitors with a 6-phase content audit. seo-title-optimization rewrites titles and H1s against live SERP winners and truncation limits.
- intro writes short post intros, proof-kb builds a first-hand proof knowledge base your pages draw from, and unslop-seo edits drafts in place.
- vs-and-alternatives (Illyism) and seo-competitor-pages (Claude SEO) write X vs Y and alternatives pages. The Illyism version builds each page on real switching triggers and pricing math.
AI search (GEO)
Claude SEO's page on Google's AI optimization guide quotes Google directly: "optimizing for generative AI search is optimizing for the search experience, and thus still SEO." The AI search skills start from that.
- seo-geo (Claude SEO) audits pages for AI Overviews and answer engines on citability, entity clarity, AI crawler access, brand signals and passage structure.
- seo-agentic (Claude SEO) checks how well AI agents can use your site, including the Lighthouse Agentic Browsing score, the accessibility tree, and robots.txt and Content-Signal rules for AI agents.
- unslop-seo (Illyism) rebuilds a post so answer engines can quote it, with the answer up top and question headings. customer-journey maps how buyers find you across Google, AI chatbots and social.
- block-ai-scrapers (Illyism) does the opposite job. It blocks AI scrapers and headless browsers while keeping verified Googlebot indexing.
Backlinks and links
- seo-backlinks (Claude SEO) analyzes your backlink profile, anchors, toxic signals, competitor gaps and disavow candidates, using Moz, Bing Webmaster Tools and Common Crawl data.
- honest-link-outreach (Illyism) builds a vetted outreach batch with a SEND/CUT prospect table, target URLs and plain-text email drafts.
- directory-submissions (Illyism) submits a startup, SaaS, AI tool or MCP server to 50+ high-DR directories, launchpads, MCP registries and GitHub Awesome lists. reddit-serp finds unlocked Reddit threads on Google page 1 and drafts replies.
- internal-linking (Illyism) routes links from your high-traffic posts to pages like /pricing and /vs/, and ships a before and after table.
Skills that need a paid tool
Six Illyism skills carry the uses-paid-service tag because they run on the author's own products. The MCP tells your AI to ask you before it relies on them.
- aiseotracker, ai-seo-report and content-coverage need AI SEO Tracker, the author's paid tracker of brand citations in ChatGPT, Perplexity, Gemini, Copilot and AI Overviews.
- linkdr plans a DR 30 to 60+ backlink campaign through LinkDR, the author's paid link-building service, with a checkout link you approve.
- scribiz needs Scribiz, the author's paid transcription service.
- awesome-tools submits to the author's Awesome Tools directory, which has a free and a paid listing.
A few other skills need an account with an outside data provider. seo-dataforseo and dataforseo-serp use DataForSEO, and the library has a page on what each DataForSEO call costs. ahrefs-research pulls Ahrefs data through its MCP or API. Claude SEO's optional extensions, such as SE Ranking and Profound, also connect to paid services with your own account.
Can Claude do an SEO audit?
Yes. With the Claude SEO skills connected, Claude follows the seo-audit skill and returns a scored action plan sorted by priority. For the full script-backed version with its own crawler and headless browser, install AgriciDaniel's Claude SEO plugin in Claude Code.
What are Claude skills for SEO?
They are instruction files that tell an AI how to do one SEO job, such as a local audit or a schema fix, step by step. Each skill has a main page plus reference pages it loads when needed, so the AI follows a written method instead of guessing.
Do I need to install anything to use these SEO skills?
No. You paste one URL into your AI app and it reads the skills over MCP. You only install something for the parts that run code: Claude SEO's Python scripts and installers live in its repo, and the Illyism skills install with npx skills add Illyism/seo-skills.
Does the MCP work outside Claude?
Yes. It is a standard remote MCP server, so Cursor, VS Code, Windsurf, ChatGPT and any other MCP app connect with the same URL. The skills are plain markdown, so any model that can call MCP tools can follow them.
Do I need llms.txt for AI search?
No. The library's summary of Google's AI optimization guide says you do not need llms.txt or AI-specific markup files, and its llms.txt evidence page says no major AI search system reads the file today. Getting indexed and publishing first-hand content matter more.
Credit to the authors
Both packs belong to their authors. We host the instruction files so any AI can read them. If a skill helps you, star the original repos:
- Claude SEO by Agrici Daniel (AgriciDaniel), MIT License. The FLOW prompts come from AgriciDaniel/flow under CC BY 4.0.
- Illyism SEO Skills by Ilias Ism, MIT License, with a catalog at il.ly/skills.
Where to start
Connect the MCP and ask for one job on one site you own. A good first run is "Use seo-page on my homepage and fix the top three issues in the code." Then try seo-local or vs-and-alternatives, whichever matches the pages that bring you customers. If your site runs on your own server, pair it with the VPS and app security checklist.