Threads Post
Publora MCP 서버를 사용하여 Meta Threads에 게시물을 만들고 예약합니다. 단일 게시물, 이미지 캐러셀(2-20장) 및 답글 제어를 지원합니다. 현재 플랫폼 연결로 인해 멀티파트 스레딩은 비활성화되어 있습니다.
필수 조건
요금제: 무료 Starter 플랜에서 작동합니다. 현재 한도 및 가격: publora.com/pricing
시작하기
- publora.com/register에서 계정 만들기 (무료)
- Publora 대시보드에서 Instagram OAuth를 통해 Threads 연결
- app.publora.com/dashboard/api에서 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": ["threads-12345"],
"content": "게시물 내용",
"scheduledTime": "2026-03-25T10:00:00Z"
}'
플랫폼 ID 형식: threads-{id} (/platform-connections에서 확인)
📖 문서: docs.publora.com
플랫폼 제한
| 기능 | 한도 |
|---|---|
| 게시물당 문자 수 | 500 |
| 해시태그 | 게시물당 최대 1개 |
| 링크 | 게시물당 최대 5개 |
| 캐러셀당 이미지 수 | 2-20 |
| 이미지 크기 | 8 MB |
| 이미지 형식 | JPEG, PNG (WebP는 자동 변환) |
| 동영상 길이 | 5분 |
| 동영상 크기 | 1 GB |
| 동영상 형식 | MP4, MOV |
| 하루 게시물 수 | 250 |
| 하루 답글 수 | 1,000 |
사용 가능한 도구
create_post
새로운 Threads 게시물 또는 스레드를 만듭니다.
매개변수:
platforms: Threads 연결 ID의 배열 (예:["threads-12345"])content: 게시물 텍스트 (500자 초과 시 자동 스레딩이 비활성화되어 있음)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을 가져옵니다.
complete_media
사전 서명된 PUT이 성공한 후 get_upload_url을 통해 업로드된 파일을 최종 확정합니다. 선택 사항입니다. 예약 시에도 보류 중인 미디어가 최종 확정되지만, 조기에 호출하면 게시 전에 형식 및 프로브 오류를 표시합니다. 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는 업로드된 파일을 정리합니다.
긴 콘텐츠
Threads 게시물은 500자로 제한되며, Threads 앱 연결 복구 중으로 Publora의 멀티파트 스레딩이 현재 비활성화되어 있습니다. 제한을 초과하는 콘텐츠는 자동으로 분할되지 않습니다. 따라서:
- 게시물을 500자 이내로 유지하거나,
- 직접 여러 개의 게시물로 나누어 게시하거나,
- 긴 버전은 현재 스레딩이 가능한 플랫폼(X)으로 옮기고 링크를 걸어주세요.
수동 --- 구분자와 [1/3] 표시는 작성된 대로 유지되지만, 현재로서는 연결된 답글 체인을 만들지 않습니다. 복구 일정은 [email protected]으로 문의하세요.
답글 제어
REST API platformSettings를 통해 게시물에 답글할 수 있는 사람을 제어합니다:
| 값 | 설명 |
|---|---|
"" (빈 문자열) | 기본 플랫폼 동작 (누구나 답글 가능) |
"everyone" | 명시적으로 누구나 답글 허용 |
accounts_you_follow | 내가 팔로우하는 계정만 답글 가능 |
"mentioned_only" | 멘션된 계정만 답글 가능 |
참고: platformSettings는 MCP create_post 및 update_post 도구와 REST에서 모두 허용됩니다. 스키마는 엄격합니다: 잘못 입력된 플랫폼이나 키는 자동으로 무시되지 않고 검증 오류로 거부됩니다.
중요 제한 사항
-
해시태그 1개 제한: Threads는 게시물당 최대 1개의 해시태그만 허용합니다. 추가 해시태그는 플랫폼에서 무시됩니다.
-
게시 후 수정 불가: 한 번 게시된 Threads 게시물은 API를 통해 수정할 수 없습니다. 필요한 경우 삭제 후 재게시하세요.
-
동영상 캐러셀 미지원: Publora의 캐러셀 구현은 이미지만 지원합니다. 단독 동영상 게시물은 정상 작동합니다.
-
멀티스레드 게시물 임시 사용 불가: 여러 개의 연결된 답글로 콘텐츠를 분할하는 기능이 일시적으로 비활성화되었습니다. 단일 게시물과 캐러셀은 계속 작동합니다.
예제
간단한 텍스트 게시물
Threads에 다음을 게시해 주세요:
"오늘 2시간을 절약해 준 놀라운 생산성 꿀팁을 발견했습니다. 핵심은 비슷한 작업을 함께 묶어 처리하는 것입니다."
이미지 캐러셀
이 5개의 제품 진화 스크린샷으로 Threads 캐러셀을 만들어 주세요.
캡션: "컨셉에서 출시까지 - 우리의 6개월 여정. #buildinpublic"
참고: 2-20개의 이미지가 필요합니다. 캐러셀 내 동영상은 지원되지 않습니다.
긴 콘텐츠 (별도 게시물로 게시)
스레딩이 비활성화되어 있으므로 파트를 명시적으로 요청하세요:
Threads에 별도 게시물로 게시해 주세요:
"스레드: 첫 창업자로서 저지른 7가지 실수
---
1. 너무 빨리 채용하기. 2명에서 3개월 만에 15명으로 늘렸습니다. 문화가 피폐해졌습니다.
---
2. 단위 경제성 무시하기. 수익이 좋아 보였지만 CAC를 계산할 때까지는..."
예약 게시물
내일 오전 10시에 다음을 예약해 주세요:
"월요일 동기부여: 시작하기 가장 좋은 시간은 어제였습니다. 두 번째로 좋은 시간은 지금입니다."
모범 사례
- 처음에 후크 걸기: 처음 두 줄이 참여도를 결정합니다. 효과적으로 만드세요.
- 적절한 길이: 단일 게시물은 100-250자가 효과적입니다.
- 고유 콘텐츠: 독창적이고 대화체의 게시물이 보상받습니다.
- 단일 해시태그: 관련성이 높은 해시태그 하나만 사용하세요 (플랫폼 제한).
- 수정 불가: 게시 전에 내용을 다시 확인하세요.
타이밍
- 최적 시간: 대상 시간대 기준 오전 7-9시, 오후 12-1시, 오후 7-9시
- 빈도: 성장을 위해 하루 1-3개 게시물
- 일관성: 정기적인 게시는 활성 계정임을 알립니다.
참여
- 첫 1시간 내에 댓글에 답글하세요.
- Instagram과 상호 참조하세요 (계정이 연결되어 있습니다).
- 검색을 위해 관련 주제/키워드를 사용하세요.
문제 해결
| 오류 | 원인 | 해결 방법 |
|---|---|---|
| "계정이 연결되지 않음" | Threads/Instagram OAuth 만료 | Publora 대시보드에서 재연결 |
| "내용이 너무 김" | 게시물이 500자를 초과하고 스레딩 실패 | 수동으로 --- 구분 기호 추가 |
| "미디어 업로드 실패" | 잘못된 형식 또는 크기 | 확인: 이미지 < 8 MB, JPEG/PNG만 |
| "캐러셀은 2-20개 항목 필요" | 잘못된 이미지 수 | 캐러셀에 2-20장의 이미지 확인 |
| "250개 게시물/일 초과" | 속도 제한 도달 | 24시간 대기 |