채용 빅데이터 서비스

이 MCP 서비스는 기업 키워드 검색, 채용 공고 검색, 고용주 채용 프로필, 인재 수요, 직무 보수 및 채용 트렌드 분석 기능을 제공하여 사용자가 인재 시장 조사, 고용주 분석 및 채용 결정을 수행할 수 있도록 돕습니다.

주요 기능

• 🏢 기업 약칭 및 키워드 검색

• 🔍 기업 채용 공고 검색

• 🏢 고용주 채용 프로필 분석

• 👥 기업 인재 수요 분석

• 💰 채용 공고 보수 조회

• 📈 기업 채용 트렌드 개요

Related MCP server: PayHub MCP Server

서비스 설계 설명

• 서비스는 실제 업무 시나리오에 따라 6개의 Tool을 제공하며, 상위 API 수에 따라 도구를 나열하지 않습니다.

• 사용자가 기업 약칭만 제공하는 경우 먼저 recruitment_enterprise_search를 사용하여 기업 전체 이름 또는 안정적인 ID를 얻습니다.

• 채용 상세와 채용 통계 두 Product ID는 서로 다른 시나리오의 Tool에서 재사용됩니다.

• recruitment_demand_analysis는 view를 통해 상세 또는 통계를 선택하며, 한 번에 하나의 Product ID만 접근합니다.

• 페이지네이션 결과의 비즈니스 외부 레이어는 total과 resultList만 포함하며, pageSize 최대값은 50입니다.

• 프로필 및 통계의 긴 목록은 listLimit으로 제한되며, 기본값은 50, 최대값은 200입니다.

• recruitment_trend는 채용 수, 최근 3개월 통계, 업데이트 빈도 및 평균 급여만 반환하여 프로필 긴 목록을 중복 반환하지 않습니다.

환경 요구 사항

• Python 3.10+

• 의존 패키지: python-dotenv, requests, mcp

로컬 빠른 시작

1. 프로젝트 디렉터리로 이동

cd recruitment-mcp-server

2. 가상 환경 생성 및 의존성 설치

python3 -m venv mcp_env
source mcp_env/bin/activate
pip install -r requirements.txt

3. 환경 변수 구성

환경 변수 템플릿 복사:

cp .env.example .env

.env 파일 편집:

INTEGRATOR_ID=your_integrator_id
SECRET_ID=your_secret_id
SECRET_KEY=your_secret_key
HANDAAS_REQUEST_TIMEOUT=30

HANDAAS_REQUEST_TIMEOUT는 선택적 구성이며, 단위는 초이고 기본값은 30입니다.

4. Streamable HTTP 서비스 시작

python server/mcp_server.py streamable-http

서비스 기본 주소는 http://localhost:8000/mcp입니다.

시작 스크립트를 사용할 수도 있습니다:

./start_mcp_server.sh streamable-http

stdio, sse, streamable-http 세 가지 시작 방식을 지원합니다.

5. Cursor / Cherry Studio MCP 구성

