Google Jobs MCP Server
一个模型上下文协议 (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
🚀 快速入门
安装依赖项:
npm install配置环境:使用以下内容修改您的
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"
}
}
}构建服务器:
npm run build启动服务器:
npm start故障排除
API 密钥问题:
验证配置中的密钥
在 SERP API 仪表板中检查关键状态
确认密钥有剩余配额
搜索问题:
验证搜索参数格式
检查网络连接
验证国家/语言代码支持
📦安装
Related MCP server: Scrapeless MCP Server
通过 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💻 技术栈
📖 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创建并维护。
Available Tools
1 toolsearch_jobsB
Google Jobs API search tool.
Supported search parameters:
Basic Search: Job title or keywords
Location: City or region
Time Filter: Recently posted jobs
Job Type: Full-time, part-time, contract, internship
Salary Range: Filter by compensation
Geographic Range: Set search radius
Language: Multi-language support
All parameters except 'query' are optional and can be freely combined.
Inputs: query (required), location, posted_age, employment_type, +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The single tool 'search_jobs' has a clearly defined and distinct purpose for job searching.
The tool name 'search_jobs' follows a consistent verb_noun pattern. Since there is only one tool, there is no inconsistency to evaluate, and the naming is straightforward and descriptive.
A single tool is too few for a server named 'Google Jobs MCP Server', which implies a broader domain of job-related operations. While search is a core function, the lack of tools for actions like retrieving job details, applying, or managing saved jobs makes the set feel incomplete and thin.
The tool surface is severely incomplete for a jobs domain. It only provides search functionality, missing essential operations such as getting detailed job information, applying to jobs, saving or bookmarking jobs, or filtering by employer. This will likely cause agent failures when trying to perform common job-related tasks beyond basic searching.
Maintenance
Related MCP Connectors
A Model Context Protocol server for Wix AI tools
MCP server for Google search results via SERP API
Google Jobs listings with apply links and full descriptions. Paid, on Apify's hosted MCP.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Related MCP Servers
- AlicenseBqualityDmaintenanceA Model Context Protocol server that enables LLMs to perform web searches using Google's Custom Search API through a standardized interface.147MIT
- AlicenseCqualityCmaintenanceA Model Context Protocol server implementation that enables AI assistants like Claude to perform Google searches and retrieve web data directly through natural language requests.1329 npm170MIT
- FlicenseCqualityDmaintenanceA Model Context Protocol server that enables LLMs to perform Google searches via the Serper API, allowing models to retrieve current information from the web.1339-
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables AI assistants to perform web searches using Google Search API, returning up to 20 search results in JSON format.2Apache 2.0