Toprank完全解説：Claude Code向けSEO/Google/Meta広告プラグインを解剖

「ダッシュボードを見て『あとは自分で直してね』」というSEO/広告ツールに、ほとんどの担当者は飽きている。SEMrushもAhrefsも、データを見せたあとに必ず人間の手動作業が残る。広告で言えば、無駄キーワードを止めるのも、ネガティブキーワードを追加するのも、最終的に管理画面に戻ってクリックするのは結局自分だ。

NotFair（notfair.co）が2026年に公開した nowork-studio/toprank（★2,316／297フォーク／MIT）は、この最後の手動作業をClaude Code側に巻き取ることを正面から狙ったOSSプラグインだ。Google Ads・Meta Ads（Facebook+Instagram）・Google Search Consoleに直結し、データの取得・診断・実行までをCLIの1コマンドで連続実行する。

Claude Code全体の使い方は Claude Code完全ガイド2026：インストールから本番運用まで をご覧ください。

1. Toprankとは何か：CLI型データドリブン広告/SEOエージェントの正体

Toprankは「ダッシュボードではなくデータドリブンな意思決定そのもの」を目的にしたClaude Codeプラグインだ。READMEの冒頭スローガン Data-driven decisions, not dashboards. がコンセプトを正確に表現している。

公式リポジトリの説明文は「Open-source Claude Code skills for SEO, GEO, Google Ads, Meta Ads」で、対象領域は4つに整理されている。

• SEO: 技術監査・コンテンツ生成・メタタグ最適化・構造化データ生成
• GEO: 生成エンジン（ChatGPT/Claude/Perplexity/Gemini）からの引用最適化
• Google Ads: 監査・キャンペーン管理・RSAコピー生成・ランディングページ評価
• Meta Ads: Facebook+Instagram広告監査・キャンペーン管理

リポジトリは2026年3月27日に作成され、わずか2か月で2,316★・297フォークを集めている。最終pushは2026年5月17日、Pythonベース（一部Goスキル）、MITライセンス。トピックには claude-code-plugin／claude-skills／mcp／seo／geo／googleads／metaads が並び、Claude Codeエコシステム内では数少ない「マーケティング業務領域に特化したOSSプラグイン」として独自の立ち位置を確立している。

特筆すべきは、CLI（Toprank）とWeb（NotFair）が同じエンジンを共有している点だ。READMEには Both sides share the same engine, so an audit you run from the CLI uses the same tooling as the one on the web. と明記されており、ブラウザでクリック操作するNotFair Web版とClaude Code内のスキル実行が、内部的に同一のMCPサーバーと処理ロジックを叩く構成になっている。

Toprankが想定する典型的ユースケース

READMEで列挙されている問いかけは、現場担当者なら誰もが抱える3つだ。

1. Am I wasting money on ads right now?（今この瞬間、広告費を無駄にしていないか？）
2. Why did my traffic drop and how do I fix it?（なぜトラフィックが落ちたか、どう直すか？）
3. How do I get more conversions without spending more?（予算を増やさずコンバージョンをどう伸ばすか？）

これらは従来「データを見る → 担当者が考える → 管理画面で操作する」の3段階で対処されてきた。Toprankはこの3段階を1つのCLIコマンド + 確認応答にまで圧縮することを目指す。「Do it all.」と返事するだけで、3キーワードの一時停止・12件のネガティブキーワード追加・2キーワードの入札額調整が連鎖実行されるREADMEの実例は、その思想を象徴している。

重要なのは、すべてのMutation操作が7日以内に取り消し可能な点だ。READMEの実行ログにも All changes are reversible within 7 days. と明示されており、AIエージェントが暴走しても巻き戻せる安全弁が設計に組み込まれている。

2. アーキテクチャ全体像：プラグイン・MCPサーバー・OpenClaw自律層の3層構造

