Visibly AI — SEO MCP Server

Claude Code — SEO エージェンシー＆フリーランサー向けスターター

SEO フリーランサーやエージェンシー向けの、必要なものがすべてそろった Claude Code の設計図です。Visibly AI MCP を接続し、クライアント業務全体（現状分析 → ポテンシャル分析 → 提案 → CI 準拠の PDF）に使える、すぐに利用可能なスラッシュコマンドと、推測ではなく実際の SEO データを Claude に使わせるスマートなフックを備えています。

SEO フリーランサーであり、Neuro-SEO System® の開発者でもある Antonio Blago が構築し、実際の業務で徹底的に検証しました。

クイックスタート • 内容 • ワークフロー • CTR モデル • カスタマイズ • 無料キーを取得 • 相談を予約

---

これを作った理由

SEO コンサルティングで繰り返し行う作業は、いつも同じ 5 つです。実際の検索順位データを取得し、クライアントのキーワードセットと照合し、機会を数値化し、提案にまとめ、見栄えのよい PDF に仕上げます。必要なデータソース、手法、ガードレールを用意すれば、Claude Code はこれらすべてを実行できます。

このリポジトリには、まさにその一式が含まれています。しかも、API キーなしで動作します。インストールすると、付属の .mcp.json が Visibly AI MCP にキーなしで接続され、無料のナレッジツール（キーワード分類、SEO チェックリスト、Google のガイドライン、URL 構造分析）と、すべてのローカル手法を利用できます。Search Console のエクスポートデータを用意すれば、現状分析 → ポテンシャル分析 → 提案 → PDF の一連の流れをオフラインで実行できます。データエンジンをいつでも使えるようにしたい場合は、Visibly AI キーを追加してください。GSC／GA のライブデータは 0 クレジットで利用でき、キーワード、バックリンク、競合他社、オンページ監査も 1 つの MCP から利用できます。デフォルトでは無料、必要に応じてプロ向け機能を利用できます。

✨ 内容

項目	内容
.mcp.json	接続設定済みの Visibly AI MCP — デフォルトではキー不要（無料のナレッジツール）。キーを追加すると、GSC ライブデータ、キーワード、バックリンク、競合他社、オンページ監査、クロール機能を利用できます。
/visibly-seo-status-quo	クライアントのオーガニック検索での可視性を分析します。GSC × ターゲットキーワード、分類、クイックウィンを確認できます。
/visibly-seo-potential	ポテンシャル分析：実測 CTR モデル → 現実的な 12 か月後の目標 → トラフィック、リード、ROI の計算。
/visibly-seo-offer	分析結果とクライアントの状況に基づき、クライアントに合わせた段階的な SEO コンサルティング提案を作成します。
/visibly-seo-pdf-build	任意の分析スクリプトを、整ったブランド準拠の PDF に変換します。
SEO フック	SEO の意図を検出し、一般的なスクレイピングではなく Visibly AI MCP ツールを Claude に使わせる UserPromptSubmit フックです。
CLAUDE.md	ワークフロー全体とフォルダーの規約を記述した、プロジェクト指示のテンプレートです。
docs/	ワークフロー、CTR モデル、ベストプラクティスをまとめた手法のドキュメントです。

🚀 クイックスタート

使い方は 2 通りあります。どちらかを選んでください。

オプション A — プラグインとしてインストール（最速）

/plugin marketplace add AntonioBlago/claude-code-seo-starter
/plugin install seo-starter@antonioblago

/visibly-seo-status-quo、/visibly-seo-potential、/visibly-seo-offer、/visibly-seo-pdf-build コマンド、自動で呼び出される SEO スキル、SEO 意図を検出するフック、キー不要の Visibly AI MCP がすべて接続済みの状態で利用できます。 開始時にキーは不要です — MCP サーバーを承認すれば、無料のナレッジツールとローカルワークフロー全体を利用できます。

データエンジン全体（GSC ライブデータ、キーワード、バックリンク、オンページ機能）を利用しますか？ Visibly AI キーを追加してください。visibly-ai.com から取得し（約 30 秒、カード不要）、一度接続するだけで使えます（書き込み時に解決され、Git には含まれません）。

claude mcp add --transport http visiblyai https://mcp.visibly-ai.com/mcp --header "Authorization: Bearer lc_xxxxxxxxxxxxxxxx"

必要に応じて、/reload-plugins で再起動してください。プロ向けプラン、Google-OAuth（0 クレジット）、および任意の DataForSEO 接続方法については、docs/setup.md を参照してください。

オプション B — テンプレートをクローン

リポジトリ全体（ドキュメント、PDF テンプレート、セットアップスクリプト）をプロジェクトのひな型として使用します。

1. 前提条件

