boss-cli-mcp

Расширение проекта joohw/boss-cli, предоставляющее CLI и MCP-сервис для автоматизации Boss 直聘.

Проект управляет локальным Chrome через Puppeteer/CDP, повторно используя локальный статус входа, и предоставляет MCP-совместимым AI-клиентам, таким как Claude Desktop, Cursor, Zcode, возможности поиска кандидатов, чата, отправки сообщений, массовых ответов, поиска рекомендаций и управления вакансиями.

Этот проект выполняет реальные действия с аккаунтом Boss. Перед отправкой сообщений, приветствий, просмотром резюме и сопоставлением проверяйте кандидата и параметры, а также соблюдайте правила платформы.

Возможности

• Чтение списка всех или непрочитанных кандидатов

• Открытие чата по имени или порядковому номеру в списке

• Отправка одного сообщения

• Асинхронная массовая отправка ответов кандидатам

• Запрос прогресса массовой отправки и результатов по каждому кандидату

• Действия в чате: запрос резюме, заметка, «не подходит», обмен WeChat и др.

• Чтение рекомендованных кандидатов и результатов обычного поиска

• Глубокий поиск и сопоставление

• Предпросмотр онлайн-резюме

• Чтение списка вакансий и сведений о вакансии

• Два способа вызова: 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.

Установка upstream CLI

Если нужен только CLI, можно напрямую установить upstream-пакет 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

Добавьте следующее содержимое в конфигурационный файл MCP для Claude Desktop:

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

Примечание:

• В command указывается только путь к исполняемому файлу Node.js.

• Полный путь к MCP-файлу должен быть одной строкой в args и не может разбиваться по пробелам.

• Windows-обратная косая черта в JSON должна записываться как \\.

• После изменения конфигурации необходимо полностью перезапустить или перезагрузить 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/MMP.md

Upstream и лицензия

Этот репозиторий разработан на основе joohw/boss-cli и сохраняет лицензию GPL-3.0 исходного проекта.

В этот репозиторий добавлены MCP-сервис, документация для MCP-клиентов, возможность массовых отправок и запросы статуса асинхронных задач.

Подробнее см. LICENSE.

boss-cli-mcp

Расширение проекта joohw/boss-cli, предоставляющее CLI и MCP-сервис для автоматизации Boss 直聘.

Проект управляет локальным Chrome через Puppeteer/CDP, повторяя локальную авторизацию, и предоставляет MCP-совместимым AI-клиентам, таким как Claude Desktop, Cursor, Zcode, возможности поиска кандидатов, чата, отправки сообщений, массовых ответов, поиска рекомендаций и управления вакансиями.

Этот проект выполняет реальные действия с аккаунтом Boss. Перед отправкой сообщений, приветствий, просмотром резюме и углублённым сравнением необходимо указывать кандидата и параметры, а также соблюдать правила платформы.

Возможности

• Чтение списка кандидатов (всех или непрочитанных)

• Открытие чата по имени или по порядку в списке

• Отправка одного сообщения

• Асинхронная массовая отправка ответов кандидатам

• Запрос прогресса массовой отправки и результатов по каждому кандидату

• Запрос резюме, добавление заметок, отклонение, обмен WeChat и другие действия в чате

• Чтение рекомендованных кандидатов и результатов обычного поиска

• Углублённые поиск и сравнение

• Предпросмотр онлайн-резюме

• Чтение списка вакансий и деталей вакансии

• Два способа вызова: CLI и stdio MCP

Требования к окружению

• 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

Добавьте следующие содержимое в файл конфигурации MCP для Claude Desktop:

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

Примечание:

• В command укажите путь к исполняемому файлу Node.js.

• Полный путь к MCP-файлу должен быть одной строкой в массиве args, нельзя разбивать по пробелам.

• Обратные проблемы в Windows в JSON должны записываться как \\.

• После изменения конфигурации необходимо полностью перезапустить или перезагрузить MCP-клиент.

Если не уверены в пути установки Node.js, выполните в PowerShell:

(Get-Command node).Source

Первый вход

После успешного подключения MCP-клиента вызовите:

boss_login

Инструмент откроет локальный Chrome. После завершения сканирования или проверки последующие операции будут сохранять локальную сессию браузера из ~/.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/index.ts

• src/toolset/

• docs/md

Upstream и лицензия

Данный репозиторий основан на joohw/boss-cli. Сохраняется лицензия GPL-3.0 оригинального проекта.

В этом репозитории добавлены MCP-сервисы, документация для MCP-клиентов, массовые отправка и возможность запроса статуса асинхронных задач.

Подробнее см. LICENSE.