@reconcrap/boss-recommend-mcp 0.1.0

package/README.md

@@ -0,0 +1,127 @@
+# @reconcrap/boss-recommend-mcp
+
+Boss 推荐页自动化流水线 MCP（stdio）服务。
+
+它把 recommend 页面上的两段能力串起来：
+
+- `boss-recommend-search-cli`: 只负责推荐页筛选项
+- `boss-recommend-screen-cli`: 只负责滚动列表、打开详情、提取完整简历图、多模态判断，并对通过人选统一执行 `favorite` 或 `greet`
+
+MCP 工具名：`run_recommend_pipeline`
+
+状态机：
+
+- `NEED_INPUT`
+- `NEED_CONFIRMATION`
+- `COMPLETED`
+- `FAILED`
+
+## 设计特点
+
+- 页面目标固定为 `https://www.zhipin.com/web/chat/recommend`
+- 支持推荐页原生筛选：学校标签 / 性别 / 近14天没有
+- `post_action` 必须在每次完整运行开始时确认一次
+- `target_count` 会在每次运行开始时询问一次（可留空，不设上限）
+- 当 `post_action=greet` 时，必须在运行开始时确认 `max_greet_count`
+- 一旦确认 `post_action`，本次运行内所有通过人选都统一按该动作执行
+- 若达到 `max_greet_count` 但流程仍需继续，后续通过人选会自动改为收藏
+- 不会对每位候选人重复确认
+- 推荐页详情处理完成后，会强制关闭详情页并确认已关闭
+- 简历提取采用“分段滚动截图 + 拼成长图”的方式，再交给多模态模型判断
+
+## 安装
+
+```bash
+npm install
+```
+
+安装后可以直接运行：
+
+```bash
+node src/cli.js start
+```
+
+或使用 CLI fallback：
+
+```bash
+node src/cli.js run --instruction "推荐页筛选985男生，近14天没有，有大模型平台经验，符合标准的收藏"
+```
+
+## 配置
+
+用户配置文件默认路径：
+
+```bash
+$CODEX_HOME/boss-recommend-mcp/screening-config.json
+```
+
+配置样例见：
+
+```bash
+config/screening-config.example.json
+```
+
+必填字段：
+
+- `baseUrl`
+- `apiKey`
+- `model`
+
+可选字段：
+
+- `openaiOrganization`
+- `openaiProject`
+- `debugPort`
+- `outputDir`
+
+## 常用命令
+
+```bash
+node src/cli.js install
+node src/cli.js init-config
+node src/cli.js set-port --port 9222
+node src/cli.js doctor
+node src/cli.js launch-chrome --port 9222
+node src/cli.js run --instruction-file request.txt --confirmation-file confirmation.json --overrides-file overrides.json
+```
+
+## MCP Tool Input
+
+```json
+{
+  "instruction": "推荐页筛选211女生，近14天没有，有 AI Agent 经验，符合标准的直接沟通",
+  "confirmation": {
+    "filters_confirmed": true,
+    "criteria_confirmed": true,
+    "target_count_confirmed": true,
+    "target_count_value": 20,
+    "post_action_confirmed": true,
+    "post_action_value": "greet",
+    "max_greet_count_confirmed": true,
+    "max_greet_count_value": 10
+  },
+  "overrides": {
+    "school_tag": "211",
+    "gender": "女",
+    "recent_not_view": "近14天没有",
+    "criteria": "候选人需要有 AI Agent 或 MCP 工具开发经验",
+    "target_count": 20,
+    "post_action": "greet",
+    "max_greet_count": 10
+  }
+}
+```
+
+## 测试
+
+```bash
+npm run test:parser
+npm run test:pipeline
+```
+
+## 当前实现边界
+
+- 选择器已经按 recommend 页面语义切换
+- `post_action` 的运行级单次确认已经落到 parser / pipeline / screen CLI
+- 图片化简历筛选已经接入 recommend-screen-cli
+- 页面按钮的真实联调验证仍然应该按你的要求，在交互前先征求确认后再做

package/bin/boss-recommend-mcp.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import "../src/cli.js";

package/config/screening-config.example.json

@@ -0,0 +1,7 @@
+{
+  "baseUrl": "https://api.openai.com/v1",
+  "apiKey": "replace-with-openai-api-key",
+  "model": "gpt-4.1-mini",
+  "openaiOrganization": "optional-org-id",
+  "openaiProject": "optional-project-id"
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@reconcrap/boss-recommend-mcp",
+  "version": "0.1.0",
+  "description": "Unified MCP pipeline for recommend-page filtering and screening on Boss Zhipin",
+  "keywords": [
+    "boss",
+    "mcp",
+    "codex",
+    "recruiting",
+    "boss-zhipin",
+    "recommend"
+  ],
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "boss-recommend-mcp": "bin/boss-recommend-mcp.js"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "cli": "node src/cli.js",
+    "install:local": "node src/cli.js install",
+    "postinstall": "node scripts/postinstall.cjs",
+    "test:parser": "node src/test-parser.js",
+    "test:pipeline": "node src/test-pipeline.js"
+  },
+  "files": [
+    "bin",
+    "config/screening-config.example.json",
+    "skills",
+    "scripts/postinstall.cjs",
+    "src",
+    "vendor",
+    "README.md"
+  ],
+  "dependencies": {
+    "chrome-remote-interface": "^0.33.3",
+    "ws": "^8.19.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT"
+}

