ИИ-агенты и документация
Главная AI-стратегия Postiz не в том, чтобы написать ещё один генератор текстов.
Postiz пытается стать руками любого AI-агента.
Claude, Codex, OpenClaw, Hermes или чужой SaaS могут придумать контент. Но чтобы реально его опубликовать, им всё равно нужно:
- найти подключённые аккаунты;
- узнать требования конкретной соцсети;
- загрузить изображения и видео;
- выбрать формат поста;
- передать настройки TikTok, Reddit, YouTube или LinkedIn;
- поставить публикацию в очередь;
- проверить результат и забрать аналитику.
Postiz забирает этот скучный и технически сложный слой на себя. Модель и интерфейс могут меняться, а одна система публикации остаётся.
Стратегия в одной схеме
У Postiz есть несколько входов в один и тот же продукт.
| Вход | Для кого | Что получает пользователь |
|---|---|---|
| Встроенный AI-агент | Маркетолог без кода | Чат, который пишет текст, создаёт медиа и ставит пост в календарь |
| MCP | Claude, ChatGPT, Cursor и другие совместимые клиенты | Набор готовых инструментов, которые агент обнаруживает сам |
CLI + SKILL.md | Codex, Claude Code, OpenClaw, Hermes и другие агенты с доступом к терминалу | Команды публикации плюс инструкция, как правильно ими пользоваться |
| Public API | Разработчик или сценарий автоматизации | Прямые HTTP-запросы и JSON для встраивания в свои продукты |
| OAuth2 | Сторонний SaaS | Возможность запросить у пользователя доступ к Postiz без передачи его API-ключа |
Это не пять разных продуктов. Это пять интерфейсов к одной инфраструктуре социальных сетей.
Что здесь вообще означают MCP, CLI, API и Skill
Технические термины легко запутать, поэтому разберём их на бытовом примере.
Представьте ресторан:
- API — подробная инструкция для кухни: какой запрос отправить, какие поля заполнить и какой ответ придёт;
- CLI — касса с короткими командами:
показать аккаунты,загрузить файл,создать пост; - MCP — единый формат меню, которое совместимый AI-агент может сам прочитать и понять;
- Skill — памятка для сотрудника: в каком порядке нажимать кнопки, что обязательно проверить и какие ошибки не допускать;
- OAuth2 — безопасное окно согласия, через которое пользователь разрешает стороннему приложению работать от своего имени, не отдавая ему пароль.
Эта простота важна для маркетинга. Postiz может заходить в новую агентскую экосистему без переделки всех интеграций с соцсетями: достаточно научить нового агента пользоваться уже существующим интерфейсом.
Эволюция: от планировщика к слою выполнения
Первый этап: API и автоматизации
Сначала Postiz был обычным планировщиком с публичным API. Именно API позволил подключить n8n, Make и собственные сценарии клиентов.
В разборе перехода от $4 000 к $6 000 MRR Нево объяснял, что увидел ролики автоматизаторов: AI генерировал вирусные TikTok-видео, а Postiz стоял в конце процесса и публиковал результат.
Это изменило позиционирование. Продавать стали не «календарь на 18 аккаунтов», а готовый результат — автоматический контентный конвейер.
Второй этап: MCP
В апреле 2025 года в обновлении Postiz v1.39.3 появился MCP. Он позволил управлять Postiz из Claude, Cursor и других совместимых клиентов через обычный разговор.
Вместо того чтобы вручную писать API-запрос, пользователь может сказать агенту: «покажи мои аккаунты» или «поставь этот пост на завтра».
Третий этап: OpenClaw и навыки
30 января 2026 года Нево анонсировал skill для OpenClaw. Историческая команда установки выглядела так: clawdhub install postiz.
Позже упаковка изменилась. Сейчас официальные страницы предлагают универсальную команду:
npx skills add gitroomhq/postiz-agentВ разборе роста Postiz до $154 000 MRR Нево говорит, что заметил волну OpenClaw, быстро сделал Postiz совместимым через Markdown-файл, а затем улучшил документацию и начал создавать SEO-страницы под разных агентов.
Здесь важно правильно понимать фразу про «один Markdown-файл». Весь продукт не появился из одного файла. API, авторизация, загрузка медиа и десятки интеграций уже существовали. Файл только объяснил агенту, как использовать готовую систему.
Четвёртый этап: агент становится главным позиционированием
Сейчас главная Postiz начинается с обещания Run your social media on autopilot with AI agents.
То есть AI перестал быть дополнительной функцией внутри планировщика. Он стал главным способом объяснить весь продукт.
По словам Нево в статье о своей AI-маркетинговой системе, волна агентских сценариев принесла Postiz 2 000 новых клиентов за один месяц. Это цифра самого основателя, а не независимо проверенная аналитика, но она объясняет, почему позиционирование изменилось так резко.
Встроенный Smart Agent: самый простой вход
Для обычного маркетолога вся эта техническая система спрятана за чат-интерфейсом.
Согласно FAQ на главной, встроенный агент умеет:
- писать хуки, подписи, треды и хэштеги;
- адаптировать текст под конкретную площадку;
- генерировать изображения;
- создавать короткие видео;
- провести задачу до конца — например, написать LinkedIn-пост, создать картинку и назначить время публикации.
Текстовая генерация включена во все платные планы. Изображения и видео ограничены месячными лимитами, которые растут вместе с тарифом.
Это верхний слой стратегии. Ниже находятся MCP, CLI и API — способы выполнить ту же работу из внешнего агента или собственного приложения.
MCP: агент сам видит доступные действия
MCP-документация говорит, что сервер Postiz сейчас отдаёт агенту девять инструментов.
| Инструмент | Что делает простыми словами |
|---|---|
integrationList | Показывает подключённые аккаунты |
groupList | Показывает группы клиентов или брендов |
integrationSchema | Объясняет правила и настройки конкретной площадки |
triggerTool | Получает динамические данные: каналы Discord, Reddit-flairs, YouTube-плейлисты и другое |
schedulePostTool | Создаёт черновик, публикует сразу или ставит пост в расписание |
generateImageTool | Генерирует изображение |
generateVideoOptions | Показывает доступные варианты генерации видео |
videoFunctionTool | Получает настройки генератора, например доступные голоса |
generateVideoTool | Генерирует видео |
Самая важная функция здесь — не генерация текста, а integrationSchema.
У каждой сети свои правила. Reddit требует subreddit и иногда flair. YouTube — видимость, плейлист, отметку о детском контенте и превью. Instagram различает feed, stories, reels и collaborator tags. Агент сначала запрашивает схему, а уже затем формирует корректную публикацию.
Это снижает вероятность того, что одна универсальная команда сломается на конкретной площадке.
Как подключается MCP
В инструкции есть готовые варианты для Claude Desktop, Claude Code и Cursor, а также общий endpoint для любого MCP-клиента.
Для Claude Code документация предлагает одну команду:
claude mcp add postiz --transport http \
--url https://api.postiz.com/mcp \
--header "Authorization: Bearer your-api-key"После подключения проверка состоит из обычной просьбы: «Покажи мои подключённые аккаунты». Если всё работает, агент вызывает integrationList.
Та же документация отдельно показывает self-hosted-вариант: домен Postiz заменяется адресом собственного сервера. Это сохраняет open-source-обещание даже в агентском сценарии.
CLI: универсальный переходник для агентов с терминалом
MCP поддерживают не все агенты, зато многие умеют выполнять команды в терминале. Для них Postiz сделал отдельный CLI и вынес его в репозиторий gitroomhq/postiz-agent.
CLI — это набор коротких команд поверх публичного API:
postiz integrations:list
postiz integrations:settings <id>
postiz upload ./image.png
postiz posts:create
postiz posts:list
postiz analytics:platform <id>Почему CLI сделан именно для AI
На лендинге Postiz Agent отдельно подчёркнуто, что команды возвращают структурированный JSON.
Для человека красивый текст удобнее. Для агента лучше предсказуемая структура с полями: он может прочитать ответ, достать ID аккаунта и использовать его в следующей команде.
Типовой процесс выглядит так:
Discover— найти аккаунты и доступные настройки.Fetch— запросить динамические данные площадки.Prepare— загрузить изображения или видео.Post— создать публикацию с правильными настройками.Analyze— забрать аналитику и использовать её в следующем цикле.
SKILL.md: документация, которую читает сам агент
Самый интересный артефакт — файл SKILL.md.
Это не статья для человека. Это машиночитаемая инструкция, которая сообщает агенту:
- когда использовать Postiz;
- какие команды ему доступны;
- какие переменные окружения нужны;
- в каком порядке выполнять действия;
- какие настройки требуются разным площадкам;
- какие ошибки нельзя допускать.
В начале файла есть два жёстких правила:
- Сначала проверить авторизацию.
- Любой локальный медиафайл сначала прогнать через
postiz upload, а в публикацию передавать уже полученный URL.
Дальше файл описывает полный рабочий цикл и нюансы каждой сети. Например, агент узнаёт, как работать с Reddit-flairs, YouTube playlists, Instagram post types и LinkedIn company pages.
Это важный продуктовый принцип: документация становится частью интерфейса. Если инструкция неполная, агент будет ошибаться так же, как пользователь в плохом интерфейсе.
Публичный API: фундамент всей системы
Под CLI и MCP лежит Public API.
На момент проверки документация перечисляет 32 поддерживаемые платформы. Для 25 из них есть собственные настройки: тип публикации, collaborators, reply controls, playlists, boards, flairs и другие поля.
Именно этот слой — настоящая техническая работа. Добавить на лендинг логотип нового агента легко. Поддерживать десятки социальных API, загрузку медиа, авторизацию и уникальные схемы публикации — сложно.
Сильный onboarding-лайфхак: визуальный генератор JSON
В разделе Generate Output пользователь открывает почти тот же визуальный редактор, что и в обычном Postiz.
Но вместо публикации интерфейс генерирует готовый JSON для API-запроса.
То есть разработчику не нужно вручную угадывать сложную структуру TikTok или Instagram. Он собирает пост привычными кнопками и получает корректный пример данных.
OAuth2: Postiz можно встроить в чужой SaaS
Через OAuth2 сторонний продукт может попросить пользователя разрешить доступ к его Postiz-аккаунту.
Пользователь видит экран согласия, подтверждает доступ, а приложение получает токен. Ему не нужно копировать и передавать разработчику свой API-ключ.
Это меняет роль Postiz. Он может быть не только самостоятельным приложением, но и скрытой инфраструктурой внутри другого продукта: AI-видеоредактора, контентного агента или платформы для маркетинговых автоматизаций.
Документация обслуживает и людей, и модели
Документация Postiz разделена не только по функциям продукта, но и по способу интеграции:
- обычная установка и self-hosting;
- Public API;
- CLI;
- MCP;
- Developer App через OAuth2;
- добавление новых social providers;
- contribution guide.
llms.txt: карта сайта для AI
Вверху страниц документации находится ссылка на llms.txt — текстовый индекс всех разделов.
Обычная документация рассчитана на человека, который кликает меню. llms.txt помогает модели быстро увидеть структуру сайта и выбрать нужную страницу без обхода интерфейса.
Это небольшая, но показательная деталь: Postiz оптимизирует не только продукт для агентов, но и сам процесс чтения документации агентами.
Документация — часть open-source-воронки
Quickstart сразу разводит установку на четыре варианта:
- Docker Compose — рекомендуемый путь для обычного self-hosting;
- Development — для разработчиков;
- standalone Docker — продвинутый сценарий;
- Helm — развёртывание в Kubernetes.
И это влияет на маркетинг. Человек приходит из GitHub или из AI-экосистемы, запускает self-hosted-версию, а затем может перейти в облако, когда не захочет поддерживать инфраструктуру и интеграции самостоятельно.
Как одна интеграция превращается в десятки посадочных страниц
После появления Postiz Agent команда не ограничилась одним лендингом.
Она сделала отдельные страницы под агентские экосистемы:
Затем каждую экосистему перемножили на социальные сети:
- OpenClaw × Instagram;
- OpenClaw × YouTube;
- OpenClaw × LinkedIn;
- Codex × Instagram;
- Hermes × Dev.to;
- Paperclip × LinkedIn.
Механика страницы повторяется:
- H1 называет агента и площадку.
- Сразу даётся команда установки.
- Объясняется, как агент обнаруживает
SKILL.md. - Показываются настройки именно этой соцсети.
- Приводится пример запроса на естественном языке.
- В конце стоит CTA на облачную версию Postiz.
Это programmatic SEO, но с продуктовым основанием. Страницы повторяют шаблон, однако интент действительно различается: публикация Reels требует других настроек, чем загрузка YouTube-видео или создание Reddit-поста.
Как они рассказывают об AI-интеграциях
Postiz использует четыре слоя дистрибуции.
1. News: объявить совместимость
Новая интеграция сначала появляется как короткое продуктовое обновление. Так был анонсирован OpenClaw skill.
2. Лендинг: занять коммерческий запрос
Затем появляется страница вида Social Media CLI for Codex или Automate Instagram with Hermes Agent.
3. Техническая статья: показать полный workflow
В статье о маркетинговом стеке AI-агентов Нево показывает связку:
- Virlo ищет тренды;
- Agent Media генерирует видео;
- Larry создаёт слайды;
- Postiz публикует;
- Paperclip распределяет задачи между агентами;
- GitHub issues хранят обратную связь и историю экспериментов.
4. Кейс: доказать результат чужим сценарием
В статье про AI-агента и TikTok разбирается не абстрактная функция, а конкретная архитектура: агент создаёт материалы, загружает их через Postiz, выставляет platform settings и сохраняет публикацию черновиком, если финальное действие невозможно сделать через API.
Так документация превращается в контент-маркетинг. Команды и JSON доказывают, что история воспроизводима, а кейс объясняет, зачем вообще читать команды.
Они используют Postiz не только как продукт, но и как часть собственного AI-конвейера
В разборе AI-контента и SEO Нево показывает внутренний процесс:
- AI начинает с уже подтверждённого источника;
- технические детали подтягиваются из репозиториев Postiz Agent и документации;
- изображения загружаются через Postiz CLI;
- статья публикуется через CMS;
- из неё в тот же день собираются публикации для LinkedIn, Reddit и X;
- дистрибуция выполняется через CLI или MCP.
Это замкнутый цикл:
построить инструмент → применить его к собственному маркетингу → описать процесс → привлечь пользователей этого же инструмента.
Где здесь настоящий moat
Сгенерировать подпись к посту может почти любая модель. Это слабое преимущество.
Сильный слой Postiz состоит из другого:
- Покрытие площадок. API-документация сейчас перечисляет 32 платформы.
- Авторизация. Каждая сеть имеет свой OAuth, app review и ограничения.
- Platform-specific schemas. Агент должен знать, какие поля нужны именно этой сети.
- Media pipeline. Файлы требуется загрузить, сохранить и передать провайдеру в допустимом формате.
- Надёжное расписание. Публикация должна выполниться через несколько часов или дней, даже если агент уже выключен.
- Обратная связь. Аналитика позволяет агенту не только публиковать, но и корректировать следующий контент.
- Открытый код. Сообщество добавляет площадки и проверяет интеграции, а облако монетизирует удобство.
Поэтому правильное определение Postiz — не «AI пишет посты», а универсальный publishing backend для людей, автоматизаций и агентов.
Как AI-стратегия монетизируется
Тарифы Postiz ограничивают не количество разговоров с агентом, а полезные ресурсы вокруг исполнения:
- число подключённых каналов;
- число публикаций;
- объём AI-изображений и видео;
- число webhooks;
- клиентские группы;
- командные функции.
Публичный API входит в платные планы. Встроенный агент увеличивает использование AI-лимитов, а внешний агент увеличивает число автоматических публикаций и ценность подключённых каналов.
Главная выгода для бизнеса — встраивание в рабочий процесс. Если у клиента агент ежедневно публикует через Postiz, заменить сервис сложнее, чем отменить редко используемый визуальный календарь.
Ограничения и слабые места
Автономность нельзя продавать без контроля
На agent-лендингах Postiz повторяет предупреждение: Please make sure there is always a human in the loop.
Это не декоративный дисклеймер. Агент может выбрать не тот аккаунт, неверно интерпретировать время, опубликовать черновик или создать неподходящий публичный текст.
Правильный продуктовый сценарий должен включать:
- черновик по умолчанию для рискованных площадок;
- явное подтверждение немедленной публикации;
- белый список разрешённых аккаунтов;
- журнал действий;
- возможность удалить или остановить запланированный пост;
- минимальные права токена.
Терминов стало слишком много
На сайте одновременно существуют Smart Agent, Postiz Agent, CLI, MCP, API и Skills. Технический пользователь разберётся, обычный маркетолог — не обязательно.
Документации пригодился бы короткий выбор:
- хотите всё делать в Postiz → встроенный агент;
- используете Claude или Cursor → MCP;
- агент умеет запускать команды → CLI + Skill;
- строите собственный продукт → API + OAuth2.
Документация уже расходится в цифрах
На разных страницах встречаются 28+, 30+ и 32 платформы. В старых статьях MCP описан как восемь инструментов, а актуальная документация перечисляет девять — добавился groupList.
Это естественно для быстро растущего продукта, но для agent-first-компании особенно опасно. Человек может заметить устаревшую команду, а агент механически выполнит её.
Programmatic-страницы могут стать тонкими клонами
Страницы Codex, Hermes, OpenClaw и Paperclip во многом повторяют один шаблон. Это быстро занимает поисковые запросы, но создаёт риск:
- одинакового контента;
- неверных утверждений о возможностях стороннего агента;
- устаревших команд;
- разъезда между
SKILL.md, CLI и лендингом.
Защититься можно только автоматическими тестами примеров и единым источником данных, из которого генерируются документация, skill и лендинги.
Плейбук: как повторить эту стратегию
Шаг 1. Найти действие, а не AI-фичу
Не начинайте с кнопки «сгенерировать текст». Найдите реальную операцию, которую агент должен выполнить: отправить рассылку, обновить CRM, создать счёт, опубликовать контент.
Шаг 2. Сначала построить стабильный API
У действия должны быть предсказуемые входные данные, ошибки и ответы. Без этого MCP и Skill лишь маскируют ненадёжный продукт.
Шаг 3. Сделать короткий CLI
Команды должны соответствовать человеческой логике:
- найти сущности;
- получить схему;
- подготовить файл;
- выполнить действие;
- проверить результат.
Ответы возвращайте в структурированном JSON.
Шаг 4. Написать Skill как операционную инструкцию
В него нужно положить:
- условия использования;
- обязательные переменные и программы;
- порядок действий;
- опасные операции;
- типовые ошибки;
- 3–5 рабочих примеров;
- правила для частных случаев.
Шаг 5. Добавить MCP для клиентов без терминала
Пусть агент сам обнаруживает инструменты и их схемы. Начните с минимального набора действий, а не переносите в MCP весь внутренний API.
Шаг 6. Сделать первый успех копируемым
Postiz даёт готовые команды, проверочный prompt и визуальный генератор JSON. Пользователь должен получить первый результат за несколько минут.
Шаг 7. Разделить документацию по аудиториям
- обычный пользователь;
- self-hoster;
- разработчик API;
- пользователь MCP;
- пользователь CLI;
- создатель стороннего приложения.
Шаг 8. Подхватывать новые экосистемы
Когда появляется новый агент:
- проверить, умеет ли он MCP или shell-команды;
- добавить минимальный адаптер или metadata;
- протестировать один реальный сценарий;
- выпустить страницу интеграции;
- написать пошаговый tutorial;
- показать кейс;
- сделать страницы agent × ключевая операция.
Шаг 9. Не забыть о контроле
По умолчанию агент должен готовить черновик. Необратимое публичное действие — только после подтверждения или в заранее определённом безопасном сценарии.
Шаг 10. Превратить использование продукта в контент
Покажите собственный workflow, команды, ошибки и результат. Лучшие материалы Postiz одновременно являются кейсом, документацией и лендингом.
Главный вывод
Postiz не пытается выиграть гонку моделей.
Он строит слой, который остаётся полезным при любой модели и любом интерфейсе:
агент думает → Postiz понимает требования площадки → загружает медиа → публикует → возвращает аналитику.
А маркетинговая машина устроена поверх этого слоя:
новый AI-продукт → совместимость → skill или MCP → документация → отдельный лендинг → tutorial → кейс → поисковый трафик → платное облако.
Это и есть сильная часть стратегии: одна техническая интеграция одновременно улучшает продукт, открывает новый канал дистрибуции и создаёт десятки контентных поводов.
Основные источники
- Главная Postiz
- Postiz Agent
- Postiz Agent для Codex
- Репозиторий Postiz Agent
SKILL.md- MCP: Introduction
- MCP: Client Setup
- CLI: Introduction
- Public API: Overview
- OAuth2
- Документация Postiz
llms.txt- Анонс OpenClaw skill
- AI-маркетинговый стек Нево
- Кейс AI-агента и TikTok
- Разбор AI-контентного конвейера
- Разбор Нево о росте до $154 000 MRR