Toprankは見かけ上1つのプラグインだが、内部的には3つの独立レイヤーで構成されている。プラグイン本体（Skills）／リモートMCPサーバー（NotFair）／OpenClawアダプティブ層の3層だ。

第1層：スキル本体

ローカルにインストールされる主要構造を、READMEのHow It Worksセクションから抜粋する。

toprank/
├── .claude-plugin/
│   ├── plugin.json       # プラグインメタデータ
│   └── marketplace.json  # マーケットプレイス登録
├── .mcp.json             # NotFair MCP自動登録
├── google-ads/           # 4スキル
├── meta-ads/             # 3スキル
├── seo/                  # 9スキル
├── gemini/               # クロスモデルレビュー
├── openclaw/             # 自律エージェント層
├── toprank-upgrade-skill/
└── test/                 # 単体+LLM Judge評価

各スキルディレクトリは独立したSKILL.mdを持ち、Claude Code側のスキル探索メカニズムから個別に呼び出される。/toprank:seo-analysisのようにプラグイン名前空間付きで呼び出すため、他のClaude Codeスキルとの名前衝突を防ぐ設計になっている。

第2層：NotFair リモートMCPサーバー

ここがToprank最大の特徴だ。Google AdsとMeta Adsへのアクセスは、ローカルではなくnotfair.coが運営するリモートMCPサーバーに委ねられる。

認証はOAuth 2.1の動的クライアント登録で、初回利用時にブラウザタブが開いてnotfair.coにサインインするだけ。トークンはClaude Code側のOSキーチェーンに保存され、mcp-remoteのような中継ブリッジを噛ませる必要がない。

Google Adsサーバー側の特筆機能は runScript ツールで、最大20本のGAQLクエリを並列実行して分析的な問いに対応する。たとえば「過去90日で品質スコアが急落し、かつ予算消化率が90%超のキャンペーンは？」のような複合分析を、20並列のGAQLで1秒台に圧縮する。

Meta側はMutation面が意図的に狭く設計されている。READMEに明記されているとおり、create-campaign・audience編集・creative uploadは存在しない。pause/enable/updateBudget/renameCampaignのみがサーバー側に置かれ、それ以外の操作はMeta Ads Managerに戻す設計だ。AIエージェントによる事故を最小化する設計判断と読み取れる。

第3層：OpenClaw アダプティブ層

openclaw/配下にあるアダプティブ層は、Toprankを自律エージェント化する装置だ。README記載の機能を整理すると以下のとおり。

これは単体のToprankスキルを「呼び出されたら動く」状態から、「所有しているサイト群を24時間ウォッチして勝手に改善PRを上げる」状態に昇格させる構造で、SEOコンサル業務のラスト1マイルをエージェント化する野心的な設計だ。

3. Google Ads自動運用：監査スコアカード・RSAコピー生成・ランディング最適化

Google Adsカテゴリには4つのスキルが同梱される。役割分担は次のとおりだ。

初回監査が最も価値の重い1コマンド

READMEに掲載されたgoogle-ads-auditの実行例は、Toprankのコア機能を一望できる例として優れている。

You:    /toprank:google-ads-audit

Claude: Connected to your Google Ads account (MyStore).

        3 campaigns active. $2,400 spent this month.

        Scorecard:
        ┌──────────────────────┬──────────┬──────────────────────────────┐
        │ Dimension            │ Status   │ Summary                      │
        ├──────────────────────┼──────────┼──────────────────────────────┤
        │ Conversion tracking  │ OK       │ 3 actions firing correctly   │
        │ Keyword health       │ Critical │ 8 keywords burning cash      │
        │ Search term quality  │ Warning  │ 12 irrelevant queries        │
        │ Impression share     │ Warning  │ Losing 35% to rank           │
        │ Spend efficiency     │ Critical │ $340/mo wasted               │
        └──────────────────────┴──────────┴──────────────────────────────┘

        Top 3 actions:
        1. Pause 3 keywords ($210/mo, zero conversions)
        2. Add 12 negative keywords ($130/mo wasted on irrelevant terms)
        3. Increase bids 15% on 2 high-converting keywords losing IS

