boss-cli-mcp

Automatisierungs-CLI- und MCP-Dienst für Boss 直聘, erweitert auf Basis von joohw/boss-cli.

Das Projekt steuert das lokale Chrome über Puppeteer/CDP und verwendet den lokalen Anmeldestatus wieder. Es bietet MCP-fähigen KI-Clients wie Claude Desktop, Cursor, Zcode Funktionen für Kandidatenabfragen, Chat, Nachrichtenversand, Massenantworten, Suchvorschläge und Stellenverwaltung.

Dieses Projekt führt echte Vorgänge an Ihrem Boss-直聘-Konto aus. Bevor Sie Nachrichten senden, Kontakt aufnehmen, Lebensläufe ansehen oder Deep-Matching durchführen, verifizieren Sie Kandidaten und Parameter und beachten Sie die Plattformregeln.

Funktionen

• Vollständige oder ungelesene Kandidatenliste lesen

• Chat über den Namen oder den Listenindex öffnen

• Einzelne Nachricht senden

• Kandidaten asynchron in Massen beantworten

• Fortschritt und Einzelergebnisse von Massensendungen abfragen

• Chat-Aktionen wie Lebenslauf anfordern, Notiz, nicht geeignet, WeChat austauschen usw.

• Empfohlene Kandidaten und reguläre Suchergebnisse lesen

• Tiefensuche und Matching

• Online-Lebenslauf-Vorschau

• Stellenliste und Stellendetails lesen

• Aufruf per CLI oder stdio-MCP

Related MCP server: Chrome MCP Server

Systemanforderungen

• Node.js 20 oder höher

• Lokal installiertes Chrome oder Chromium

• Windows, macOS oder Linux

• Ein Konto mit Zugriff auf den Boss-直聘-Unternehmensbereich

Installation

MCP aus diesem Repository ausführen

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

MCP-Einstiegspunkt nach dem Build:

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

Manuellen Start testen:

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

Der MCP kommuniziert über stdio. Es ist normal, dass das Terminal nach dem Start keine reguläre Ausgabe zeigt. Drücken Sie Ctrl+C, um den Testprozess zu beenden.

Upstream-CLI installieren

Falls Sie nur die CLI benötigen, können Sie das npm-Paket des Upstream-Projekts direkt installieren:

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

MCP-Clients konfigurieren

Zcode

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

Claude Desktop

Fügen Sie den folgenden Inhalt in die MCP-Konfigurationsdatei von Claude Desktop ein:

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

Hinweise:

• Unter command tragen Sie nur den Pfad zur ausführbaren Datei von Node.js ein.

• Der vollständige Pfad der MCP-Datei muss ein einziger String in args sein und darf nicht nach Leerzeichen aufgeteilt werden.

• Unter Windows müssen Backslashes in JSON als \\ geschrieben werden.

• Nach einer Konfigurationsänderung muss der MCP-Client vollständig neu gestartet oder neu geladen werden.

Falls Sie den Installationspfad von Node.js nicht sicher kennen, führen Sie in PowerShell Folgendes aus:

(Get-Command node).Source

Erste Anmeldung

Rufen Sie nach erfolgreicher Verbindung des MCP-Clients Folgendes auf:

boss_login

Das Tool öffnet Ihr lokales Chrome. Nach Abschluss der QR-Code-Anmeldung oder Verifizierung werden bei nachfolgenden Vorgängen die in ~/.boss-cli/ gespeicherten lokalen Browsersitzungen wiederverwendet.

MCP-Tools

Batch-Nachrichten senden

Empfohlener Ablauf

1. Rufen Sie boss_list_candidates auf, um zuerst die Kandidatenliste zu erhalten.

2. Zeigen Sie die Liste dem Benutzer an und lassen Sie sie manuell bestätigen.

3. Rufen Sie boss_batch_send_messages auf, um den Auftrag zu starten.

4. Speichern Sie die zurückgegebene taskId.

5. Rufen Sie boss_batch_send_status auf, um den Fortschritt abzufragen, bis der Status completed oder failed lautet.

Massensendung starten

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

Standardmäßig wird die Massensendung asynchron gestartet und sofort zurückgegeben:

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

Auftragsstatus abfragen

Rufen Sie boss_batch_send_status auf:

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

Nach Abschluss wird etwa Folgendes zurückgegeben:

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

Parameter:

• candidateName: Name des Kandidaten, am besten aus dem Ergebnis von boss_list_candidates übernehmen.

• text: Der zu sendende Nachrichtentext.

• exact: Ob der Name exakt übereinstimmen muss; empfohlen, true beizubehalten.

• confirm: Muss explizit auf true gesetzt werden, sonst wird nicht gesendet.

• waitForCompletion: Standard ist false. Eine Änderung auf true wird nicht empfohlen, da sonst beim ersten Laden der Seite ein Timeout des MCP-Clients ausgelöst werden kann.

Das Batch-Tool verarbeitet Kandidaten seriell und protokolliert pro Person den Status sent oder failed. Ein einzelner fehlgeschlagener Kandidat blockiert nachfolgende Kandidaten nicht.

Beispiel-Prompts in einem KI-Client

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

Schnellstart mit CLI

# 登录
boss login

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

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

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

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

Vollständige CLI-Parameter:

boss help

Einfache FAQ

MCP meldet beim Start Cannot find module

Meistens wurde ein Pfad mit Leerzeichen in mehrere Argumente aufgeteilt. Stellen Sie sicher, dass der vollständige MCP-Pfad ein einzelner String im args-Array ist:

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

Timeout beim ersten MCP-Aufruf

Der erste Aufruf muss Chrome starten oder sich verbinden und die Boss-直聘-Seite laden, was länger dauern kann. Massensendungen verwenden standardmäßig asynchrone Aufgaben. Daher sollten Sie die taskId speichern und boss_batch_send_status abfragen, statt den Auftrag erneut zu starten.

Wenn ein synchroner Aufruf ein Timeout anzeigt, wird der Vorgang im Browser möglicherweise trotzdem weiter ausgeführt. Prüfen Sie vor einem erneuten Senden zuerst den Chatverlauf, um doppelte Nachrichten zu vermeiden.

MCP-Tools nach Quellcodeänderung nicht aktuell

Bauen Sie das Projekt neu und starten Sie den MCP-Client neu:

cd D:\boss-cli
npm run build

Wo werden Daten gespeichert?

Diese Daten werden lokal gespeichert und sollten nicht nach GitHub übertragen werden.

Entwicklung

npm install
npm run build
npm run mcp

Die Hauptimplementierung des MCP befindet sich in:

• src/mcp/index.ts

• src/toolset/

• docs/mcp.md

Upstream und Lizenz

Dieses Repository basiert auf joohw/boss-cli und behält die GPL-3.0-Lizenz des Originalprojekts bei.

Dieses Repository fügt einen MCP-Dienst, Dokumentation für MCP-Clients, Massensende- sowie asynchrone Auftragsstatusabfragen hinzu.

Weitere Informationen finden Sie in LICENSE.