{
"markdown": "# job-search-mcp\r\n\r\n[](LICENSE)\r\n[](https://www.npmjs.com/package/job-search-mcp)\r\n[](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.PJW2004%2Fjob-search/versions/0.0.6)\r\n\r\n채용 플랫폼(잡코리아, 사람인)에서 회사명으로 채용공고를 검색하는 MCP 서버입니다.\r\n\r\n> [!NOTE] \r\n> 원티드(Wanted)는 왜 없나요?
\r\n> 원티드는 CDN 레벨에서 자동화 접근을 차단하고 있으며, robots.txt 자체도 403으로 응답합니다.\r\n\r\n## 기능\r\n\r\n회사명을 입력하면 각 플랫폼에서 채용공고를 수집하여 다음 정보를 반환합니다:\r\n\r\n| 항목 | 잡코리아 | 사람인 |\r\n|------|----------|--------|\r\n| 공고 제목 | ✅ | ✅ |\r\n| 회사명 | ✅ | ✅ |\r\n| 경력 | ✅ | ✅ |\r\n| 학력 | ✅ | ✅ |\r\n| 지역 | △ (코드) | ✅ |\r\n| 마감일 | ✅ | ✅ |\r\n| 공고 URL | ✅ | ✅ |\r\n\r\n## MCP 도구\r\n\r\n### `search_jobs`\r\n\r\n채용 플랫폼에서 회사명으로 채용공고를 검색합니다.\r\n\r\n#### 파라미터\r\n\r\n| 파라미터 | 타입 | 필수 | 기본값 | 설명 |\r\n|----------|------|------|--------|------|\r\n| `company_name` | string | ✅ | - | 검색할 회사명 |\r\n| `platform` | string | - | `\"all\"` | 검색할 플랫폼 (`jobkorea`, `saramin`, `all`) |\r\n| `page` | number | - | `1` | 페이지 번호 |\r\n\r\n### `search_jobs_bulk`\r\n\r\n여러 회사의 채용공고를 한 번에 병렬로 검색합니다. `search_jobs`를 반복 호출하는 것보다 훨씬 빠릅니다.\r\n\r\n내부적으로 동시성 제한(10개 배치)을 적용하여, 수십~수백 개 회사를 넘겨도 서버가 자동으로 분할 처리합니다. LLM이 여러 번 나눠 호출할 필요 없이 1회 호출로 전체 결과를 받을 수 있습니다.\r\n\r\n결과는 임시 디렉토리에 텍스트 파일로 저장되며, 요약과 파일 경로만 반환합니다. LLM이 파일을 읽어 상세 내용을 확인하는 방식으로, 대량 결과에서도 컨텍스트 윈도우를 절약할 수 있습니다.\r\n\r\n#### 파라미터\r\n\r\n| 파라미터 | 타입 | 필수 | 기본값 | 설명 |\r\n|----------|------|------|--------|------|\r\n| `company_names` | string[] | ✅ | - | 검색할 회사명 목록 |\r\n| `platform` | string | - | `\"all\"` | 검색할 플랫폼 (`jobkorea`, `saramin`, `all`) |\r\n\r\n## 설치\r\n\r\n```bash\r\n# pnpm 없는 경우 \"npm install -g pnpm\"\r\npnpm install\r\npnpm build\r\n```\r\n\r\n## 사용법\r\n\r\n### npx로 실행 (권장)\r\n\r\n#### Claude Code\r\n\r\n```bash\r\nclaude mcp add job-search -- npx -y job-search-mcp\r\n```\r\n\r\n#### Claude Desktop\r\n\r\n`claude_desktop_config.json`에 추가:\r\n\r\n```json\r\n{\r\n \"mcpServers\": {\r\n \"job-search\": {\r\n \"command\": \"npx\",\r\n \"args\": [\"-y\", \"job-search-mcp\"]\r\n }\r\n }\r\n}\r\n```\r\n\r\n### 로컬 빌드로 실행\r\n\r\n#### Claude Code\r\n\r\n```bash\r\nclaude mcp add job-search -- node /path/to/job-search-mcp/dist/index.js\r\n```\r\n\r\n#### Claude Desktop\r\n\r\n```json\r\n{\r\n \"mcpServers\": {\r\n \"job-search\": {\r\n \"command\": \"node\",\r\n \"args\": [\"/path/to/job-search-mcp/dist/index.js\"]\r\n }\r\n }\r\n}\r\n```\r\n\r\n### 질문 예시\r\n\r\n```\r\n당근마켓 채용공고 검색해줘\r\n```\r\n```\r\n사람인에서 네이버 채용공고 찾아줘\r\n```\r\n\r\n### 일괄 검색 예시\r\n\r\n여러 회사의 채용공고를 한 번에 검색할 때 유용합니다. `search_jobs`를 반복 호출하는 것보다 빠릅니다.\r\n\r\n```\r\n네이버, 카카오, 라인플러스, 당근마켓, 토스 채용공고를 한 번에 검색해줘.\r\n```\r\n\r\n### 대량 검색 성능 테스트 (100개사)\r\n\r\n아래 프롬프트를 그대로 붙여넣어 `search_jobs_bulk`의 대량 처리 성능을 테스트할 수 있습니다.\r\n\r\n```\r\n다음 100개 회사의 채용공고를 한 번에 검색해줘:\r\n삼성전자, SK하이닉스, LG전자, 현대자동차, 기아, 네이버, 카카오, 쿠팡, 배달의민족, 토스,\r\n당근마켓, 라인플러스, 삼성SDS, LG CNS, SK텔레콤, KT, 현대모비스, 포스코, 한화솔루션, CJ대한통운,\r\n셀트리온, 크래프톤, 넥슨코리아, 엔씨소프트, 넷마블, 스마일게이트, 카카오게임즈, 펄어비스, 컴투스, 데브시스터즈,\r\n야놀자, 직방, 리디, 무신사, 마켓컬리, 오늘의집, 토스증권, 카카오뱅크, 케이뱅크, 비바리퍼블리카,\r\n한글과컴퓨터, 더존비즈온, 안랩, 이스트소프트, 카카오엔터프라이즈, 네이버클라우드, NHN, 우아한형제들, 두나무, 하이브,\r\n롯데정보통신, 신한은행, 하나은행, KB국민은행, 우리은행, 현대카드, 삼성생명, 교보생명, 한화생명, 미래에셋증권,\r\nSK플래닛, 11번가, 위메프, 티몬, SSG닷컴, GS리테일, BGF리테일, 올리브영, 아모레퍼시픽, LG생활건강,\r\n현대건설, 대우건설, GS건설, 삼성물산, SK에코플랜트, 한화건설, 롯데건설, 포스코건설, DL이앤씨, HDC현대산업개발,\r\nCJ ENM, 스튜디오드래곤, 카카오엔터테인먼트, SM엔터테인먼트, JYP엔터테인먼트, YG엔터테인먼트, 넷플릭스코리아, 쿠팡플레이, 왓챠, 티빙,\r\nLG이노텍, 삼성전기, SK실트론, DB하이텍, 한미반도체, 리노공업, 원익IPS, 주성엔지니어링, 코미코, 솔브레인\r\n```\r\n\r\n## 아키텍처\r\n\r\n![](\"img/job_search_mcp_architecture.svg\")
\r\n\r\n- **동시성 제어**: `search_jobs_bulk`는 10개씩 배치로 병렬 요청\r\n- **결과 저장**: 대량 검색 결과는 임시 파일(`%TEMP%/job-search-mcp/`)로 저장하여 컨텍스트 절약\r\n- **타임아웃**: 각 HTTP 요청에 15초 `AbortSignal.timeout` 적용\r\n\r\n## 제한사항\r\n\r\n- 웹 스크래핑 기반이므로, 잡코리아/사람인의 HTML 구조 변경 시 파싱이 실패할 수 있습니다.\r\n- 짧은 시간에 너무 많은 요청을 보내면 플랫폼 측에서 일시적으로 접근을 차단(rate limit)할 수 있습니다.\r\n- 각 요청에는 15초 타임아웃이 적용되어 있으며, 시간 초과 시 해당 요청은 실패 처리되고 나머지 결과는 정상 반환됩니다.\r\n\r\n## 성능 개선 기록\r\n\r\n테스트 환경 : \r\n- 모델 : `Claude Opus 4.6 (1M)`\r\n- 장비 : `Raspberry pi 4 Model B 8GB RAM`\r\n- 네트워크 : `CAT 5E UTP`\r\n\r\n| 버전 | 기업(건) | 공고(개) | 소요 시간(MCP) | 소요 시간(총합) | 비고 |\r\n|--|--|--|--|--|--|\r\n| `v0.0.5` | 100 | 5,002 | `maximum allowed tokens` | 3m 18s | 단순 토큰 출력 방식 |\r\n| `v0.0.6` | 100 | 5,002 | 125.7s | 2m 49s | 동시성 제한(10 batch)
파일 저장 방식 |\r\n\r\n## 트러블슈팅\r\n\r\n### Raspberry Pi 등 저사양 환경에서 MCP 실행이 극도로 느린 경우\r\n\r\n**현상**\r\n\r\n`search_jobs_bulk`로 대량 검색 시, 로컬 PC에서는 수십 초면 끝나는 작업이 수십 분 이상 걸리거나 응답이 오지 않습니다.\r\n\r\n**원인**\r\n\r\n`npx -y job-search-mcp` 방식은 매 실행마다 npm registry에서 최신 버전을 확인합니다. Raspberry Pi처럼 네트워크가 느린 환경에서는 이 registry 통신이 병목이 되어, 실제 검색이 시작되기 전에 수 분 이상 지연될 수 있습니다.\r\n\r\n```bash\r\n# ss -tnp로 확인하면 npm registry(104.16.x.x)에 연결된 상태로 멈춰있음\r\nESTAB 0 0 192.168.x.x:41824 104.16.3.34:443 users:((\"npm exec job-se\",...))\r\n```\r\n\r\n**해결**\r\n\r\n글로벌 설치로 전환하면 매번 registry를 확인하지 않고 바로 실행됩니다.\r\n\r\n```bash\r\n# 글로벌 설치\r\nnpm install -g job-search-mcp\r\n\r\n# Claude Code MCP 설정 변경\r\nclaude mcp remove job-search\r\nclaude mcp add job-search -- job-search-mcp\r\n```\r\n\r\n## License\r\n\r\nMIT License. See [LICENSE](LICENSE) for details.",
"bytes": 4919,
"sha": "ff9e0c4c402ed66946b5d389ffc5842fd01eeff18291f5b7c57f0be8c81fb99d",
"repo_slug": "pjw2004/career-mcp",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_pjw2004_job_search_7df14dfe/readme"
}