X/Twitter 게시물
Publora MCP 서버를 사용하여 X(Twitter)에 게시물을 작성하고 예약합니다. 텍스트 게시물, 이미지(최대 4개), 동영상 및 긴 콘텐츠의 자동 스레드 분할을 지원합니다.
전제 조건
요금제: 유료 요금제가 필요합니다(X API 비용이 전가됨). 현재 제한 및 가격: publora.com/pricing
중요: X/Twitter는 Twitter API 비용으로 인해 무료 스타터 요금제에서 사용할 수 없습니다.
시작하기
- 계정 생성 publora.com/register
- Pro 또는 Premium 요금제 선택 (X/Twitter는 유료 요금제 필요)
- Publora 대시보드(https://app.publora.com/dashboard)에서 OAuth를 통해 X/Twitter 연결
- API 키 받기 app.publora.com/dashboard/api
- 에이전트를 MCP 서버
https://mcp.publora.com에 연결하고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": ["twitter-123456789"],
"content": "Your tweet content",
"scheduledTime": "2026-03-25T10:00:00Z"
}'
플랫폼 ID 형식: twitter-{id} (예: twitter-123456789)
📖 문서: docs.publora.com
플랫폼 제한
| 기능 | API 제한 | 참고 |
|---|---|---|
| 문자 수 | 280 | 이모지는 2자로 계산 |
| 이미지 | 최대 4개 | PNG로 자동 변환됨 (최대 너비 1000px) |
| 동영상 길이 | 2분 20초 (140초) | Publora는 X 동영상을 140초로 검증 |
| 동영상 크기 | 512 MB | MP4, MOV 형식 |
| 스레딩 | 자동 | 280자 초과 시 (1/N) 마커로 분할 |
문자 수 계산
X는 Publora가 자동으로 처리하는 특정 문자 수 계산 규칙이 있습니다:
- 표준 문자 = 1
- 이모지 = 2자
- URL은 실제 길이로 계산
- 스레드 마커는 트윗당 10자를 예약
자동 스레딩
콘텐츠가 280자를 초과하면 Publora가 자동으로 연결된 스레드를 만듭니다:
- 콘텐츠를 문단 나누기, 문장 경계, 단어 경계 순서로 분할
- 각 부분에
(1/N),(2/N)형식으로 번호 지정 - 트윗이 X의
reply_to_id파라미터를 통해 연결됨
수동 스레드 나누기
한 줄에 ---를 사용하여 스레드 나누기를 강제합니다:
이것은 스레드의 첫 번째 트윗입니다.
---
이것은 스레드의 두 번째 트윗입니다.
---
그리고 이것은 세 번째 트윗입니다!
사용 가능한 도구
create_post
새 X/Twitter 게시물 또는 스레드를 생성합니다.
파라미터:
platforms: X 연결 ID 배열 (예:["twitter-12345678"])content: 게시물 텍스트 (280자 초과 시 자동 스레드)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: 파일 이름 (예: "image.png", "video.mp4")contentType:image/png,image/jpeg,video/mp4type:"image"또는"video"
complete_media
get_upload_url를 통해 업로드된 파일을 사전 서명된 PUT이 성공한 후에 최종 확정합니다. 선택 사항입니다. 예약 시에도 보류 중인 미디어를 최종 확정하지만, 호출을 조기에 하면 게시 전에 형식 및 프로브 오류를 표시할 수 있습니다. mediaUrls로 첨부된 미디어에는 필요하지 않습니다.
파라미터:
mediaId:get_upload_url이 반환한 ID
list_connections
연결된 계정과 해당 플랫폼 ID를 나열합니다. 이것을 먼저 호출하고 ID를 그대로 복사하세요. 추측이 불가능합니다.
list_posts / get_post / update_post / delete_post
예약된 게시물과 초안을 관리합니다. update_post는 초안 또는 예약된 게시물의 content와 platforms도 수정하므로 오타 수정이나 대상 변경을 위해 다시 삭제하고 생성할 필요가 없습니다. delete_media와 prune_media_reference는 업로드된 파일을 정리합니다.
예제
간단한 트윗
다음을 X에 게시:
"새로운 API 문서를 출시했습니다. 확인해보세요!"
이미지가 포함된 트윗
새 대시보드 스크린샷과 함께 Twitter에 게시:
"리디자인 전후. 어떻게 생각하시나요?"
참고: 최대 4개의 이미지 허용. 모든 이미지는 PNG로 자동 변환됩니다.
긴 스레드
Twitter 스레드 생성:
"스레드: 스타트업을 구축하며 배운 5가지 교훈
---
1. 빠르게 출시하고, 빠르게 반복하세요. 버그가 많은 MVP로 시작했지만 실제 피드백을 기반으로 개선했습니다.
---
2. 매일 사용자와 대화하세요. 최고의 기능은 고객 대화에서 나왔습니다.
---
3. 기능보다 집중이 중요합니다. 작동하는 하나에 집중하기 위해 3개의 제품을 없앴습니다."
예약된 트윗
내일 오전 9시에 예약:
"월요일 동기부여: 준비되기 전에 시작하세요."
중요 제한 사항
-
Pro 요금제 필요: X/Twitter는 Twitter API 비용으로 인해 무료 스타터 요금제에서 제외됩니다.
-
140초 동영상 제한: Publora는 X 동영상을 2분 20초(140초)로 검증합니다. 더 긴 동영상은 검증에 실패합니다.
-
이미지 자동 변환: 모든 이미지는 업로드 전에 PNG(최대 너비 1000px)로 변환됩니다. 애니메이션 GIF는 애니메이션이 손실됩니다.
-
이미지+동영상 혼용 불가: 트윗에는 이미지 또는 동영상 중 하나만 포함할 수 있습니다.
-
첫 번째 트윗에만 미디어: 스레드에서 이미지/동영상은 첫 번째 트윗에만 첨부됩니다.
모범 사례
콘텐츠
- 첫 줄에 훅: 대부분의 참여는 첫 번째 트윗에서 발생합니다.
- 최적의 스레드 길이: 최상의 참여를 위해 3-7개 트윗
- 이모지 인지: 이모지는 2자로 계산됩니다.
타이밍
- 최적 시간: 대상 시간대 기준 오전 8-10시, 오후 12-1시, 오후 5-6시
- 빈도: 성장을 위해 하루 3-5개 트윗
- 스레드: 최대 가시성을 위해 아침에 게시
참여
- 첫 1시간 이내에 댓글에 답변
- 가시성을 위해 자신의 스레드를 인용 트윗
- 관련 해시태그 사용 (트윗당 1-2개)
문제 해결
| 오류 | 원인 | 해결책 |
|---|---|---|
| "X/Twitter requires Pro plan" | 스타터 요금제 사용 중 | publora.com/settings에서 Pro로 업그레이드 |
| "Content too long" | 280자 초과 및 스레딩 실패 | 수동 --- 나누기 추가 |
| "Video too long" | 140초 초과 | 동영상을 2분 20초 미만으로 자르기 |
| "Too many images" | 이미지가 4개를 초과 | 4개 이하로 줄이기 |
| "Rate limit exceeded" | X API 제한 도달 | 잠시 기다렸다가 재시도 |