AdSense MCP

MCP-сервер, который извлекает данные ad-hoc из AdSense Management API v2. Он предоставляет неограниченный интерфейс отчетов: любые поддерживаемые измерения, метрики, фильтры, временной период, порядок сортировки, часовой пояс, язык, валюта и лимит AdSense могут быть переданы в accounts.reports.generate.

Сервер использует OAuth-область только для чтения https://www.googleapis.com/auth/adsense.readonly. Он не записывает данные в аккаунт AdSense.

Установка

После публикации запустите его из MCP-клиента с помощью npx -y @sirmacke/adsense-mcp. Настройте либо ADSENSE_ACCESS_TOKEN, либо все три: ADSENSE_CLIENT_ID, ADSENSE_CLIENT_SECRET и ADSENSE_REFRESH_TOKEN.

Related MCP server: google-ads-mcp

Безопасность

OAuth-токены доступа, refresh-токены и секреты клиента являются учетными данными. Не храните их в этом репозитории, в трекерах задач, в истории командной оболочки и в конфигурации MCP, которой вы делитесь с другими. Если один из них раскрыт, немедленно отзовите его в Google Cloud; см. SECURITY.md.

Настройка

1. В Google Cloud включите AdSense Management API и создайте OAuth Desktop-клиент.

2. Получите refresh-токен с областью https://www.googleapis.com/auth/adsense.readonly. Держите его в секрете.

3. Скопируйте .env.example в вашу защищенную конфигурацию окружения и заполните либо ADSENSE_ACCESS_TOKEN, либо идентификатор клиента OAuth, секрет и refresh-токен.

4. Установите и соберите:

npm install
npm run build

Одноразовая авторизация OAuth (без gcloud)

Скачайте JSON OAuth Desktop-клиента из Google Cloud, затем выполните:

$env:ADSENSE_OAUTH_CLIENT_FILE = "C:\secure\adsense-client.json"
$env:ADSENSE_TOKEN_FILE = "C:\secure\adsense-oauth.json"
npm run authorize

Команда открывает экран согласия Google на callback localhost и сохраняет идентификатор клиента, секрет клиента и refresh-токен только в приватном файле токенов. Скопируйте эти значения в поля ADSENSE_CLIENT_ID, ADSENSE_CLIENT_SECRET и ADSENSE_REFRESH_TOKEN конфигурации MCP. Не оставляйте внешний экран согласия в статусе «Тестирование»: его refresh-токены истекают через семь дней.

Claude Desktop

Текущие сборки Claude Desktop используют расширения. Выполните npm run package, затем установите build/adsense-mcp.mcpb через Настройки → Расширения → Дополнительные настройки → Установить расширение. Он безопасно запросит значения OAuth. В установках, поддерживающих классическую конфигурацию, добавьте вместо этого:

{
  "mcpServers": {
    "adsense": {
      "command": "node",
      "args": ["/absolute/path/to/adsense-mcp/dist/index.js"],
      "env": {
        "ADSENSE_CLIENT_ID": "...",
        "ADSENSE_CLIENT_SECRET": "...",
        "ADSENSE_REFRESH_TOKEN": "..."
      }
    }
  }
}

Codex

Добавьте эквивалентное определение сервера в вашу конфигурацию Codex MCP, используя ту же команду, аргументы и переменные окружения. Сервер использует стандартный транспорт MCP stdio и работает в обоих клиентах.

Инструменты

• adsense_list_accounts

• adsense_get_account

• adsense_generate_report

Пример запроса отчета: metrics: ["ESTIMATED_EARNINGS", "PAGE_VIEWS", "CLICKS"], dimensions: ["DATE", "COUNTRY_NAME"], dateRange: "LAST_7_DAYS", orderBy: ["-ESTIMATED_EARNINGS"].

Проверка

npm test
npm run build

Для проверки на живых данных также требуются указанные выше значения OAuth и аккаунт AdSense. Конечная точка отчета API — GET /v2/{account}/reports:generate; для нее требуется область OAuth AdSense или AdSense только для чтения.

Лицензия

MIT