AI SEO Magic Button

ai-seo-magic-button

サイトを指定するだけで、サイト全体の AEO/GEO 監査と、エージェントが実行できるすぐに使えるプランを取得できます。 AI-SEO の魔法のボタンです。Claude スキル、Claude プラグイン、そして MCP サーバーとして動作するため、どの MCP ホスト（Cursor、Cline、Windsurf、Claude Desktop）でも利用できます。

直接編集するのではなく、実行可能なプランを作成します。持ち運び可能な plan.json と Markdown のチェックリストが生成され、各項目はそれぞれ自己完結しており、エージェントが実行できます。その後、プランを使ってエージェントを実行します。

内部では、2 つのエンジンを薄いオーケストレーション層で連携させています。 @automatelab/ai-seo-mcp （監査＋スコアリング＋書き換え）と @automatelab/citation-intelligence （AI エンジンによる引用状況）です。監査からプラン作成までの基本的なフローでは、API キーは不要です。

2 ステップのフロー

1. 実行します → サイトをクロールして全ページを監査し、推定スコア上昇幅に基づいて優先順位を付けた plan.json と Markdown のチェックリストを生成します。
2. 生成されたプランを使ってエージェントを実行し、書き換え、スキーマ、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"]
    }
  }
}

1 つのツール、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/ にコピーします（または上記のプラグインからインストールします）。このスキルは、会話形式で使える魔法のボタン UI です。詳細は 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 をご覧ください。

構成

共有コアライブラリ 1 つと、薄いインターフェース 4 つで構成されています。位置付けについては docs/scope.md、スキーマとコアライブラリの境界については 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

メンテナンスと検証

解釈上の制限、該当する場合の現在のツール名、再現可能な検証については、メンテナンスガイドをご覧ください。