Social Broadcast MCP

オープンソース（MIT）のMCPサーバーです。各プラットフォームの公式APIとあなた自身のOAuth認証情報を使用して、ソーシャルメディア（Facebook、Instagram、YouTube）に投稿できます。

中央サービスなし。プランなし。人為的な制限なし。有料の仲介業者なし。

なぜ存在するのか？

SaaSツール（SocialCannon、PostFast、Bufferなど）は月額料金を請求し、制限（アカウント数、投稿数、メディアのアップロード）を課します。このプロジェクトは同じこと —AIエージェント（Hermes、Claudeなど）からの投稿— を実現しますが、各ユーザーが自分の開発者アプリを使用して自分のアカウントを接続することができます。ずっと無料です。

⚠️ SaaSとの違いは重要 です。SaaSにはMetaの公式SaaSと本質的な違い: 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設定でも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を受け取ります。ローカルファイルをアップロードするには、アクセス可能な場所（S3/GCSバケット、あなたのWebサイト、公開したローカルサーバー）に配置して、その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 Gong（Vilagarcía de Arosa）のカレンダー配信を公開した経験に基づいています。

免責事項

このプロジェクトは、Meta、Google、TikTok、X Corp.とは提携していません。愛称は各社の商標です。APIの利用は、各プラットフォームの利用規約に従います。