SocialHub

SocialHub - власний застосунок M.A.V.E.N для публікацій у соцмережах за адресою /socialhub. Це не Postiz: він вбудований у M.A.V.E.N і дотримується мови та теми застосунку. Є кнопка повноекранного режиму.

Що робить

Розділи: Calendar, Compose, Channels, Analytics, Templates & drafts, Bulk CSV, Automations, Team, Agents & API та Settings.

Медіа можна завантажити або вказати зі сховища Obsidian - інших джерел не приймає.

Підключення каналів

Telegram (вже працює)

У @BotFather створіть нового бота. Не беріть бота, якого вже використовує шлюз Hermes: два споживачі getUpdates дають помилку 409.
Вставте токен у Channels → Telegram.
Натисніть «Open Telegram and pick a channel» (Telegram сам додасть бота адміністратором) або «Or pick a group». Також можна надіслати /connect у групі, де бот уже є.

Mastodon (вже працює)

Channels → Mastodon → введіть свій сервер (наприклад, mastodon.social).
Натисніть «Open Mastodon and authorize», потім Authorize на вашому сервері.

M.A.V.E.N сам реєструє свій застосунок на цьому сервері, тож ключі розробника й паролі не потрібні. «Preferences» на картці підключеного каналу знову відкриває вікно підключення - так можна авторизуватися повторно.

Обмеження Mastodon: 500 символів на допис (довше - вийде тред), до 4 зображень або 1 відео, alt-текст задається через опис зображення.

Інші платформи. LinkedIn, X, Bluesky, Facebook, Instagram і YouTube підключаються через брокер MAVEN Connect (connect.ownyourmodels.xyz) - це наступний етап. TikTok навмисно не підтримується.

Тестовий канал

Доки платформу не підключено, призначені їй дописи йдуть до тестового каналу - підключеного Telegram-каналу чи групи, які ви задаєте в Settings. Такі дописи позначені «[Test · Platform]».

Погодження, автономність і ліміти

Дописи, написані агентами, чекають погодження людиною в черзі.
Виняток - платформи з позначкою autonomous у Settings. Допис агента, що йде лише на автономні платформи, публікується без погодження.
Для дописів агентів діє добовий ліміт на акаунт (за замовчуванням 20).
Невдалий допис повторюється 3 рази з інтервалом 10 хвилин і ніколи не публікується двічі там, де вже вийшов.
Stop all publishing зупиняє все - і людей, і агентів.

Секрети (токен бота й токени Mastodon) зберігаються зашифрованими в ~/.maven/socialhub/secrets.json із правами 600.

Як публікують агенти

Агенти публікують через єдину точку входу. Канали за замовчуванням для дописів агентів - LinkedIn і X.

Контент-фабрика - соціальний крок запуску. Див. Content factory і Brands.
Kanban - кнопка «Publish to SocialHub» на задачі в Done. Текст результату задачі та шляхи до зображень чи відео зі сховища, названі в ньому, стають дописом.
Maven Swarm - інструмент socialhub_publish (аргументи: текст, шляхи до медіа, канали linkedin/x/telegram, дата, час, first_comment).
Hermes Swarm - дія вузла «Publish - queue the result as a post in SocialHub». Вивід попереднього кроку стає дописом.
Chat copilot - інструмент, доступний у чаті.

Для скриптів

Локальні HTTP-ендпоїнти, лише localhost:

POST /api/socialhub/media із {path} повертає id.
POST /api/socialhub/posts із {action:"create", text, channels, media, date, time, status, source}.
POST /api/socialhub/posts із {action:"publish", id}.

Що далі

Підключення LinkedIn, X, Bluesky, Facebook, Instagram і YouTube через брокер MAVEN Connect.