JobScout MCP

JobScout MCP

一款以隐私为先、可自带连接的多来源职位发现 MCP 服务。JobScout 为 AI Agent 提供一个经过标准化的职位池，并保留来源信息、进行确定性去重，还提供 AI/Web3 专项信号。

JobScout 有意止步于可信的职位发现。它不会存储简历、对候选人排名、联系雇主或申请职位。

为什么选择 JobScout

• 搜索已启用的服务提供方，不让单一来源代表整个市场。
• 将发现来源信息与规范的雇主申请渠道分开。
• 个别服务提供方出错时，仍可返回部分结果。
• 在获取服务提供方结果后应用远程办公和时效性筛选条件。
• 明确说明服务提供方无法应用哪些条件，而不是返回未限定范围的结果，假装它回答了问题。
• 在本地以确定性方式识别 AI、Agentic 和 Web3 信号。
• 将候选人身份和职业策略保留在 Career OS 等私有客户端中。

MCP 工具

工具	用途	网络
jobscout_list_sources	显示已配置的服务提供方、传输方式和覆盖范围	否
jobscout_search_jobs	搜索、标准化、筛选并去重已启用的职位公告板和聚合器	视服务提供方而定
jobscout_search_employers	仅搜索你配置的官方雇主 ATS 职位公告板（Greenhouse、Ashby、Lever），采用相同的筛选和披露字段，并提供声明式输出架构	仅限列出的公告板
jobscout_classify_jobs	检测所提供职位中的 AI、Agentic 和 Web3 信号	否
jobscout_deduplicate	标准化并合并所提供的 JobScout 记录	否
jobscout_briefing	将记录转换为适合简报的条目，包含简洁的 one_line 和最佳链接	否
jobscout_source_yield	报告各来源的贡献：唯一发现、重叠、雇主渠道覆盖情况、无日期记录和冲突	否

雇主 ATS 来源使用独立工具，因此按名称允许或拒绝工具的部署可以单独提供这些来源（例如仅供 Pro 使用），而无需改动免费搜索。免费搜索不会返回 ATS 来源的结果。jobscout_list_sources 会报告每个来源的 search_tool；如果免费搜索指定了雇主来源，则会将其列在 sources_elsewhere 中，而不会搜索该来源。要合并这两个职位池，请将它们传递给 jobscout_deduplicate。

两个 MCP 提示词可引导首次使用，且服务不会存储任何信息：jobscout_setup 会介绍如何启用服务提供方，以及各服务提供方会连接哪些对象；jobscout_find_jobs 会在每次搜索时收集职位、地点和远程办公偏好。如果运行搜索时没有启用任何服务提供方，系统会返回 setup_required: true 和相关指引，而不是误导性地返回空结果。结果还会报告 providers_disabled、records_rejected（包含 records_rejected_by_provider 细分）、undated_records、location_unfiltered 和 warnings，确保始终说明结果较少的原因。调用方可以使用 require_dated 和 include_descriptions，在召回率与确定性之间取舍，也可以移除不需要的不可信描述文本。

快速开始

需要 Node.js 22.13 或更高版本。

npm exec --yes --package=@sarutobi-sasuke/jobscout-mcp -- jobscout-mcp

启用公开 Himalayas 适配器的 Codex 示例：

codex mcp add jobscout --env JOBSCOUT_ENABLE_HIMALAYAS=true -- npm exec --yes --package=@sarutobi-sasuke/jobscout-mcp -- jobscout-mcp

MCP 主机也可以直接从 GitHub 运行此软件包，便于固定到某个提交或测试尚未发布的分支：

npm exec --yes --package=github:SarutobiSasuke8/jobscout-mcp -- jobscout-mcp

Claude Desktop、Cursor、本地开发、JobSpy 和故障排查请参阅安装指南。

在 ChatGPT、Codex 和 Claude 中安装

JobScout 有两种运行方式：通过 stdio 在本地运行（目前可用），或作为托管的 Streamable HTTP 服务运行。托管服务计划部署在 https://jobscout.mcprack.dev，并在 deploy/ 中提供现成的部署方案，但目前尚未部署。

本地运行，目前可用

• Codex： codex mcp add jobscout --env JOBSCOUT_ENABLE_HIMALAYAS=true -- npm exec --yes --package=@sarutobi-sasuke/jobscout-mcp -- jobscout-mcp
• Claude Code： claude mcp add jobscout --env JOBSCOUT_ENABLE_HIMALAYAS=true -- npm exec --yes --package=@sarutobi-sasuke/jobscout-mcp -- jobscout-mcp
• **Claude Desktop、Cursor 和其他 JSON 主机：**请参阅安装说明。

ChatGPT 和 Codex 插件（JobScout Discover）

目录软件包位于 plugins/jobscout-discover，并遵循 OpenAI 的插件格式。其清单和 mcp.json 指向 https://jobscout.mcprack.dev。它尚未上架：需要先部署该服务、为现有账户登录提供 OAuth、准备演示账户，并提交至门户审核。审核材料和完整的待办事项清单见 JobScout Discover；托管方案和运维手册见部署说明。

