boss-cli-mcp

joohw/boss-cli を拡張した Boss 直聘の自動化 CLI と MCP サービスです。

本プロジェクトは Puppeteer/CDP を用いてローカルの Chrome を操作し、ローカルのログイン状態を再利用することで、Claude Desktop、Cursor、Zcode などの MCP 対応 AI クライアントに、候補者の照会、チャット、メッセージ送信、一括返信、おすすめ検索、求人管理の機能を提供します。

本プロジェクトは Boss アカウントに対して実際の操作を実行します。メッセージ送信、挨拶、履歴書の閲覧、深度マッチングを行う前に、候補者とパラメーターをご確認のうえ、プラットフォームの規則を守ってください。

機能

• 全件または未読の候補者リストを取得

• 名前またはリスト番号でチャットを開く

• メッセージを1件送信

• 候補者への一括返信を非同期で実行

• 一括送信の進行状況と候補ごとの結果を確認

• 履歴書の取得、メモ、不適合、微信の交換などのチャット操作

• オススメ候補と通常の検索結果を取得

• 深度検索とマッチング

• オンライン履歴書のプレビュー

• 求人一覧と求人詳細を取得

• CLI と stdio MCP の2通りの呼び出し方式に対応

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 配列内の1つの文字列として指定してください。スペースで分割しないでください。

• 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」として記録します。1人の候補が失敗しても、それ以降の候補の処理は継続されます。

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 配列の中の1つの文字列になるよう確認してください:

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

MCP の初回呼び出しがタイムアウトする

初回の呼び出しでは Chheddar 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 を参照してください。