Snapchat Ads

この映像では、サンプルデータを使ったホスト型 getmcpads を紹介しています。クリエイティブギャラリーやアラートから Google Sheets へのエクスポート、一括公開まで、MCP Apps はホスト型製品に含まれます。このリポジトリでは、スタンドアロンのネイティブ API ツールを提供します。

読み取りツール 21 個 · 書き込みツール 25 個（デフォルトで無効）。

Snap Marketing API の認証情報と、Claude Desktop、Claude Code、Cursor など stdio MCP に対応したクライアントを使って、ローカルで実行します。リクエストは Snap に直接送信されます。対応する ChatGPT の構成を含む、管理された接続を利用する場合は、ホスト型オプションをお使いください。

新着情報

v1.0.0：初のスタンドアロンリリース · 2026 年 10 月 23 日

• getmcpads ゲートウェイのリビジョン 3e1c2c8 から移植した、初のスタンドアロンサーバーです。ネイティブ読み取りツール 21 個、ネイティブ書き込みツール 25 個、および snapchat://guide と snapchat://reporting-fields リソースを提供します。
• SNAPCHAT_ADS_ACCOUNT_IDS を必須とし、選択した広告アカウントに対して、すべてのリクエストと参照先エンティティを検証します。
• SNAPCHAT_ADS_ENABLE_WRITES が正確に true でない限り、書き込みを無効にします。すべての書き込みは confirm: true になるまでプレビューされ、キャンペーン、広告スクワッド、広告は一時停止状態で作成されます。
• 更新用認証情報を使って、アクセス トークンをメモリ内で更新します。どこにも書き込まず、すべてのエラーから認証情報を除去します。
• 接続先を adsapi.snapchat.com と accounts.snapchat.com のみに制限し、リダイレクトを追跡せず、タイムアウトと 16 MB のレスポンス上限を設定します。
• HTTP 200 の応答にリクエストの失敗または失敗した項目が含まれる場合はエラーとして報告し、単一作成の明示的な拒否は適用されなかったものとして報告します。
• ホスト型の凍結ファイルのアップロード、クリエイティブギャラリー UI、アラート、Launcher は含まれません。
• Node.js 22.23.4、24.22.1、26.12.1、またはそれらの系列の新しいバージョンを必須とします。それ以外の場合は stderr に警告を表示し、CI では Node 22、24、26 をテストします。

変更履歴の全文 · すべてのリリース

ソースの同期： SOURCE_SYNC.md。

アップグレードに関する注意

Node.js 22.23.4、24.22.1、26.12.1、またはそれらの系列の新しいリリースが必要です。これらのリリースには 2026 年 10 月のセキュリティ修正が含まれており、古いバージョンで実行すると、サーバーは stderr に警告を表示します。CI では Node 22、24、26 を対象としています。書き込みは引き続き任意で、明示的な確認が必要です。ホスト型のクリエイティブ連携と MCP Apps UI は、このリリースには含まれません。

このリリースをインストールする

これは GitHub のソースリリースです。npm と MCP Registry のバージョンは別途公開されています。以下のコマンドはこの特定のバージョンを選択します。このドキュメントの後半にある、バージョンを固定していない npx の例では、現在 npm で入手できるバージョンが選択されます。

git clone --branch v1.0.0 --depth 1 https://github.com/get-mcp-ads/snapchat-ads-mcp-server.git
cd snapchat-ads-mcp-server
npm ci
npm run build

MCP クライアントで、以下に記載する環境変数を使って、dist/cli.js の絶対パスを指定して node を実行するように設定してください。

マネージド接続。 ホスト型 getmcpads で Snapchat Ads を使う。アカウントを接続し、アシスタントがアクセスできるデータを選択して、ホスト型 MCP 接続を使います。現在の機能とプランについては、サイトをご覧ください。

設定

クライアントのシークレット設定を通じて、以下の環境変数を指定してください。

