Repolode
imrenagicom

imrenagicom/adsctl

Go CLI для работы с рекламой Meta, готовый к использованию AI-агентами: проверка и мониторинг кампаний, отчёты и запуск рекламы с выводом JSON и явным указанием аккаунта.

Open source альтернатива:Meta Ads Manager

Звёзды
76
Форки
6
Открытые issues
0
Последний коммит
позавчера

Что это?

adsctl — CLI на Go и Cobra для работы с рекламными аккаунтами. Первая поддерживаемая платформа — Meta (реклама в Facebook и Instagram); также планируется адаптер для Google. По умолчанию CLI возвращает JSON, для операций записи требует явно указать аккаунт, а учётные данные читает из внешних файлов с токенами или переменных окружения, не сохраняя их в конфигурации.

CLI позволяет находить ресурсы (аккаунты, кампании, группы объявлений, объявления, креативы, пиксели, аудитории), запрашивать нативные Insights и формировать асинхронные отчёты со сводками, рейтингами и экспортом в CSV/JSONL. Также доступны одноразовые правила мониторинга только для чтения, которые выявляют проблемы с показом и метриками. Операции записи включают создание, обновление, приостановку и архивирование объектов кампании, изменение бюджета с предварительным просмотром в режиме dry-run и многоэтапный запуск кампаний с записью состояния и возможностью возобновления и сверки после прерываний.

В репозиторий также входят три навыка для агентов (отчётность и операции, аудит эффективности Meta и настройка); проект можно установить как плагин для Codex, Claude Code и Google Antigravity. В CLI есть команды для публикации в Instagram изображений, Reels, Stories и каруселей; доступны готовые бинарные файлы для Linux, macOS и Windows.

Ключевые возможности

  • 01По умолчанию возвращает JSON-конверты с версией, подходящие для AI-агентов и shell-скриптов.
  • 02Для операций записи с рекламой требует явно указать профиль и аккаунт; поддерживает предварительный просмотр в режиме dry-run.
  • 03Читает токены доступа Meta из внешних файлов или переменных окружения и никогда не сохраняет их в конфигурации.
  • 04Поддерживает нативные запросы Insights, асинхронные задачи, сводки, рейтинги и экспорт в CSV/JSONL.
  • 05Выполняет детерминированные правила мониторинга только для чтения и сообщает об изменениях между снимками аккаунта.
  • 06Поддерживает возобновляемый многоэтапный запуск кампаний с журналом состояния и сверкой.

Сценарии использования

  • Поручить AI-агенту получать отчёты об эффективности кампаний и выявлять проблемы с показом рекламы.
  • Запускать в CI или cron плановые проверки аккаунта только для чтения и завершать задачи с ошибкой при обнаружении проблем.
  • Массово приостанавливать рекламу или менять бюджеты в рекламных аккаунтах клиентов с помощью скрипта.
  • Публиковать посты, Reels и карусели в Instagram из автоматизированного конвейера.

Быстрый старт

  1. 1

    Запустите официальный скрипт установки из README

  2. 2

    Загрузите настройки PATH в оболочку

    source "$HOME/.adsctl/env"
  3. 3

    Убедитесь, что CLI запускается

    adsctl version

Что важно знать

  • Пока реализована поддержка только рекламы Meta; адаптер для Google появится в будущем.
  • Вам нужно самостоятельно создать приложение разработчика Meta и предоставить токен доступа; CLI не обрабатывает OAuth.
  • В Windows не поддерживаются постоянный запуск и выполнение мониторинга.

В подборках

Темы

Частые вопросы

Что такое adsctl?
Go CLI для работы с рекламой Meta, готовый к использованию AI-агентами: проверка и мониторинг кампаний, отчёты и запуск рекламы с выводом JSON и явным указанием аккаунта. adsctl — CLI на Go и Cobra для работы с рекламными аккаунтами. Первая поддерживаемая платформа — Meta (реклама в Facebook и Instagram); также планируется адаптер для Google. По умолчанию CLI возвращает JSON, для операций записи требует явно указать аккаунт, а учётные данные читает из внешних файлов с токенами или переменных окружения, не сохраняя их в конфигурации.
adsctl можно использовать бесплатно? Какая у него лицензия?
adsctl распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
adsctl всё ещё поддерживается?
Активно поддерживается. Последний коммит в adsctl — 5 нояб. 2026 г..
Для чего можно использовать adsctl?
Поручить AI-агенту получать отчёты об эффективности кампаний и выявлять проблемы с показом рекламы. Запускать в CI или cron плановые проверки аккаунта только для чтения и завершать задачи с ошибкой при обнаружении проблем. Массово приостанавливать рекламу или менять бюджеты в рекламных аккаунтах клиентов с помощью скрипта. Публиковать посты, Reels и карусели в Instagram из автоматизированного конвейера.
Как установить adsctl?
Запустите официальный скрипт установки из README Загрузите настройки PATH в оболочку: source "$HOME/.adsctl/env" Убедитесь, что CLI запускается: adsctl version
Где скачать adsctl?
Исходный код и инструкции по установке — на GitHub: https://github.com/imrenagicom/adsctl

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Набор open-source-навыков для SEO, GEO и платной рекламы, которые добавляют маркетинговые сценарии в AI-агенты для программирования, например Claude Code, Codex и Gemini CLI.

4,1 тыс.+27 за неделю519PythonMITАктивно поддерживаетсяОбновлён 23 часа назад

Система показа рекламы с открытым исходным кодом: помогает издателям размещать объявления на сайтах, управлять рекламными кампаниями и отслеживать их результаты.

Продуктивность и приложения#ad-server#advertising#php
1,5 тыс.+3 за неделю616PHPGPL-2.0Активно поддерживаетсяОбновлён вчера

Мультиязычный инструмент для подготовки отчётов о тестировании: он превращает результаты разных фреймворков и CI/CD-систем в наглядные HTML-отчёты.

5,6 тыс.+1 за неделю780HTMLApache-2.0Активно поддерживаетсяОбновлён вчера

Локальное приложение для проверки аппаратной части Mac перед покупкой или продажей: автоматические проверки, интерактивные тесты и отчёты в PDF/PNG.

Инструменты разработчика#macos#hardware-diagnostics#swiftui
908+19 за неделю83SwiftБез лицензииОбновлён 12 дней назад