Free · skill + plugin + MCP · MIT

AI SEO Magic Button

One command from zero to a whole-site AEO/GEO audit. Point the AI SEO Magic Button at your domain and it crawls your site, scores every page with the AutomateLab ai-seo and citation-intelligence engines, and hands you a prioritized plan.json your agent can execute - no manual triage, no dashboard-hopping, no API keys required for the core flow.

npx -y ai-seo-magic-button mcp

Get it on GitHub npm package Read the launch post

What it does

Point it at a domain and it crawls every page, runs the full AEO/GEO audit, and produces a plan.json where every item carries a baked agent action and an acceptance check. Fixes are ranked by estimated score lift - not by category - and cross-page gaps (missing sitemap, no llms.txt, schema absent sitewide) surface as single items. You go from domain name to executable AI SEO plan in one command.

The magic button is analyze-and-propose only. It never edits your site directly. Apply and verify are separate steps you run deliberately, so the plan stays portable and the decision to ship stays with you.

What makes it different

A plan, not a report

Every output item carries a baked tool call and an acceptance check. Your agent reads the plan and executes it - no interpretation, no copy-pasting from a PDF.

Whole-site AEO audit in one shot

It crawls every page, not just the one you paste in. Cross-page gaps - missing sitemap, no llms.txt, schema absent everywhere - surface as single plan items ranked by total lift.

No API keys for the core flow

The audit-to-plan path works on any public URL without credentials. Citation data is optional - add Perplexity or ChatGPT keys when you want it, skip them when you don't.

Skill, plugin, and MCP in one package

Three install paths, one npm package. Drop the skill file into .claude/skills/, install via /plugin, or wire the MCP server into any JSON config. Same core, same plan format.

Tool and command surface

One shared core library, four thin surfaces. The MCP server exposes one tool; the CLI adds three execution commands on top of the same audit engine.

Tool / Command	Surface	What it does
`generate_seo_plan`	MCP	Crawls the given domain (up to `pages` URLs), runs the full AEO/GEO audit, and returns the complete plan.json plus markdown checklist as structured content your agent can act on immediately.
`audit`	CLI	Same audit as the MCP tool, writing plan.json and plan.md to disk. Use this to inspect or version-control the plan before running apply.
`apply`	CLI	Runs the plan's tool-driven items against your site (rewrites, schema, llms.txt, robots) and writes results to magic-button-out/. Each item is idempotent - safe to re-run.
`verify`	CLI	Re-audits the site against the original plan and diffs the scores. Returns a before/after table so you can confirm the lift is real, not estimated.
`sink`	CLI	Pushes plan items into an agency-os Notion board as subtasks. Use this when you want human-in-the-loop approval before your agent applies each fix.
/plugin install	Plugin	Installs the magic button as a Claude Code plugin. Loads the skill surface automatically - no SKILL.md copy step, no MCP config block needed.

Install in 3 steps

Pick your install path (requires Node.js 18+) # Option A: Claude Code plugin (recommended) /plugin install https://github.com/AutomateLab-tech/ai-seo-magic-button # Option B: MCP server in any host npx -y ai-seo-magic-button mcp # Option C: Claude skill only # copy skill/ from the repo into .claude/skills/ai-seo-magic-button/
Wire into your MCP host config (skip if you used the plugin install)
```
{
  "mcpServers": {
    "ai-seo-magic-button": {
      "command": "npx",
      "args": ["-y", "ai-seo-magic-button", "mcp"]
    }
  }
}
```
Paste this block into ~/.claude/claude_code_config.json, Cursor's mcp.json, or your host's equivalent. No environment variables required for the core flow.
Restart your MCP host. The generate_seo_plan tool appears. Ask your agent: "Run the AI SEO magic button on example.com and show me the top 5 fixes." The plan arrives as structured content - your agent can start executing immediately.

Full reference: the GitHub readme and plan-format.md.

FAQ

What is the AI SEO Magic Button?

AI SEO Magic Button is a free, MIT-licensed tool that runs as a Claude skill, Claude plugin, or MCP server. You point it at a domain and it crawls your site, audits every page for AEO/GEO signals using the AutomateLab ai-seo and citation-intelligence engines, and produces a prioritized plan.json plus a markdown checklist. Every item in the plan is self-contained and agent-executable - you run your agent against the plan to apply the fixes.

How is this different from using the ai-seo MCP directly?

The ai-seo MCP audits one page at a time and returns raw scores. The magic button wraps it into a whole-site crawl, ranks the fixes across all pages by estimated score lift, and packages them into a portable plan.json your agent can execute sequentially. It is the orchestration layer you would otherwise have to build yourself.

Does the AI SEO Magic Button need API keys to run?

No. The core audit-to-plan flow works on any public URL without credentials. The citation-intelligence engine (which tracks what LLMs cite) accepts optional API keys for Perplexity, Claude, and ChatGPT. If you skip those keys, the plan still covers AEO schema, llms.txt, robots.txt, and content rewrite tasks.

Does it edit my site automatically?

No. The magic button is analyze-and-propose only. It produces a plan.json and a markdown checklist. You run your agent against the plan to apply the fixes. No direct edits happen without an explicit apply command from you.

Which agents and editors does the AI SEO Magic Button work with?

Any MCP-compatible host: Claude Code, Claude Desktop, Cursor, Cline, Windsurf, and any agent runtime that loads MCP servers. The Claude plugin install path also works in Claude Code without a separate MCP config block. The skill surface works in any agent that loads SKILL.md files from .claude/skills/.

What does the AI SEO Magic Button cost?

The package is MIT-licensed and free. You pay only for your AI agent's model usage. The underlying engines - ai-seo-mcp and citation-intelligence - are also MIT-licensed and free.

Want the magic button wired into your publishing workflow?

We use it on automatelab.tech every week - audit on publish, apply overnight, verify before the next editorial cycle. If you want that loop running on your site, we can set it up.

Get in touch