変数	目的
SNAPCHAT_ADS_ACCOUNT_IDS	必須。このサーバーが使用できる広告アカウントの UUID をカンマ区切りで指定します。ほかのアカウントへのリクエストは、マシンから送信される前に拒否されます。組織 ID は広告アカウント ID ではありません。
SNAPCHAT_ADS_REFRESH_TOKEN	独自の Snap Marketing API OAuth アプリから取得したリフレッシュトークンです。以下の 2 つの変数と併用すると、サーバーはアクセストークンをメモリ内で更新します。
SNAPCHAT_ADS_CLIENT_ID	その OAuth アプリのクライアント ID です。
SNAPCHAT_ADS_CLIENT_SECRET	その OAuth アプリのクライアントシークレットです。
SNAPCHAT_ADS_ACCESS_TOKEN	任意のアクセストークンです。単独で使用した場合、Snap によって期限切れにされるまで有効で、その期間は 1 時間です。リフレッシュ用の認証情報と併用した場合は、最初に使用されます。
SNAPCHAT_ADS_ENABLE_WRITES	デフォルトは false です。正確な値が true の場合に限り、書き込みツールが公開されます。それ以外の値では、サーバーは起動時に停止します。

SNAPCHAT_ADS_ACCESS_TOKEN、または 3 つのリフレッシュ用変数をすべて設定してください。サーバーは起動時に設定を検証し、修正が必要な変数名を示しますが、値は繰り返し表示しません。

認証情報を取得するには、Snap Marketing API 用の OAuth アプリを作成し、snapchat-marketing-api スコープで一度認可してから、Snap の認証ガイドの説明に従って認可コードをリフレッシュトークンと交換します。このパッケージは OAuth のブラウザーフローを実行しません。更新されたトークンはメモリ内にのみ保持されるため、再起動すると、設定したリフレッシュトークンを使って再び処理を開始します。

パッケージが npm で公開された後のクライアント設定例：

