Reddit Ads MCP Connector

MCP на простом языке для Reddit Ads API v3
Базовый адрес API: https://ads-api.reddit.com/api/v3

Задавайте вопросы на простом английском — не нужно запоминать пути к эндпоинтам или ID рекламных аккаунтов (если настроен один аккаунт).

Что умеет

Related MCP server: Google Ads API v20 MCP Server

Предварительные требования

1. Приложение Reddit на reddit.com/prefs/apps — тип web app или script

2. Запишите client ID (под названием приложения) и client secret

3. Refresh token с областью adsread (одноразовый OAuth — см. ниже)

Настройка (локально)

cd reddit-mcp-connector
python -m venv .venv
# Windows:
.venv\Scripts\activate
pip install -r requirements.txt
copy .env.example .env

Заполните .env:

REDDIT_CLIENT_ID=your_client_id
REDDIT_CLIENT_SECRET=your_secret
REDDIT_REFRESH_TOKEN=your_refresh_token
REDDIT_USER_AGENT=web:reddit-mcp-connector:v1.0.0 (by /u/YOUR_USERNAME)
REDDIT_AD_ACCOUNT_ID=t2_xxxxx   # optional but recommended

Запустите сервер:

python reddit_mcp_server.py --http

Слушает на http://127.0.0.1:8002/mcp.

Получение refresh token (один раз)

1. Соберите URL авторизации (замените плейсхолдеры):

https://www.reddit.com/api/v1/authorize?client_id=YOUR_CLIENT_ID&response_type=code&state=anything&redirect_uri=http://localhost:8080&duration=permanent&scope=adsread

2. Откройте его в браузере, подтвердите доступ, скопируйте code из URL перенаправления.

3. Обменяйте код:

curl -X POST https://www.reddit.com/api/v1/access_token ^
  -u "CLIENT_ID:CLIENT_SECRET" ^
  -d "grant_type=authorization_code&code=CODE&redirect_uri=http://localhost:8080"

4. Сохраните refresh_token из JSON-ответа в .env как REDDIT_REFRESH_TOKEN.

Ваш redirect URI в настройках приложения Reddit должен точно совпадать (например, http://localhost:8080).

Cursor (локально)

"reddit": {
  "url": "http://127.0.0.1:8002/mcp"
}

1. Держите сервер запущенным: python reddit_mcp_server.py --http

2. Cursor Настройки → MCP → обновить

3. reddit должен отображаться зелёным с инструментами вроде list_campaigns, get_performance_report, …

Затем спросите: «List my campaigns» или «Spend and impressions last 7 days».

Google Cloud Run

Разместите тот же HTTP MCP endpoint на Cloud Run.

Развёртывание

.\deploy-cloudrun.ps1 -ProjectId "YOUR_GCP_PROJECT_ID"

Учётные данные хранятся в Secret Manager в виде JSON (reddit-mcp-credentials). Скрипт запрашивает недостающие значения или читает их из .env.

Cursor (Cloud Run)

"reddit": {
  "url": "https://YOUR-CLOUD-RUN-URL/mcp"
}

Пользовательский коннектор Claude

Когда задан MCP_PUBLIC_URL (скрипт развёртывания делает это автоматически), включается Claude.ai OAuth + DCR.

1. Разверните с помощью .\deploy-cloudrun.ps1 -ProjectId "..."

2. Настройки → Коннекторы → Добавить пользовательский коннектор

3. URL: https://YOUR-SERVICE.run.app/mcp (обязательно должен включать /mcp)

4. Оставьте OAuth Client ID пустым (DCR включён)

Примеры запросов

• "List my Reddit ad accounts"

• "Show campaigns for my ad account"

• "Spend and impressions last 7 days"

• "Daily performance trend this month"

• "Break down performance by campaign"

• "List conversion pixels"

Инструменты

Примечание по безопасности

Развёртывание Cloud Run использует --allow-unauthenticated, поэтому MCP URL доступен. Claude OAuth ограничивает доступ к инструментам зарегистрированными клиентами. Относитесь к учётным данным и URL как к конфиденциальной информации.