Skip to main content
Glama
boss-mcp-job-hunting

boss-mcp-job-hunting

by lemonskiller

boss-mcp-job-hunting

job hunting 的意思是“求职 / 找工作”。这个 MCP 用于在 Boss 直聘上按目标岗位关键词搜索职位,并过滤最近一段时间发布的岗位。

当前版本使用 FastMCP + Playwright。它不会硬编码 Boss 的内部接口,而是使用一个本地持久化浏览器资料目录复用登录态:

  • 优先调用 import_boss_cookies(cookie_header="...") 导入正常浏览器里的 Cookie。

  • 如果 Boss 对 Playwright profile 触发风控,可以用 search_boss_jobs_chrome_debug() 连接真实 Chrome 会话读取页面。

  • start_boss_qr_login() / complete_boss_qr_login() 是备用方案;Boss 可能会让 App 显示“扫码失败”。

  • login_boss_interactive() 仍可作为备用,但 Boss 可能会把浏览器登录页跳到 about:blank。

  • 再调用 search_boss_jobs(keyword="AI解决方案岗", days=30) 搜索最近 30 天匹配岗位。

安装

cd boss-mcp-job-hunting
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
playwright install chromium

Related MCP server: BossZhipin MCP Server

运行

作为 stdio MCP server:

boss-mcp-job-hunting

或者:

python -m boss_mcp_job_hunting.server

MCP 客户端配置

{
  "mcpServers": {
    "boss-mcp-job-hunting": {
      "command": "boss-mcp-job-hunting",
      "args": []
    }
  }
}

工具

import_boss_cookies

把已经登录 Boss 直聘的浏览器 Cookie 导入到 MCP 的持久化资料目录。这是当前最稳的登录方式。

{
  "cookie_header": "复制浏览器请求头里的 Cookie 内容",
  "verify": true
}

也可以在 MCP 启动环境里设置 BOSS_COOKIE,搜索时会自动应用。

start_boss_qr_login

生成 Boss 直聘登录二维码图片,不打开浏览器登录页。这个接口可能被 Boss App 判定为“扫码失败”,因此只作为备用方案。

{}

返回里的 qr_image_path 是本地二维码图片路径。用 Boss 直聘 App 扫码后,继续调用 complete_boss_qr_login。

complete_boss_qr_login

等待 App 扫码确认,并把拿到的登录 Cookie 导入 MCP 的持久化资料目录。

{
  "timeout_seconds": 180,
  "verify": true
}

扫码登录后,登录态会保存在:

./.boss-browser-profile

open_boss_login

只打开 Boss 直聘登录页,不等待登录完成。更推荐使用 login_boss_interactive。

{
  "headless": false
}

login_boss_interactive

打开可见浏览器窗口,等待扫码登录和安全验证完成。默认会先给你 90 秒扫码时间,这段时间不会访问岗位搜索页,避免 Boss 在你扫码前就把页面跳到 about:blank。如果登录页变成 about:blank,工具会返回 blank_redirect,不会自动重开窗口;这时建议用 import_boss_cookies。

{
  "timeout_seconds": 300,
  "qr_wait_seconds": 90,
  "check_interval_seconds": 5
}

get_boss_login_status

检查本地浏览器资料目录里是否看起来已经登录。

search_boss_jobs

搜索岗位并过滤最近 N 天发布的结果。

示例:

{
  "keyword": "AI解决方案岗",
  "city": "全国",
  "days": 30,
  "pages": 3,
  "extra_keywords": ["大模型", "售前", "解决方案", "AI Solution"],
  "require_publish_date": true,
  "headless": true
}

常用城市:全国、北京、上海、广州、深圳、杭州、成都、南京、武汉、西安、苏州、天津、重庆。

如果某些岗位卡片没有显示发布时间,可以把 require_publish_date 设为 false,这样会保留没有发布时间但关键词匹配的岗位。

search_boss_jobs_chrome_debug

连接你真实的 Chrome 会话读取 Boss 页面。适合普通 MCP 浏览器 profile 被 Boss 风控拦截,但你自己的 Chrome 可以正常登录浏览时使用。

先关闭 Chrome,然后启动一个带调试端口的独立 Chrome:

open -na 'Google Chrome' --args --remote-debugging-port=9222 --user-data-dir=/tmp/boss-mcp-chrome-debug

在这个 Chrome 里正常登录 Boss 直聘,手动打开目标搜索页并等结果渲染出来,然后调用:

{
  "keyword": "AI解决方案岗",
  "city": "全国",
  "days": 30,
  "pages": 3,
  "extra_keywords": ["大模型", "售前", "解决方案", "AI Solution"],
  "require_publish_date": true,
  "debug_url": "http://127.0.0.1:9222",
  "allow_navigation": false
}

这个工具只连接本机 Chrome DevTools,不会把 Cookie 写入 Git。默认 allow_navigation=false,只读取你已经打开的 Boss 标签页,不新开页面、不跳转 URL,避免 Boss 把页面变成 about:blank。

说明

Boss 直聘页面和风控策略可能变化。如果搜索结果为空,通常先尝试:

  1. 调用 import_boss_cookies 导入正常浏览器的 Cookie。

  2. 如果 Cookie 失效,重新在正常浏览器里登录 Boss 直聘并复制新的 Cookie。

  3. 如果 Playwright profile 仍触发风控,用 search_boss_jobs_chrome_debug 连接真实 Chrome。

  4. 如果想尝试二维码备用方案,调用 start_boss_qr_login() 和 complete_boss_qr_login()。

  5. 把 search_boss_jobs 的 headless 改为 false 观察浏览器页面。

  6. 减少 pages,避免过于频繁访问。

Available Tools

3 tools
get_boss_login_statusC

Check whether the persistent Boss browser profile appears logged in.

Inputs: headless. Returns: result

open_boss_loginA

Open Boss Zhipin login page with the persistent browser profile.

Keep the opened browser window until you finish scanning the QR code. The profile is stored locally and reused by search tools.

Inputs: headless. Returns: result

search_boss_jobsB

Search Boss Zhipin jobs by keyword and keep postings from recent days.

Inputs: keyword (required), city, days, pages, +4 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a distinct and clear purpose: checking login status, opening the login page, and searching jobs. No overlap in functionality.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun snake_case pattern (get_boss_login_status, open_boss_login, search_boss_jobs), making them predictable.

    Tool Count4/5

    Three tools is minimal but reasonable for a focused job-hunting assistant covering login and search. Could be slightly expanded but not undersized.

    Completeness2/5

    The tool surface lacks essential job-hunting operations like viewing job details, applying, or saving jobs. Only login and search are covered, leaving significant gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      C
      maintenance
      Automates job searching and initial communication on the Boss Zhipin platform by parsing resumes and matching them with relevant job listings. It includes anti-bot detection features and supports automated messaging to HR representatives through various MCP clients.
      10
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with the Boss直聘 recruitment platform to search for jobs and send automated greetings to recruiters. It features automatic QR code login and security verification using Playwright for seamless session management.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides MCP tools for job discovery, welfare filtering, resume and AI-assisted applications, and recruiter workflows across Chinese job platforms such as BOSS Zhipin, Zhilian, and 51job.
      MIT