Reddit Ads MCP

RedditAdsMcp

Reddit Ads API 用の C# MCP（Model Context Protocol）サーバーです。アカウント、キャンペーン、広告グループ、広告の一覧表示や、パフォーマンスレポートの取得を行う読み取り専用ツールを提供します。

.NET 10 と公式の ModelContextProtocol SDK で構築されています。

利用可能なツール

ツール	説明
ListAccounts	現在の認証情報でアクセスできるすべての Reddit 広告アカウントを一覧表示します
ListCampaigns	アカウントのキャンペーンを一覧表示します
ListAdGroups	広告グループを一覧表示します。キャンペーンでの絞り込みも可能です
ListAds	広告を一覧表示します。広告グループでの絞り込みも可能です
GetPerformanceReport	カスタムの日付範囲、フィールド、内訳を指定してパフォーマンスレポートを取得します
GetDailyPerformance	過去 N 日間のインプレッション、クリック数、広告費、CTR、CPC、eCPM を取得する便利なラッパーです

すべてのツールは省略可能な accountId パラメーターを受け付けます。省略した場合は、REDDIT_ACCOUNT_ID のデフォルトアカウントが使用されます。

前提条件

1. 有効な Reddit Ads 広告主アカウントを持つ Reddit アカウント
2. .NET 10 SDK

インストール

オプション A：dotnet ツールとしてインストール（推奨）

dotnet tool install -g RedditAdsMcp

次に、Claude Code を設定します（下記の手順 5bを参照）。

オプション B：クローンしてソースからビルド

git clone https://github.com/mkerchenski/RedditAdsMcp.git
cd RedditAdsMcp
dotnet build

次に、Claude Code を設定します（下記の手順 5aを参照）。

セットアップ

1. Reddit Ads API アプリを作成する

1. ads.reddit.com にアクセスします
2. 左側のサイドバーで、Developer Applications（アカウント／ビジネスの設定内）をクリックします
3. Create a new app をクリックし、以下を入力します。

フィールド	値
App name	Reddit Ads MCP
Description	MCP server for Reddit Ads reporting
About url	https://github.com/mkerchenski/RedditAdsMcp（または空欄のまま）
Redirect URI	https://hurrah.dev/oauth/reddit

Reddit では公開 HTTPS リダイレクト URI が必要です（localhost は使用できません）。上記の URL は、パッケージの作成者が管理するシンプルなコールバックページで、コピー用の認証コードを表示します。データは保存されません。代わりに、ご自身が管理する任意の HTTPS URL を使用することもできます。その場合は、手順 2～3 のリダイレクト URI を同じ URL に更新してください。

4. Create app をクリックします
5. App ID と Secret をコピーします。次の手順で両方必要になります

2. アプリを認証する

ブラウザーで次の URL を開き、YOUR_APP_ID を手順 1 で取得した App ID に置き換えます。

https://www.reddit.com/api/v1/authorize?client_id=YOUR_APP_ID&response_type=code&state=mcp&redirect_uri=https%3A%2F%2Fhurrah.dev%2Foauth%2Freddit&duration=permanent&scope=adsread

Allow をクリックします。認証コードが表示されるページにリダイレクトされるので、Copy をクリックします。

3. コードをリフレッシュトークンと交換する

次のコマンドを実行し、3 つのプレースホルダーを App ID、Secret、認証コードに置き換えます。

curl -X POST https://www.reddit.com/api/v1/access_token \
  -u "YOUR_APP_ID:YOUR_SECRET" \
  -A "ads-mcp/1.0" \
  -d "grant_type=authorization_code&code=YOUR_AUTHORIZATION_CODE&redirect_uri=https://hurrah.dev/oauth/reddit"

redirect_uri は、手順 1 で入力した値と完全に一致する必要があります。

レスポンス JSON には refresh_token フィールドが含まれています。取り消すまで有効なため、保存してください。

4. アカウント ID を確認する

1. ads.reddit.com にアクセスし、All accounts（左上のドロップダウン）をクリックします
2. 左側でビジネスを選択すると、右側に広告アカウントが表示されます
3. アカウント ID はアカウント名の下に表示される値です（例：a2_eaf73mplhhps）

5a. Claude Code を設定する（ソースから）

Claude Code の MCP 設定（プロジェクト内の .mcp.json または ~/.claude/settings.json）に追加し、4 つのプレースホルダー値を置き換えます。

"reddit-ads": {
  "type": "stdio",
  "command": "dotnet",
  "args": ["run", "--project", "/path/to/RedditAdsMcp", "--no-build"],
  "env": {
    "REDDIT_CLIENT_ID": "your_app_id",
    "REDDIT_CLIENT_SECRET": "your_secret",
    "REDDIT_REFRESH_TOKEN": "your_refresh_token",
    "REDDIT_ACCOUNT_ID": "your_account_id"
  }
}

5b. Claude Code を設定する（dotnet ツール）

"reddit-ads": {
  "type": "stdio",
  "command": "reddit-ads-mcp",
  "env": {
    "REDDIT_CLIENT_ID": "your_app_id",
    "REDDIT_CLIENT_SECRET": "your_secret",
    "REDDIT_REFRESH_TOKEN": "your_refresh_token",
    "REDDIT_ACCOUNT_ID": "your_account_id"
  }
}

Claude Code で /mcp を実行して確認します。reddit-ads サーバーに 6 つのツールが表示されます。

開発

dotnet build    # compile
dotnet run      # start MCP server on stdio
dotnet pack     # create NuGet package

ライセンス

MIT