mcp-jobs

🚀 제로 구성 멀티 플랫폼 채용 정보 통합 서비스! MCP 아키텍처 기반으로 주요 채용 사이트에서 채용 정보를 가져올 수 있으며, 설치 즉시 사용 가능, 별도 설정 불필요.

⚡ 30초 빠른 시작

🚀 1단계: 서비스 시작 (제로 구성)

# 一行命令，立即启动
npx -y mcp-jobs

🤖 2단계: AI 클라이언트 설정

AI 클라이언트(예: Cursor, Claude Desktop)에 다음을 추가하세요:

• 서비스 이름: mcp-jobs

• 명령어: npx -y mcp-jobs

• 환경 변수: 비워 둠

💬 3단계: 사용 시작

AI 어시스턴트에게 직접 말하세요: "베이징의 프론트엔드 개발 직무를 검색해줘"

이것으로 끝입니다! 🎉 회원가입 불필요, API Key 불필요, 설정 파일 불필요.

Related MCP server: JobSpy MCP Server

🌟 핵심 기능

• 🔓 제로 진입 장벽: API Key 불필요, 회원가입 불필요, 설정 불필요

• 📦 설치 즉시 사용: 한 줄 명령어로 전체 서비스 시작

• 🔍 스마트 검색: 직무명, 도시, 급여 범위 등 조건으로 필터링 지원

• 🌐 멀티 플랫폼 통합: 여러 주요 채용 사이트에서 자동으로 데이터 수집

• 📊 표준화된 출력: 통일된 데이터 형식으로 대규모 언어 모델 처리에 용이

• ⚡ 실시간 업데이트: 채용 정보의 최신성 보장

• 🔧 선택적 확장: API Key로 추가 기능 잠금 해제 지원 (완전 선택 사항)

📦 설치 방법

🚀 즉시 실행 (권장)

설치 불필요, 설정 불필요, 바로 사용:

# 一行命令，立即启动
npx -y mcp-jobs

🔧 전역 설치 (선택 사항)

자주 사용해야 하는 경우:

# 全局安装
npm install -g mcp-jobs

# 直接运行
mcp-jobs

📁 프로젝트 내 설치 (선택 사항)

# 安装到项目依赖中
npm install mcp-jobs
# 或使用 yarn
yarn add mcp-jobs
# 或使用 pnpm
pnpm add mcp-jobs

🎯 사용 방법

🚀 기본 사용 (제로 구성)

별도 설정 없이 바로 시작:

# 启动服务
npx -y mcp-jobs

# 服务将自动提供以下功能：
# ✅ 职位搜索
# ✅ 职位详情获取
# ✅ 多平台数据聚合
# ✅ 标准化数据输出

이것으로 끝입니다!

🔧 고급 설정 (완전 선택 사항)

추가 기능이 필요하다면 다음 매개변수를 선택적으로 구성할 수 있습니다:

# 可选：复制配置模板
cp .env.example .env

# 可选：编辑配置文件，取消注释您需要的功能
# USERNAME=your_username            # 可选：基础认证
# PASSWORD=your_password            # 可选：基础认证

# 可选：爬虫配置
# CRAWLER_HEADLESS=true             # 可选：无头模式 (调试时可设为 false)
# CRAWLER_TIMEOUT=30000             # 可选：页面超时时间 (毫秒)
# CRAWLER_VIEWPORT_WIDTH=1280       # 可选：浏览器视窗宽度
# CRAWLER_VIEWPORT_HEIGHT=800       # 可选：浏览器视窗高度
# CRAWLER_DEBUG=false               # 可选：调试模式

선택적 구성 설명

💡 중요 안내: 모든 구성은 완전 선택 사항입니다. 서비스는 어떤 구성 없이도 완전한 핵심 기능을 제공합니다.

🤖 AI 클라이언트 설정

🚀 Cursor 설정 (제로 구성)

최소 구성 (권장)

1. Cursor 설정 열기

2. Features > MCP Servers로 이동

3. "+ Add New MCP Server" 클릭

4. 다음 정보 입력:

   • Name: mcp-jobs

   • Type: command

   • Command: npx -y mcp-jobs

JSON 구성 방식

기본 구성 (설치 즉시 사용):

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

고급 구성 (선택적 확장):

{
  "mcpServers": {
    "mcp-jobs": {
      "command": "npx",
      "args": ["-y", "mcp-jobs"],
      "env": {
        "USERNAME": "your-username",
        "PASSWORD": "your-password"
      }
    }
  }
}

💡 팁: 기본 구성을 권장하며, 완전한 채용 검색 기능을 제공합니다!

🤖 Claude Desktop 설정

제로 구성 설정:

1. Claude Desktop 열기

2. 왼쪽 하단 Settings 아이콘 클릭

3. "MCP Servers" 옵션 선택

4. "Add New Server" 클릭

5. 다음 정보 입력:

   • Name: mcp-jobs

   • Type: command

   • Command: npx -y mcp-jobs

   • Environment Variables: 비워 둠 (변수 불필요)

