Reddit Ads

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

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

Claude Desktop、Claude Code、Cursorなど、stdio MCPに対応したクライアントを使い、ご自身のプラットフォーム認証情報でローカル実行できます。リクエストはプラットフォームに直接送信されます。対応するChatGPTのセットアップなど、管理された接続を利用するには、ホスト版をご利用ください。

新着情報

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

• getmcpadsのネイティブなReddit Ads API v3ツールを、名称、スキーマ、所有権チェックとともに移植しました。読み取りツール31個、書き込みツール22個に加え、リソースが2つあります。
• 2026-09-11時点のReddit独自のスキーマに照らして、書き込みペイロードをローカルで検証します。
• 広告アカウントの許可リストを明示的に指定する必要があります。デフォルトは読み取り専用で、すべての書き込みを事前にプレビューします。キャンペーン、広告グループ、広告は一時停止状態で作成されます。
• リフレッシュトークンを使ってアクセストークンをメモリ上で更新し、ディスクには保存しません。
• Redditの固定ホストを使用し、リダイレクトを無効にして、タイムアウトと応答サイズの上限を設け、認証情報をマスキングします。また、書き込みの自動リトライは行いません。
• 2026年10月のセキュリティ修正を含むNode.jsリリースが必要です。CIではNode 22、24、26をチェックします。
• ホスト版のクリエイティブUI、アラート、エクスポート、MCP Appsとの連携は含まれません。

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

ソース同期については、SOURCE_SYNC.mdをご覧ください。

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

Node.js 22.23.4、24.22.1、26.12.1、または各系列のそれ以降のリリースが必要です。CIではNode 22、24、26を対象としており、古いランタイムではサーバーがstderrに警告を出力します。書き込みは任意で、有効にするには明示的な確認が必要です。ホスト版のクリエイティブ連携とMCP Apps UIは、このリリースには含まれません。

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

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

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

MCP クライアントで、node を dist/cli.js の絶対パスおよび以下に記載されているプラットフォームの認証情報とともに実行するように設定してください。パッケージが npm で公開された後は、同じサーバーを npx -y @getmcpads/reddit-ads-mcp-server で実行できます。Claude Desktop の設定例は次のとおりです。

{
  "mcpServers": {
    "reddit-ads": {
      "command": "npx",
      "args": ["-y", "@getmcpads/reddit-ads-mcp-server"],
      "env": {
        "REDDIT_ADS_REFRESH_TOKEN": "your-refresh-token",
        "REDDIT_ADS_CLIENT_ID": "your-app-client-id",
        "REDDIT_ADS_CLIENT_SECRET": "your-app-secret",
        "REDDIT_ADS_ACCOUNT_IDS": "a2_abc123"
      }
    }
  }
}

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

設定

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

変数	用途
REDDIT_ADS_ACCESS_TOKEN	adsread を持つ OAuth アクセストークン。書き込みを有効にする場合は adsedit も必要です。3 つの更新用変数が設定されている場合は省略可能です。
REDDIT_ADS_REFRESH_TOKEN	永続的な更新トークン。以下の 2 つの変数と併用すると、サーバーはアクセストークンをメモリ上で更新します。
REDDIT_ADS_CLIENT_ID	Reddit アプリのクライアント ID。更新トークンと併用する場合に必要です。
REDDIT_ADS_CLIENT_SECRET	Reddit アプリのシークレット。更新トークンと併用する場合に必要です。
REDDIT_ADS_ACCOUNT_IDS	必須の広告アカウント ID。a2_abc123 のように、カンマ区切りで指定します。読み取りの場合も含め、指定したもの以外のアカウントは拒否されます。
REDDIT_ADS_ENABLE_WRITES	デフォルトは false です。値が正確に true の場合に限り、22 個の書き込みツールを公開します。
REDDIT_ADS_USER_AGENT	省略可能です。Reddit はクライアントに識別情報を示すよう求めています。例：node:my-ads-app:v1.0.0 (by /u/your_username)。

Reddit の Ads API ドキュメントの説明に従って、開発者アプリケーションを登録し、Ads API へのアクセスを申請してください。次に、スコープとして adsread を指定し、書き込みを有効にする予定の場合に限り adsedit も指定して、Reddit の OAuth 認可コードフローを実行します。更新トークンを受け取るには、duration=permanent も指定してください。 Reddit のアクセストークンは約 1 時間で期限切れになります。日常的に使用する場合は、更新トークンとアプリの認証情報を指定してください。アクセストークンのみの場合は、期限が切れるまで使用できます。 このパッケージはトークンを受け取ります。OAuth ブラウザーフローは実行せず、更新したトークンをディスクに書き込むこともありません。Reddit の広告アカウント ID は a2_ で始まります。ビジネス ID は別の値です。

