boss-cli-mcp

joohw/boss-cli를 기반으로 확장한 Boss 直聘 자동화 CLI 및 MCP 서비스입니다.

이 프로젝트는 Puppeteer/CDP를 통해 로컬 Chrome을 구동하고 로컬 로그인 상태를 재사용하여, Claude Desktop, Cursor, Zcode 등 MCP를 지원하는 AI 클라이언트에 후보자 조회, 채팅, 메시지 전송, 일괄 답장, 추천 검색 및 채용 공고 관리 기능을 제공합니다.

본 프로젝트는 Boss 계정에 대해 실제 작업을 수행합니다. 메시지 전송, 인사 보내기, 이력서 열람, 심층 매칭 전에 후보자와 파라미터를 확인하고 플랫폼 규칙을 준수하세요.

기능

• 전체 또는 읽지 않은 후보자 목록 조회

• 이름 또는 목록 순번으로 채팅 열기

• 단일 메시지 전송

• 후보자에게 비동기 일괄 답장 보내기

• 일괄 전송 진행 상황 및 개인별 결과 조회

• 이력서 확인, 메모, 부적합 처리, 微信 교환 등 채팅 작업

• 추천 후보자 및 일반 검색 결과 조회

• 심층 검색 및 매칭

• 온라인 이력서 미리보기

• 채용 공고 목록 및 채용 공고 상세 조회

• CLI 및 stdio MCP 두 가지 호출 방식

Related MCP server: Chrome MCP Server

환경 요구 사항

• Node.js 20 이상

• 로컬에 Chrome 또는 Chromium 설치

• Windows, macOS 또는 Linux

• Boss 直聘 기업 계정에 로그인할 수 있는 계정

설치

이 저장소에서 MCP 실행

git clone https://github.com/bmbbms/boss-cli-mcp.git D:\boss-cli
cd D:\boss-cli
npm install
npm run build

빌드 후의 MCP 진입점:

D:\boss-cli\dist\mcp\index.js

수동으로 시작 테스트:

& "D:\nodejs\node.exe" "D:\boss-cli\dist\mcp\index.js"

MCP는 stdio로 통신하므로, 시작 후 터미널에 일반적인 출력이 없는 것은 정상입니다. Ctrl+C를 누르면 테스트 프로세스를 종료할 수 있습니다.

업스트림 CLI 설치

CLI만 필요하면 업스트림 npm 패키지를 바로 설치할 수 있습니다:

npm install -g @joohw/boss-cli@latest
boss help

MCP 클라이언트 설정

Zcode

{
  "boss-recruiter": {
    "type": "stdio",
    "command": "D:\\nodejs\\node.exe",
    "args": [
      "D:\\boss-cli\\dist\\mcp\\index.js"
    ]
  }
}

Claude Desktop

Claude Desktop의 MCP 설정 파일에 다음 내용을 추가하세요:

{
  "mcpServers": {
    "boss-recruiter": {
      "command": "D:\\nodejs\\node.exe",
      "args": [
        "D:\\boss-cli\\dist\\mcp\\index.js"
      ]
    }
  }
}

참고:

• command에는 Node.js 실행 파일 경로만 입력합니다.

• MCP 파일의 전체 경로는 args 배열에서 하나의 문자열이어야 하며, 공백으로 분리되면 안 됩니다.

• JSON에서 Windows 백슬래시는 \\로 작성해야 합니다.

• 설정을 변경한 후에는 MCP 클라이언트를 완전히 재시작하거나 다시 로드해야 합니다.

Node.js 설치 경로를 정확히 모르겠다면 PowerShell에서 다음을 실행하세요:

(Get-Command node).Source

첫 로그인

MCP 클라이언트 연결이 성공하면 다음을 호출하세요:

boss_login

이 도구가 로컬 Chrome을 엽니다. QR 코드 스캔 또는 인증을 완료하면 이후 작업은 ~/.boss-cli/에 저장된 로컬 브라우저 세션을 재사용합니다.

MCP 도구

일괄 메시지 전송

권장 절차

1. boss_list_candidates를 호출하여 먼저 후보자 목록을 읽습니다.

2. 목록을 사용자에게 보여주고 수동 확인을 합니다.

3. boss_batch_send_messages를 호출하여 작업을 시작합니다.

4. 반환된 taskId를 저장합니다.

5. boss_batch_send_status를 호출하여 상태가 completed 또는 failed가 될 때까지 진행 상황을 조회합니다.