部署上线后，ChatGPT 开发者模式连接器或 Claude 自定义连接器可以指向 https://jobscout.mcprack.dev/mcp，Claude Code 则可以使用 claude mcp add --transport http jobscout https://jobscout.mcprack.dev/mcp。在此之前，请使用上面的本地安装方式。

套餐仅在运营方自有网站上销售。聊天中不提供结账功能。请参阅商业化说明。

数据源

数据源默认禁用，且彼此隔离，单个数据源的故障不会影响其他数据源。

数据源	传输方式	身份验证	备注
Himalayas	远程 MCP	可选	公开职位搜索；雇主链接仍应验证
We Work Remotely	公开 RSS 源	无	无关键词搜索端点；结果在客户端筛选
RemoteOK	公开 JSON 端点	无	最新职位列表源在客户端筛选；其 API 条款要求注明来源
Lenny's Job Board	HTTP 搜索 API	无	通过 TrueUp 未公开文档的端点提供产品、增长、设计和工程职位；职位板链接为发现链接
JobSpy	本地 Python 子进程	无	可选的 python-jobspy；可用性和网站条款各不相同
Greenhouse、Ashby、Lever	官方公开职位板 API	无	按列出的公司职位板选择启用；雇主的 ATS 职位申请 URL 为权威链接。仅由 jobscout_search_employers 搜索，不由 jobscout_search_jobs 搜索

数据源接口支持未来接入官方 ATS 和专业职位板适配器，而无需让核心功能依赖任何单一供应商。请参阅数据源文档。

AI 和 Web3 情报

每个标准化职位都可以包含确定性的 signals，涵盖 AI Agent、推理、评估、安全、Web3 协议、DeFi、DePIN、钱包、交易所、开发者基础设施、游戏和 Agent 商务。目前的技术检测包括 MCP、A2A、x402、LLM、RAG、Ethereum、Base 和 Solana。

这些是可检查的职位发现信号，而非不透明的候选人评分。请参阅职位情报。

可选的 Agent 操作指南

agents/jobscout-operator.md 为具备 MCP 能力的 Agent 提供安全、可复用的职位发现工作流和输出约定。它有意设计为一个功能完整的操作 Agent，而非捆绑虚构团队；其中不包含私人候选人档案或 Career OS 策略。

信任与安全

• 提供方响应不可信，并会经过架构验证。
• 只接受 HTTP(S) 职位 URL。
• 远程输出和子进程输出均设有明确的大小和时间限制。
• JobSpy 在无 shell 的情况下启动，并通过 stdin 接收类型化 JSON。
• 不会自动申请、自动登录、绕过 CAPTCHA、捕获凭据或规避代理。
• 用户仍需自行负责遵守提供方条款、确认职位时效、核实地点资格以及雇主申请渠道。

启用第三方提供方前，请阅读 SECURITY.md。

开发

npm install
cp .env.example .env
npm run check
npm run smoke:mcp
npm run check:plugin

协议冒烟测试使用官方 MCP Inspector。提供方贡献必须包含测试夹具、故障处理行为、来源信息处理和测试；请参阅 CONTRIBUTING.md。

验证

npm ci
npm test          # build, then every test under test/, offline
npm run check     # the full gate CI runs: lockfile, typecheck, lint, boundary, plugin, tests

测试不会访问网络。每个来源适配器（Greenhouse、Ashby、Lever、RemoteOK、We Work Remotely、Lenny's Job Board、Himalayas 以及 JobSpy 桥接输出）都会使用 test/fixtures/sources/ 中按记录格式构造的测试夹具进行测试。夹具中使用的公司和职位均为虚构内容，并会检查每个规范化字段，包括来源信息：来源、发现 URL、来源职位 ID 和 captured_at。test/dedupe-edge-cases.test.ts 涵盖同一职位从多个来源到达、拼写和 URL 变体、重新发布以及来源信息如何合并。npm test 会预加载 test/network-guard.ts；任何试图发起真实网络调用的测试都会失败，只允许访问环回地址。CI 会在每个拉取请求中于 Ubuntu 和 Windows 上运行 npm run check。

发布状态

下一版将包含更保守的重复项处理方式和流式信息流大小限制。请参阅可靠性证据和剩余门槛。在新版本打标签并发布之前，这些更改尚未发布。

已在 npm 上发布为 @sarutobi-sasuke/jobscout-mcp，并已在官方 MCP Registry 上发布为 io.github.SarutobiSasuke8/jobscout-mcp。GitHub 上的发布版本使用 vX.Y.Z 标签；CI 会携带来源证明发布到 npm。请参阅 RELEASING.md，了解发布流程和回滚顺序。

相关先例与许可证

JobSpy 作为可选的 MIT 许可依赖项使用，而非复制其代码。borgius/jobspy-mcp-server 展示了市场对 JobSpy MCP 封装的需求；本项目未复制其中的任何源代码。

JobScout MCP 使用 Apache-2.0 许可证。第三方依赖项保留其各自的许可证。