You:    Do it all.

        [paused 3 wasteful keywords — saved $210/mo]
        [added 12 negative keywords — saved $130/mo]
        [increased bids on 2 high-performers]

        Done. All changes are reversible within 7 days.

ここで注目すべきは、監査結果がそのまま実行可能なアクションリストに落ちる設計だ。SEMrushの監査結果は通常PDFや管理画面のチェックリストになるが、ToprankではClaudeとの対話で「Do it all.」と返すだけで連鎖実行される。Top 3 actionsの構造化が、Claude側の意思決定コスト削減にも効いている。

Weekly Review機能：実施した変更の効果を採点

/toprank:google-ads にはウィークリーレビュー機能が組み込まれている。READMEのサンプル出力では、12件の変更のうち9件が成熟済みで、Wins 4件・Losses 2件・成熟前 3件と分類されている。

特筆すべきは 2 changes had other edits on the same campaign within 7 days, so their direction is low-confidence. の一文だ。同一キャンペーンへの他編集の影響を信頼度として扱う設計で、A/Bテストの相互汚染を自動検知する。これは熟練マーケターでもしばしば見落とすバイアスだ。

このウィークリーレビュー機能は、Claude CodeのCoworker（定期実行ジョブ）として登録すれば毎週月曜朝に自動で出力させることができる。属人化していたレポート業務をエージェントに委譲する典型例だ。

4. Meta Ads自動運用：ROAS分析・クリエイティブ疲労診断・狭いMutation設計

Meta AdsはGoogle Adsと異なる事情を抱える。Pixel/CAPI周りの計測健全性、Learning Phase（学習期間）の挙動、クリエイティブ疲労、Audience Overlap——いずれもMeta固有の運用知識が必要だ。

Toprankのmeta-ads-auditは、これらをMeta特化の7次元で採点する。

監査結果は単発で終わらず、クリエイティブ在庫データ・ペルソナデータを永続化する。これは下流の/toprank:meta-adsスキルがコピー生成・A/B案出しを行うときに利用される設計で、監査ステップが「次のアクションのための知識ベース構築」を兼ねている。

Mutation API を「狭く・安全に」設計する思想

/toprank:meta-adsが呼び出せるMutationは以下に限定される。

# 停止系
pauseCampaign / pauseAdSet / pauseAd

# 再開系
enableCampaign / enableAdSet / enableAd

# 予算・命名
updateAdSetBudget / updateCampaignBudget / renameCampaign

逆に、新規キャンペーン作成・Audience編集・クリエイティブのアップロードはサーバー側に存在しない。これらの操作が必要な場合、スキルはユーザーをMeta Ads Managerの該当画面に誘導する設計だ。

これはAIエージェント設計の鉄則「Mutationのblast radius（影響範囲）は狭く保つ」を忠実に体現している。GoogleAdsのrunScriptに相当するrunScript（Meta側）も、ads.graphParallel([calls])で最大20並列のGraph API呼び出しを許すが、これは読み取り中心の分析fan-outに位置付けられている。

5. SEOスキル群と新しいGEO最適化（AI検索向け）

SEO/GEOカテゴリは9スキルで構成され、TopRankの中で最も多機能なカテゴリだ。

SEO監査の対話例

/toprank:seo-analysisはGSCデータを90日分読み込み、技術問題を含む診断を返す。READMEの実例を引用する。

You:    /toprank:seo-analysis

Claude: Found your site at mystore.com — pulling Search Console data now.

        [90 days of real traffic data loaded]
        [pages crawled for technical issues]

        Three things hurting you most:

        Your homepage lives at two addresses. Google splits your ranking
        power between them. Easy fix.

        Two pages targeting the same search terms — they compete against
        each other and neither wins.

        One page gets 400 monthly impressions but ranks #52. The title
        doesn't match what people actually search for.

        Here's your 30-day plan, most impactful first.

