Google Jobs MCP Server

一个模型上下文协议 (MCP) 服务器实现，通过 SerpAPI 集成提供 Google 职位搜索功能。它具有多语言支持、灵活的搜索参数和智能错误处理功能。

https://github.com/user-attachments/assets/8f6739e1-7db7-4171-88b4-59c6290a4c72

✨ 特点

🌍 多语言支持

完全本地化支持英语、中文、日语和韩语，并具有自动语言检测和回退功能。

🔍 灵活的搜索选项

综合搜索参数包括：

• 职位名称和关键词
• 带半径过滤的位置
• 工作类型（全职、兼职等）
• 薪资范围过滤器
• 发布日期过滤
• 结果排序

💡 智能错误处理

• 全面的输入验证
• 有用的错误消息和建议
• 自动搜索优化建议
• 速率限制处理

📊 丰富的职位详情

• 详细职位信息格式
• 公司福利和亮点
• 薪资信息（如有）
• 直接申请链接
• 职位发布时间戳

🔄 高级功能

• 分页支持
• 多种排序选项
• 地理半径搜索
• 就业类型过滤

🔑 SERP API 设置指南

在开始之前，您需要获取 SERP API 密钥：

1. 访问SERP API 网站并创建帐户
2. 注册后，转到您的仪表板：
   • 找到“API 密钥”部分
   • 复制您的 API 密钥
   • 新用户可获得 100 次免费 API 调用
3. API 使用详情：
   • 免费套餐：每月 100 次搜索
   • 付费计划起价为每月 50 美元，可进行 5000 次搜索
   • 根据成功的 API 调用计费
   • 多种付款方式：信用卡、PayPal等。
4. 使用限制：
   • 请求率：每秒 2 个请求
   • IP限制：无
   • 并发请求：5
   • 响应缓存时间：1小时

👩‍🔧 MCP 服务器与 NVM/NPM 连接问题解决方案

点击查看我的配置解决方案👉https: //github.com/modelcontextprotocol/servers/issues/76

🚀 快速入门

1. 安装依赖项：

2. 配置环境：使用以下内容修改您的claude_desktop_config.json （根据您的系统调整路径）：

3. 构建服务器：

4. 启动服务器：

故障排除

1. API 密钥问题：

• 验证配置中的密钥
• 在 SERP API 仪表板中检查关键状态
• 确认密钥有剩余配额

2. 搜索问题：

• 验证搜索参数格式
• 检查网络连接
• 验证国家/语言代码支持

📦安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Google Jobs：

手动安装

@chanmeng666/google-jobs-server

运行评估

evals 包会加载一个 mcp 客户端，然后运行 index.ts 文件，因此测试之间无需重新构建。您可以通过在 npx 命令前添加前缀来加载环境变量。完整文档可在此处找到。

💻 技术栈

📖 API 文档

服务器实现了模型上下文协议，并公开了一个具有以下参数的求职工具：

• query ：搜索查询字符串（必需）
• location ：工作地点（可选）
• posted_age ：发布日期过滤器（可选）
• employment_type ：工作类型过滤器（可选）
• salary ：薪资范围过滤器（可选）
• radius ：地理搜索半径（可选）
• hl ：语言代码（可选）
• page ：页码（可选）
• sort_by ：排序顺序（可选）

🔧 开发

📝 许可证

该项目已获得 MIT 许可。

🙋‍♀ 作者

由Chan Meng创建并维护。