publora/linkedin-analytics

LinkedIn Analytics

LinkedIn 게시물과 프로필의 노출수, 참여도, 팔로워 증가를 추적하고, 반응, 댓글, 공유를 통해 게시물과 상호작용합니다. 통계는 REST API에서 제공되며, 반응, 댓글, 공유 및 멘션 조회는 MCP 도구입니다.

필수 조건

요금제: 무료 Starter 요금제에서 사용 가능합니다. 현재 제한 및 가격: publora.com/pricing

시작하기

1. 계정 생성 publora.com/register (무료)
2. LinkedIn 연결 Publora 대시보드에서 OAuth를 통해 연결
3. API 키 발급 app.publora.com/dashboard/api에서 발급
4. 에이전트 연결 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/linkedin-post-statistics" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platformId": "linkedin-abc123",
    "postedId": "urn:li:share:7123456789012345678",
    "queryTypes": "ALL"
  }'

# 계정 통계 가져오기
curl -X POST "https://api.publora.com/api/v1/linkedin-account-statistics" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platformId": "linkedin-abc123",
    "queryTypes": "ALL"
  }'

플랫폼 ID 형식: linkedin-{id} ({id}는 /platform-connections 응답에서 가져옴)

예시 ID: linkedin-Tz9W5i6ZYG, linkedin-abc123xyz

📖 전체 API 문서: docs.publora.com

분석 도구 (REST 전용)

LinkedIn 분석은 MCP 도구로 노출되지 않습니다. MCP 서버는 게시, 미디어 및 LinkedIn 참여 도구를 제공하며, 통계는 REST API에만 존재합니다. 따라서 x-publora-key 헤더를 사용하여 이러한 엔드포인트를 직접 호출하세요. 에이전트에게 linkedin_post_stats MCP 도구를 요청하면 실패합니다. 해당 도구는 존재하지 않습니다.

POST /linkedin-post-statistics

단일 게시물의 참여 지표입니다.

본문:

• platformId: 플랫폼 연결 ID (예: linkedin-abc123), list_connections에서 가져옴
• postedId: 게시물 URN (urn:li:share:... 또는 urn:li:ugcPost:...)
• queryTypes (선택 사항): IMPRESSION, MEMBERS_REACHED, RESHARE, REACTION, COMMENT 또는 ALL

반환: 노출수, 고유 노출수(도달 회원), 반응, 댓글, 공유 및 데이터가 캐시되었는지 여부를 알려주는 cached 플래그입니다.

POST /linkedin-account-statistics

계정의 집계 통계입니다.

본문: platformId, 선택적 queryTypes, 선택적 aggregation (DAILY 또는 TOTAL, 기본값 TOTAL).

POST /linkedin-followers

시간 경과에 따른 팔로워 수 또는 증가율입니다.

본문: platformId, 선택적 period (lifetime 또는 daily), 선택적 dateRange ({start: {year, month, day}, end: {year, month, day}}).

POST /linkedin-profile-summary

결합된 프로필 개요: 팔로워 및 통계.

본문: platformId, 선택적 dateRange.

curl -X POST "https://api.publora.com/api/v1/linkedin-post-statistics" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"platformId": "linkedin-abc123", "postedId": "urn:li:share:7123456789012345678", "queryTypes": "ALL"}'

참여 도구

linkedin_create_reaction

LinkedIn 게시물에 반응합니다.

매개변수:

• postedId: LinkedIn 게시물 URN
• platformId: 플랫폼 연결 ID
• reactionType: 다음 중 하나

유형	설명
LIKE	기본 좋아요
PRAISE	박수 / 칭찬
EMPATHY	하트 / 공감
INTEREST	전구 / 통찰
APPRECIATION	지지
ENTERTAINMENT	재미 / 웃음

linkedin_delete_reaction

게시물에서 반응을 제거합니다.

매개변수:

• postedId: LinkedIn 게시물 URN
• platformId: 플랫폼 연결 ID

linkedin_create_comment

LinkedIn 게시물에 댓글을 작성합니다 (최대 1,250자).

매개변수:

• postedId: LinkedIn 게시물 URN
• platformId: 플랫폼 연결 ID
• message: 댓글 텍스트 (최대 1,250자)
• parentComment (선택 사항): 중첩 답글을 위한 댓글 URN

linkedin_delete_comment