ここで読むべきは、Claudeが「人間っぽい言い回し」で問題を説明している点だ。「URLが2つに分裂してランク力が割れている」「2ページがカニバリして両方負けている」「タイトルが検索クエリと噛み合っていない」——これらは技術用語に頼らず本質を伝える表現で、非エンジニアの依頼主にもそのまま見せられる。SEOコンサル業務での説明工数を直接削れる設計だ。

GEO最適化：AI検索時代の必須スキル

/toprank:geo-optimizerはGenerative Engine Optimization——つまりAI検索エンジン（ChatGPT/Claude/Perplexity/Gemini/Google AI Overviews）からの引用最適化を専門に扱う。

具体的には次の3アウトプットを返す。

1. 0-100点のGEOスコア：現状コンテンツがAI検索でどれだけ引用されやすいかを定量評価
2. AI引用向けリライト案：Claude側の改稿提案
3. エンジン別戦略：ChatGPT/Claude/Perplexity/Gemini/AI Overviewsそれぞれの最適化戦略

AI検索からの流入比率が増加する2026年以降、GEOは従来SEOと併走必須の領域だ。1スキルでこの新領域までカバーしている点は、Toprankが単なる「SEMrushクローン」ではないことを示す重要な特徴だ。

コネクタ：MCPサーバーへの抽象化

各SEOスキルは外部ツールを ~~category プレースホルダで参照する設計になっている。READMEから抜粋する。

このプレースホルダ設計のおかげで、スキルはツール非依存だ。NotFair MCPが将来別実装に置き換わっても、スキルファイル自体は書き換え不要で動き続ける。コネクタが無い場合は graceful degradation（緩やかな縮退）が組み込まれており、GSC接続なしでも技術クロールだけは実行できる。

6. インストールから初回監査までの30秒手順

Toprankの導入は驚くほど短い。Claude Code内で2行打つだけだ。

/plugin marketplace add nowork-studio/toprank
/plugin install toprank@nowork-studio

これで/toprank:*の全スキルが利用可能になる。.mcp.jsonは自動配置され、NotFair MCPサーバーの登録も完了する。

手動セットアップ（settings.json直接編集派向け）

settings.jsonを手で編集したい場合は以下を追加する。

{
  "extraKnownMarketplaces": {
    "nowork-studio": {
      "source": {
        "source": "github",
        "repo": "nowork-studio/toprank"
      }
    }
  },
  "enabledPlugins": {
    "toprank@nowork-studio": true
  }
}

初回OAuth認証

/toprank:google-ads-auditを初めて実行すると、ブラウザタブが開き、notfair.coにサインインを促される。Googleアカウントで認可するとトークンがOSキーチェーンに保存され、以降は無言で動作する。Meta Adsも同様に初回OAuthが独立して走る。

設定ファイル：.notfair.json

各プロジェクトディレクトリに.notfair.jsonを配置し、Google AdsアカウントIDとMeta AdsアカウントIDを書く。

{
  "accountId": "123-456-7890",
  "metaAccountId": "act_9876543210",
  "site": "https://mystore.com"
}

両方を同じファイルに記述する設計のため、Google→Metaの切替え時に毎回サインインを促されることはない。

ピンとこない時のスモークテスト

/toprank:seo-analysisをSearch Console接続のみで実行するのが最も摩擦が低い。GSCのオーナー権限を持っているサイトを指定すれば、広告アカウントなしでも30分以内に最初の30日プランが手元に届く。

7. 競合・代替ツールとの比較（RustySEO/SEMrush/Promptfoo/Surfer）

Toprankの立ち位置を理解するため、隣接領域のツールと並べて比較する。

