# Керуй Meta Ads з телефона через AI

Покроковий гайд: підключити Claude до реклами, дати йому пам'ять і сервіси, зібрати власного бота — і запускати кампанії з Telegram. Без коду на старті.

Модульно. Не обов'язково все одразу — обирай свій трек:
- Хочеш просто керувати з компа → стоп на Треку 1.
- Хочеш свого бота в Telegram → йди до кінця.

> ⚡ **Найшвидший шлях:** не обов'язково робити це руками. Кинь цей файл у Claude Code і напиши: «Ось інструкція — розбери її, питай у мене дані (токен, акаунт, валюта) і налаштуй усе сам». Claude проведе тебе по кроках і зробить більшість роботи за тебе.

> 🆘 **Застряг? У тебе є чит-код.** Тобі не треба нічого розуміти в коді — лише копіювати команди. Якщо крок незрозумілий або вискочила помилка — **зроби скріншот і кинь у Claude** з фразою «поясни простими словами, що це і що натиснути» (або «зроби це за мене»). Працює на будь-якому кроці гайда. Дурних питань тут не буває.

---

## Track 00 — База: Claude ↔ Meta Ads  `[Beginner]`

Мета: щоб у чаті ожила команда «покажи мої кампанії» і вона реально повертала дані з акаунта.

> 🚀 **Два шляхи.** Легкий (просто керувати з чату): офіційний **Meta Ads MCP** від самої Meta. У Claude: Customize → Connectors → + Add → Add custom connector, адреса `https://mcp.facebook.com/ads`, входиш своїм Facebook-акаунтом, без токенів і `.env`. Ручний/developer (кроки 2–4 нижче): свій токен + `.env` — треба для власного бота (Треки 4–5) чи повного контролю. Не впевнений — починай з конектора.

1. **Постав Claude.**
   - **Claude Desktop** — качаєш застосунок із claude.ai/download, більше нічого не треба. Найлегший старт.
   - **Claude Code** (термінал, потужніше, треба для Треків 4–5) — ставиться однією командою, Node.js не потрібен. На Mac:
     ```bash
     # 1) встановити Claude Code
     curl -fsSL https://claude.ai/install.sh | bash
     # 2) відкрити НОВЕ вікно терміналу і перевірити
     claude --version
     # 3) запуск у папці проєкту (перший раз попросить увійти в акаунт)
     claude
     ```
     Windows: у PowerShell `irm https://claude.ai/install.ps1 | iex`, далі кроки 2–3.
   > 💳 **Потрібна платна підписка.** Claude Code не працює на безкоштовному плані: потрібен Pro, Max, Team/Enterprise або API-акаунт (Console).
2. **Створи Meta App.** developers.facebook.com → Create App → тип Business → прив'яжи Business Manager з рекламним акаунтом.
3. **Згенеруй «вічний» токен.** НЕ з Graph API Explorer (живе 1–2 год). Зроби System User у Business Settings → System Users, видай доступ до акаунта, згенеруй токен зі scopes (при генерації обери термін дії **«Never»** — без закінчення):
   ```
   ads_management  ads_read  business_management  pages_manage_ads
   ```
   > Для старту вистачає `ads_read` (читати) + `ads_management` (керувати); решта — лише якщо керуєш активами бізнесу / Page-оголошеннями. Токен «Never» не має дати закінчення, але може стати недійсним при зміні пароля/прав → тоді перегенеруй (помилка 190).
4. **Підключи Meta до Claude.** Токен у `.env` (ніколи не коміть у git):
   ```
   META_ACCESS_TOKEN=EAAB...твій_system_user_token
   META_AD_ACCOUNT_ID=act_1234567890
   ```
   Далі агенту потрібен «місток» до Meta API. У Meta є офіційні: **Ads MCP** (`https://mcp.facebook.com/ads`, той самий, що в легкому шляху; у Claude Code додається через `claude mcp add`) і **Ads CLI** для розробників. Для власного бота можна й свій місток: попроси Claude згенерувати MCP-сервер для Meta Marketing API під твій токен.
   > `.env` — звичайний текстовий файл із ключами (як гаманець паролів), не викладай його публічно. 😌 Не хочеш руками? Скажи Claude: «створи .env з моїм Meta-токеном і налаштуй доступ до Meta» — зробить сам.
5. **Перша команда:**
   ```
   Покажи мої активні кампанії в Meta Ads і витрати за вчора
   ```
   Повернувся список → фундамент готовий.

> ⚠️ Новий app стартує на рівні Development. Ліміти Meta **динамічні** (по обсягу викликів і витрат акаунта), фіксованого числа немає. Для більших обсягів подай заявку на **Full access** (раніше Advanced Access): ліміти в рази вищі, а блок при перевищенні коротший (60 с замість 300 с).

---

## Track 01 — Керування рекламою через чат  `[Beginner]`

Все, що робив кліками, тепер робиться фразою. Пиши, як сказав би колезі.

