🚀 JobSpy MCP 服务器
JobSpy MCP 服务器是一个模型上下文协议 (MCP) 服务器，借助 JobSpy 工具，让 AI 助手（如Claude）能够在多个工作招聘平台上搜索职位，为 AI 处理提供便利。
🚀 快速开始
在使用 JobSpy MCP 服务器之前，请确保满足以下先决条件：
- Node.js 16 或更高版本
- Python 3.6 或更高版本
- 已安装的 JobSpy 工具
✨ 主要特性
- 可在 Indeed、LinkedIn、Glassdoor 等多个平台上搜索职位。
- 能根据关键词、地点和时间筛选职位信息。
- 返回结构化的数据，方便 AI 进行处理。
- 支持 JSON 和 CSV 格式的输出结果。
📦 安装指南
# 克隆仓库
git clone https://github.com/yourusername/jobspy-mcp-server.git
cd jobspy-mcp-server
# 安装依赖项
npm install
# 设置 JobSpy 环境
pip install jobspy
📚 详细文档
配置
服务器会自动查找 JobSpy 脚本的位置，并通过以下环境变量进行配置：
| 属性 | 详情 |
|---|---|
| JOBSPY_DOCKER_IMAGE | Docker 镜像名称 |
| JOBSPY_ACCESS_TOKEN | 访问令牌 |
设置方法
- 直接使用命令行
export JOBSPY_DOCKER_IMAGE=jobspy-mcp-server:latest
export JOBSPY_ACCESS_TOKEN=your_access_token
- 创建 .env 文件
在项目根目录下创建一个
.env文件，添加以下内容：
JOBSPY_DOCKER_IMAGE=jobspy-mcp-server:latest
JOBSPY_ACCESS_TOKEN=your_access_token
使用方法
启动服务器
npm start
与 Claude Desktop 集成
在配置文件中添加以下内容，以支持与 Claude 的集成：
{
"claude": {
"enabled": true,
"apiKey": "your_claude_api_key"
}
}
SSE 传输支持
服务器提供了实时流式处理功能。以下是连接示例代码：
const eventSource = new EventSource('http://localhost:9423/sse');
eventSource.addEventListener('message', function(e) {
console.log('数据:', e.data);
});
API 接口
搜索职位
curl -X POST "http://localhost:9423/api" \
-H "Content-Type: application/json" \
-d '{
"method": "search_jobs",
"params": {
"search_term": "软件工程师",
"location": "加利福尼亚州圣弗朗西斯科",
"site_names": "indeed,linkedin",
"results_wanted": 10,
"format": "json"
}
}'
可用工具
搜索职位（search_jobs）
参数说明
| 参数 | 类型 | 描述 | 默认值 |
|---|---|---|---|
| site_names | string | 要搜索的站点列表（indeed,linkedin,zip_recruiter,glassdoor,google,bayt,naukri） | "indeed" |
| search_term | string | 搜索关键词 | "软件工程师" |
| location | string | 工作地点 | "加利福尼亚州圣弗朗西斯科" |
| google_search_term | string | Google 特定的搜索词 | null |
| results_wanted | integer | 要求的结果数量 | 20 |
| hours_old | integer | 工作多久以前可以被考虑（小时） | 72 |
| country_indeed | string | Indeed 搜索所在的国家 | "USA" |
| linkedin_fetch_description | boolean | 是否抓取 LinkedIn 的职位描述（速度较慢） | false |
| format | string | 输出格式（json 或 csv） | "json" |
| output | string | 输出文件名（不带扩展名） | "jobs" |
示例用法
我需要查找波士顿的高级软件工程师职位，且在 24 小时内发布。
Docker 支持
构建镜像
docker build -t jobspy-mcp-server .
运行容器
docker run -p 9423:9423 jobspy-mcp-server
开发环境
开发模式运行
npm run dev
执行测试
npm test
⚠️ 重要提示
请确保在使用过程中，严格按照文档说明进行操作，以保证服务器的正常运行。同时，在翻译过程中，技术术语和代码示例保持不变，以保证准确性和可操作性。