이것으로 끝입니다! API Key 불필요, 즉시 사용 가능.

🚀 Windsurf 설정

기본 구성 (제로 설정):

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

🚀 Cline 설정

기본 구성 (제로 설정):

mcp:
  servers:
    mcp-jobs:
      command: npx
      args: ["-y", "mcp-jobs"]

🔧 고급 설정 (완전 선택 사항)

⚠️ 중요 안내: 아래 모든 구성은 완전 선택 사항입니다! 서비스는 어떤 구성 없이도 완전한 기능을 제공합니다.

서비스 동작을 사용자 정의해야 하는 경우 다음 환경 변수를 선택적으로 구성할 수 있습니다:

# 可选：MCP API 密钥（用于解锁高级功能）
# 可选：基础认证
# USERNAME=your-username
# PASSWORD=your-password

# 可选：自定义 MCP 服务地址

💡 다시 한번 안내: 어떤 구성 없이도 완전한 채용 검색 기능을 사용할 수 있습니다!

🎯 지금 바로 사용 시작

설정 완료 후(한 줄 명령어만으로!), 자연어로 AI 어시스턴트에게 채용 검색 요구사항을 설명할 수 있습니다:

💬 사용 예시

직접 채용 검색:

• "상하이 지역의 프론트엔드 개발 엔지니어 직무를 검색해줘"

• "베이징의 데이터 분석가 포지션을 찾아줘, 3년 이상 경력 요구"

• "항저우 지역에서 급여가 가장 높은 프로덕트 매니저 직무를 찾아줘"

채용 상세 정보 확인:

• "이 직무의 상세 정보를 가져와줘: [직무 링크]"

• "이 포지션의 요구사항과 급여 상황을 분석해줘"

스마트 분석:

• "다른 도시의 유사 직무 급여 수준을 비교해줘"

• "현재 시장에서 인기 있는 기술 요구사항을 정리해줘"

🚀 제로 진입 장벽 체험: 복잡한 API 호출을 배울 필요 없이, 자연어만으로 전문적인 채용 검색 서비스를 이용할 수 있습니다!

대규모 언어 모델이 자동으로 mcp-jobs 서비스를 호출하여 관련 정보를 가져오고 결과를 표시합니다.

🔧 디버깅 및 개발

🐛 디버그 모드

크롤러 동작을 디버깅하거나 새 기능을 개발해야 하는 경우 디버그 모드를 활성화할 수 있습니다:

# 启用可视化浏览器窗口（非无头模式）
CRAWLER_HEADLESS=false npx -y mcp-jobs

# 启用调试日志
CRAWLER_DEBUG=true npx -y mcp-jobs

# 组合使用
CRAWLER_HEADLESS=false CRAWLER_DEBUG=true npx -y mcp-jobs

⚙️ 사용자 정의 브라우저 구성

# 自定义视窗大小
CRAWLER_VIEWPORT_WIDTH=1920 CRAWLER_VIEWPORT_HEIGHT=1080 npx -y mcp-jobs

# 增加超时时间（适用于慢速网络）
CRAWLER_TIMEOUT=60000 npx -y mcp-jobs

# 自定义用户代理
CRAWLER_USER_AGENT="Custom Bot 1.0" npx -y mcp-jobs

📝 구성 우선순위

구성의 우선순위는 높은 순에서 낮은 순입니다:

1. 사이트별 구성 - crawlerConfig.ts에서 특정 웹사이트에 설정된 browserConfig

2. 환경 변수 - CRAWLER_* 환경 변수로 설정

3. 기본 구성 - 시스템 기본값

🌟 왜 MCP Jobs를 선택해야 하나요?

✅ 진정한 제로 진입 장벽

• 🚫 회원가입 불필요 - 개인 정보를 입력할 필요 없음

• 🚫 복잡한 설정 불필요 - 한 줄 명령어로 시작

• 🚫 문서 학습 불필요 - 자연어로 바로 상호작용

⚡ 즉시 사용 가능

• 📦 설치 즉시 사용, 준비 작업 불필요

• 🔍 완전한 채용 검색 기능

• 🌐 멀티 플랫폼 데이터 통합

• 📊 표준화된 데이터 출력

🛡️ 안정적이고 신뢰할 수 있음

• 🔄 자동 재시도 메커니즘

• ⚠️ 우아한 오류 처리

• 📈 실시간 데이터 업데이트

• 🔧 선택적 고급 기능

📋 사용 시 유의사항

1. 완전 무료 - 핵심 기능은 어떠한 비용도 없음

2. 규정 준수 - 각 채용 플랫폼의 이용 약관을 준수하세요

3. 합리적 사용 - 요청 빈도를 조절하여 과도한 접근을 피하세요

4. 시스템 요구사항 - Node.js >= 16.0.0

오픈소스 라이선스

MIT License

도움 받기

사용 중 문제가 발생하면 다음 방법으로 도움을 받을 수 있습니다:

• GitHub Issue 제출