**Розминка (база):**
- **Аналітика:** `Який ROAS по ринках за 7 днів? Топ-3 і аутсайдери`
- **Запуск:** `Залий креативи з цієї папки в SE, DE, FI. Згрупуй 3 формати кожного креатива (1:1 + 4:5 + 9:16) в одне оголошення, по одному оголошенню на продукт. Бюджет 20€/день на адсет, статус PAUSED`
  > ⚠️ За замовчуванням агент не вгадає, що треба мультиформат — зальє кожен файл окремо. Тому групування проси прямо в команді. Агент розуміє, що з чим групувати, **по назві файлу**: однаковий префікс + формат у кінці (`creativeA_1x1.mp4`, `creativeA_4x5.mp4`, `creativeA_9x16.mp4`). Сумніваєшся — додай «покажи прев'ю кожного оголошення перед запуском». Нюанс: працює для одиночних фото/відео; карусель так не вміє — для неї один формат (зазвичай 4:5).

**Вищий пілотаж — те, на що агенція витрачає години.** Тут агент думає як аналітик: шукає причину, рахує реальні гроші, прогнозує, пропонує дію. Кидай як є:

- **Креативна втома:** `Пройдись по всіх активних відео за 14 днів. Знайди ті, де CTR впав >25% від піку, а CPA росте — це вигоряння. Згрупуй по типу хука, скажи які виключати і який хук зараз працює найкраще`
- **Реальний прибуток (не ROAS від Meta):** `Зведи витрати Meta з виторгом Shopify по ринках за травень. Відніми COGS 35% і знижки. Покажи реальний прибуток — де ми справді в плюсі, а де Meta завищує ROAS`
- **Прогноз бюджету:** `При поточному темпі — скільки витратимо до кінця місяця? Виб'ємось за план 15k€? Якщо так — які адсети підрізати першими, не вбиваючи найкращі`
- **Адсети, що конкурують між собою:** `Пройдись по активних адсетах і знайди ті, що одночасно таргетять той самий ринок і схожу аудиторію (вік, стать, інтереси, custom audiences). Покажи такі пари з витратами й результатами і підкажи, що об'єднати чи вимкнути`
- **Діагностика просідання:** `Цього тижня ROAS впав. Розберись чому — CPM, CTR, конверсія, по яких ринках. Поясни простими словами і дай 3 дії на завтра`

> 🛟 Золоте правило: усе, що *змінює* рекламу, агент спершу показує планом і чекає «так». Нове ллєш у PAUSED → перевірив очима → активував. Останнє слово — за тобою.

---

## Track 02 — Пам'ять + кастомні інструкції  `[Beginner / Advanced]`

Секрет, що відрізняє іграшку від інструмента. Один раз описуєш правила бізнесу — агент перестає перепитувати й помилятися.

1. **Файл правил `CLAUDE.md`** у корені проєкту — агент читає на старті кожної розмови:
   ```
   ## Контекст бренду
   - Валюта акаунта — USD, показуй "$".
     # ← заміни на свою: EUR→"€", GBP→"£", PLN→"zł", SEK→"kr"…
   - Середній чек (AOV) ≈ $60. Поріг збитку = 2× AOV без покупки.
   - Ринки: US, UK, CA. Мова звітів — українська.
   ## Атрибуція
   - Партнерські адсети — лише 7-day click.
   ## Правила запуску
   - Нові оголошення — завжди PAUSED.
   - Перед запуском покажи план і чекай "так".
   ```
   🌍 **Локалізуй під себе** — це найважливіше: впиши свою валюту, AOV і ринки. У більшості це USD або EUR (у мене акаунт у SEK, тож прошу зводити в євро/долари за курсом). Тоді агент не плутатиме валюти у звітах.

2. **Довготривала пам'ять — 4 типи.** CLAUDE.md це *правила*; пам'ять це *накопичені факти* між розмовами. Самі файли пам'яті агент веде сам (CLAUDE.md вище — єдине, що редагуєш руками). Структура:
   ```
   MEMORY.md       # індекс-зміст: посилання на все нижче
   user_*.md       # хто ти: роль, преференції, стиль
   feedback_*.md   # твої правки/корекції — агент їх не повторює
   project_*.md    # стан проєктів: цілі, дедлайни, запуски
   reference_*.md  # де шукати: Asana, GA4, дашборди, доки
   ```
   Просто кажеш у чаті:
   ```
   Запам'ятай: UGC-хук у перші 3 сек дає CPA на ~30% нижче. Враховуй у рекомендаціях.
   Запам'ятай: не люблю простирадла тексту — звіти короткими блоками.
   ```
   Перше ляже в project/insight, друге — у feedback. Далі агент сам застосовує.

3. **Що це дає:** через тиждень агент знає твій бізнес краще за нового співробітника — валюту, пороги, стиль, історію рішень, чого ти не любиш. Перестає перепитувати й помилятись на тому, що вже виправляв.

> 🧠 Бонус: готовий `CLAUDE.md` + структуру пам'яті можна віддати під будь-який інший бізнес — його агент одразу «знає» свій ринок і правила. Описуєш систему раз, далі лише міняєш контекст.