{
  "mcpServers": {
    "recruitment-mcp-server": {
      "type": "streamableHttp",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

STDIO 버전 설치 및 배포

{workdir}를 recruitment-mcp-server의 절대 경로로 바꾸세요:

{
  "mcpServers": {
    "recruitment-mcp-server": {
      "command": "{workdir}/mcp_env/bin/python",
      "args": [
        "{workdir}/server/mcp_server.py",
        "stdio"
      ]
    }
  }
}

INTEGRATOR_ID, SECRET_ID, SECRET_KEY는 HandaaS에 로그인하여 회원가입 및 커넥터를 개통한 후에 얻을 수 있습니다. 실제 자격 증명은 로컬 .env 또는 배포 키에만 저장해야 합니다.

사용 가능한 도구 및 Product ID

1. recruitment_enterprise_search

기능: 기업 약칭, 브랜드, 제품 또는 기타 키워드로 후보 기업을 검색합니다.

주요 매개변수: matchKeyword 필수; pageIndex 기본값 1; pageSize 기본값 10, 최대 50.

반환: 후보 기업 total/resultList. 후보를 확인한 후 기업 전체 이름, 기업 ID 또는 통합 사회 신용 코드를 채용 Tool에 전달합니다.

2. recruitment_job_search

기능: 지정된 기업의 채용 공고 상세를 조회합니다.

주요 매개변수:

• matchKeyword(필수): 기업 이름, 기업 ID, 등록 번호 또는 통합 사회 신용 코드.

• keywordType(선택): 기업 식별 유형, name, nameId, regNumber, socialCreditCode를 지원합니다.

• pageIndex(선택): 페이지 번호, 1부터 시작.

• pageSize(선택): 페이지당 수량, 기본값 50, 최대 50.

반환: total 및 resultList; 공고 상세에는 직무 이름, 도시, 학력, 보수, 근무 연수, 게시 시간 및 근무 주소 등의 필드가 포함될 수 있습니다.

3. recruitment_employer_profile

기능: 복리후생, 채용 도시, 직무 키워드 및 평균 급여를 포함한 기업 채용 프로필을 조회합니다.

주요 매개변수:

• matchKeyword(필수): 기업 이름, 기업 ID, 등록 번호 또는 통합 사회 신용 코드.

• keywordType(선택): 기업 식별 유형.

• listLimit(선택): 프로필 목록 필드에서 최대 반환 항목 수, 기본값 50, 최대 200.

반환: 기업 채용 통계 및 프로필; 목록이 잘린 경우 truncatedFields를 반환합니다.

4. recruitment_demand_analysis

기능: 기업 인재 수요를 분석하며, 직무 상세 또는 기업 통계 뷰를 선택할 수 있습니다.

주요 매개변수:

• matchKeyword(필수): 기업 식별자.

• view(선택): details 직무 상세; statistics 기업 통계. 기본값 statistics.

• keywordType(선택): 기업 식별 유형.

• pageIndex, pageSize(선택): details 뷰에서만 사용, pageSize 최대 50.

• listLimit(선택): statistics 뷰에서만 사용, 기본값 50, 최대 200.

반환: 상세 뷰는 total 및 resultList를 반환하고, 통계 뷰는 기업 채용 프로필 및 통계 필드를 반환합니다.

5. recruitment_salary

기능: 기업 채용 공고의 보수 범위를 조회하여 직무 및 인재 시장 보수 비교에 사용합니다.

주요 매개변수:

• matchKeyword(필수): 기업 이름, 기업 ID, 등록 번호 또는 통합 사회 신용 코드.

• keywordType(선택): 기업 식별 유형.

• pageIndex(선택): 페이지 번호, 1부터 시작.

• pageSize(선택): 페이지당 수량, 기본값 50, 최대 50.

반환: total 및 resultList; workingSalary에는 통화, 최저 보수 및 최고 보수가 포함될 수 있습니다.

6. recruitment_trend

기능: 기업 채용 트렌드 개요를 조회하며, 월별 시계열은 반환하지 않습니다.

주요 매개변수:

• matchKeyword(필수): 기업 이름, 기업 ID, 등록 번호 또는 통합 사회 신용 코드.

• keywordType(선택): 기업 식별 유형.

반환:

• recruitingCurrentCount: 현재 채용 인원.

• recruitingLastThreeMonthCount: 최근 3개월 채용 인원.

• recruitingLastThreeMonthNo: 최근 3개월 채용 공고 수.

• recruitingAvgUpdate: 공고 평균 업데이트 빈도.

• recruitingAvgWorkingSalary: 평균 채용 급여.

사용 시나리오

1. 기업 식별: 약칭 또는 브랜드 키워드를 통해 기업 전체 이름과 안정적인 식별자를 확인합니다.

2. 인재 수요 연구: 대상 기업이 현재 채용 중인 직무와 인재 방향을 확인합니다.

3. 고용주 분석: 기업의 채용 도시, 복리후생, 직무 키워드 및 채용 활동성을 파악합니다.

4. 보수 비교: 서로 다른 기업 또는 직무의 보수 범위를 비교합니다.

5. 채용 트렌드 판단: 현재 및 최근 3개월 채용 규모와 평균 업데이트 빈도를 분석합니다.

6. 경쟁 정보: 채용 수요 변화를 통해 기업의 사업 확장 방향을 판단합니다.

사용 시 주의사항

1. 약칭 처리: 기업 약칭으로 직접 조회할 수 없는 경우 먼저 recruitment_enterprise_search를 호출합니다.

2. 기업 식별자: 후보를 확인한 후 기업 ID 또는 통합 사회 신용 코드를 사용하는 것이 좋습니다.

3. 페이지네이션 제한: pageIndex는 1부터 시작하며, pageSize는 1에서 50 사이여야 합니다.

4. 목록 제한: listLimit은 1에서 200 사이여야 합니다.

5. 뷰 선택: 직무 레코드가 필요하면 view=details를 사용하고, 요약 프로필이 필요하면 view=statistics를 사용합니다.

6. 트렌드 기준: recruitment_trend는 현재 및 최근 3개월 개요이며, 월별 시계열이 아닙니다.

사용 질문 예시

recruitment_enterprise_search（기업 키워드 검색）

1. “小米”는 어느 기업에 해당하나요?

2. “京东”를 통해 정확한 기업 이름과 기업 ID를 찾아주세요.

recruitment_job_search（채용 공고 검색）

1. 小米科技有限责任公司는 현재 어떤 직무를 채용 중인가요?

2. 北京京东世纪贸易有限公司의 최근 채용 공고를 조회해 주세요.

recruitment_employer_profile（고용주 채용 프로필）

1. 小米科技有限责任公司의 채용 도시, 복리후생 및 직무 프로필을 분석해 주세요.

2. 珠海格力电器股份有限公司의 평균 채용 급여는 어떤가요?

recruitment_demand_analysis（채용 수요 분석）

1. 특정 기업의 인재 수요 구조를 요약해 주세요.

2. 대상 기업의 구체적인 직무 수요를 나열해 주세요.

recruitment_salary（직무 보수 조회）

1. 小米科技有限责任公司 채용 공고의 보수 범위를 확인해 주세요.

2. 珠海格力电器股份有限公司의 직무 급여 수준은 어떤가요?

recruitment_trend（채용 트렌드 개요）

1. 小米科技有限责任公司의 현재 채용 열기와 최근 3개월 트렌드는 어떤가요?

2. 京东의 최근 채용 인원, 공고 수 및 평균 급여를 조회해 주세요.

테스트 검증

python -m py_compile server/mcp_server.py
python -m unittest discover -s tests -v

단위 테스트는 Mock HTTP 응답을 사용하며 실제 HandaaS 채용 API를 호출하지 않습니다.