一个模型上下文协议 (MCP) 服务器实现,通过 SerpAPI 集成提供 Google 职位搜索功能。它具有多语言支持、灵活的搜索参数和智能错误处理功能。
https://github.com/user-attachments/assets/8f6739e1-7db7-4171-88b4-59c6290a4c72
✨ 特点
🌍 多语言支持
完全本地化支持英语、中文、日语和韩语,并具有自动语言检测和回退功能。
🔍 灵活的搜索选项
综合搜索参数包括:
职位名称和关键词
带半径过滤的位置
工作类型(全职、兼职等)
薪资范围过滤器
发布日期过滤
结果排序
💡 智能错误处理
全面的输入验证
有用的错误消息和建议
自动搜索优化建议
速率限制处理
📊 丰富的职位详情
详细职位信息格式
公司福利和亮点
薪资信息(如有)
直接申请链接
职位发布时间戳
🔄 高级功能
分页支持
多种排序选项
地理半径搜索
就业类型过滤
🔑 SERP API 设置指南
在开始之前,您需要获取 SERP API 密钥:
访问SERP API 网站并创建帐户
注册后,转到您的仪表板:
找到“API 密钥”部分
复制您的 API 密钥
新用户可获得 100 次免费 API 调用
API 使用详情:
免费套餐:每月 100 次搜索
付费计划起价为每月 50 美元,可进行 5000 次搜索
根据成功的 API 调用计费
多种付款方式:信用卡、PayPal等。
使用限制:
请求率:每秒 2 个请求
IP限制:无
并发请求:5
响应缓存时间:1小时
👩🔧 MCP 服务器与 NVM/NPM 连接问题解决方案
点击查看我的配置解决方案👉https: //github.com/modelcontextprotocol/servers/issues/76
🚀 快速入门
安装依赖项:
配置环境:使用以下内容修改您的
claude_desktop_config.json(根据您的系统调整路径):
构建服务器:
启动服务器:
故障排除
API 密钥问题:
验证配置中的密钥
在 SERP API 仪表板中检查关键状态
确认密钥有剩余配额
搜索问题:
验证搜索参数格式
检查网络连接
验证国家/语言代码支持
📦安装
Related MCP server: MCP Server for Google Search
通过 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创建并维护。