package/scripts/postinstall.cjs

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+const fs = require("node:fs");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+function isGlobalInstall() {
+  if (String(process.env.npm_config_global || "").toLowerCase() === "true") return true;
+  if (String(process.env.npm_config_location || "").toLowerCase() === "global") return true;
+
+  const argvRaw = String(process.env.npm_config_argv || "");
+  if (argvRaw.includes("--global") || argvRaw.includes(" -g ")) return true;
+
+  return false;
+}
+
+function main() {
+  if (!isGlobalInstall()) {
+    return;
+  }
+
+  const cliPath = path.join(__dirname, "..", "src", "cli.js");
+  if (!fs.existsSync(cliPath)) {
+    return;
+  }
+
+  const result = spawnSync(process.execPath, [cliPath, "install"], {
+    cwd: path.join(__dirname, ".."),
+    stdio: "inherit",
+    windowsHide: true,
+    shell: false
+  });
+
+  if (result.error) {
+    console.warn(`[boss-recommend-mcp] postinstall warning: ${result.error.message}`);
+    return;
+  }
+  if (typeof result.status === "number" && result.status !== 0) {
+    console.warn(`[boss-recommend-mcp] postinstall warning: install exited with code ${result.status}`);
+  }
+}
+
+main();

package/skills/boss-recommend-pipeline/README.md

@@ -0,0 +1,10 @@
+# Boss Recommend Pipeline Skill
+
+用于 Boss 推荐页的人选筛选流水线。
+
+核心规则：
+
+- 先确认推荐页 filters
+- 再确认筛选 criteria
+- 再确认本次运行统一动作 `favorite` 或 `greet`
+- 只确认一次 `post_action`，不要逐个候选人反复确认

package/skills/boss-recommend-pipeline/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: "boss-recommend-pipeline"
+description: "Use when users ask to run Boss recommend-page filtering and screening via boss-recommend-mcp; confirm filters, criteria, optional target_count, and run-level post_action (plus max_greet_count when post_action=greet) before execution."
+---
+
+# Boss Recommend Pipeline Skill
+
+## Purpose
+
+当用户希望在 Boss 推荐页按条件筛选候选人时，优先调用 MCP 工具 `run_recommend_pipeline` 完成端到端任务：
+
+1. 解析推荐页筛选指令
+2. 结构化推荐页 filters
+3. 确认筛选 criteria
+4. 在运行开始时询问 `target_count`（可选，可留空）
+5. 在运行开始时一次性确认 `post_action`
+6. 若 `post_action=greet`，同时确认 `max_greet_count`
+7. 执行 recommend-search-cli 与 recommend-screen-cli
+8. 返回结果摘要
+
+## Required Confirmation
+
+在真正执行前，必须先确认：
+
+- 推荐页 filters 是否正确
+- screening criteria 是否正确
+- `target_count`（目标筛选人数）是否需要设置（可不设上限）
+- `post_action` 是否确定为 `favorite` 或 `greet`
+- 当 `post_action=greet` 时，`max_greet_count`（最多打招呼人数）是否确定
+
+`post_action` 的确认是**单次运行级别**的：
+
+- 若用户确认 `favorite`，则本次运行中所有通过人选都统一收藏
+- 若用户确认 `greet`，则本次运行中先按 `max_greet_count` 执行打招呼，超出上限后自动改为收藏
+- 不要在每位候选人通过后再次逐个确认
+
+## Tool Contract
+
+- Tool name: `run_recommend_pipeline`
+- Input:
+  - `instruction` (required)
+  - `confirmation`
+    - `filters_confirmed`
+    - `criteria_confirmed`
+    - `target_count_confirmed`
+    - `target_count_value` (integer, optional)
+    - `post_action_confirmed`
+    - `post_action_value` (`favorite|greet`)
+    - `max_greet_count_confirmed`
+    - `max_greet_count_value` (integer)
+  - `overrides`
+    - `school_tag`
+    - `gender`
+    - `recent_not_view`
+    - `criteria`
+    - `target_count`
+    - `post_action`
+    - `max_greet_count`
+
+## Execution Notes
+
+- 推荐页筛选入口在 recommend 页面，不是 search 页面。
+- recommend-search-cli 只负责应用推荐页筛选项。
+- recommend-screen-cli 负责滚动推荐列表、打开详情、提取完整简历图、调用多模态模型判断，并按单次确认的 `post_action` 执行收藏或打招呼。
+- 详情页处理完成后必须关闭详情页并确认已关闭。
+
+## Fallback
+
+如果 MCP 不可用，改用：
+
+`boss-recommend-mcp run --instruction "..." [--confirmation-json '{...}'] [--overrides-json '{...}']`
+
+CLI fallback 的状态机与 MCP 保持一致：
+
+- `NEED_INPUT`
+- `NEED_CONFIRMATION`
+- `COMPLETED`
+- `FAILED`
+
+## Setup Checklist
+
+执行前先检查：
+
+- `boss-recommend-mcp` 是否已安装
+- `screening-config.json` 是否存在且包含可用模型配置
+- Chrome 远程调试端口是否可连
+- 当前 Chrome 是否停留在 `https://www.zhipin.com/web/chat/recommend`
+
+## Response Style
+
+- 用结构化中文输出
+- 先给用户确认卡片，再正式执行
+- 不要跳过 `post_action` 的首轮确认
+- 不要把 recommend 流程说成 search 流程