job-search-mcp

채용 플랫폼(잡코리아, 사람인)에서 회사명으로 채용공고를 검색하는 MCP 서버입니다.

[!NOTE] 원티드(Wanted)는 왜 없나요?<br/> 원티드는 CDN 레벨에서 자동화 접근을 차단하고 있으며, robots.txt 자체도 403으로 응답합니다.

기능

회사명을 입력하면 각 플랫폼에서 채용공고를 수집하여 다음 정보를 반환합니다:

항목	잡코리아	사람인
공고 제목	✅	✅
회사명	✅	✅
경력	✅	✅
학력	✅	✅
지역	△ (코드)	✅
마감일	✅	✅
공고 URL	✅	✅

MCP 도구

search_jobs

채용 플랫폼에서 회사명으로 채용공고를 검색합니다.

파라미터

파라미터	타입	필수	기본값	설명
company_name	string	✅	-	검색할 회사명
platform	string	-	"all"	검색할 플랫폼 (jobkorea, saramin, all)
page	number	-	1	페이지 번호

search_jobs_bulk

여러 회사의 채용공고를 한 번에 병렬로 검색합니다. search_jobs를 반복 호출하는 것보다 훨씬 빠릅니다.

내부적으로 동시성 제한(10개 배치)을 적용하여, 수십~수백 개 회사를 넘겨도 서버가 자동으로 분할 처리합니다. LLM이 여러 번 나눠 호출할 필요 없이 1회 호출로 전체 결과를 받을 수 있습니다.

결과는 임시 디렉토리에 텍스트 파일로 저장되며, 요약과 파일 경로만 반환합니다. LLM이 파일을 읽어 상세 내용을 확인하는 방식으로, 대량 결과에서도 컨텍스트 윈도우를 절약할 수 있습니다.

파라미터

파라미터	타입	필수	기본값	설명
company_names	string[]	✅	-	검색할 회사명 목록
platform	string	-	"all"	검색할 플랫폼 (jobkorea, saramin, all)

설치

# pnpm 없는 경우 "npm install -g pnpm"
pnpm install
pnpm build

사용법

npx로 실행 (권장)

Claude Code

claude mcp add job-search -- npx -y job-search-mcp

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "job-search": {
      "command": "npx",
      "args": ["-y", "job-search-mcp"]
    }
  }
}

로컬 빌드로 실행

Claude Code

claude mcp add job-search -- node /path/to/job-search-mcp/dist/index.js

Claude Desktop

{
  "mcpServers": {
    "job-search": {
      "command": "node",
      "args": ["/path/to/job-search-mcp/dist/index.js"]
    }
  }
}

질문 예시

당근마켓 채용공고 검색해줘

사람인에서 네이버 채용공고 찾아줘

일괄 검색 예시

여러 회사의 채용공고를 한 번에 검색할 때 유용합니다. search_jobs를 반복 호출하는 것보다 빠릅니다.

네이버, 카카오, 라인플러스, 당근마켓, 토스 채용공고를 한 번에 검색해줘.

대량 검색 성능 테스트 (100개사)

아래 프롬프트를 그대로 붙여넣어 search_jobs_bulk의 대량 처리 성능을 테스트할 수 있습니다.

다음 100개 회사의 채용공고를 한 번에 검색해줘:
삼성전자, SK하이닉스, LG전자, 현대자동차, 기아, 네이버, 카카오, 쿠팡, 배달의민족, 토스,
당근마켓, 라인플러스, 삼성SDS, LG CNS, SK텔레콤, KT, 현대모비스, 포스코, 한화솔루션, CJ대한통운,
셀트리온, 크래프톤, 넥슨코리아, 엔씨소프트, 넷마블, 스마일게이트, 카카오게임즈, 펄어비스, 컴투스, 데브시스터즈,
야놀자, 직방, 리디, 무신사, 마켓컬리, 오늘의집, 토스증권, 카카오뱅크, 케이뱅크, 비바리퍼블리카,
한글과컴퓨터, 더존비즈온, 안랩, 이스트소프트, 카카오엔터프라이즈, 네이버클라우드, NHN, 우아한형제들, 두나무, 하이브,
롯데정보통신, 신한은행, 하나은행, KB국민은행, 우리은행, 현대카드, 삼성생명, 교보생명, 한화생명, 미래에셋증권,
SK플래닛, 11번가, 위메프, 티몬, SSG닷컴, GS리테일, BGF리테일, 올리브영, 아모레퍼시픽, LG생활건강,
현대건설, 대우건설, GS건설, 삼성물산, SK에코플랜트, 한화건설, 롯데건설, 포스코건설, DL이앤씨, HDC현대산업개발,
CJ ENM, 스튜디오드래곤, 카카오엔터테인먼트, SM엔터테인먼트, JYP엔터테인먼트, YG엔터테인먼트, 넷플릭스코리아, 쿠팡플레이, 왓챠, 티빙,
LG이노텍, 삼성전기, SK실트론, DB하이텍, 한미반도체, 리노공업, 원익IPS, 주성엔지니어링, 코미코, 솔브레인

아키텍처

<img src="img/job_search_mcp_architecture.svg" />

• 동시성 제어: search_jobs_bulk는 10개씩 배치로 병렬 요청
• 결과 저장: 대량 검색 결과는 임시 파일(%TEMP%/job-search-mcp/)로 저장하여 컨텍스트 절약
• 타임아웃: 각 HTTP 요청에 15초 AbortSignal.timeout 적용

제한사항

• 웹 스크래핑 기반이므로, 잡코리아/사람인의 HTML 구조 변경 시 파싱이 실패할 수 있습니다.
• 짧은 시간에 너무 많은 요청을 보내면 플랫폼 측에서 일시적으로 접근을 차단(rate limit)할 수 있습니다.
• 각 요청에는 15초 타임아웃이 적용되어 있으며, 시간 초과 시 해당 요청은 실패 처리되고 나머지 결과는 정상 반환됩니다.

성능 개선 기록

테스트 환경 :

• 모델 : Claude Opus 4.6 (1M)
• 장비 : Raspberry pi 4 Model B 8GB RAM
• 네트워크 : CAT 5E UTP

버전	기업(건)	공고(개)	소요 시간(MCP)	소요 시간(총합)	비고
v0.0.5	100	5,002	maximum allowed tokens	3m 18s	단순 토큰 출력 방식
v0.0.6	100	5,002	125.7s	2m 49s	동시성 제한(10 batch)<br/>파일 저장 방식

트러블슈팅

Raspberry Pi 등 저사양 환경에서 MCP 실행이 극도로 느린 경우

현상

search_jobs_bulk로 대량 검색 시, 로컬 PC에서는 수십 초면 끝나는 작업이 수십 분 이상 걸리거나 응답이 오지 않습니다.

원인

npx -y job-search-mcp 방식은 매 실행마다 npm registry에서 최신 버전을 확인합니다. Raspberry Pi처럼 네트워크가 느린 환경에서는 이 registry 통신이 병목이 되어, 실제 검색이 시작되기 전에 수 분 이상 지연될 수 있습니다.

# ss -tnp로 확인하면 npm registry(104.16.x.x)에 연결된 상태로 멈춰있음
ESTAB  0  0  192.168.x.x:41824  104.16.3.34:443  users:(("npm exec job-se",...))

해결

글로벌 설치로 전환하면 매번 registry를 확인하지 않고 바로 실행됩니다.

# 글로벌 설치
npm install -g job-search-mcp

# Claude Code MCP 설정 변경
claude mcp remove job-search
claude mcp add job-search -- job-search-mcp

License

MIT License. See LICENSE for details.