{
  "mcpServers": {
    "snapchat-ads": {
      "command": "npx",
      "args": ["-y", "@getmcpads/snapchat-ads-mcp-server"],
      "env": {
        "SNAPCHAT_ADS_ACCOUNT_IDS": "your-ad-account-uuid",
        "SNAPCHAT_ADS_REFRESH_TOKEN": "your-refresh-token",
        "SNAPCHAT_ADS_CLIENT_ID": "your-client-id",
        "SNAPCHAT_ADS_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

npm run doctor は、各変数が設定されているかどうかを値を表示せずに報告し、お使いの Node.js リリースに 2026 年 10 月のセキュリティ修正が含まれているかどうかも知らせます。

安全性と対象範囲

書き込みはデフォルトでプレビューされます。confirm: true を指定して再度呼び出す前に、対象のアカウント、対象項目、パラメーターを正確に確認してください。 キャンペーン、広告グループ、広告は一時停止状態で作成されます。snapchat_update_status による有効化は広告予算を消費する可能性があり、プレビューにもその旨が表示されます。 結果が不確かな書き込みは再試行されません。書き込み後のタイムアウト、ネットワーク障害、サーバーエラー、または読み取れない応答は、結果不明として報告されます。まずエンティティを読み取り、状態を照合してください。書き込みが成功した場合は、アカウントスコープの読み取りで結果を確認し、その確認に失敗した場合もレシートは保持されます。 書き込みの前に、親エンティティと、参照されるすべてのピクセル、アプリ、オーディエンス、メディア、クリエイティブ、リードフォームを読み取り、選択した広告アカウントと照合します。不明な引数は拒否されます。 Snap は、HTTP 200 でも request_status または個別項目が失敗を示す場合があります。どちらもエラーとして報告されます。単一作成リクエストが明示的に検証で拒否された場合は、applied: false として報告されます。 _micro で終わる金額フィールド、spend、金額単位のコンバージョン値は、マイクロ通貨単位です。1,000,000 がアカウント通貨の 1 単位に相当します。リストツールは次のページを示す next_cursor を返し、インサイトは Snap が次のページを返した場合に partial: true を示します。 Snap のドキュメントには、アプリあたり毎秒約 20 件、アクセストークンあたり毎秒 10 件のリクエストが記載されています。HTTP 429 は、待機するよう指示して報告されます。

リクエストの送信先は adsapi.snapchat.com と、トークン更新用の accounts.snapchat.com のみです。リダイレクト先へのリクエストは行わず、すべてのリクエストにタイムアウトを設定し、応答サイズは 16 MB 以下に制限しています。Snap が返すメディアリンクはデータとして引き渡し、ダウンロードすることはありません。すべてのエラーでトークンは伏せられます。

アップロードには base64 バイト列を使用します。画像は 5 MB まで、直接アップロードする動画は 10 MiB までです。マルチパートツールでは、8 MiB 単位のパートを使って最大 256 MiB の動画をアップロードできます。アップロード後は、ready が true になるまで snapchat_get_media_status を呼び出してください。ゲートウェイにある 4 つの固定ファイルアップロードツールは、ホストされた Launcher ストレージからファイルを読み取るため、このサーバーには含まれません。ゲートウェイのネイティブアップロードはバイト列を受け取り、URL を取得しないため、このサーバーにはローカルファイルや URL を使ったアップロード機能もありません。

このサーバーは、Snap Marketing API の確認済みサブセットを公開します。正確なスキーマについては tools/list または server-card.json を、単位や厳選されたレポートフィールドについては snapchat://guide および snapchat://reporting-fields リソースを、プロバイダーの詳細については公式 API リファレンスを参照してください。

Snap 公式 Ads MCP サーバー

Snap は独自の Snapchat Ads MCP server を公開しています。以下の比較は、2026 年 10 月 23 日に確認した Snap の概要と接続ガイドのみを使用しています。

	Snap の Ads MCP サーバー	このサーバー
実行場所	HTTP 経由で接続するリモートエンドポイント、https://mcp.snapchat.com/ads	お使いのマシン上、stdio 経由
アクセス	読み取り専用：エージェントは何も作成、更新、削除できません。Snap は将来のリリースで書き込みアクセスを提供する予定です。	読み取りツール 21 個、有効化すると書き込みツール 25 個
認可	Snap がサポート対象の各エージェント用に登録したクライアント ID を使う OAuth。組織の管理者がエージェントを承認し、その後、各メンバーが認可します。	環境変数で設定する、ご自身の Snap Marketing API OAuth アプリ
アカウントの範囲	メンバーの Snapchat Ads 権限で許可される組織と広告アカウント	SNAPCHAT_ADS_ACCOUNT_IDS に含まれる広告アカウントのみ

ホスト型オプション

getmcpads for Snapchat Ads は、ホスト型接続とアカウントの選択を管理します。 ホスト版とソース版では、リリース内容が異なる場合があります。お問い合わせ先：[email protected]。

開発

npm run typecheck
npm run lint
npm run build
npm test
npm run catalog

すべてのテストは、合成レスポンスとモックした fetch を使ってオフラインで実行されます。実際のアカウントが読み取られたり、変更されたりすることはありません。

ツール

すべてのツールを以下に記載しています。完全なパラメーターと出力スキーマについては、server-card.json を参照してください。アドスクワッドは、Snap の広告グループです。

21 個の読み取りツール

ツール	目的
snapchat_health_check	選択した広告アカウント、そのタイムゾーン、通貨、テストフラグを読み取ります。テストアカウントでは広告を配信できません。
snapchat_get_campaigns	選択したアカウントのキャンペーンを、ネイティブ設定とページネーション情報とともに一覧表示します。
snapchat_get_adsquads	選択したアカウントのアドスクワッドを一覧表示します。
snapchat_get_ads	選択したアカウントの広告を一覧表示します。
snapchat_get_creatives	選択したアカウントのクリエイティブを一覧表示します。
snapchat_get_media	選択したアカウントのメディアを一覧表示します。
snapchat_get_segments	選択したアカウントのオーディエンスセグメントを一覧表示します。
snapchat_get_creative_elements	コレクション広告のタイルであるクリエイティブ要素を一覧表示します。
snapchat_get_interaction_zones	コレクション広告のインタラクションゾーンを一覧表示します。
snapchat_get_lead_generation_forms	リード獲得フォームを一覧表示します。
snapchat_get_media_status	1 つのメディアオブジェクトとその処理状態を読み取ります。クリエイティブを作成できるのは、ready: true の場合のみです。
snapchat_list_ad_creatives	ストーリー広告の子要素やコレクション広告のタイルを含め、広告に使用されている画像と動画を新しいメディアリンクとともに特定します。
snapchat_get_targeting	設定済みのアドスクワッドのターゲティング、オーディエンス、除外、地域、掲載枠を読み取ります。
snapchat_get_entity	キャンペーン、アドスクワッド、広告、クリエイティブ、メディア、セグメント、クリエイティブ要素、インタラクションゾーン、リードフォームのいずれか 1 つを、所有権を検証したうえで読み取ります。
snapchat_get_write_schema	作成と編集でこのサーバーが受け付けるフィールドと、必須フィールドを説明します。
snapchat_get_insights	期間、粒度、エンティティの内訳、任意の配信ピボットを指定して、ネイティブ統計を読み取ります。
snapchat_get_mobile_apps	アカウントに関連付けられた Snap App ID を読み取ります。
snapchat_get_pixels	アカウントに関連付けられたピクセルを読み取ります。
snapchat_get_targeting_specs	500 件を超える条件を含め、別途保存されたターゲティング仕様を読み取ります。
snapchat_get_targeting_options	国、地域、大都市圏、郵便番号、言語、性別、年齢層、興味、デバイスなど、ネイティブのターゲティング値を確認します。
snapchat_get_setup_guide	目標、オーディエンスのワークフロー、フォーマットの前提条件、このサーバーの制限を読み取ります。

25 個の書き込みツール

デフォルトでは無効です。明示的に確認しない限り、呼び出しはプレビューを実行します。使用前に設定と正確なスキーマを確認してください。

ツール	用途
snapchat_create_campaign	キャンペーンを作成します。常に一時停止状態になります。
snapchat_update_campaign	キャンペーンの設定を更新します。
snapchat_create_adsquad	キャンペーン配下に広告セットを作成します。常に一時停止状態になります。
snapchat_update_adsquad	広告セットのターゲティング、スケジュール、予算、その他の設定を更新します。
snapchat_create_ad	広告セット配下に広告を作成します。常に一時停止状態になります。
snapchat_update_ad	広告の設定を更新します。
snapchat_create_creative	メディア、公開プロフィール、コールトゥアクションを確認したうえで、クリエイティブを作成します。
snapchat_update_creative	クリエイティブの設定を更新します。
snapchat_create_media	メディアをアップロードするためのメディアオブジェクトを作成します。
snapchat_create_segment	顧客リスト、ピクセル、モバイル、エンゲージメントのいずれかのオーディエンスセグメントを作成します。
snapchat_create_creative_element	コレクション広告用のクリエイティブ要素を作成します。
snapchat_create_interaction_zone	クリエイティブ要素からインタラクションゾーンを作成します。
snapchat_create_lead_generation_form	リード獲得フォームを作成します。
snapchat_rename_campaign	1つのキャンペーンの名前を変更します。変更されるのは名前のみです。
snapchat_rename_adsquad	1つの広告セットの名前を変更します。変更されるのは名前のみです。
snapchat_rename_ad	1つの広告の名前を変更します。変更されるのは名前のみです。
snapchat_rename_ad_account	広告アカウントを読み取った内容に新しい名前を設定して書き戻し、名前を変更します。
snapchat_update_status	キャンペーン、広告セット、広告を一時停止または有効化します。有効化すると予算を消費する場合があります。
snapchat_upload_media	Base64形式の画像または動画データをメディアオブジェクトにアップロードします。
snapchat_update_segment	オーディエンスセグメントの名前、説明、または保持期間を変更します。
snapchat_update_audience_users	正規化した SHA-256 ハッシュとして、顧客リストのメンバーを追加または削除します。
snapchat_create_lookalike	所有する顧客リストから類似オーディエンスを作成します。
snapchat_init_media_upload	最大 256 MiB の動画のマルチパートアップロードを開始します。
snapchat_upload_media_part	マルチパート動画アップロードのパートを1つアップロードします。
snapchat_finalize_media_upload	マルチパート動画アップロードを完了します。

リソース

リソース	内容
snapchat://guide	単位、ページネーション、書き込み時の安全性、アップロード制限、レート制限。
snapchat://reporting-fields	snapchat_get_insights のために厳選された統計フィールドと内訳。

ライセンス

Apache License 2.0。NOTICE を参照してください。

getmcpads のその他のサービス

Meta Ads · Google Ads · Google Analytics 4 · Google Search Console · TikTok Ads · Pinterest Ads · X Ads

getmcpads の Emmanuel がメンテナンスしています。お問い合わせ：[email protected]。