mcp-jobs
🚀 零配置 的多平台职位聚合服务！基于 MCP 架构，支持从主流招聘网站获取职位信息，开箱即用，无需任何设置。
⚡ 30 秒快速开始
🚀 第一步：启动服务（零配置）
# 一行命令，立即启动
npx -y mcp-jobs
🤖 第二步：配置 AI 客户端
在您的 AI 客户端（如 Cursor、Claude Desktop）中添加：
- 服务名称:
mcp-jobs - 命令:
npx -y mcp-jobs - 环境变量: 留空
💬 第三步：开始使用
直接向 AI 助手说："搜索北京的前端开发职位"
就这么简单！ 🎉 无需注册、无需 API Key、无需配置文件。
🌟 核心特性
- 🔓 零门槛：无需 API Key，无需注册，无需配置
- 📦 开箱即用：一行命令即可启动完整服务
- 🔍 智能搜索：支持按职位名称、城市、薪资范围等条件筛选
- 🌐 多平台聚合：自动从多个主流招聘网站获取数据
- 📊 标准化输出：统一的数据格式，便于大模型处理
- ⚡ 实时更新：保证职位信息的时效性
- 🔧 可选增强：支持 API Key 解锁额外功能（完全可选）
📦 安装方式
🚀 即时运行（推荐）
无需安装，无需配置，立即使用：
# 一行命令，立即启动
npx -y mcp-jobs
🔧 全局安装（可选）
如果您需要频繁使用：
# 全局安装
npm install -g mcp-jobs
# 直接运行
mcp-jobs
📁 项目内安装（可选）
# 安装到项目依赖中
npm install mcp-jobs
# 或使用 yarn
yarn add mcp-jobs
# 或使用 pnpm
pnpm add mcp-jobs
🎯 使用说明
🚀 基础使用（零配置）
无需任何设置，立即开始：
# 启动服务
npx -y mcp-jobs
# 服务将自动提供以下功能：
# ✅ 职位搜索
# ✅ 职位详情获取
# ✅ 多平台数据聚合
# ✅ 标准化数据输出
就是这么简单！
🔧 高级配置（完全可选）
如果您需要额外的增强功能，可以选择性配置以下参数：
# 可选：复制配置模板
cp .env.example .env
# 可选：编辑配置文件，取消注释您需要的功能
# USERNAME=your_username # 可选：基础认证
# PASSWORD=your_password # 可选：基础认证
# 可选：爬虫配置
# CRAWLER_HEADLESS=true # 可选：无头模式 (调试时可设为 false)
# CRAWLER_TIMEOUT=30000 # 可选：页面超时时间 (毫秒)
# CRAWLER_VIEWPORT_WIDTH=1280 # 可选：浏览器视窗宽度
# CRAWLER_VIEWPORT_HEIGHT=800 # 可选：浏览器视窗高度
# CRAWLER_DEBUG=false # 可选：调试模式
可选配置说明
| 配置项 | 用途 | 是否必需 |
|---|---|---|
USERNAME | 基础认证用户名 | ❌ 可选 |
PASSWORD | 基础认证密码 | ❌ 可选 |
CRAWLER_HEADLESS | 浏览器无头模式 (true/false) | ❌ 可选 |
CRAWLER_TIMEOUT | 页面超时时间 (毫秒) | ❌ 可选 |
CRAWLER_VIEWPORT_WIDTH | 浏览器视窗宽度 | ❌ 可选 |
CRAWLER_VIEWPORT_HEIGHT | 浏览器视窗高度 | ❌ 可选 |
CRAWLER_DEBUG | 调试模式 (true/false) | ❌ 可选 |
💡 重要提示：所有配置都是完全可选的。服务在没有任何配置的情况下提供完整的核心功能。
🤖 AI 客户端配置
🚀 Cursor 配置（零配置）
最简配置（推荐）
- 打开 Cursor 设置
- 进入 Features > MCP Servers
- 点击 "+ Add New MCP Server"
- 输入以下信息：
- Name:
mcp-jobs - Type:
command - Command:
npx -y mcp-jobs
- Name:
JSON 配置方式
基础配置（开箱即用）：
{
"mcpServers": {
"mcp-jobs": {
"command": "npx",
"args": ["-y", "mcp-jobs"]
}
}
}
高级配置（可选增强）：
{
"mcpServers": {
"mcp-jobs": {
"command": "npx",
"args": ["-y", "mcp-jobs"],
"env": {
"USERNAME": "your-username",
"PASSWORD": "your-password"
}
}
}
}
💡 提示：推荐使用基础配置，已提供完整的职位搜索功能！
🤖 Claude Desktop 配置
零配置设置：
- 打开 Claude Desktop
- 点击左下角 Settings 图标
- 选择 "MCP Servers" 选项
- 点击 "Add New Server"
- 输入以下信息：
- Name:
mcp-jobs - Type:
command - Command:
npx -y mcp-jobs - Environment Variables: 留空（无需任何变量）
- Name:
就这样！ 无需 API Key，立即可用。
🚀 Windsurf 配置
基础配置（零设置）：
{
"mcpServers": {
"mcp-jobs": {
"command": "npx",
"args": ["-y", "mcp-jobs"]
}
}
}
🚀 Cline 配置
基础配置（零设置）：
mcp:
servers:
mcp-jobs:
command: npx
args: ["-y", "mcp-jobs"]
🔧 高级配置（完全可选）
⚠️ 重要提示：以下所有配置都是完全可选的！服务在无任何配置的情况下即可提供完整功能。
如果您需要自定义服务行为，可以选择性配置以下环境变量：
# 可选：MCP API 密钥（用于解锁高级功能）
# 可选：基础认证
# USERNAME=your-username
# PASSWORD=your-password
# 可选：自定义 MCP 服务地址
💡 再次提醒：无需任何配置即可使用完整的职位搜索功能！
🎯 立即开始使用
配置完成后（只需一行命令！），您就可以通过自然语言向 AI 助手描述职位搜索需求：
💬 使用示例
直接搜索职位：
- "搜索上海地区的前端开发工程师职位"
- "查找北京的数据分析师岗位，要求 3 年以上经验"
- "找出杭州地区薪资最高的产品经理职位"
获取职位详情：
- "获取这个职位的详细信息：[职位链接]"
- "分析这个岗位的要求和薪资情况"
智能分析：
- "比较不同城市的同类职位薪资水平"
- "总结当前市场上热门的技能要求"
🚀 零门槛体验：无需学习复杂的 API 调用，直接用自然语言即可获得专业的职位搜索服务！
大模型会自动调用 mcp-jobs 服务获取相关信息并为您展示结果。
🔧 调试和开发
🐛 调试模式
如果您需要调试爬虫行为或开发新功能，可以启用调试模式：
# 启用可视化浏览器窗口（非无头模式）
CRAWLER_HEADLESS=false npx -y mcp-jobs
# 启用调试日志
CRAWLER_DEBUG=true npx -y mcp-jobs
# 组合使用
CRAWLER_HEADLESS=false CRAWLER_DEBUG=true npx -y mcp-jobs
⚙️ 自定义浏览器配置
# 自定义视窗大小
CRAWLER_VIEWPORT_WIDTH=1920 CRAWLER_VIEWPORT_HEIGHT=1080 npx -y mcp-jobs
# 增加超时时间（适用于慢速网络）
CRAWLER_TIMEOUT=60000 npx -y mcp-jobs
# 自定义用户代理
CRAWLER_USER_AGENT="Custom Bot 1.0" npx -y mcp-jobs
📝 配置优先级
配置的优先级从高到低：
- 站点特定配置 - 在
crawlerConfig.ts中为特定网站设置的browserConfig - 环境变量 - 通过
CRAWLER_*环境变量设置 - 默认配置 - 系统默认值
🌟 为什么选择 MCP Jobs？
✅ 真正的零门槛
- 🚫 无需注册账号 - 不用填写任何个人信息
- 🚫 无需复杂配置 - 一行命令即可启动
- 🚫 无需学习文档 - 直接用自然语言交互
⚡ 立即可用
- 📦 开箱即用，无需任何准备工作
- 🔍 完整的职位搜索功能
- 🌐 多平台数据聚合
- 📊 标准化数据输出
🛡️ 可靠稳定
- 🔄 自动重试机制
- ⚠️ 优雅的错误处理
- 📈 实时数据更新
- 🔧 可选的高级功能
📋 使用须知
- 完全免费 - 核心功能无需任何费用
- 遵守规范 - 请遵守各招聘平台的使用协议
- 合理使用 - 建议控制请求频率，避免过度访问
- 系统要求 - Node.js >= 16.0.0
开源协议
获取帮助
如果您在使用过程中遇到任何问题，请通过以下方式获取帮助：
- 提交 GitHub Issue