Spresh Spy On Competitor Fb Ads

spreshapp-mcp

Claude を SpreshApp の Facebook 広告インテリジェンスプラットフォームに接続する MCP サーバーです。

---

Claude Desktop または Claude Code のセッションから、競合他社の調査、成果を上げている広告の訴求軸の解読、ブランドの広告履歴の追跡、保存した広告ライブラリの分析を Claude に依頼できます。

必要条件

• Node.js >= 20
• SpreshApp アカウント

セットアップ

Claude Desktop

claude_desktop_config.json に以下を追加します（macOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json）。

{
  "mcpServers": {
    "spreshapp": {
      "command": "npx",
      "args": ["-y", "spreshapp-mcp"]
    }
  }
}

保存した後、Claude Desktop を再起動してください。

Claude Code

claude mcp add spreshapp -- npx -y spreshapp-mcp

VS Code（MCP 拡張機能を使用）

{
  "mcp": {
    "servers": {
      "spreshapp": {
        "command": "npx",
        "args": ["-y", "spreshapp-mcp"]
      }
    }
  }
}

認証

MCP サーバーを起動する前に、一度認証してください。

npx -y spreshapp-mcp login

ブラウザーが開き、SpreshApp アカウントでログインできます（PKCE を使用する OAuth 2.0）。ログイン後、認証情報は ~/.spreshapp/credentials.json に保存され（ファイルモード 600）、各セッションの開始前に自動的に更新されます。

ヘッドレス環境またはリモートエージェント環境では、ブラウザーでの OAuth の代わりに、ダッシュボードから取得した SpreshApp API キーを使用してください。

npx -y spreshapp-mcp login --no-browser

ユーザーとエージェント向けのセットアップ手順が表示されます。ユーザーは spreshapp.com/app/api-access でキーを作成またはコピーできます。キーは sk_sprs_ で始まります。

MCP サーバーの環境変数にキーを設定します。

SPRESHAPP_API_KEY=sk_sprs_... npx -y spreshapp-mcp

高度なセットアップでは、OAuth トークン用の変数も引き続き使用できます：SPRESHAPP_ACCESS_TOKEN、SPRESHAPP_REFRESH_TOKEN、SPRESHAPP_CLIENT_ID、SPRESHAPP_TOKEN_EXPIRES_AT。

認証ステータスを確認します。

npx -y spreshapp-mcp status

再度ログインするには、次を実行します。

npx -y spreshapp-mcp logout
npx -y spreshapp-mcp login

利用可能なツール

広告ツール

ツール	説明
ad_search	キーワード、ニッチ、または業界で Facebook 広告を検索します
ad_search_expand_query	検索クエリを拡張して、関連性の高い広告をさらに見つけます
ad_get	特定の広告の詳細を取得します
ad_get_analysis	広告について保存された AI 分析を取得します
ad_analyze	任意の広告を AI で分析します
ad_analyze_batch	1 回の呼び出しで複数の広告を分析します
ad_chat	広告のクリエイティブ戦略について Claude とチャットします

ブランドツール

ツール	説明
brand_search	SpreshApp でブランドを検索します
brand_get_overview	ブランドのプロフィールと統計情報をすべて取得します
brand_get_status	ブランドの現在の追跡ステータスを取得します
brand_get_ad_history	ブランドの過去の広告数データを取得します
brand_list_active_ads	ブランドが現在配信しているすべての広告を一覧表示します
brand_follow	ブランドの追跡を開始します

ライブラリツール

ツール	説明
search_ads	保存した広告ライブラリを検索します
get_folder_ads	特定のフォルダーから広告を取得します
list_folders	保存したフォルダーをすべて一覧表示します
get_tags	ライブラリ全体で使用されているタグを一覧表示します
get_pages	保存した Facebook ページを一覧表示します

プロンプトの例

Find 10 high-performing Facebook video ads in the fitness niche and summarize the angles used.

Research Nike's current Facebook ad strategy, how many ads are they running and what are the themes?

Open my "Inspiration" folder and identify the top 3 creative hooks.

Track the brand glossier.com and show me their ad history over the last 30 days.

トラブルシューティング

症状	対処方法
ブラウザーが開かない	ターミナルに表示された URL をコピーして、手動で開いてください
「Authentication expired」エラー	~/.spreshapp/credentials.json を削除して、コマンドを再実行してください
「Not subscribed to any plan」	spreshapp.com/pricing にアクセスしてください
「Daily limit reached」	クォータは UTC の午前 0 時にリセットされます。または、プランをアップグレードしてください
「Feature not available」	現在のプランにはこのツールが含まれていません。spreshapp.com/pricing でプランをアップグレードしてください

License

UNLICENSED — proprietary software. See spreshapp.com for terms.