Skip to main content
Glama
ChanMeng666

Google Jobs MCP Server

by ChanMeng666

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

询问 DeepWiki

👉立即尝试!👈

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

屏幕截图 2024-12-31 183813

屏幕截图 2024-12-31 183754

屏幕截图 2024-12-31 180734

屏幕截图 2024-12-31 182106

✨ 特点

🌍 多语言支持

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

🔍 灵活的搜索选项

综合搜索参数包括:

  • 职位名称和关键词

  • 带半径过滤的位置

  • 工作类型(全职、兼职等)

  • 薪资范围过滤器

  • 发布日期过滤

  • 结果排序

💡 智能错误处理

  • 全面的输入验证

  • 有用的错误消息和建议

  • 自动搜索优化建议

  • 速率限制处理

📊 丰富的职位详情

  • 详细职位信息格式

  • 公司福利和亮点

  • 薪资信息(如有)

  • 直接申请链接

  • 职位发布时间戳

🔄 高级功能

  • 分页支持

  • 多种排序选项

  • 地理半径搜索

  • 就业类型过滤

🔑 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. 搜索问题:

  • 验证搜索参数格式

  • 检查网络连接

  • 验证国家/语言代码支持

📦安装

Related MCP server: MCP Server for Google Search

通过 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

运行评估

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

OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts

💻 技术栈

TypeScriptNodeJS微胶囊钙

📖 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创建并维护。 GitHub LinkedIn

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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ChanMeng666/server-google-jobs'

If you have feedback or need assistance with the MCP directory API, please join our Discord server