Social Post (YouTube, Facebook, Mastodon)
Publora MCP 서버를 사용하여 YouTube, Facebook 페이지 및 Mastodon에 게시물을 생성하고 예약합니다. 이 스킬은 플랫폼별 복잡성 없이 표준 게시 방식으로 작동하는 플랫폼을 다룹니다.
필수 조건
요금제: 무료 Starter 플랜에서 작동합니다. 현재 한도 및 가격: publora.com/pricing
시작하기
- 계정 생성 publora.com/register (무료)
- 플랫폼 연결 Publora 대시보드에서 OAuth를 통해 연결:
- YouTube: Google OAuth (YouTube 채널 필요)
- Facebook: Facebook OAuth (페이지 전용, 개인 프로필 불가)
- Mastodon: OAuth (mastodon.social 인스턴스)
- API 키 받기 app.publora.com/dashboard/api
- 에이전트 연결
https://mcp.publora.com의 MCP 서버에Authorization: Bearer sk_YOUR_API_KEY로 인증합니다. Claude Code에서:
claude mcp add publora --transport http https://mcp.publora.com \
--header "Authorization: Bearer sk_YOUR_API_KEY"
Claude Desktop, Cursor, Codex, OpenClaw 및 claude.ai 커넥터는 각각 다른 설정 파일이나 흐름이 필요합니다. 정확한 경로와 코드 조각은 클라이언트 설정을 참조하세요.
REST API 폴백
MCP를 사용할 수 없는 경우 REST API를 직접 사용하세요:
기본 URL: https://api.publora.com/api/v1
인증: x-publora-key 헤더
# 연결된 플랫폼 가져오기
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
-H "x-publora-key: sk_your_api_key"
# 게시물 만들기
curl -X POST "https://api.publora.com/api/v1/create-post" \
-H "x-publora-key: sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"platforms": ["youtube-UCxxx", "facebook-123456", "mastodon-789"],
"content": "게시물 내용",
"scheduledTime": "2026-03-25T10:00:00Z"
}'
플랫폼 ID 형식:
- YouTube:
youtube-{channel_id}(예:youtube-UCxxx) - Facebook:
facebook-{page_id}(예:facebook-112233445566) - Mastodon:
mastodon-{id}(예:mastodon-456)
📖 문서: docs.publora.com
YouTube
동영상 전용 플랫폼 - 모든 게시물에는 동영상 파일이 필요합니다.
플랫폼 제한
| 기능 | 제한 |
|---|---|
| 동영상 제목 | 100자 |
| 동영상 설명 | 5,000자 |
| 동영상 길이 | 12시간 |
| 동영상 크기 | 256 GB |
| 동영상 형식 | MP4, MOV, AVI, WebM |
플랫폼 설정 (REST API 사용)
{
"platformSettings": {
"youtube": {
"privacy": "public",
"title": "내 동영상 제목"
}
}
}
| 설정 | 값 | 기본값 |
|---|---|---|
privacy | "public", "unlisted", "private" | "public" |
title | 문자열 | 내용의 처음 70자에서 생성 |
참고: platformSettings는 MCP의 create_post 및 update_post 도구와 REST에서 모두 허용됩니다. 스키마는 엄격하여, 잘못 입력된 플랫폼이나 키는 자동으로 무시되지 않고 유효성 검사 오류와 함께 거부됩니다.
YouTube 예시
이 튜토리얼 동영상을 YouTube에 업로드하세요:
"10분 만에 REST API 구축하기 - 초보자를 위한 완벽 가이드"
이 동영상을 공개되지 않음으로 업로드하세요 (내부 공유용):
"내부 데모 - Q1 대시보드 기능"
YouTube 제한 사항
- 동영상 필수: YouTube는 텍스트 전용 또는 이미지 게시물을 지원하지 않습니다.
- 단일 동영상: 게시물당 동영상 하나
- 처리 시간: 업로드 후 동영상 처리에 수초에서 수분 소요
- 토큰 갱신: YouTube 토큰은 약 6개월 후 만료되며, 필요한 경우 다시 연결하세요.
페이지 전용 - 게시물은 Facebook 페이지에만 게시되며 개인 프로필에는 게시되지 않습니다.
플랫폼 제한
| 기능 | 제한 |
|---|---|
| 게시물 텍스트 | 2,200자 (프론트엔드) / 63,206자 (API) |
| 이미지 | 게시물당 최대 10개 |
| 이미지 크기 | 10 MB |
| 동영상 길이 | 45분 |
| 동영상 크기 | 2 GB |
다중 페이지 지원
여러 Facebook 페이지를 관리하는 경우 각 페이지는 고유한 플랫폼 ID를 갖습니다:
facebook-112233445566(페이지 1)facebook-778899001122(페이지 2)
단일 요청으로 여러 페이지에 게시할 수 있습니다.
Facebook 예시
이 공지사항을 내 Facebook 페이지에 게시하세요:
"저희의 신제품 출시를 발표하게 되어 매우 기쁩니다! 자세한 내용은 웹사이트를 방문해 주세요."
두 Facebook 페이지 모두에 이 글을 게시하세요:
"휴일 공지: 월요일에 사무실이 휴무입니다."
이 이벤트 사진을 Facebook에 공유하세요:
"회사 워크숍 하이라이트! 훌륭한 팀, 좋은 추억."
Facebook 제한 사항
- 페이지 전용: API를 통해 개인 프로필에 게시할 수 없습니다.
- WebP 자동 변환: WebP 이미지는 자동으로 JPEG가 됩니다.
- 59일 토큰: 토큰이 자동 갱신되지만, 실패할 경우 재연결이 필요할 수 있습니다.
- 혼합 미디어 불가: 게시물은 이미지 또는 동영상 중 하나만 포함할 수 있으며, 둘 다는 불가능합니다.
Mastodon
Fediverse 플랫폼 - 게시물이 분산 네트워크 전반에 연합됩니다.
플랫폼 제한
| 기능 | 제한 |
|---|---|
| 게시물 텍스트 | 500자 |
| 이미지 | 게시물당 최대 4개 |
| 이미지 크기 | 16 MB |
| 동영상 크기 | ~99 MB |
| 이미지 형식 | JPEG, PNG, GIF, WebP |
| 동영상 형식 | MP4, WebM, MOV |
Mastodon 예시
이 글을 Mastodon에 게시하세요:
"안녕하세요 fediverse! 저희 오픈소스 프로젝트의 주요 업데이트를 방금 출시했습니다. #오픈소스"
이 스크린샷을 Mastodon에 공유하세요:
"새로운 기능: 다크 모드가 출시되었습니다! #ui #다크모드"
Mastodon 제한 사항
- mastodon.social 전용: 현재는 mastodon.social 인스턴스에만 연결됩니다.
- 공개 가시성: 모든 게시물은 기본적으로 공개됩니다.
- 자동 스레딩 없음: X/Twitter와 달리 Mastodon은 긴 내용을 분할하지 않습니다.
- 500자 엄격: 500자를 초과하는 내용은 거부됩니다.
사용 가능한 도구 (모든 플랫폼)
create_post
모든 플랫폼에 새 게시물을 만듭니다.
매개변수:
platforms: 플랫폼 ID 배열 (예:["youtube-UCxxx", "facebook-123", "mastodon-456"])content: 게시물 텍스트scheduledTime: ISO 8601 UTC 날짜/시간. 선택 사항: 생략하면 게시물이 초안으로 생성됩니다. 미래 시간을 보내면 예약됩니다. 5분 이상 과거의 시간은SCHEDULED_TIME_IN_PAST와 함께 거부되므로, 즉시 게시하려면 현재 시간에 1분을 더한 값을 사용하세요.mediaUrls: 최대 10개의 공개 https 이미지 또는 동영상 URL. Publora가 서버 측에서 다운로드하여 검증 전에 첨부하므로, 미디어와 예약이 한 번의 호출로 처리됩니다. 이는 초안 작성 후get_upload_url및complete_media흐름의 원샷 대안입니다. 수집 속도는 시간당 60개의 URL로 제한됩니다.
get_upload_url
미디어 업로드를 위한 사전 서명된 URL을 가져옵니다.
매개변수:
postGroupId: 미디어를 첨부할 게시물 IDfileName: 파일 이름contentType: MIME 타입type:"image"또는"video"
complete_media
get_upload_url을 통해 업로드된 파일을 사전 서명된 PUT이 성공한 후 최종 확정합니다. 선택 사항입니다. 예약 시 보류 중인 미디어도 최종 확정되지만, 조기에 호출하면 게시 전에 형식 및 프로브 오류를 표시합니다. mediaUrls로 첨부된 미디어에는 필요하지 않습니다.
매개변수:
mediaId:get_upload_url에서 반환된 ID
list_connections
연결된 계정과 해당 플랫폼 ID를 나열합니다. 먼저 이 함수를 호출하고 ID를 그대로 복사하세요. ID는 절대 추측할 수 없습니다.
list_posts / get_post / update_post / delete_post
예약된 게시물과 초안 게시물을 관리합니다. update_post는 초안 또는 예약된 게시물의 content와 platforms도 패치하므로, 오타 수정이나 대상 변경을 위해 더 이상 삭제 후 재생성할 필요가 없습니다. delete_media 및 prune_media_reference는 업로드된 파일을 정리합니다.
교차 플랫폼 게시
한 번에 여러 플랫폼에 게시:
이 동영상을 YouTube에 게시하고 이 텍스트를 Facebook과 Mastodon에 게시하세요:
"새로운 기능 발표 - 데모를 시청하세요!"
Publora가 플랫폼별 요구 사항을 자동으로 처리합니다:
- YouTube: 제목/설명이 포함된 동영상
- Facebook: 텍스트 + 동영상
- Mastodon: 텍스트 (500자 제한 적용)
문제 해결
| 플랫폼 | 오류 | 해결 방법 |
|---|---|---|
| YouTube | "동영상 필요" | 동영상 파일 첨부 |
| YouTube | "계정 연결 끊김" | 대시보드에서 다시 연결 |
| "페이지를 찾을 수 없음" | 페이지 연결 확인 | |
| "토큰 만료" | 대시보드에서 페이지 다시 연결 | |
| Mastodon | "내용이 너무 깁니다" | 500자 미만으로 단축 |
| Mastodon | "이미지가 너무 많습니다" | 4개 이하로 줄임 |
| 전체 | 속도 제한 오류 | 대기 후 재시도 |
여기에 있던 512 MB 수치는 대시보드의
/media/process-videomultipart 엔드포인트에 속합니다. API 및 MCP 업로드는 사전 서명되며 위의 플랫폼 상한을 사용합니다.