@reconcrap/boss-recommend-mcp 0.1.2 → 0.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reconcrap/boss-recommend-mcp",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Unified MCP pipeline for recommend-page filtering and screening on Boss Zhipin",
   "keywords": [
     "boss",

package/vendor/boss-recommend-search-cli/src/cli.js

@@ -20,6 +20,39 @@ function parsePositiveInteger(raw) {
   return Number.isFinite(value) && value > 0 ? value : null;
 }
 
+function sortSchoolSelection(values) {
+  const order = new Map(SCHOOL_TAG_OPTIONS.map((label, index) => [label, index]));
+  const unique = Array.from(new Set((values || []).filter((item) => order.has(item))));
+  if (!unique.length) return [];
+  if (unique.includes("不限")) {
+    return unique.length === 1
+      ? ["不限"]
+      : unique.filter((item) => item !== "不限").sort((left, right) => order.get(left) - order.get(right));
+  }
+  return unique.sort((left, right) => order.get(left) - order.get(right));
+}
+
+function parseSchoolSelection(raw) {
+  const text = normalizeText(raw);
+  if (!text) return null;
+  if (text === "不限") return ["不限"];
+
+  const selected = [];
+  for (const chunk of text.split(/[，,、/|]/)) {
+    const value = normalizeText(chunk);
+    if (SCHOOL_TAG_OPTIONS.includes(value)) {
+      selected.push(value);
+    }
+  }
+  for (const label of SCHOOL_TAG_OPTIONS) {
+    if (label !== "不限" && text.includes(label)) {
+      selected.push(label);
+    }
+  }
+  const normalized = sortSchoolSelection(selected);
+  return normalized.length ? normalized : null;
+}
+
 function normalizeDegree(value) {
   const normalized = normalizeText(value);
   if (!normalized) return null;
@@ -72,7 +105,7 @@ function parseDegreeSelection(raw) {
 
 function parseArgs(argv) {
   const args = {
-    schoolTag: "不限",
+    schoolTag: ["不限"],
     degree: ["不限"],
     gender: "不限",
     recentNotView: "不限",
@@ -91,7 +124,7 @@ function parseArgs(argv) {
     const token = argv[index];
     const next = argv[index + 1];
     if (token === "--school-tag" && next) {
-      args.schoolTag = next;
+      args.schoolTag = parseSchoolSelection(next);
       args.__provided.schoolTag = true;
       index += 1;
     } else if (token === "--degree" && next) {
@@ -134,7 +167,12 @@ async function promptValue(ask, question, validate, defaultValue) {
 
 async function enrichArgsFromPrompt(args) {
   if (!isInteractiveTTY() || args.help) return args;
-  const askTargets = Object.values(args.__provided || {}).some((item) => item === false) || !Array.isArray(args.degree) || args.degree.length === 0;
+  const askTargets =
+    Object.values(args.__provided || {}).some((item) => item === false)
+    || !Array.isArray(args.schoolTag)
+    || args.schoolTag.length === 0
+    || !Array.isArray(args.degree)
+    || args.degree.length === 0;
   if (!askTargets) return args;
 
   const rl = readline.createInterface({
@@ -144,11 +182,12 @@ async function enrichArgsFromPrompt(args) {
   const ask = (question) => new Promise((resolve) => rl.question(question, resolve));
   try {
     if (!args.__provided.schoolTag) {
+      const current = Array.isArray(args.schoolTag) && args.schoolTag.length > 0 ? args.schoolTag.join("/") : "不限";
       args.schoolTag = await promptValue(
         ask,
-        `学校标签（${SCHOOL_TAG_OPTIONS.join("/")}，默认: ${args.schoolTag}）: `,
-        (value) => SCHOOL_TAG_OPTIONS.includes(value) ? value : null,
-        args.schoolTag
+        `学校标签（可多选，逗号/斜杠分隔；${SCHOOL_TAG_OPTIONS.join("/")}，默认: ${current}）: `,
+        (value) => parseSchoolSelection(value),
+        Array.isArray(args.schoolTag) && args.schoolTag.length > 0 ? args.schoolTag : ["不限"]
       );
     }
     if (!args.__provided.gender) {
@@ -159,6 +198,14 @@ async function enrichArgsFromPrompt(args) {
         args.gender
       );
     }
+    if (!args.__provided.recentNotView) {
+      args.recentNotView = await promptValue(
+        ask,
+        `近14天已看过滤（${RECENT_NOT_VIEW_OPTIONS.join("/")}，默认: ${args.recentNotView}）: `,
+        (value) => RECENT_NOT_VIEW_OPTIONS.includes(value) ? value : null,
+        args.recentNotView
+      );
+    }
     if (!args.__provided.degree || !Array.isArray(args.degree) || args.degree.length === 0) {
       const current = Array.isArray(args.degree) && args.degree.length > 0 ? args.degree.join(",") : "不限";
       args.degree = await promptValue(
@@ -168,14 +215,6 @@ async function enrichArgsFromPrompt(args) {
         Array.isArray(args.degree) && args.degree.length > 0 ? args.degree : ["不限"]
       );
     }
-    if (!args.__provided.recentNotView) {
-      args.recentNotView = await promptValue(
-        ask,
-        `近14天已看过滤（${RECENT_NOT_VIEW_OPTIONS.join("/")}，默认: ${args.recentNotView}）: `,
-        (value) => RECENT_NOT_VIEW_OPTIONS.includes(value) ? value : null,
-        args.recentNotView
-      );
-    }
     if (!args.__provided.port) {
       args.port = await promptValue(
         ask,
@@ -361,11 +400,10 @@ class RecommendSearchCli {
         const rect = el.getBoundingClientRect();
         return rect.width > 2 && rect.height > 2;
       };
-      const school = doc.querySelector('.check-box.school');
-      const degree = doc.querySelector('.check-box.degree');
-      const gender = doc.querySelector('.check-box.gender');
-      const recent = doc.querySelector('.check-box.recentNotView');
-      return Boolean((school && degree && gender && recent) || isVisible(panel));
+      const groups = Array.from(doc.querySelectorAll('.check-box'));
+      const visibleGroups = groups.filter((group) => isVisible(group));
+      if (visibleGroups.length >= 2) return true;
+      return Boolean(isVisible(panel) && visibleGroups.length >= 1);
     })()`);
     return result === true;
   }
@@ -522,11 +560,46 @@ class RecommendSearchCli {
         return { ok: false, error: 'NO_RECOMMEND_IFRAME' };
       }
       const doc = frame.contentDocument;
-      const group = doc.querySelector('.check-box.' + groupClass);
+      const normalize = (value) => String(value || '').replace(/\\s+/g, '').trim();
+      const groupCandidates = Array.from(doc.querySelectorAll('.check-box'));
+      const getOptionSet = (group) => new Set(
+        Array.from(group.querySelectorAll('.default.option, .options .option, .option'))
+          .map((item) => normalize(item.textContent))
+          .filter(Boolean)
+      );
+      const findGroup = () => {
+        const direct = doc.querySelector('.check-box.' + groupClass);
+        if (direct) return direct;
+        if (groupClass === 'school') {
+          return groupCandidates.find((group) => {
+            const set = getOptionSet(group);
+            return set.has('985') || set.has('211') || set.has('双一流院校');
+          }) || null;
+        }
+        if (groupClass === 'degree') {
+          return groupCandidates.find((group) => {
+            const set = getOptionSet(group);
+            return set.has('大专') || set.has('本科') || set.has('硕士') || set.has('博士');
+          }) || null;
+        }
+        if (groupClass === 'gender') {
+          return groupCandidates.find((group) => {
+            const set = getOptionSet(group);
+            return set.has('男') || set.has('女');
+          }) || null;
+        }
+        if (groupClass === 'recentNotView') {
+          return groupCandidates.find((group) => {
+            const set = getOptionSet(group);
+            return set.has('近14天没有');
+          }) || null;
+        }
+        return null;
+      };
+      const group = findGroup();
       if (!group) {
         return { ok: false, error: 'GROUP_NOT_FOUND' };
       }
-      const normalize = (value) => String(value || '').replace(/\s+/g, '').trim();
       const frameRect = frame.getBoundingClientRect();
       const getPoint = (el) => {
         const rect = el.getBoundingClientRect();
@@ -555,19 +628,191 @@ class RecommendSearchCli {
     })(${JSON.stringify(groupClass)}, ${JSON.stringify(label)})`);
   }
 
+  async ensureGroupReady(groupClass) {
+    return this.evaluate(`((groupClass) => {
+      const frame = document.querySelector('iframe[name="recommendFrame"]')
+        || document.querySelector('iframe[src*="/web/frame/recommend/"]')
+        || document.querySelector('iframe');
+      if (!frame || !frame.contentDocument) {
+        return { ok: false, error: 'NO_RECOMMEND_IFRAME' };
+      }
+      const doc = frame.contentDocument;
+      const normalize = (value) => String(value || '').replace(/\\s+/g, '').trim();
+      const groupCandidates = Array.from(doc.querySelectorAll('.check-box'));
+      const getOptionSet = (group) => new Set(
+        Array.from(group.querySelectorAll('.default.option, .options .option, .option'))
+          .map((item) => normalize(item.textContent))
+          .filter(Boolean)
+      );
+      const findGroup = () => {
+        const direct = doc.querySelector('.check-box.' + groupClass);
+        if (direct) return direct;
+        if (groupClass === 'school') {
+          return groupCandidates.find((group) => {
+            const set = getOptionSet(group);
+            return set.has('985') || set.has('211') || set.has('双一流院校');
+          }) || null;
+        }
+        if (groupClass === 'degree') {
+          return groupCandidates.find((group) => {
+            const set = getOptionSet(group);
+            return set.has('大专') || set.has('本科') || set.has('硕士') || set.has('博士');
+          }) || null;
+        }
+        if (groupClass === 'gender') {
+          return groupCandidates.find((group) => {
+            const set = getOptionSet(group);
+            return set.has('男') || set.has('女');
+          }) || null;
+        }
+        if (groupClass === 'recentNotView') {
+          return groupCandidates.find((group) => {
+            const set = getOptionSet(group);
+            return set.has('近14天没有');
+          }) || null;
+        }
+        return null;
+      };
+
+      const scrollGroupIntoView = (group) => {
+        try {
+          group.scrollIntoView({ behavior: 'instant', block: 'center' });
+        } catch {
+          try { group.scrollIntoView({ block: 'center' }); } catch {}
+        }
+      };
+
+      let group = findGroup();
+      if (group) {
+        scrollGroupIntoView(group);
+        return { ok: true, found: true, scrolled: false };
+      }
+
+      const topScroller = doc.querySelector('.recommend-filter.op-filter .filter-panel .top')
+        || doc.querySelector('.recommend-filter.op-filter .top')
+        || doc.querySelector('.recommend-filter.op-filter .filter-panel');
+      if (!topScroller) {
+        return { ok: false, error: 'FILTER_SCROLL_CONTAINER_NOT_FOUND' };
+      }
+      const maxScrollTop = Math.max(0, topScroller.scrollHeight - topScroller.clientHeight);
+      const steps = 14;
+      for (let index = 0; index <= steps; index += 1) {
+        const nextTop = maxScrollTop <= 0 ? 0 : Math.round((maxScrollTop * index) / steps);
+        topScroller.scrollTop = nextTop;
+        group = findGroup();
+        if (group) {
+          scrollGroupIntoView(group);
+          return { ok: true, found: true, scrolled: true, step: index };
+        }
+      }
+      return { ok: false, error: 'GROUP_NOT_FOUND' };
+    })(${JSON.stringify(groupClass)})`);
+  }
+
   async selectOption(groupClass, label) {
-    const option = await this.getOptionInfo(groupClass, label);
+    let option = await this.getOptionInfo(groupClass, label);
+    if (!option?.ok && option?.error === "GROUP_NOT_FOUND") {
+      await this.openFilterPanel();
+      const ensure = await this.ensureGroupReady(groupClass);
+      if (!ensure?.ok) {
+        throw new Error(ensure?.error || "GROUP_NOT_FOUND");
+      }
+      await sleep(humanDelay(180, 60));
+      option = await this.getOptionInfo(groupClass, label);
+    }
     if (!option?.ok) {
       throw new Error(option?.error || 'OPTION_NOT_FOUND');
     }
     if (option.alreadySelected) {
       return;
     }
+    const domClick = await this.clickOptionBySelector(groupClass, label);
+    if (!domClick?.ok) {
+      throw new Error(domClick?.error || "OPTION_DOM_CLICK_FAILED");
+    }
+    if (await this.waitOptionSelected(groupClass, label, 10)) {
+      return;
+    }
+
     await this.simulateHumanClick(option.x, option.y);
-    await sleep(humanDelay(300, 80));
+    if (!(await this.waitOptionSelected(groupClass, label, 10))) {
+      throw new Error("OPTION_SELECTION_NOT_APPLIED");
+    }
   }
 
-  async getDegreeFilterState() {
+  async clickOptionBySelector(groupClass, label) {
+    return this.evaluate(`((groupClass, label) => {
+      const frame = document.querySelector('iframe[name="recommendFrame"]')
+        || document.querySelector('iframe[src*="/web/frame/recommend/"]')
+        || document.querySelector('iframe');
+      if (!frame || !frame.contentDocument) {
+        return { ok: false, error: 'NO_RECOMMEND_IFRAME' };
+      }
+      const doc = frame.contentDocument;
+      const normalize = (value) => String(value || '').replace(/\\s+/g, '').trim();
+      const groupCandidates = Array.from(doc.querySelectorAll('.check-box'));
+      const getOptionSet = (group) => new Set(
+        Array.from(group.querySelectorAll('.default.option, .options .option, .option'))
+          .map((item) => normalize(item.textContent))
+          .filter(Boolean)
+      );
+      const findGroup = () => {
+        const direct = doc.querySelector('.check-box.' + groupClass);
+        if (direct) return direct;
+        if (groupClass === 'school') {
+          return groupCandidates.find((group) => {
+            const set = getOptionSet(group);
+            return set.has('985') || set.has('211') || set.has('双一流院校');
+          }) || null;
+        }
+        if (groupClass === 'degree') {
+          return groupCandidates.find((group) => {
+            const set = getOptionSet(group);
+            return set.has('大专') || set.has('本科') || set.has('硕士') || set.has('博士');
+          }) || null;
+        }
+        if (groupClass === 'gender') {
+          return groupCandidates.find((group) => {
+            const set = getOptionSet(group);
+            return set.has('男') || set.has('女');
+          }) || null;
+        }
+        if (groupClass === 'recentNotView') {
+          return groupCandidates.find((group) => {
+            const set = getOptionSet(group);
+            return set.has('近14天没有');
+          }) || null;
+        }
+        return null;
+      };
+      const group = findGroup();
+      if (!group) {
+        return { ok: false, error: 'GROUP_NOT_FOUND' };
+      }
+      const options = Array.from(group.querySelectorAll('.options .option, .option'));
+      const target = label === '不限'
+        ? (group.querySelector('.default.option') || options.find((item) => normalize(item.textContent) === '不限'))
+        : options.find((item) => normalize(item.textContent) === normalize(label));
+      if (!target) {
+        return { ok: false, error: 'OPTION_NOT_FOUND' };
+      }
+      target.click();
+      return { ok: true };
+    })(${JSON.stringify(groupClass)}, ${JSON.stringify(label)})`);
+  }
+
+  async waitOptionSelected(groupClass, label, rounds = 8) {
+    for (let index = 0; index < rounds; index += 1) {
+      const state = await this.getOptionInfo(groupClass, label);
+      if (state?.ok && state.alreadySelected) {
+        return true;
+      }
+      await sleep(120 + index * 40);
+    }
+    return false;
+  }
+
+  async getSchoolFilterState() {
     return this.evaluate(`(() => {
       const frame = document.querySelector('iframe[name="recommendFrame"]')
         || document.querySelector('iframe[src*="/web/frame/recommend/"]')
@@ -576,11 +821,88 @@ class RecommendSearchCli {
         return { ok: false, error: 'NO_RECOMMEND_IFRAME' };
       }
       const doc = frame.contentDocument;
-      const group = doc.querySelector('.check-box.degree');
+      const normalize = (value) => String(value || '').replace(/\\s+/g, '').trim();
+      const groups = Array.from(doc.querySelectorAll('.check-box'));
+      const group = doc.querySelector('.check-box.school')
+        || groups.find((item) => {
+          const set = new Set(
+            Array.from(item.querySelectorAll('.default.option, .options .option, .option'))
+              .map((node) => normalize(node.textContent))
+              .filter(Boolean)
+          );
+          return set.has('985') || set.has('211') || set.has('双一流院校');
+        });
       if (!group) {
         return { ok: false, error: 'GROUP_NOT_FOUND' };
       }
+      const labels = ${JSON.stringify(SCHOOL_TAG_OPTIONS)};
+      const activeLabels = labels.filter((label) => {
+        const node = Array.from(group.querySelectorAll('.options .option, .option'))
+          .find((item) => normalize(item.textContent) === normalize(label));
+        return Boolean(node && node.classList.contains('active'));
+      });
+      const defaultOption = group.querySelector('.default.option');
+      return {
+        ok: true,
+        defaultActive: Boolean(defaultOption && defaultOption.classList.contains('active')),
+        activeLabels
+      };
+    })()`);
+  }
+
+  async selectSchoolFilter(labels) {
+    const ensure = await this.ensureGroupReady("school");
+    if (!ensure?.ok) {
+      throw new Error(ensure?.error || "GROUP_NOT_FOUND");
+    }
+
+    const targetLabels = Array.isArray(labels) && labels.length > 0 ? labels : ["不限"];
+    if (targetLabels.includes("不限")) {
+      await this.selectOption("school", "不限");
+      return;
+    }
+
+    const currentState = await this.getSchoolFilterState();
+    if (!currentState?.ok) {
+      throw new Error(currentState?.error || "SCHOOL_FILTER_STATE_FAILED");
+    }
+    const current = sortSchoolSelection(currentState.activeLabels || []);
+    const desired = sortSchoolSelection(targetLabels);
+    const same =
+      !currentState.defaultActive
+      && current.length === desired.length
+      && current.every((value, index) => value === desired[index]);
+    if (same) return;
+
+    await this.selectOption("school", "不限");
+    for (const label of desired) {
+      await this.selectOption("school", label);
+    }
+  }
+
+  async getDegreeFilterState() {
+    return this.evaluate(`(() => {
+      const frame = document.querySelector('iframe[name="recommendFrame"]')
+        || document.querySelector('iframe[src*="/web/frame/recommend/"]')
+        || document.querySelector('iframe');
+      if (!frame || !frame.contentDocument) {
+        return { ok: false, error: 'NO_RECOMMEND_IFRAME' };
+      }
+      const doc = frame.contentDocument;
       const normalize = (value) => String(value || '').replace(/\\s+/g, '').trim();
+      const groups = Array.from(doc.querySelectorAll('.check-box'));
+      const group = doc.querySelector('.check-box.degree')
+        || groups.find((item) => {
+          const set = new Set(
+            Array.from(item.querySelectorAll('.default.option, .options .option, .option'))
+              .map((node) => normalize(node.textContent))
+              .filter(Boolean)
+          );
+          return set.has('大专') || set.has('本科') || set.has('硕士') || set.has('博士');
+        });
+      if (!group) {
+        return { ok: false, error: 'GROUP_NOT_FOUND' };
+      }
       const labels = ${JSON.stringify(DEGREE_OPTIONS)};
       const activeLabels = labels.filter((label) => {
         const node = Array.from(group.querySelectorAll('.options .option'))
@@ -597,6 +919,11 @@ class RecommendSearchCli {
   }
 
   async selectDegreeFilter(labels) {
+    const ensure = await this.ensureGroupReady("degree");
+    if (!ensure?.ok) {
+      throw new Error(ensure?.error || "GROUP_NOT_FOUND");
+    }
+
     const targetLabels = Array.isArray(labels) && labels.length > 0 ? labels : ["不限"];
     if (targetLabels.includes("不限")) {
       await this.selectOption("degree", "不限");
@@ -670,11 +997,14 @@ class RecommendSearchCli {
       console.log(JSON.stringify({
         status: "COMPLETED",
         result: {
-          usage: "node src/cli.js --school-tag 985 --degree 本科及以上 --gender 男 --recent-not-view 近14天没有 --port 9222"
+          usage: "node src/cli.js --school-tag 985/211 --degree 本科及以上 --gender 男 --recent-not-view 近14天没有 --port 9222"
         }
       }));
       return;
     }
+    if (!Array.isArray(this.args.schoolTag) || this.args.schoolTag.length === 0) {
+      throw new Error("INVALID_SCHOOL_TAG_INPUT");
+    }
     if (!Array.isArray(this.args.degree) || this.args.degree.length === 0) {
       throw new Error("INVALID_DEGREE_INPUT");
     }
@@ -687,10 +1017,10 @@ class RecommendSearchCli {
       }
 
       await this.openFilterPanel();
-      await this.selectOption("school", this.args.schoolTag);
-      await this.selectDegreeFilter(this.args.degree);
+      await this.selectSchoolFilter(this.args.schoolTag);
       await this.selectOption("gender", this.args.gender);
       await this.selectOption("recentNotView", this.args.recentNotView);
+      await this.selectDegreeFilter(this.args.degree);
       await this.closeFilterPanel();
       const candidateInfo = await this.waitForCandidateCountStable();