AI SEO Magic Button

ai-seo-magic-button

指定你的网站，即可获得全站 AEO/GEO 审核，以及一份可直接运行的计划，供你的 Agent 执行。 AI SEO 的一键魔法按钮——可作为 Claude 技能、Claude 插件，也可作为 MCP 服务运行，因此适用于任何 MCP 宿主（Cursor、Cline、Windsurf、Claude Desktop）。

它生成的是可执行的计划，而不是直接修改内容：一个可移植的 plan.json，以及一份 Markdown 检查清单，其中的每个项目都自包含且可由 Agent 执行。随后，你可以让 Agent 根据计划执行操作。

在底层，它是一个精简的编排层，连接两个引擎： @automatelab/ai-seo-mcp （审核 + 评分 + 重写）和 @automatelab/citation-intelligence （AI 引擎引用的内容）。运行核心的审核 → 计划流程无需 API 密钥。

两步工作流

1. 运行它 → 它会抓取你的网站、审核每个页面，并生成 plan.json + 一份 Markdown 检查清单，按预估评分提升幅度排序。
2. 让你的 Agent 根据生成的计划执行操作（重写、schema、 llms.txt、robots）——然后验证评分是否确实提升。

安装

作为 MCP 服务（适用于任何宿主）

// e.g. claude_desktop_config.json / Cursor / Cline
{
  "mcpServers": {
    "ai-seo-magic-button": {
      "command": "npx",
      "args": ["-y", "ai-seo-magic-button", "mcp"]
    }
  }
}

提供一个工具：generate_seo_plan { domain, pages? } → 返回完整的 plan.json（以结构化内容形式）和 Markdown 检查清单。

作为 Claude Code 插件

/plugin marketplace add AutomateLab-tech/ai-seo-magic-button
/plugin install ai-seo-magic-button@ai-seo-magic-button-marketplace

作为 Claude 技能

将 skill/ 复制到你的 .claude/skills/（或通过上方的插件安装）。该技能提供对话式的一键魔法按钮体验——详见 skill/SKILL.md。

CLI

npm install && npm run build

# audit -> plan.json + plan.md
node dist/cli.js audit example.com --pages 10

# execute the plan's tool-driven items (writes to ./magic-button-out)
node dist/cli.js apply plan.json

# re-audit and diff the score (proof the plan worked)
node dist/cli.js verify plan.json

# optional: push items into an agency-os Notion board (else local checklist)
node dist/cli.js sink plan.json

默认情况下，子引擎通过 npx 解析。若要使用本地构建：

export AISEO_MCP_PATH=/abs/path/ai-seo-mcp/dist/index.js
export CITATION_MCP_PATH=/abs/path/citation-intelligence-mcp/dist/index.js

示例

$ node dist/cli.js audit example.com --pages 2

https://example.com
  pages audited: 1 · avg score: 48 (D)
  fixes: 8 · est. lift: +78 points
   1. [critical] +12 No JSON-LD structured data found on this page.
   2. [critical] +12 No FAQ structure found (no FAQPage schema or H3 question headings).
   3. [critical] +12 No sitemap found at standard locations.
   6. [high]     +10 Rewrite for AEO: this page
   7. [medium]   +4  Low authority signals - missing Organization/author schema.
   8. [medium]   +4  No canonical link element found.

完整的 plan.json 示例见 examples/plan.example.json。 每个项目都包含自包含的 action（工具 + 预置参数）和 acceptance 检查——详见 docs/plan-format.md。

构建方式

一个共享核心库，四个轻量接口。项目定位见 docs/scope.md，schema 与核心库的边界见 docs/plan-format.md。

src/core/   audit + plan + apply + verify + sink  (the only place with logic)
src/cli.ts        CLI surface
src/mcp-server.ts MCP server surface (generate_seo_plan)
skill/            Claude skill surface
plugin/           Claude plugin surface

许可证

MIT

维护与验证

有关解读限制、当前适用的工具名称和可复现验证，请参阅维护指南。