작성한 댓글을 삭제합니다.

매개변수:

• postedId: LinkedIn 게시물 URN
• commentId: 댓글 URN 또는 숫자 ID
• platformId: 플랫폼 연결 ID

linkedin_create_reshare

기존 게시물을 선택적 설명과 함께 공유합니다.

매개변수:

• platformId: 플랫폼 연결 ID
• parent: 공유할 게시물의 공유 URN (urn:li:share:... 또는 urn:li:ugcPost:...). 참고: 이 도구는 postedId 대신 parent를 사용합니다.
• commentary (선택 사항): 공유 위에 표시할 텍스트 (최대 3,000자)
• visibility (선택 사항): PUBLIC 또는 CONNECTIONS, 기본값 PUBLIC. CONNECTIONS는 개인 계정용입니다.

참고: LinkedIn 피드 URL에는 activity ID가 포함되어 있지만, 이는 항상 공유 ID와 동일하지는 않습니다. 수동으로 변환한 activity ID 대신 get_post에서 반환된 postedId를 사용하세요.

linkedin_list_mentionables

이름을 @멘션에 필요한 URN으로 변환하여 회원 ID를 직접 작성할 필요가 없도록 합니다.

매개변수:

• q (선택 사항): 검색할 이름
• limit (선택 사항): 반환할 결과 수

두 매개변수 모두 선택 사항이며, 이 도구는 platformId를 사용하지 않습니다. 단일 연결이 아닌 계정 전체를 검색합니다.

예제 프롬프트

주간 성과 검토

지난 7일간의 내 LinkedIn 성과를 분석해줘.
다음을 보여줘:
1. 가장 성과가 좋았던 게시물
2. 내 참여율 추세
3. 팔로워 증가
4. 개선을 위한 추천 사항

게시물 분석

내 마지막 5개 LinkedIn 게시물의 상세 통계를 가져와서 어떤 콘텐츠가 내 잠재 고객에게 반응이 좋은지 패턴을 식별해줘.

참여 캠페인

동료의 승진 게시물(urn:li:share:123456)에 PRAISE 반응을 남기고 축하 댓글을 추가해줘.

팔로워 추적

지난 30일간의 내 LinkedIn 팔로워 증가를 보여줘. 매주 몇 명의 새 팔로워를 얻었어?

지표 참조

지표	설명
IMPRESSION	콘텐츠가 피드에 표시된 총 횟수
MEMBERS_REACHED	게시물을 본 고유 LinkedIn 회원 수
RESHARE	재게시/공유 횟수
REACTION	총 반응 수 (모든 유형 합산)
COMMENT	댓글 수

참여율 벤치마크

팔로워 수별 평균 LinkedIn 참여율:

팔로워	좋은 참여율
< 5K	3-5%
5K-50K	2-3%
50K+	1-2%

성과가 좋은 게시물의 일반적인 특징:

• 평균 노출수의 2배
• 댓글 대 반응 비율이 10% 이상
• 기준 참여율보다 높은 참여율

중요 참고 사항

1. 분석 지연: LinkedIn 분석은 완전히 채워지는 데 최대 24시간이 걸릴 수 있습니다. 게시 직후에 쿼리하면 부분적인 데이터가 반환됩니다.

2. URN 형식: LinkedIn URL은 urn:li:activity:xxx 형식을 사용하지만 API는 urn:li:share:xxx 또는 urn:li:ugcPost:xxx 형식을 요구합니다. 정확한 URN을 위해 Publora의 get_post 응답에서 postedId를 사용하세요.

3. 캐싱: 분석 응답이 캐시될 수 있습니다. 응답에는 데이터가 캐시에서 왔는지 여부를 나타내는 cached 필드가 포함됩니다.

4. 속도 제한: LinkedIn은 시간당 약 200회 이상의 API 호출을 허용합니다. 429 오류 발생 시 백오프를 구현하세요.

문제 해결

오류	원인	해결 방법
"Platform ID not found"	잘못된 연결 ID	list_connections를 실행하여 유효한 ID 확인
"Post not found"	잘못된 URN 형식	urn:li:share: 또는 urn:li:ugcPost: 형식 사용
429 Too Many Requests	속도 제한 초과	대기 후 지수 백오프로 재시도
"message cannot exceed 1250 characters"	댓글이 너무 김	댓글을 1,250자 미만으로 줄임