Social Broadcast MCP

开源（MIT）MCP 服务器，用于使用每个平台的官方 API 和你自己的 OAuth 凭据在社交媒体（Facebook、Instagram、YouTube）上发布内容。

没有中央服务。没有套餐。没有人造。没有付费中介。

为什么存在？

SaaS 工具（SocialCannon、PostFast、Buffer 等）会收取每月订阅费，并设置限制（账户数、帖子数、媒体上传数）。这个项目做的是同样的事情——从 AI 代理（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。要上传本地文件，请将其放在任何可访问的位置（如 S3/GCS，或你的网站，或本地暴露的服务器）并传递其 URL。一个直接上传的辅助工具（helper）已在路线图中。

文档

• docs/SETUP_META.md — 逐步创建 Meta 应用

• docs/SETUP_YOUTUBE.md — Google Cloud 项目 + OAuth

• docs/TIKTOK.md — TikTok 集成的预期方式（需要审核）

• docs/SECURITY.md — 令牌本地管理和最佳实践

安全性

• 令牌以 0600 权限本地存储在 ~/.social-broadcast-mcp/。

• 绝不会发送到任何外部服务器。

• 没有遥测。没有分析。没有回传内容。。

• 查看 src/auth/store.ts 以确切了解保存了什么。

许可证

MIT — 可自由使用、复制、修改和分发。为社区打造，源自实际使用 Templo Song（Vilagarcía de Arosa）日历的干货经验。

免责声明

本项目与 Meta、Google、TikTok 或 X Corp 无关。所有商标归其各自所有者所有。使用 API 须遵守各平台的服务条款。