# meta-ads

Подключает Meta Marketing API к ИИ-агенту для управления рекламой Facebook и Instagram, аудиториями, креативами и отчётами.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 91
- Автор: mikusnuz
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/mikusnuz/meta-ads-mcp
- Обновлён: 2026-10-19
- HTML: https://affpapa.org/nevibecode/mcp/meta-ads

## Что делает

meta-ads подключает Meta Marketing API v26.0 к Claude Code. MCP-сервер даёт 134 инструмента для кампаний, групп объявлений и рекламы, а также для аудиторий, креативов, статистики и каталогов. Через него можно создать кампанию, загрузить изображения, проверить показатели или найти публичные объявления в Facebook Ad Library.

Для отчётов за большие периоды предусмотрены асинхронные операции: сначала создаётся отчёт, затем забирается результат. Есть инструменты для A/B-тестов и автоматических правил, которые могут приостанавливать объявления по заданным условиям. Нужны Node.js 20 или новее, токен Meta Marketing API и числовой ID рекламного аккаунта без префикса `act_`. Без Node.js 20 в окружении `npx` сервер не запустится.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `META_ADS_ACCESS_TOKEN`, `META_AD_ACCOUNT_ID`, `META_APP_ID`, `META_APP_SECRET`, `META_BUSINESS_ID`, `META_PIXEL_ID` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env META_ADS_ACCESS_TOKEN=<META_ADS_ACCESS_TOKEN> --env META_AD_ACCOUNT_ID=<META_AD_ACCOUNT_ID> --env META_APP_ID=<META_APP_ID> --env META_APP_SECRET=<META_APP_SECRET> --env META_BUSINESS_ID=<META_BUSINESS_ID> --transport stdio meta-ads -- npx -y @mikusnuz/meta-ads-mcp
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add meta-ads --env META_ADS_ACCESS_TOKEN=<META_ADS_ACCESS_TOKEN> --env META_AD_ACCOUNT_ID=<META_AD_ACCOUNT_ID> --env META_APP_ID=<META_APP_ID> --env META_APP_SECRET=<META_APP_SECRET> --env META_BUSINESS_ID=<META_BUSINESS_ID> -- npx -y @mikusnuz/meta-ads-mcp
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "meta-ads": {
            "command": "npx",
            "args": [
                "-y",
                "@mikusnuz/meta-ads-mcp"
            ],
            "env": {
                "META_ADS_ACCESS_TOKEN": "<META_ADS_ACCESS_TOKEN>",
                "META_AD_ACCOUNT_ID": "<META_AD_ACCOUNT_ID>",
                "META_APP_ID": "<META_APP_ID>",
                "META_APP_SECRET": "<META_APP_SECRET>",
                "META_BUSINESS_ID": "<META_BUSINESS_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "meta-ads": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mikusnuz/meta-ads-mcp"
            ],
            "env": {
                "META_ADS_ACCESS_TOKEN": "<META_ADS_ACCESS_TOKEN>",
                "META_AD_ACCOUNT_ID": "<META_AD_ACCOUNT_ID>",
                "META_APP_ID": "<META_APP_ID>",
                "META_APP_SECRET": "<META_APP_SECRET>",
                "META_BUSINESS_ID": "<META_BUSINESS_ID>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e META_ADS_ACCESS_TOKEN=<META_ADS_ACCESS_TOKEN> -e META_AD_ACCOUNT_ID=<META_AD_ACCOUNT_ID> -e META_APP_ID=<META_APP_ID> -e META_APP_SECRET=<META_APP_SECRET> -e META_BUSINESS_ID=<META_BUSINESS_ID> meta-ads npx -y @mikusnuz/meta-ads-mcp
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

## Когда брать
- создать кампанию Facebook с группами объявлений и рекламами
- проверить показатели аккаунта или кампании за выбранный период
- приостановить кампании с ROAS ниже заданного порога
- настроить A/B-тест для двух креативов
- собрать аудиторию и похожую аудиторию из данных клиентов

## Примеры запросов агенту
- Создай кампанию Facebook, группу объявлений и рекламу с подходящим креативом.
- Проверь показатели кампании за сегодня и назови объявления с низким ROAS.
- Найди публичные объявления конкурента через Facebook Ad Library.

## Похожие
- [labelhead-artist-momentum](https://affpapa.org/nevibecode/mcp/labelhead-artist-momentum.md) — MCP-сервер · ★ 107423
- [openshorts](https://affpapa.org/nevibecode/mcp/openshorts.md) — MCP-сервер · ★ 7049
- [OpenScreen](https://affpapa.org/nevibecode/mcp/openscreen.md) — MCP-сервер · ★ 4863
- [Usertour MCP Server](https://affpapa.org/nevibecode/mcp/usertour-mcp-server.md) — MCP-сервер · ★ 2326
- [Appllama](https://affpapa.org/nevibecode/mcp/appllama.md) — MCP-сервер · ★ 3046
- [obsei](https://affpapa.org/nevibecode/mcp/obsei.md) — MCP-сервер · ★ 1441

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md