linkedin-safe-mcp

AI 에이전트(Claude Code, Codex, Claude Desktop, Cursor 등)에게 LinkedIn 슈퍼파워를 부여하는 MCP 서버 — LinkedIn 계정을 위험에 빠뜨리지 않으면서:

• LinkedIn에 게시 — 텍스트, 링크, 이미지를 LinkedIn의 공식 API(OAuth, ToS 준수)를 통해 게시하고, 댓글과 좋아요도 가능.

• 채용 정보 검색 — 키워드/지역/재택/경력/날짜 필터를 LinkedIn의 공개 게스트 엔드포인트로 검색. 로그인도 쿠키도 필요 없음: 계정이 전혀 관여하지 않습니다.

• 구직 활동 관리 — 로컬 SQLite 애플리케이션 트래커(관심 → 지원 → 면접 → 제안)에 메모와 채용 공고별 스냅샷을 저장하여, 공고가 내려간 후에도 에이전트가 파이프라인을 관리하고 맞춤형 자기소개서를 작성할 수 있습니다.

왜 이런 설계인가?

LinkedIn은 공식 채용 검색 API를 제공하지 않으며, 비공식 경로(li_at 세션 쿠키를 사용한 Voyager 내부 API, 로그인 세션의 헤드리스 브라우저)는 LinkedIn 이용약관 §8.2를 위반하고 계정이 제한되는 사례가 빈번합니다. 이 서버는 의도적으로 절충안을 택했습니다:

요구 사항

• Python 3.11+ 및 uv

• 게시 기능만: 무료 셀프 서비스 LinkedIn 개발자 앱(아래 5분 설정). 구직 검색과 트래커는 설정 없이 작동합니다.

설치 및 에이전트 연결

이 디렉토리를 복제/복사한 후 MCP 클라이언트에 등록하세요. 아래 <REPO>는 이 프로젝트의 절대 경로입니다.

Claude Code

claude mcp add linkedin \
  --env LINKEDIN_CLIENT_ID=your_client_id \
  --env LINKEDIN_CLIENT_SECRET=your_client_secret \
  -- uv run --directory <REPO> linkedin-safe-mcp

또는 프로젝트의 .mcp.json에:

{
  "mcpServers": {
    "linkedin": {
      "command": "uv",
      "args": ["run", "--directory", "<REPO>", "linkedin-safe-mcp"],
      "env": {
        "LINKEDIN_CLIENT_ID": "your_client_id",
        "LINKEDIN_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Codex (~/.codex/config.toml)

[mcp_servers.linkedin]
command = "uv"
args = ["run", "--directory", "<REPO>", "linkedin-safe-mcp"]
env = { LINKEDIN_CLIENT_ID = "your_client_id", LINKEDIN_CLIENT_SECRET = "your_client_secret" }

Claude Desktop (claude_desktop_config.json) — 위 .mcp.json과 동일한 JSON 형식입니다.

LINKEDIN_CLIENT_* 변수는 게시에만 필요합니다. 구직 검색 + 추적만 사용한다면 생략하세요.

게시 활성화(일회성 LinkedIn 앱 설정)

1. https://www.linkedin.com/developers/apps로 이동 → Create app(LinkedIn 페이지를 연결해야 하며, 간단한 페이지를 만들 수 있습니다).

2. 앱의 Products 탭에서 Share on LinkedIn 및 Sign In with LinkedIn using OpenID Connect를 추가합니다.

3. Auth 탭에서 리다이렉트 URL http://localhost:8765/callback을 추가합니다.

4. Client ID와 Client Secret을 위에 표시된 환경 변수에 복사합니다.

5. 한 번 인증합니다 — 두 가지 방법 모두 가능:

   • 터미널에서: uv run --directory <REPO> linkedin-safe-mcp auth

   • 또는 에이전트에게 게시를 요청하면 login 도구를 호출하여 인증 URL을 전달합니다.

토큰은 ~/.linkedin-mcp/tokens.json(모드 0600)에 저장되며 약 60일 동안 유효합니다. LinkedIn은 셀프 서비스 앱에 리프레시 토큰을 발급하지 않으므로 만료 시 로그인을 다시 실행해야 합니다(auth_status가 에이전트에게 정확한 시점을 알려줍니다).

도구

에이전트가 할 수 있는 일: "이번 주에 게시된 재택 시니어 엔지니어 역할을 찾아서, 유망한 공고를 저장하고, 저장된 설명에서 맞춤형 자기소개서를 작성하고, 지원한 공고를 표시하고, 내 오픈소스 작업 요약을 게시하세요."

구성

동작 참고 사항 및 제한

• 게시: LinkedIn은 회원 게시를 하루 150회 요청으로 제한하며, 최근 게시물의 정확한 중복을 거부합니다(422). 게시 텍스트의 예약 문자는 버전 API에서 자동으로 이스케이프되어 괄호로 인한 오류를 방지합니다. 해시태그는 유지됩니다.

• 구직 검색: 게스트 엔드포인트는 IP당 속도 제한(HTTP 429)이 있습니다. 서버는 결과를 캐시(검색 10분 / 공고 상세 6시간)하고, 백오프로 재시도하며, 다중 페이지 가져오기를 조절합니다. 지속적인 429가 발생하면 에이전트에게 "잠시 기다리세요"라는 명확한 오류를 반환합니다. limit를 적당히 유지하세요.

• 스크래핑 자세: 게스트 구직 검색은 로그아웃 방문자가 보는 것과 동일한 공개 페이지를 사람 수준의 속도로 읽고, 캐시로 부하를 최소화합니다. 그럼에도 LinkedIn은 언제든 이 엔드포인트를 변경하거나 차단할 수 있습니다 — 파서는 픽스처 테스트로 고정되어 있어 문제가 발생하면 크게 감지되고, 도구 오류는 에이전트가 조치할 수 있도록 유지됩니다.

개발

uv sync            # install deps (Python ≥3.11)
uv run pytest      # 48 tests: parsers vs live fixtures, payloads, OAuth, tracker,
                   # plus an end-to-end stdio smoke test that spawns the real server
uv run ruff check src tests && uv run ruff format --check src tests

구성: src/linkedin_mcp/ — server.py(도구 표면) · api/(공식 REST: 게시, 소셜 작업, 업로드, 이중 rest/ugc 백엔드) · auth/(OAuth + 토큰 저장소) · jobs/(게스트 클라이언트, HTML 파서, 필터 매핑) · tracker/(SQLite 저장소) · cli.py(serve | auth | status | logout).

로드맵

• PyPI에 게시(uvx linkedin-safe-mcp 원라이너)

• 좋아요 외 반응 유형; 다중 이미지 게시물; 설문 게시물

• 동일한 도구 스키마 뒤의 선택적 타사 구직 데이터 제공자

• 원격/호스팅 사용을 위한 streamable-http 전송

• (고려 중, 선택적, 기본 꺼짐) 개인화 기능을 위한 쿠키 기반 Voyager 제공자 — LinkedIn ToS를 위반하므로 경고를 크게 표시

라이선스

MIT