Social Broadcast MCP

MCP‑сервер с открытым исходным кодом (MIT) для публикации в социальных сетях (Facebook, Instagram, YouTube) через официальные API каждой платформы и с собственными учётными данными OAuth.

Без центрального сервиса. Без тарифов. Без искусственных ограничений. Без платёжных посредников.

Зачем он существует?

SaaS‑инструменты (SocialCannon, PostFast, Buffer...) берут ежемесячную плату и вводят ограничения (аккаунты, посты, загрузка медиа). Этот проект делает то же самое — публикует через ИИ‑агента (Hermes, Claude и т. д.), — но каждый пользователь подключает свои собственные аккаунты через свои приложения разработчика. Бесплатно навсегда.

⚠️ Ключевое отличие от SaaS: у них уже есть приложения, одобренные Meta/Google после полной проверки. Здесь вы создаёте своё приложение (бесплатно) и используете его для своих аккаунтов. Это допустимо для личного использования и собственного бизнеса и позволяет избежать проверки Meta (App Review), которая требуется только для публичного доступа к аккаунтам третьих лиц.

Related MCP server: @posteverywhere/mcp

Платформы

Установка

git clone https://github.com/tu-usuario/social-broadcast-mcp.git
cd social-broadcast-mcp
npm install
npm run build

Настройка в Hermes (или любом клиенте MCP)

# ~/.hermes/config.yaml (o config del perfil)
mcp_servers:
  social-broadcast:
    command: "node"
    args: ["/ruta/a/social-broadcast-mcp/dist/index.js"]

Или в любом совместимом клиенте MCP:

{
  "mcpServers": {
    "social-broadcast": {
      "command": "node",
      "args": ["/ruta/a/social-broadcast-mcp/dist/index.js"]
    }
  }
}

Использование

1. Подключение Facebook + Instagram

Нужно создать аккаунт на developers.facebook.com (см. docs/SETUP_META.md) и получить:

• App ID (clientId)

• App Secret (clientSecret, нужен только в режиме разработки)

Затем через агента:

connect_meta(clientId: "TU_APP_ID", clientSecret: "TU_APP_SECRET")

Откроется браузер → вы авторизуетесь в своей учётной записи → аккаунты сохраняются локально в ~/.social-broadcast-mcp/.

2. Подключение YouTube

Создайте проект на Google Cloud Console с YouTube Data API v3 (см. docs/SETUP_YOUTUBE.md):

connect_youtube(clientId: "TU_CLIENT_ID", clientSecret: "TU_CLIENT_SECRET")

3. Просмотр подключённых аккаунтов

list_accounts()

4. Публикация

publish_post(
  accountId: "fb:533433607139839",
  content: "🌀 CREA TU PROPIO GONG 🌀\nUn gong hecho por ti, para ti, como tú.",
  mediaUrls: ["https://tudominio.com/imagen.jpg"],
  platformOptions: { "mediaType": "REELS" }  // para Reels de IG
)

Чтобы запланировать публикацию вместо мгновенной загрузки, добавьте scheduledAt: "2026-09-01T18:00:00+01:00".

Примечание о медиа: API принимает публичные URL. Для загрузки локальных файлов разместите их в любом доступном месте (bucket S3/GCS, ваш сайт или локальный сервер с открытым доступом) и передайте их URL. Хелпер для прямой загрузки — в дорожной карте.

Документация

• docs/SETUP_META.md — создание приложений Meta шаг за шагом

• docs/SETUP_YOUTUBE.md — проект Google Cloud + OAuth

• docs/TIKTOK.md — как бы выглядела интеграция TikTok (требуется проверка)

• docs/SECURITY.md — локальное хранение токенов и лучшие практики

Безопасность

• Токены хранятся локально в ~/.social-broadcast-mcp/ с правами доступа 0600.

• Они никогда не отправляются на внешний сервер.

• Никакой телеметрии. Никакой аналитики. Ничего, что «зовёт домой».

• Посмотрите src/auth/store.ts, чтобы точно увидеть, какие данные сохраняются.

Лицензия

MIT — свободно используйте, копируйте, изменяйте и распространяйте. Сделано для сообщество на основе реального опыта публикации календаря Templo del Lagar (Vilagarcía de Arosa).

Дискренция

Проект не аффилирован с Meta, Google, TikTok или X Corp. Товарные знаки принадлежат их владельцам. Использование APIs регулируется условиями обслуживания (terms of service) каждой платформы.