npm run doctor を実行すると、値を表示せずに、どの変数が設定されているかと、使用中の Node.js リリースに 2026 年 10 月のセキュリティ修正が含まれているかを確認できます。最初の呼び出しでは reddit_health_check を実行してください。これにより、アカウント、そのビジネス、通貨、タイムゾーンが読み取られます。

安全性とカバレッジ

書き込みはデフォルトでプレビューされます。confirm: true を指定して再度呼び出す前に、対象アカウント、対象およびペイロードが正確であることを確認してください。 キャンペーン、広告グループ、広告は一時停止状態で作成されます。有効化すると広告予算を消費する可能性があり、configured_status を ACTIVE に設定するプレビューには activationMaySpend と表示されます。 結果が不確かな場合は、書き込みを自動的に再試行しないでください。まずアカウントを読み取って照合してください。サーバーが再試行するのは、HTTP 401 が返された場合に限り、トークンを更新したうえで一度だけです。これは、Reddit がそのリクエストを実行する前に拒否したためです。 アカウントの許可リストは、すべてのリクエストの前に適用されます。各エンティティの読み取りは、広告アカウントに対して直接、またはそのプロフィール、ビジネス、カタログを通じて確認されます。確認済みの書き込みの前には、参照されるキャンペーン、広告グループ、投稿、オーディエンス、ピクセル、商品セット、プロフィール、アセットも同様に確認されます。 書き込みペイロードは、2026-09-11 時点の Reddit のスキーマに固定して検証されます。請求フィールドと計算によって決まるステータスは拒否されます。ローカル検証に合格しても、プロバイダーが受け入れるとは限りません。 予算、入札額、SPEND はマイクロ通貨単位です。これはアカウント通貨の 100 万分の 1 です。その他のレポートフィールドは、それぞれのネイティブ単位のままです。ページネーションカーソルには、Reddit 独自のページトークンが使われます。

リクエストの送信先は ads-api.reddit.com と、トークン更新時の www.reddit.com のみです。リダイレクト先へのリクエストは行いません。各リクエストにはタイムアウトとレスポンスサイズの上限が設定されています。すべての結果とエラーで認証情報はマスキングされます。 Reddit が返すメディア URL はデータとしてそのまま渡されます。このサーバーがそれらをダウンロードすることはありません。

Reddit の一部の機能は意図的に公開していません。

• 顧客リストのメンバーのアップロードとコンバージョンイベントの注入。
• リードの送信と、個人記録のその他すべてのダウンロード。リードフォームは設定情報としてのみ読み取り可能です。
• 商品フィード、請求、資金調達手段。
• 破壊的な削除。ステータス更新で受け付けるのは PAUSED と ACTIVE のみで、保存済みオーディエンスを DELETED に設定することはできません。
• Reddit が 2026 年 9 月 21 日に終了した、オンサイトのリードフォーム作成。

このサーバーが公開するのは、レビュー済みの Reddit Ads API の一部です。上流に新しいエンドポイントが追加されても、自動的に公開されることはありません。ホスト型クリエイティブギャラリー、アラート、エクスポート、MCP Apps の UI は対象外です。 正確なスキーマは tools/list または server-card.json で確認してください。固定された書き込みスキーマについては reddit_get_write_schema、プロバイダーの詳細については Reddit の API リファレンス を参照してください。

ホスト型オプション

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

開発

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

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

ツール

すべてのツールを以下に一覧表示します。パラメーターと出力の完全なスキーマについては、server-card.json を参照してください。

31 個の読み取りツール