ToprankのユニークセリングポイントはBO列の「Mutation実行」だ。SEMrush・Ahrefs・Surferも分析能力は十分だが、最終的に管理画面に戻る前提で設計されている。ToprankはClaudeに「Do it all.」と返事するだけで実行されるため、運用ループが圧倒的に短い。

同じOSS×SEOの軸では RustySEO完全解説：Tauri+Rust製の無料デスクトップSEOツール、SEMrushの代替候補 が参考になる。RustySEOは自サイトGSC＋クロール特化のスタンドアロンアプリで、Toprankの「広告込み・CLI内自動実行」とは異なる方向のOSSだ。

Claude Code プラグイン群との比較

Claude Codeスキル/プラグイン群の中でもToprankは異色だ。

• Prismatic Skills：Claude Codeプラグインのマーケットプレイス基盤を解説 ——汎用的なスキル配布インフラ。Toprankはそれに乗る側。
• Addy Osmani Agent Skills：18K星のスキルフレームワーク基本セット ——汎用スキルのテンプレート集。Toprankは特定領域（マーケティング）特化型。
• Microsoft Waza：Agent Skillsの品質をCIで自動採点する評価フレームワーク ——スキル品質の物差し。Toprankはこの物差しで評価される側。

Toprankの位置付けは「特定業務領域に深く突っ込んだ垂直プラグイン」で、汎用スキル群とは差別化される。マーケティングという領域では、汎用LLMよりGSC/GoogleAds/MetaAdsのドメイン知識をスキル化した方が圧倒的に強い、というToprankチームの判断が読み取れる。

8. まとめ：Toprankを今日から使うべきユーザーと注意点

ここまで見たToprankの特徴を要約する。

今すぐ導入すべきユーザー

• 少人数で複数サイトのSEOを回す個人/小規模事業者：GSC監査・GEO最適化スキルだけで週数時間の節約効果。
• Google Adsを月10万円以上回す広告主：無駄キーワード自動停止・ネガティブ追加だけで投資対効果が明確に出る規模感。
• マーケティングエージェンシー：OpenClaw経由のマルチサイト管理が、クライアントポートフォリオの運用工数を大幅に削減する。
• SEOコンサル：監査レポート出力・クライアント向け説明工数の削減効果が大きい。

導入前に確認すべきこと

今後ウォッチすべきポイント

• OpenClaw／Hermesアダプティブ層の成熟度。フルオートSEOエージェントが本当に「人間レビュー無し」で回せるレベルに到達するか。
• GEOスキルの引用最適化アルゴリズムの進化。AI検索エンジン側のアルゴリズム変動に追従できるか。
• MCPサーバー追加の動向。現在はGoogle Ads/Meta Adsの2本だが、LinkedIn Ads・TikTok Ads・X Adsへの拡張があれば一気にカバレッジが広がる。
• 代替MCP対応の充実度。プレースホルダ抽象化が機能して、NotFairに依存しない構成が現実的に組めるか。

Toprankは「AIエージェントが本気で業務領域に侵食し始めた」象徴的なOSSだ。SEMrushを月数万円払って眺める時代から、Claude Codeに「直しといて」と一言投げるだけで完結する時代への移行を体感したい人は、まず/toprank:seo-analysisの1コマンドから試してほしい。

参照ソース

• nowork-studio/toprank — GitHub公式リポジトリ（README、スキル一覧、MCPサーバー仕様、OpenClawドキュメント）
• NotFair公式サイト notfair.co（Webアプリ側のNotFair、MCP OAuthエンドポイント）
• Model Context Protocol公式仕様（NotFair MCPサーバーが採用するOAuth 2.1ストリーマブルHTTPの基盤プロトコル）
• Google Ads API公式ドキュメント — GAQLリファレンス（NotFair-GoogleAdsのrunScriptが叩く対象クエリ言語）
• Meta Marketing API — Conversions APIガイド（meta-ads-auditが評価対象とするPixel/CAPIの計測健全性の参考）