• ネイティブインストーラーでインストールした Claude Code：curl -fsSL https://claude.ai/install.sh | bash（macOS、Linux、WSL）または irm https://claude.ai/install.ps1 | iex（Windows PowerShell）。Claude Code を初めて使う方は、まず claude-homebase をご覧ください：/homebase でグローバルな CLAUDE.md とプロジェクト構造を設定してから、SEO のパスを選ぶとここにたどり着きます。
• (任意) プロ向けプラン用の Visibly AI アカウント — 無料で登録。必須ではありません。スターターはキーなしで動作します。
• Python 3.11+（PDF／データ処理用のヘルパーを使う場合のみ必要）

2. ブループリントを取得する

# Use it as a GitHub template, or just clone:
git clone https://github.com/AntonioBlago/claude-code-seo-starter.git
cd claude-code-seo-starter

3. （任意）Visibly AI キーを追加する

無料プランではこの手順をスキップしてください。キーなしの .mcp.json がすでに動作します。 完全なデータエンジンを有効にするには、visibly-ai.com で無料アカウントを作成し、 lc_... キーをコピーして、一度接続します（書き込み時に解決され、git には含まれません）。

claude mcp add --transport http visiblyai https://mcp.visibly-ai.com/mcp --header "Authorization: Bearer lc_xxxxxxxxxxxxxxxx"

プランの詳細、Google OAuth（クレジット消費なしで GSC／GA のライブデータを取得）、および任意の DataForSEO 接続については、docs/setup.md をご覧ください。

4. 起動する

claude

初回起動時に、Claude Code が Visibly AI MCP サーバーの承認を求めます。承認したら、次を試してください。

/visibly-seo-status-quo example.com

以上です。無料プランでは、GSC エクスポートを Python テンプレートに読み込ませます。キーを使う場合は、データがライブで取得されます。どちらの場合も、SEO ワークフロー全体を実行できます。

🔁 ワークフロー

各スラッシュコマンドは、実際のクライアント案件における1つのフェーズに対応しています。これらは連続して実行できます。

/visibly-seo-status-quo <domain>   →   /visibly-seo-potential <domain>   →   /visibly-seo-offer <domain>   →   /visibly-seo-pdf-build <script.py>
   (where do we           (what's the upside,        (what should the          (hand the client a
    rank today?)           in clicks & €?)            client buy?)              polished PDF)

方法論の詳細は docs/workflows.md に記載されています。

📈 CTR モデル

ポテンシャル分析の精度は、クリック率曲線の品質に左右されます。このリポジトリでは、テンプレートで今もよく使われている、実態より高い教科書的な数値の代わりに、Google Search Console のファーストパーティデータ（キーワード130万件、ドメイン94件）に基づく順位別 CTR を示した Keyword Study 2026 を提供しています。

差別化のポイントは、曲線が検索意図を考慮していることです。ナビゲーショナルキーワードは順位1位で CTR が約8.9％、インフォメーショナルキーワードは約3.2％です。単一の混合値で予測すると、潜在的な効果を気づかないまま誤って見積もってしまいます。検索意図と順位の完全な対応表、および適用する Python コードは docs/ctr-model.md をご覧ください。誠実な入力 → 根拠のある予測 → 厳しい検証にも耐える提案。

🔍 透明性 — 処理の実行場所

データの流れは明確です。

• キーなし（デフォルト）： .mcp.json はアカウントなしで mcp.visibly-ai.com に接続します。応答するのは無料のナレッジツール（チェックリスト、ガイダンス、Google ガイドライン、キーワード分類、URL 構造チェック）のみです。クライアントデータは関与しません。
• キーあり： データツール（query_search_console、query_analytics、キーワード、バックリンク、オンページ）は、EU 内の Railway でホストされる Visibly AI バックエンドを経由します。GSC／GA データは Claude に届くまでにこのバックエンドを通過します。これは製品の仕組みであり、副次的な影響ではありません。さらに、GSC のデータが1行でも流れるには、明示的なオプトインが3段階必要です。Visibly アカウントを作成し、API キーを追加して、Visibly 内で OAuth を使って Google アカウントを接続します。Google の同意がなければ、query_search_console が読み取れるプロパティはありません。クライアントにとって許容できない場合は、キーを追加しないでください。代わりに GSC エクスポートをローカルの Python テンプレートに読み込ませれば、ワークフロー全体を引き続き実行できます。
• 権限： .claude/settings.json で自動許可されるのはメタデータと無料のナレッジツールのみです。クライアントデータ（GSC、GA、キーワード、バックリンク、オンページ、クロール）を読み取るすべてのツールは ask に設定されており、使用前に Claude が確認を求めます。
• フック（.claude/hooks/seo-check.sh）はローカルで実行され、どこにも何も送信しません。プロンプトが SEO 関連に見える場合に、推測ではなく実データを使うよう促すリマインダーを追加するだけです。この通知が不要な場合は、フックを削除してください。

