LinkedIn Skill Part 1

단계

1. post 작성 with token

2. post 작성 with skill (claude code)

개요

LinkedIn API를 통해 개인 프로필로 포스팅을 자동화한다. 전체 흐름은 다음과 같다:

1. Company Page 생성 - LinkedIn Developer App 생성 시 필수 요구사항

2. Developer App 생성 - API 접근을 위한 앱 등록

3. Access Token 발급 - 인증 토큰 획득

4. API로 포스팅 - 개인 프로필로 글 작성

Company Page는 App 생성을 위한 필수 조건일 뿐, 실제 포스팅은 개인 프로필(urn:li:person)로 한다.

개인 vs 조직 포스팅

용도	author 값	필요 scope
개인 프로필로 포스팅	urn:li:person:{id}	w_member_social
Company Page로 포스팅	urn:li:organization:{id}	w_organization_social

1. Company Page 생성 (완료)

App 생성 시 Company Page가 필수이므로 먼저 만들어야 한다.

1. Company Page 생성 접속

2. Small business 선택

3. 아래 정보 입력 후 페이지 만들기 클릭

항목	값
이름	wooddrafts
웹사이트	https://www.wooddrafts.com
업종	정보 서비스
단체 규모	직원 0-1명
단체 종류	개인사업
로고	wooddrafts-logo-300px.png
태그라인	Design WoodWorking

Company Page 생성 폼

생성 완료 후 대시보드:

Company Page 대시보드

• 관리 URL: https://www.linkedin.com/company/77777/admin/dashboard/

• Individual Developer는 본인 이름으로 default Company Page가 자동 생성되어 있을 수 있음

2. LinkedIn Developer App 생성

2-1. App 생성

1. LinkedIn Developer Portal 접속

2. 아래 정보 입력:

항목	값
App name	앱 이름 (예: teamsmiley)
LinkedIn Page	본인 이름으로 검색하면 default Company Page가 나옴
Privacy policy URL	비필수, 비워두어도 됨
App logo	필수, 정사각형 100px 이상
Legal Agreement	동의 체크

App 생성 화면

2-2. Share on LinkedIn 권한 요청

1. 생성된 앱의 Products 탭 이동

2. Share on LinkedIn > Request access 클릭

3. Sign In with LinkedIn using OpenID Connect > Request access 클릭

Products 탭

Request access 확인

• Share on LinkedIn: 포스팅 기능 (w_member_social)

• Sign In with LinkedIn using OpenID Connect: 프로필 조회 기능 (openid, profile) - Token Generator에서 URN 확인에 필요

alt text

2-3. App 인증 (Verification)

1. Settings 탭 이동

2. Verify 버튼 클릭

Settings 탭 - Verify

1. Generate URL 클릭하여 인증 URL 생성

Verify company 다이얼로그

1. 생성된 URL을 복사하여 브라우저에 붙여넣으면 인증 완료

Verify responsibility 확인 화면

인증 완료 화면

3. Access Token 발급

Token Generator로 발급

1. LinkedIn OAuth Token Generator 접속

2. 앱 선택

3. scope 체크: openid, profile, w_member_social

4. Request access token 클릭

5. 발급된 토큰 저장

• 유효기간: 2개월 (만료 후 같은 방법으로 재발급)

alt text

alt text

alt text

에러나면 secret mode로 해보라. 된다.

인증 정보 확인

Auth 탭에서 확인:

• Client ID: 앱 식별자

• Client Secret: 앱 비밀키 (외부 공유 금지)

alt text

4. API를 통한 포스팅

4-1. 사용자 URN 확인

export ACCESS_TOKEN=AQXf_lESBSLuy401m8jb3xRMHf1EoDOac1NGNllQqTCuTMUZjsqal3voedMHPL4

curl --silent \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  "https://api.linkedin.com/v2/userinfo"

{
  "sub": "XXX",
  "email_verified": true,
  "name": "xxx xxx xxx",
  "locale": { "country": "KR", "language": "ko" },
  "given_name": "xxx xxx",
  "family_name": "xxx",
  "email": "[e-mail]"
}

응답의 sub 값이 사용자 URN ID이다.

4-3. 텍스트 포스트

curl -X POST 'https://api.linkedin.com/rest/posts' \
  -H "Authorization: Bearer ${ACCESS_TOKEN}" \
  -H 'X-Restli-Protocol-Version: 2.0.0' \
  -H 'Linkedin-Version: 202602' \
  -H 'Content-Type: application/json' \
  --data '{
    "author": "urn:li:person:${SUB}",
    "commentary": "포스팅 내용을 여기에 작성",
    "visibility": "PUBLIC",
    "distribution": {
      "feedDistribution": "MAIN_FEED",
      "targetEntities": [],
      "thirdPartyDistributionChannels": []
    },
    "lifecycleState": "PUBLISHED",
    "isReshareDisabledByAuthor": false
  }'

성공 시 201 응답, x-restli-id 헤더에 Post ID 반환.

확인

https://www.linkedin.com/in/byung-yong-kim-8a61a5146/recent-activity/all/

alt text

6. 주의사항

• Access Token 유효기간: 2개월 (만료 후 Token Generator에서 재발급)

• 포스트 내용에 쌍따옴표(")가 포함되면 JSON escape 필요

• ugcPosts API는 deprecated -> Posts API (/rest/posts) 사용

• API 버전은 Linkedin-Version 헤더로 YYYYMM 형식 지정