Social Broadcast MCP

각 플랫폼의 공식 API와 자신의 OAuth 자격 증명을 사용해 소셜 네트워크(Facebook, Instagram, YouTube)에 게시하기 위한 open source (MIT) MCP 서버입니다.

중앙 서비스가 없습니다. 요금제가 없습니다. 인위적인 제한이 없습니다. 유료 중개자도 없습니다.

왜 존재하는가?

SaaS 도구(SocialCannon, PostFast, Buffer...)는 월 구독료를 받고 한도(계정, 게시물, 미디어 업로드)를 부과합니다. 이 프로젝트는 AI 에이전트(Hermes, Claude 등)에서 게시한다는 같은 일을 —하지만 각 사용자는 자신의 계정을 연결하며, 이때 자신의 개발자 앱을 사용합니다. 영원히 무료입니다.

⚠️ SaaS의 핵심 차이: 그들은 이미 전체 검토가 완료된 Meta/Google 승인 앱을 가지고 있습니다. 여기서는 당신이 앱을 만들고(무료) 직접 계정에 사용합니다. 이는 개인/자체 비즈니스 용도로 유효하며, 제3자 계정의 공개 액세스에만 요구되는 Meta(앱 리뷰)를 우회할 수 있습니다.

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/ 문서 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 참조):

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을 전달하세요. 직접 업로드 헬퍼는 로드맵에 포함되어 있습니다.

문서

• 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 Arousa)의 달력을 실제로 게시한 경험을 바탕으로 합니다.

면책 조항

이 프로젝트는 Meta, Google, TikTok 또는 X Corp와 제휴하지 않습니다. 상표는 각 소유자에 귀속됩니다. API 사용은 각 플랫폼의 서비스 약관을 따릅니다.