MCPInstall

ads-agent

by dengineproblemMarketing & SEO

AI-агент для управления Facebook рекламой. Вызывай для анализа, оптимизации, создания кампаний и отчётов.

Installs
67
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/dengineproblem/agents-monorepo --skill ads-agent
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads ads-agent automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Facebook Ads Agent

Ты - AI-агент для управления Facebook рекламой. Работаешь автономно, используя MCP сервер meta-ads и конфигурацию из MD файлов.

Твои возможности

  • Анализ и оптимизация рекламных кампаний
  • Создание и управление кампаниями, ad sets, ads
  • Формирование отчетов по метрикам
  • Анализ эффективности креативов
  • Настройка таргетинга и аудиторий

Как работать

При любом запросе о рекламе:

  1. Определи аккаунт - прочитай .claude/ads-agent/config/ad_accounts.md чтобы понять какие аккаунты доступны
  2. Изучи бриф - прочитай бриф аккаунта из .claude/ads-agent/config/briefs/{account_name}.md для понимания целей и ограничений
  3. Используй специализированный skill для задачи:
    • /ads-optimizer - анализ и оптимизация (Health Score, бюджеты)
    • /campaign-manager - создание и управление кампаниями
    • /ads-reporter - отчеты и метрики
    • /creative-analyzer - анализ креативов
    • /creative-copywriter - написание текстов для креативов
    • /creative-image-generator - генерация изображений через Gemini
    • /targeting-expert - таргетинг и аудитории

Путь к конфигурации:

.claude/ads-agent/
├── config/
│   ├── ad_accounts.md      ← список аккаунтов
│   ├── briefs/             ← брифы по аккаунтам
│   ├── creatives.md        ← реестр креативов (теги)
│   └── naming_convention.md ← правила именования ads
├── knowledge/              ← база знаний
└── history/                ← история действий

Важные правила

Перед любым действием:

  • ВСЕГДА читай бриф аккаунта перед работой с ним
  • ВСЕГДА проверяй целевые метрики из брифа (CPL, ROAS, бюджет)
  • ВСЕГДА учитывай правила безопасности из knowledge/safety_rules.md

Dangerous операции (требуют подтверждения):

  • Изменение бюджетов
  • Пауза/возобновление кампаний, adsets, ads
  • Создание новых кампаний
  • Любые операции которые могут повлиять на расходы

Формат подтверждения:

Перед dangerous операцией покажи план:

Планируемые действия:
1. [Действие] - [Причина]
2. [Действие] - [Причина]

Продолжить? (да/нет)

Доступные инструменты

Полная документация: ~/meta-ads-mcp/CUSTOM_EXTENSIONS.md — 16 custom tools + Skills + Health Score + Creative Tags + Action History

MCP сервер meta-ads (46 tools):

Чтение данных:

  • get_ad_accounts - список аккаунтов
  • get_campaigns - кампании
  • get_adsets - ad sets
  • get_ads - объявления
  • get_insights - метрики за период
  • get_ad_creatives - креативы
  • get_custom_audiences - аудитории

Управление:

  • pause_campaign, resume_campaign
  • pause_adset, resume_adset
  • pause_ad, resume_ad
  • update_adset - изменение бюджета, таргетинга
  • create_campaign, create_adset, create_ad

Таргетинг:

  • search_interests - поиск интересов
  • search_geo_locations - гео-локации
  • search_demographics - демография
  • estimate_audience_size - оценка аудитории
  • create_lookalike_audience - похожие аудитории

Креативы:

  • upload_ad_image - загрузка изображений
  • upload_video - загрузка видео
  • create_ad_creative - создание креатива
  • create_*_carousel - карусельные креативы

База знаний

Перед принятием решений изучи:

  • .claude/ads-agent/knowledge/safety_rules.md - правила безопасности и лимиты
  • .claude/ads-agent/knowledge/metrics_glossary.md - формулы и интерпретация метрик
  • .claude/ads-agent/knowledge/fb_best_practices.md - best practices Facebook Ads
  • .claude/ads-agent/knowledge/troubleshooting.md - решения типичных проблем

История действий и логирование

Читай историю ПЕРЕД оптимизацией!

Перед любой оптимизацией читай файлы за последние 3 дня:

.claude/ads-agent/history/YYYY-MM/YYYY-MM-DD.md (today)
.claude/ads-agent/history/YYYY-MM/YYYY-MM-DD.md (yesterday)
.claude/ads-agent/history/YYYY-MM/YYYY-MM-DD.md (day_before)

Зачем это нужно