---

## Track 03 — Підключити інші сервіси (MCP)  `[Advanced]`

MCP = універсальний «перехідник» для AI. Агент бачить замовлення, склад, календар, таблиці. З'являється справжня аналітика: не «скільки витратив», а «скільки заробив».

- **Shopify** — гроші й товари: `Зведи витрати Meta з net revenue Shopify по кожному ринку за минулий місяць. Реальний ROAS після знижок і повернень + який ринок найприбутковіший насправді`
- **Google + Asana** — Drive (креативи), Calendar (плани), Asana (таски).
- **Своя база (SQLite)** — історія запусків, лог рішень, метрики. Фундамент для самонавчання.

> 🔌 Як додати: Desktop → `claude_desktop_config.json` (macOS `~/Library/Application Support/Claude/`, Windows `%APPDATA%\Claude\`, або Settings → Developer → Edit Config); Claude Code → `claude mcp add`. Найлегше — попроси Claude «додай MCP для Shopify», він впише сам. Кожен сервіс = +1 суперсила.

---

## Track 04 — Зібрати власного бота  `[Advanced]`

Справжня сила — іменований агент із характером (у мене це Sigrid).

1. **Особистість** — system-промпт: хто він, як говорить, що вміє, чого ніколи не робить.
2. **Інструменти** — ті самі Meta/Shopify виклики як функції:
   ```
   while True:
       msg    = telegram.get_message()
       plan   = agent.think(msg, tools=[meta, shopify, db])
       result = agent.run(plan)
       telegram.reply(agent.summarize(result))
   ```
3. **Telegram-обгортка** — `python-telegram-bot` приймає повідомлення й віддає агенту.

> 🤖 Не обов'язково писати з нуля — Claude Code сам напише бот під твоє ТЗ. Реально навіть якщо ти не програміст.

---

## Track 05 — Винести на сервер → керувати з Telegram  `[Advanced]`

Агент живе на сервері 24/7. Пишеш або надиктовуєш голосом у Telegram — він робить роботу.

1. **VPS** — дешевий сервер (я на Hetzner, від ~5€/міс).
2. **Служба systemd** — піднімається сам після ребуту, не падає:
   ```
   sudo systemctl enable --now my-agent.service
   sudo systemctl status my-agent
   ```
3. **Міст у Telegram** — приймає повідомлення з телефона, віддає агенту, відповідь назад у чат. Писати самому вже не обов'язково: є **офіційний Telegram-плагін** Anthropic. Створи бота в @BotFather, далі в Claude Code:
   ```
   /plugin install telegram@claude-plugins-official
   /telegram:configure ТОКЕН_ВІД_BOTFATHER
   # перезапуск з каналом:
   claude --channels plugin:telegram@claude-plugins-official
   ```
   Напиши боту → отримаєш код → у Claude Code `/telegram:access pair КОД`, потім `/telegram:access policy allowlist` (писати агенту зможеш лише ти). Потрібен Bun; функція в research preview, команди можуть змінитись: https://code.claude.com/docs/en/channels
   > 📲 Ще простіше без бота: **Remote Control** — керуєш своєю сесією Claude Code з мобільного застосунку Claude або з claude.ai.
4. **Голос → текст** (Whisper): надиктував голосове → стало командою.
   ```
   🎤 «Зведи виторг і витрати по ринках за минулий тиждень і переведи все в євро»
   ```

> 📱 Кишеньковий медіабаєр: дані, паузи, запуски, звіти — з будь-якої точки, з екрана телефона.

---

## Часті помилки

| Код | Що значить | Що робити |
|---|---|---|
| 190 | Токен недійсний / відкликаний | Перегенеруй System User токен («Never») |
| 100 | Невірний параметр / поле | Перевір `act_…` ID, формат, обов'язкові поля |
| 4 (1504022) | Ліміт на запити статистики (Insights) | Зачекай і зменш кількість запитів; точного часу Meta не дає |
| 17 (2446079) | Ліміт запитів на рекламний акаунт | Блок на 5 хв (на Full access — 1 хв). Full access ще й піднімає сам ліміт |
| 80004 | Ліміт на кількість дій з акаунтом (Business Use Case) | Знизь частоту змін; скільки чекати — у заголовку відповіді `X-Business-Use-Case` |

## Чеклист перед запуском

- [ ] Токен — System User, у `.env`, не в git
- [ ] Правильний `act_…` акаунта
- [ ] Нові оголошення — PAUSED
- [ ] Креативи 1:1 / 4:5 / 9:16
- [ ] Ціль кампанії ↔ оптимізація узгоджені (ціль **Sales** → оптимізація на подію **Purchase**/конверсію)
- [ ] Перед активацією — глянув у Ads Manager

---

Сподобався гайд? Підписуйся — більше про AI, рекламу й автоматизацію: Instagram **@iknzvch**

_Зроблено з Claude · діли вільно · 2026_