Postiz — Social Media Publishing Hub
Postiz — дефолтная система публикации: self-hosted, 14 платформ, без лимита на
число постов, REST API + опциональный MCP. Любая публикация или планирование постов
идёт сюда, если явно не нужен эксклюзив Publora.
Что понадобится (без этого навык не работает)
Postiz — не облачный сервис с ключом, а приложение, которое ты поднимаешь сам.
| Нужно |
Как получить |
| Свой инстанс Postiz |
Docker на VPS или на своей машине — 3 контейнера: приложение, PostgreSQL, Redis |
POSTIZ_URL |
адрес своего инстанса, например http://localhost:4007 |
POSTIZ_API_KEY |
в UI: Settings → Developers → Public API |
| OAuth-приложения соцсетей |
для каждой площадки заводится своё; часть (X, Instagram) требует аккаунта разработчика |
Обе переменные — в ~/.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
Порядок первого запуска:
- Поднять compose, открыть
http://<свой-хост>:4007.
- Зарегистрировать первого пользователя — это будешь ты.
- Сразу после этого поставить
DISABLE_REGISTRATION=true и перезапустить.
Инстанс, открытый в интернет с включённой регистрацией, к вечеру будет чужим:
регистрация открыта по умолчанию, и это самая частая ошибка при self-host.
- Подключить соцсети кнопками OAuth в дашборде.
- Забрать API-ключ и положить в переменные окружения.
Не хочешь выставлять наружу — держи на localhost или за VPN; для публикации
исходящего соединения достаточно, входящий доступ нужен только тебе и OAuth-редиректам.
Разграничение с publora-post
| Задача |
Куда |
| Публикация/планирование постов: X, LinkedIn, Instagram, TikTok, Facebook, Threads, Reddit, Pinterest, YouTube, Bluesky, Mastodon, Slack, Discord |
postiz (дефолт) |
| LinkedIn-аналитика: post/account stats, followers, profile summary |
publora-post (в Postiz этого нет) |
| LinkedIn-реакции и комментарии (create_reaction, create_comment) |
publora-post (в Postiz этого нет) |
| Telegram |
python ~/.claude/tools/tg_client.py send — канон для своего канала (в Postiz Telegram отсутствует) |
| Reddit, Pinterest, Slack, Discord, LinkedIn Pages |
только postiz (в Publora их нет) |
Commands
Все команды — тонкая обёртка над scripts/postiz_cli.py (stdlib, зависимостей нет):
| Команда |
Что делает |
python ~/.claude/skills/postiz/scripts/postiz_cli.py channels |
список подключённых аккаунтов |
... publish "<text>" |
опубликовать сейчас во все подключённые платформы |
... publish "<text>" --platforms x,linkedin |
опубликовать в конкретные |
... schedule 2026-09-01T10:00:00Z "<text>" --platforms x |
запланировать (ISO 8601) |
... list --from 2026-08-01 --to 2026-08-31 |
список постов за период |
... delete <post_id> |
удалить запланированный/черновик |
... upload <file> |
загрузить медиа для поста |
Скрипт сам читает ~/.claude/.credentials.master.env, если переменных нет в окружении.
Не настроено — печатает, чего именно не хватает, и выходит с кодом 1 (не «пустой успех»).
Supported Platforms
| Platform |
Type |
Settings |
| X / Twitter |
x |
who_can_reply, community, made_with_ai |
| LinkedIn |
linkedin |
carousel support |
| LinkedIn Page |
linkedin-page |
carousel, company pages |
| Instagram |
instagram |
post, story, reel, collaborators |
| TikTok |
tiktok |
privacy_level, duet, stitch, comment |
| Facebook |
facebook |
url attachment |
| Threads |
threads |
(no extra settings) |
| Reddit |
reddit |
subreddit, title, type, flair |
| Pinterest |
pinterest |
board, title, link |
| YouTube |
youtube |
title, privacy, kids, thumbnail, tags |
| Bluesky |
bluesky |
(no extra settings) |
| Mastodon |
mastodon |
(no extra settings) |
| Slack |
slack |
channel ID |
| Discord |
discord |
channel ID |
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: так тратится один запрос из лимита вместо пяти.
1---2name: postiz3description: "Дефолт публикации в соцсети — self-hosted Postiz, 14 платформ. Триггеры: «опубликуй везде», «запланируй пост». НЕ эксклюзивы Publora→publora-post."4user_invocable: true5trigger: "postiz"6arguments: "[command] [args]"7metadata:8 source: https://skillmd.com/skills/jhamidun/postiz9---1011# Postiz — Social Media Publishing Hub1213**Postiz — дефолтная система публикации**: self-hosted, 14 платформ, без лимита на14число постов, REST API + опциональный MCP. Любая публикация или планирование постов15идёт сюда, если явно не нужен эксклюзив Publora.1617## Что понадобится (без этого навык не работает)1819Postiz — **не облачный сервис с ключом**, а приложение, которое ты поднимаешь сам.2021| Нужно | Как получить |22|---|---|23| Свой инстанс Postiz | Docker на VPS или на своей машине — 3 контейнера: приложение, PostgreSQL, Redis |24| `POSTIZ_URL` | адрес своего инстанса, например `http://localhost:4007` |25| `POSTIZ_API_KEY` | в UI: Settings → Developers → Public API |26| OAuth-приложения соцсетей | для каждой площадки заводится своё; часть (X, Instagram) требует аккаунта разработчика |2728Обе переменные — в `~/.claude/.credentials.master.env`29(шаблон: `~/.claude/templates/.credentials.master.env.example`).3031### Развернуть у себя3233Официальный образ и compose — в репозитории проекта (`gitroom-hq/postiz-app`,34AGPL-3.0, self-host бесплатно). Минимальный контур:3536```37postiz — приложение (Next.js + NestJS), порт 4007 наружу38postiz-postgres — PostgreSQL 1739postiz-redis — Redis 7.240```4142Порядок первого запуска:43441. Поднять compose, открыть `http://<свой-хост>:4007`.452. Зарегистрировать **первого** пользователя — это будешь ты.463. **Сразу после этого поставить `DISABLE_REGISTRATION=true`** и перезапустить.47 Инстанс, открытый в интернет с включённой регистрацией, к вечеру будет чужим:48 регистрация открыта по умолчанию, и это самая частая ошибка при self-host.494. Подключить соцсети кнопками OAuth в дашборде.505. Забрать API-ключ и положить в переменные окружения.5152Не хочешь выставлять наружу — держи на localhost или за VPN; для публикации53исходящего соединения достаточно, входящий доступ нужен только тебе и OAuth-редиректам.5455## Разграничение с publora-post5657| Задача | Куда |58|--------|------|59| Публикация/планирование постов: X, LinkedIn, Instagram, TikTok, Facebook, Threads, Reddit, Pinterest, YouTube, Bluesky, Mastodon, Slack, Discord | **postiz (дефолт)** |60| LinkedIn-аналитика: post/account stats, followers, profile summary | `publora-post` (в Postiz этого нет) |61| LinkedIn-реакции и комментарии (create_reaction, create_comment) | `publora-post` (в Postiz этого нет) |62| Telegram | `python ~/.claude/tools/tg_client.py send` — канон для своего канала (в Postiz Telegram отсутствует) |63| Reddit, Pinterest, Slack, Discord, LinkedIn Pages | только postiz (в Publora их нет) |6465## Commands6667Все команды — тонкая обёртка над `scripts/postiz_cli.py` (stdlib, зависимостей нет):6869| Команда | Что делает |70|---------|-------------|71| `python ~/.claude/skills/postiz/scripts/postiz_cli.py channels` | список подключённых аккаунтов |72| `... publish "<text>"` | опубликовать сейчас во все подключённые платформы |73| `... publish "<text>" --platforms x,linkedin` | опубликовать в конкретные |74| `... schedule 2026-09-01T10:00:00Z "<text>" --platforms x` | запланировать (ISO 8601) |75| `... list --from 2026-08-01 --to 2026-08-31` | список постов за период |76| `... delete <post_id>` | удалить запланированный/черновик |77| `... upload <file>` | загрузить медиа для поста |7879Скрипт сам читает `~/.claude/.credentials.master.env`, если переменных нет в окружении.80Не настроено — печатает, чего именно не хватает, и выходит с кодом 1 (не «пустой успех»).8182## Supported Platforms8384| Platform | Type | Settings |85|----------|------|----------|86| X / Twitter | `x` | who_can_reply, community, made_with_ai |87| LinkedIn | `linkedin` | carousel support |88| LinkedIn Page | `linkedin-page` | carousel, company pages |89| Instagram | `instagram` | post, story, reel, collaborators |90| TikTok | `tiktok` | privacy_level, duet, stitch, comment |91| Facebook | `facebook` | url attachment |92| Threads | `threads` | (no extra settings) |93| Reddit | `reddit` | subreddit, title, type, flair |94| Pinterest | `pinterest` | board, title, link |95| YouTube | `youtube` | title, privacy, kids, thumbnail, tags |96| Bluesky | `bluesky` | (no extra settings) |97| Mastodon | `mastodon` | (no extra settings) |98| Slack | `slack` | channel ID |99| Discord | `discord` | channel ID |100101## MCP-путь (необязательный)102103У Postiz есть MCP-сервер — если он подключён, доступны инструменты104`postiz-get-channels`, `postiz-upload-file`, `postiz-create-post`,105`postiz-list-posts`, `postiz-update-post`, `postiz-delete-post`.106107В паке MCP-сервер **не прописан** намеренно: он требует твоего URL и ключа, а без108них молча висит нерабочим. Хочешь MCP — добавь сервер в свой `mcp.json` сам,109передав ему `POSTIZ_URL` и `POSTIZ_API_KEY`. CLI выше делает то же самое и не110требует настройки MCP.111112## REST API напрямую113114```bash115# List channels116curl -H "Authorization: $POSTIZ_API_KEY" "$POSTIZ_URL/public/v1/integrations"117118# Create post (publish now)119curl -X POST "$POSTIZ_URL/public/v1/posts" \120 -H "Authorization: $POSTIZ_API_KEY" \121 -H "Content-Type: application/json" \122 -d '{123 "type": "now",124 "posts": [{125 "integration": {"id": "INTEGRATION_ID"},126 "value": [{"content": "Post text here"}],127 "group": "post",128 "settings": {"__type": "x"}129 }]130 }'131132# Upload media133curl -X POST "$POSTIZ_URL/public/v1/upload" \134 -H "Authorization: $POSTIZ_API_KEY" \135 -F "file=@/path/to/image.jpg"136```137138## Content Pipeline Integration139140Типовой контур публикации своего канала:141142```1431. trend-engine → найти тему, которая сейчас растёт1442. content-engine → один исходник → версии под каждую площадку1453. image-generation → визуал1464. postiz → публикация в X + LinkedIn + Instagram + Threads147```148149Для Telegram — `python ~/.claude/tools/tg_client.py send`: возможностей больше,150чем в Postiz-интеграции TG.151152## Gotchas153154- Заголовок авторизации — **сырой ключ, без префикса `Bearer`**. С префиксом будет 401.155- Обновление поста **не частичное** — отправляй контент целиком.156- `value` — массив: несколько элементов = тред.157- Поле `group` всегда `"post"`.158- TikTok требует медиа по HTTPS-адресу, доступному извне.159- Лимит по умолчанию — 30 запросов в час (`API_LIMIT` в окружении инстанса).160- Мультиплатформенная публикация — **одним вызовом API** со всеми платформами161 в массиве `posts`: так тратится один запрос из лимита вместо пяти.