일괄 전송 시작

{
  "messages": [
    {
      "candidateName": "张三",
      "text": "您好，感谢您的关注，请问方便补充一下简历吗？",
      "exact": true
    },
    {
      "candidateName": "李四",
      "text": "您好，感谢您的关注，请问方便补充一下简历吗？",
      "exact": true
    }
  ],
  "confirm": true
}

기본적으로 비동기로 시작되고 즉시 반환됩니다:

{
  "taskId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "status": "running",
  "total": 2
}

작업 상태 조회

boss_batch_send_status를 호출합니다:

{
  "taskId": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
}

완료되면 다음과 같은 결과가 반환됩니다:

{
  "status": "completed",
  "total": 2,
  "sent": 1,
  "failed": 1,
  "results": [
    {
      "candidateName": "张三",
      "status": "sent"
    },
    {
      "candidateName": "李四",
      "status": "failed",
      "error": "未找到候选人"
    }
  ]
}

세부 정보:

• candidateName: 후보자 이름. boss_list_candidates의 결과에서 가져오는 것을 권장합니다.

• text: 전송할 메시지 본문.

• exact: 이름 정확 일치 여부. true로 유지하는 것을 권장합니다.

• confirm: 반드시 명시적으로 true로 설정해야 합니다. 그렇지 않으면 전송되지 않습니다.

• waitForCompletion 기본은 false입니다. true로 변경하지 않는 것을 권장합니다. 그렇지 않으면 페이지를 처음 로드할 때 MCP 클라이언트가 초과 시간될 수 있습니다.

일괄 도구는 후보를 순서대로 처리하며 각 후보자의 sent 또는 failed 상태를 기록합니다. 단일 후보자가 실패해도 이후 후보자의 실행은 중단되지 않습니다.

AI 클라이언트에서의 예시 프롬프트

调用 boss_list_candidates 获取未读候选人，将列表展示给我并等待确认。
我确认后，使用 boss_batch_send_messages 逐个发送指定消息。
必须精确匹配姓名并设置 confirm=true。
取得 taskId 后，定期调用 boss_batch_send_status，最后汇总成功和失败结果。

CLI 빠른 사용

# 登录
boss login

# 查看未读候选人
boss list --unread

# 打开聊天并发送消息
boss chat 张三 --strict
boss send --text "您好，请问方便发一下简历吗？"

# 查看推荐候选人
boss recommend 前端工程师

# 常规搜索
boss search "AI 产品经理"

전체 CLI 파라미터:

boss help

자주 묻는 질문

MCP 시작 시 Cannot find module 오류

주로 공백이 포함된 경로가 여러 매개변수로 분리된 것이 원인입니다. MCP 전체 경로가 args 배열의 하나의 문자열이 되도록 확인하세요:

"args": ["D:\\boss-cli\\dist\\mcp\\index.js"]

MCP 첫 번째 호출 시간 초과

첫 번째 호출은 Chrome을 시작하고 나서 Boss 페이지를 다시 로드해야 하므로 시간이 오래 걸립니다. 일괄 전송은 기본적으로 비동기 작업을 사용하므로, 작업을 반복해서 시작하는 대신 taskId를 저장하고 boss_batch_send_status로 조회해야 합니다.

동기 호출이 시간 초과로 표시되어도 작업은 브라우저에서 계속 실행되고 있을 수 있습니다. 다시 전송하기 전에 채팅 기록을 먼저 확인하여 중복 메시지를 피하세요.

소스 코드를 변경한, 하지만 MCP 도구가 갱신되지 않음

다시 빌드한 후 MCP 클라이언트를 재시작하세요:

cd D:\boss-cli
npm run build

데이터가 저장되는 위치

이 데이터는 로컬에 저장되며, GitHub에 커밋하면 안 됩니다.

개발

npm install
npm run build
npm run mcp

MCP의 주요 구현은 다음 위치에 있습니다:

• src/mcp/index.ts

• src/toolset/

• docs/mcp.md

업스트림 및 라이선스

이 저장소는 joohw/boss-cli를 기반으로 개발되었으며, 원 프로젝트의 GPL-3.0 라이선스를 유지합니다.

이 저장소에는 MCP 서비스, MCP 클라이언트 문서, 일괄 전송 및 비동기 작업 상태 조회 기능이 추가되었습니다.

자세한 내용은 LICENSE를 참조하세요.