| ツール | 目的 | | --- | --- | | `reddit_get_setup_guide` | このサーバーの対象範囲、前提条件、単位、名称変更、既知の制限事項 | | `reddit_get_write_schema` | 1つの書き込み操作に関する固定のネイティブスキーマ。ターゲティングと形式を含みます | | `reddit_get_reporting_schema` | Reddit が受け付けるすべてのレポート指標と内訳名 | | `reddit_health_check` | 許可された広告アカウント、そのビジネス、通貨、タイムゾーンを確認します | | `reddit_get_campaigns` | ネイティブ設定とステータスを含むキャンペーンの一覧 | | `reddit_get_campaign` | アカウントを確認してから、1つのキャンペーンを取得します | | `reddit_get_ad_groups` | ネイティブ設定とステータスを含む広告グループの一覧 | | `reddit_get_ad_group` | アカウントを確認してから、1つの広告グループを取得します | | `reddit_get_ads` | ネイティブ設定とステータスを含む広告の一覧 | | `reddit_get_ad` | アカウントを確認してから、1つの広告を取得します | | `reddit_get_saved_audiences` | 保存済みオーディエンスの一覧 | | `reddit_get_saved_audience` | アカウントを確認してから、1つの保存済みオーディエンスを取得します | | `reddit_get_custom_audiences` | カスタムオーディエンスの一覧 | | `reddit_get_custom_audience` | アカウントを確認してから、1つのカスタムオーディエンスを取得します | | `reddit_get_lead_gen_forms` | リードフォームの設定を一覧表示します。リードの送信内容は取得しません | | `reddit_get_lead_form` | アカウントを確認してから、1つのリードフォーム設定を取得します | | `reddit_get_targeting` | 広告グループに設定されたターゲティングを取得します | | `reddit_get_targeting_options` | 有効な地域、言語、興味、デバイス、通信事業者、コミュニティを確認します | | `reddit_get_profiles` | 広告アカウントに紐づくプロフィールの一覧 | | `reddit_get_pixels` | 広告アカウントで利用できるピクセルの一覧 | | `reddit_get_insights` | 指標、最大3つの内訳、UTC の日付、ページネーションを指定してネイティブレポートを実行します | | `reddit_get_creative_assets` | 紐づくプロフィールのアセットライブラリを一覧表示します | | `reddit_get_posts` | 紐づくプロフィールの構造化投稿を一覧表示します | | `reddit_get_post` | プロフィールを確認してから、1つの構造化投稿を取得します | | `reddit_get_asset_uploads` | クリエイティブアセットのインポート処理をポーリングします | | `reddit_get_post_job` | 署名済みレシートを含む、構造化投稿作成ジョブをポーリングします | | `reddit_list_ad_creatives` | 対象範囲を明示して、広告に使われている画像や動画を特定します | | `reddit_get_catalogs` | 広告アカウントを所有するビジネスの商品カタログを一覧表示します | | `reddit_get_products` | 所有するカタログの商品を一覧表示します | | `reddit_get_product_sets` | 所有するカタログの商品セットを一覧表示します | | `reddit_get_catalog_imports` | 所有するカタログのインポートを一覧表示します |

22 個の書き込みツール

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

ツール	目的
reddit_create_campaign	キャンペーンを作成します。常に一時停止状態です
reddit_update_campaign	一時停止や再開を含む、キャンペーンの各フィールドを更新します
reddit_create_ad_group	広告グループを作成します。常に一時停止状態です
reddit_update_ad_group	ターゲティング、入札額、ステータスを含む、広告グループの各フィールドを更新します
reddit_create_ad	広告を作成します。常に一時停止状態です
reddit_update_ad	一時停止や再開を含む、広告の各フィールドを更新します
reddit_create_saved_audience	保存済みオーディエンスを作成します
reddit_update_saved_audience	削除せずに、保存済みオーディエンスを更新します
reddit_create_custom_audience	ピクセル、エンゲージメント、または空の顧客リストのオーディエンスを作成します
reddit_upload_creative_assets	画像、動画、見出しをプロフィールのアセットライブラリにインポートします
reddit_create_post	構造化投稿の作成ジョブを開始し、その受付情報を返します
reddit_create_catalog	所有するビジネスのための商品カタログを作成します
reddit_create_product_set	所有するカタログに商品セットを作成します
reddit_upsert_products	所有するカタログの商品を作成または更新します
reddit_rename_campaign	キャンペーン名のみを変更します
reddit_rename_ad_group	広告グループ名のみを変更します
reddit_rename_ad	広告名のみを変更します
reddit_rename_ad_account	広告アカウント名のみを変更します
reddit_update_post	構造化投稿でコメントを許可するかどうかを変更します
reddit_update_asset	クリエイティブアセットの名前を変更します
reddit_update_catalog	カタログ名またはイベントソースを更新します
reddit_update_product_set	商品セットの名前またはフィルターを更新します

リソース

リソース	内容
reddit-ads://guide	セットアップガイド。reddit_get_setup_guideからも取得できます
reddit-ads://reporting-catalog	カテゴリーと単位の注記を含むすべての指標、および内訳項目かどうかを示すすべてのディメンション

ライセンス

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]。