Google Jobs MCP Server

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Provides Google Jobs search capabilities through SerpAPI integration, allowing users to search for job listings with various filters including job title, location, employment type, salary range, and more.

一个模型上下文协议 (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. 安装依赖项:
npm install
  1. 配置环境:使用以下内容修改您的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" } } }
  1. 构建服务器:
npm run build
  1. 启动服务器:
npm start

故障排除

  1. API 密钥问题:
  • 验证配置中的密钥
  • 在 SERP API 仪表板中检查关键状态
  • 确认密钥有剩余配额
  1. 搜索问题:
  • 验证搜索参数格式
  • 检查网络连接
  • 验证国家/语言代码支持

📦安装

通过 Smithery 安装

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

npx -y @smithery/cli install @chanmeng666/google-jobs-server --client claude

手动安装

@chanmeng666/google-jobs-server

# Using npm npm i @chanmeng666/google-jobs-server # or npm install @chanmeng666/google-jobs-server # Using yarn yarn add @chanmeng666/google-jobs-server # Using pnpm pnpm add @chanmeng666/google-jobs-server

💻 技术栈

📖 API 文档

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

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

🔧 开发

# Run in development mode npm run dev # Run type checking npm run typecheck # Build for production npm run build

📝 许可证

该项目已获得 MIT 许可

🙋‍♀ 作者

Chan Meng创建并维护。

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

模型上下文协议服务器通过 SerpAPI 集成提供 Google Jobs 搜索功能,具有多语言支持、灵活的搜索参数和丰富的职位详情。

  1. 🌍 Multi-Language Support
    1. 🔍 Flexible Search Options
      1. 💡 Smart Error Handling
        1. 📊 Rich Job Details
          1. 🔄 Advanced Features
            1. 🔑 SERP API Setup Guide
              1. 👩‍🔧 Solution for MCP Servers Connection Issues with NVM/NPM
                1. 🚀 Quick Start
                  1. Troubleshooting
                2. 📦 Installation
                  1. Installing via Smithery
                  2. Manual Installation
                3. 💻 Tech Stack
                  1. 📖 API Documentation
                    1. 🔧 Development
                      1. 📝 License
                        1. 🙋‍♀ Author
                          ID: bijbpfhrbx