🎨 カスタマイズ

すべてプレーンな Markdown とシェルなので、フォークして自由に調整できます。

• ブランディング — CLAUDE.md と templates/pdf_example.py を編集して、色、フォント、連絡先ブロックを変更します。
• データソース — デフォルトではキー不要です。フルエンジンを利用するには Visibly キーを追加するか、独自のデータソース（GSC エクスポート → Python テンプレート、DataForSEO、GA4、Ahrefs…）を .mcp.json に設定します。docs/setup.md を参照してください。GSC へのアクセスをゼロから構築するための無料ガイド：Indexing Checker für die Google Search Console（ドイツ語）。
• ワークフロー — .claude/commands/*.md ファイルがワークフローそのものです。自分の言葉で書き換えてください。
• ガードレール — .claude/hooks/seo-check.sh に独自のキーワードトリガーを追加できます。

詳しい手順は docs/setup.md、実践から得た教訓は docs/best-practices.md をご覧ください。

📂 リポジトリの構成

claude-code-seo-starter/
├── .claude-plugin/           # makes this repo an installable plugin + marketplace
│   ├── plugin.json           # plugin manifest
│   └── marketplace.json      # marketplace catalog (one repo = both)
├── .mcp.json                 # Visibly AI MCP connection — keyless (free tools); add key for pro
├── server.json               # MCP-registry manifest (publish via mcp-publisher)
├── .env.example              # copy → .env — optional key + separate data sources
├── CLAUDE.md                 # project instructions Claude reads on every run
├── .claude/
│   ├── commands/             # /visibly-seo-status-quo /visibly-seo-potential /visibly-seo-offer /visibly-seo-pdf-build
│   ├── skills/               # auto-invoked SEO skills (status-quo, potential, offer, pdf)
│   ├── hooks/                # seo-check.sh + hooks.json — SEO-intent nudge
│   └── settings.json         # hook registration + permissions (free tools allowed, data tools ask)
├── docs/
│   ├── setup.md              # detailed setup
│   ├── workflows.md          # the 4-phase methodology
│   ├── ctr-model.md          # empirical CTR curve
│   ├── folder-structure.md   # client knowledge base + CI base conventions
│   ├── best-practices.md     # lessons learned
│   └── promote.md            # discoverability checklist (registry, awesome lists)
├── templates/
│   ├── ci/                       # CI base — brand.py (constants) + CI.md (reference)
│   ├── client-template/          # copy → clients/<domain>/ (CLAUDE.md + _knowledge/)
│   ├── status-quo-template.md    # fill-in status-quo skeleton (classification, quick wins)
│   ├── potential-template.md     # fill-in potential skeleton (deltas, clusters, ROI scenarios)
│   ├── offer-template.md         # fill-in offer skeleton (phases, pricing, ROI, terms, CTA)
│   └── pdf_example.py            # minimal CI-PDF starter (fpdf2)
└── scripts/
    └── check-setup.sh        # verify your env is wired correctly

関連リポジトリ

リポジトリ	追加される内容
claude-homebase	Claude Code をゼロからセットアップする方法：/homebase が役割を聞き取り、CLAUDE.md、フォルダー、スキル、学習内容を作成します
claude-context-guard	コンテキストのコストが高くなったときに警告し、/clear をまたいで引き継ぎ用の概要を保持します
delegate-audit	DELEGATE-52 の衛生ルールに照らして、Claude Code のスキルと LLM パイプラインをチェックします
visiblyai-mcp-server	このスターターの基盤となる Visibly AI MCP サーバー
peec-ai-skills	ChatGPT、Perplexity、Google AI Overviews におけるブランドの可視性向上のためのスキル

手法の詳細：開発者向けのおすすめ Claude Code スキル。

🤝 コントリビューション

PR を歓迎します。詳しくは CONTRIBUTING.md をご覧ください。役に立った場合は、⭐ を付けるとほかの人にも見つけてもらいやすくなります。

📜 ライセンス

MIT — LICENSE をご覧ください。商用利用、フォーク、ご自身のクライアント向けの提供が可能です。

💬 セットアップのサポートをご希望ですか？

エージェンシーのワークフローに合わせて調整したい場合や、SEO、Claude Code、バイブコーディングについて相談したい場合は、相談を予約 してください。

---

作成者：Antonio Blago — SEO フリーランサー & Neuro-SEO System®
📅 相談を予約
_{クライアントごとに午後の作業時間を節約できたなら、このツールは役目を果たしています。}