Postiz

Postiz — Social Media Publishing Hub

Postiz — дефолтная система публикации: self-hosted, 14 платформ, без лимита на число постов, REST API + опциональный MCP. Любая публикация или планирование постов идёт сюда, если явно не нужен эксклюзив Publora.

Что понадобится (без этого навык не работает)

Postiz — не облачный сервис с ключом, а приложение, которое ты поднимаешь сам.

Обе переменные — в ~/.claude/.credentials.master.env (шаблон: ~/.claude/templates/.credentials.master.env.example).

Развернуть у себя

Официальный образ и compose — в репозитории проекта (gitroom-hq/postiz-app, AGPL-3.0, self-host бесплатно). Минимальный контур:

postiz          — приложение (Next.js + NestJS), порт 4007 наружу
postiz-postgres — PostgreSQL 17
postiz-redis    — Redis 7.2

Порядок первого запуска:

1. Поднять compose, открыть http://<свой-хост>:4007.
2. Зарегистрировать первого пользователя — это будешь ты.
3. Сразу после этого поставить DISABLE_REGISTRATION=true и перезапустить. Инстанс, открытый в интернет с включённой регистрацией, к вечеру будет чужим: регистрация открыта по умолчанию, и это самая частая ошибка при self-host.
4. Подключить соцсети кнопками OAuth в дашборде.
5. Забрать API-ключ и положить в переменные окружения.

Не хочешь выставлять наружу — держи на localhost или за VPN; для публикации исходящего соединения достаточно, входящий доступ нужен только тебе и OAuth-редиректам.

Разграничение с publora-post

Commands

Все команды — тонкая обёртка над scripts/postiz_cli.py (stdlib, зависимостей нет):

Скрипт сам читает ~/.claude/.credentials.master.env, если переменных нет в окружении. Не настроено — печатает, чего именно не хватает, и выходит с кодом 1 (не «пустой успех»).

Supported Platforms

MCP-путь (необязательный)

У Postiz есть MCP-сервер — если он подключён, доступны инструменты postiz-get-channels, postiz-upload-file, postiz-create-post, postiz-list-posts, postiz-update-post, postiz-delete-post.

В паке MCP-сервер не прописан намеренно: он требует твоего URL и ключа, а без них молча висит нерабочим. Хочешь MCP — добавь сервер в свой mcp.json сам, передав ему POSTIZ_URL и POSTIZ_API_KEY. CLI выше делает то же самое и не требует настройки MCP.

REST API напрямую

# List channels
curl -H "Authorization: $POSTIZ_API_KEY" "$POSTIZ_URL/public/v1/integrations"

# Create post (publish now)
curl -X POST "$POSTIZ_URL/public/v1/posts" \
  -H "Authorization: $POSTIZ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "now",
    "posts": [{
      "integration": {"id": "INTEGRATION_ID"},
      "value": [{"content": "Post text here"}],
      "group": "post",
      "settings": {"__type": "x"}
    }]
  }'

# Upload media
curl -X POST "$POSTIZ_URL/public/v1/upload" \
  -H "Authorization: $POSTIZ_API_KEY" \
  -F "file=@/path/to/image.jpg"

Content Pipeline Integration

Типовой контур публикации своего канала:

1. trend-engine    → найти тему, которая сейчас растёт
2. content-engine  → один исходник → версии под каждую площадку
3. image-generation → визуал
4. postiz          → публикация в X + LinkedIn + Instagram + Threads

Для Telegram — python ~/.claude/tools/tg_client.py send: возможностей больше, чем в Postiz-интеграции TG.

Gotchas

• Заголовок авторизации — сырой ключ, без префикса Bearer. С префиксом будет 401.
• Обновление поста не частичное — отправляй контент целиком.
• value — массив: несколько элементов = тред.
• Поле group всегда "post".
• TikTok требует медиа по HTTPS-адресу, доступному извне.
• Лимит по умолчанию — 30 запросов в час (API_LIMIT в окружении инстанса).
• Мультиплатформенная публикация — одним вызовом API со всеми платформами в массиве posts: так тратится один запрос из лимита вместо пяти.