server-google-jobs

🚀 Google 招聘 MCP 服务器

这是一个基于 Model Context Protocol (MCP) 的 Google 招聘工具服务器，可帮助用户实现多条件招聘搜索，为招聘猎头、人力资源部门、求职者等提供便捷的招聘信息查询服务。

🚀 快速开始

1. 安装依赖：

npm install

2. 配置环境： 修改你的 claude_desktop_config.json 文件，添加以下内容（根据系统路径调整）：

{
  "google-jobs": {
    "command": "D:\\Program\\nvm\\node.exe",
    "args": ["D:\\github_repository\\path_to\\dist\\index.js"],
    "env": {
      "SERP_API_KEY": "your-api-key"
    }
  }
}

3. 构建项目：

npm run build

4. 启动服务：

npm start

✨ 主要特性

• 多语言搜索：支持多语言搜索，满足不同地区用户需求。
• 地理位置过滤：可根据地理位置筛选工作岗位。
• 时间范围筛选：能按照发布时间范围进行岗位筛选。
• 工作类型筛选：支持按工作类型（全职、兼职等）进行筛选。
• 薪酬范围限制：可设置薪酬范围，精准查找符合期望的岗位。
• 自动化分页加载：自动进行分页加载，提升使用体验。
• 高性能响应：保证系统快速响应，提高查询效率。

使用场景

• 招聘猎头：高效搜索合适的候选人岗位。
• 人力资源部门：方便内部招聘工作开展。
• 自主求职者：精准查找符合自身需求的工作。
• 就业服务机构：为客户提供更全面的岗位信息。

📦 安装指南

环境变量

• SERP_API_KEY：必填，从 SERP 官网获取的 API Key。

参数配置

在 claude_desktop_config.json 中添加如下字段：

"google-jobs": {
  "command": "...",
  "args": [...],
  "env": {
    "SERP_API_KEY": "..."
  }
}

💻 使用示例

基础用法

通过以下参数实现灵活的招聘搜索：

• query：搜索关键词（必填）
• location：工作地点（可选）
• posted_age：发布时长（可选）
• employment_type：就业类型（可选）
• salary：薪资范围（可选）
• radius：地理半径（可选）
• hl：语言代码（可选）
• page：分页编号（可选）
• sort_by：排序方式（可选）

🔧 问题排查

常见错误

1. API Key 验证失败：
   • 检查配置文件中的 API Key 是否正确。
   • 确认 API Key 在 SERP 后台已激活。
2. 搜索结果为空：
   • 核对查询参数的格式和范围。
   • 检查网络连接是否正常。

🔧 技术细节

此项目使用的技术栈如下：

📄 许可证

此项目采用 MIT 许可证。

👨‍💻 作者信息

由 Chan Meng 创建和维护。