LinkedIn 게시물
Publora MCP 서버를 사용하여 LinkedIn 게시물을 생성하고 예약합니다. 텍스트 게시물, 단일 이미지, 다중 이미지 게시물(그리드 레이아웃), 동영상, PDF 문서를 지원합니다.
사전 요구 사항
요금제: 무료 Starter 요금제에서 작동합니다. 현재 한도 및 가격: publora.com/pricing.
시작하기
- publora.com/register에서 계정 생성 (무료)
- Publora 대시보드에서 OAuth를 통해 LinkedIn 연결
- 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 헤더 사용 (Authorization: Bearer 아님):
# 연결된 플랫폼 가져오기
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": ["linkedin-Tz9W5i6ZYG"],
"content": "게시물 내용 입력",
"scheduledTime": "2026-03-25T10:00:00Z"
}'
플랫폼 ID 형식: linkedin-{id}이며 {id}는 /platform-connections 응답에서 가져옵니다.
예시 ID: linkedin-Tz9W5i6ZYG, linkedin-abc123xyz
📖 전체 API 문서: docs.publora.com
플랫폼 제한
| 기능 | 제한 |
|---|---|
| 문자 수 | 최대 3,000자 |
| "더 보기" 전 표시 | 처음 210자 |
| 이미지 | 최대 10개 (그리드 레이아웃, 스와이프 불가) |
| 이미지 크기 | 36,152,320 픽셀이 기본 제한, 50 MB 상한 |
| 이미지 형식 | JPEG, PNG, GIF, WebP (WebP는 자동 변환) |
| 동영상 길이 | 30분 |
| 동영상 크기 | 최대 500 MB |
| 동영상 형식 | MP4 전용 |
사용 가능한 도구
create_post
새 LinkedIn 게시물을 생성하거나 나중에 발행하도록 예약합니다.
매개변수:
platforms: LinkedIn 연결 ID를 포함하는 배열 (예:["linkedin-abc123"])content: 게시물 텍스트 (최대 3,000자)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: 파일 이름 (예: "chart.png")contentType: MIME 유형 (예: "image/jpeg", "video/mp4", "application/pdf")type: "image" 또는 "video"
complete_media
사전 서명된 PUT이 성공한 후, get_upload_url을 통해 업로드된 파일을 최종 처리합니다. 선택 사항입니다. 예약 시에도 보류된 미디어를 최종 처리하지만, 일찍 호출하면 게시 전에 형식 및 프로브 오류를 노출합니다. 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는 업로드된 파일을 정리합니다.
사람 및 회사 멘션
LinkedIn 게시물은 URN 구문을 사용한 @멘션을 지원합니다:
@{urn:li:person:MEMBER_ID|표시 이름} # 사람 멘션
@{urn:li:organization:ORG_ID|회사 이름} # 회사 멘션
예시:
@{urn:li:person:4986615|Serge Bulaev}의 @{urn:li:organization:107107343|Creative Content Crafts Inc}에서의 훌륭한 인사이트!
중요: 표시 이름은 LinkedIn 프로필 이름과 정확히 일치해야 합니다 (대소문자 구분). "Inc", "LLC" 등 회사 접미사도 포함합니다.
멤버 ID를 직접 작성하지 마세요. linkedin_list_mentionables MCP 도구가 이름을 올바른 URN으로 확인합니다. linkedin-analytics 스킬을 참조하세요.
중요한 API 제한 사항
-
오가닉 캐러셀 없음: 여러 이미지를 스와이프할 수 있는 캐러셀은 API를 통해 사용할 수 없습니다 (스폰서 콘텐츠 전용). 여러 이미지 게시물은 그리드 레이아웃으로 표시됩니다.
-
혼합 미디어 불가: 동일 게시물에 이미지와 동영상 또는 문서를 함께 사용할 수 없습니다.
-
리치 텍스트 없음: LinkedIn API는 굵게, 기울임꼴 등 서식을 지원하지 않습니다. 강조를 위해 일반 텍스트나 유니코드 문자를 사용하세요.
-
캐러셀 대안으로 PDF: 여러 페이지를 스와이프할 수 있는 콘텐츠를 공유하려면 PDF 문서를 업로드하세요.
예시
간단한 텍스트 게시물
내일 오전 9시에 LinkedIn 게시물 예약:
"AI 작문 도우미의 출시를 발표하게 되어 매우 기쁩니다. 18개월의 개발 끝에 팀이 더 빠르고 더 나은 콘텐츠를 작성할 수 있도록 준비되었습니다."
멘션이 포함된 게시물
CEO를 멘션하는 LinkedIn 게시물 작성:
"콘텐츠 제작에서 AI의 미래에 대한 @{urn:li:person:4986615|Serge Bulaev}의 인사이트를 공유하게 되어 기쁩니다."
여러 이미지 게시물
새로운 대시보드 기능을 보여주는 4개의 제품 스크린샷이 포함된 LinkedIn 게시물 작성.
참고: 이미지는 스와이프 가능한 캐러셀이 아닌 그리드 레이아웃으로 표시됩니다.
PDF 문서 게시물
요약 캡션과 함께 Q4 보고서를 PDF로 LinkedIn에 공유.
여러 페이지의 캐러셀 형식 콘텐츠를 공유하는 가장 좋은 방법입니다.
모범 사례
- 첫 줄이 중요: "더 보기" 전에 처음 210자가 표시되므로 매력적으로 만드세요
- 최적 길이: 1,300자 미만의 게시물이 일반적으로 더 좋은 성과를 냅니다
- 게시 시간: 청중 시간대의 화요일-목요일, 오전 8-10시
- 해시태그: 관련 해시태그 3-5개 사용 – 일반 텍스트로 지원됩니다
- 참여 유도: 질문으로 끝내어 댓글을 장려하세요
문제 해결
| 오류 | 원인 | 해결책 |
|---|---|---|
| "Account not connected" | LinkedIn OAuth 만료 | Publora 대시보드에서 재연결 |
| "MEDIA_ASSET_PROCESSING_FAILED" | 파일이 너무 크거나 형식이 잘못됨 | 확인: 이미지 < 5 MB, 동영상 < 500 MB MP4 |
| "Rate limited" (429) | API 호출 과다 | 대기 후 백오프로 재시도 |
| "Cannot mix media types" | 동일 게시물에 이미지 + 동영상 | 게시물당 한 가지 미디어 유형만 사용 |
| MCP 사용 불가 | 서버 문제 | REST API 폴백 사용 (위 참조) |