История действий используется для:

  • Избегания повторных снижений бюджета
  • Учёта периода обучения новых adsets (48ч)
  • Анализа паттернов (3 снижения → пауза)
  • Избегания колебаний (не снижать после повышения)

Формат записи

После каждой операции записывай действия в history/YYYY-MM/YYYY-MM-DD.md:

## HH:MM - Оптимизация (skill: ads-optimizer)

### Действия выполнены:

| # | Тип | Object ID | Object Name | Old Value | New Value | Причина | Статус |
|---|-----|-----------|-------------|-----------|-----------|---------|--------|
| 1 | budget_increase | 123456789 | Кухня_30-40 | $20 | $26 | CPL $2.8, HS +35 | success |
| 2 | pause_ad | 987654321 | Carousel_1 | active | paused | Ad-eater: CPL $18 (3x target) | success |

### Контекст:
- Целевой CPL: $5
- Account: act_805414428109857
- HS распределение: very_good=2, good=3, neutral=1, bad=2
- История учтена: да

---

Типы действий

ТипОписание
budget_increaseПовышение бюджета
budget_decreaseСнижение бюджета
pause_adПауза объявления
pause_adsetПауза adset
resume_adВозобновление ad
resume_adsetВозобновление adset
create_adsetСоздание adset
create_campaignСоздание кампании

Пример workflow

Запрос: "Оптимизируй аккаунт MyBusiness"

Действия:

  1. Читаю историю за 3 дня из history/YYYY-MM/
  2. Читаю .claude/ads-agent/config/ad_accounts.md → нахожу MyBusiness: act_123456789
  3. Читаю .claude/ads-agent/config/briefs/mybusiness.md → цели: CPL $3-5, бюджет $50-100
  4. Вызываю /ads-optimizer
  5. Получаю метрики через get_campaigns(), get_insights() за 5 периодов
  6. Анализирую по правилам из брифа и knowledge
  7. Применяю правила истории (избегаю повторов, колебаний)
  8. Формирую план рекомендаций
  9. Показываю план пользователю
  10. После подтверждения - выполняю через MCP
  11. Логирую в history выполненные действия

FAQ

What does the ads-agent skill do?

AI-агент для управления Facebook рекламой. Вызывай для анализа, оптимизации, создания кампаний и отчётов.

How do I install ads-agent?

Run npx skills add https://github.com/dengineproblem/agents-monorepo --skill ads-agent in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/ads-agent/ (personal) or .claude/skills/ads-agent/ (project).

Which AI agents can use ads-agent?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is ads-agent safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains ads-agent?

It is published by dengineproblem in dengineproblem/agents-monorepo. It has 67 recorded installs.

More from dengineproblem/agents-monorepo

View all →

social-media-marketing

dengineproblem/agents-monorepo

Эксперт по SMM. Используй для стратегий в Instagram, Facebook, TikTok, LinkedIn, контент-планов и community management.

Marketing & SEO1.2K installs

frontend-design

dengineproblem/agents-monorepo

Open the skill to read its SKILL.md instructions.

Frontend & Design288 installs

video-marketing

dengineproblem/agents-monorepo

Open the skill to read its SKILL.md instructions.

Marketing & SEO259 installs

k6-load-test

dengineproblem/agents-monorepo

Open the skill to read its SKILL.md instructions.

Testing & QA181 installs

b2b-saas-marketing

dengineproblem/agents-monorepo

Open the skill to read its SKILL.md instructions.

Marketing & SEO141 installs

seo-expert

dengineproblem/agents-monorepo

Open the skill to read its SKILL.md instructions.

Marketing & SEO129 installs

Popular marketing & seo skills

View category →

reddit-automation

flowkit-labs/skills

Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation honestly and naming your product only when it truly answers the question. Two moves: discovery — scan the right subreddits for real needs (recommendation asks, expressed pain, competitor mentions) and rank the few threads where you can actually help; drafting — write from real experience, respect each community's self-promo rules, and keep a human in the loop to review and post. This markets on Reddit the honest way: contribute value, disclose who you are, never astroturf. Distilled from the playbook behind doany.ai's Reddit agent. Triggers on "find reddit opportunities", "reddit marketing", "reddit automation", "reply on reddit for my product", "reddit community engagement", "reddit lead gen", or any ask to turn Reddit threads into genuine, disclosed marketing replies.

Marketing & SEO1.1M installs

twitter-automation

101-skills/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO880K installs

twitter-automation

magentosh/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO771.7K installs

twitter-automation

qu-skills/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO564.3K installs

product-launch-video

heygen-com/hyperframes

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

Marketing & SEO538.7K installs

twitter-automation

skills-shell/superpowers

Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet

Marketing & SEO453.7K installs