Google Jobs MCP Server

](https://mseep.ai/app/chanmeng666-server-google-jobs)

Google Jobs MCP Server

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


](https://mseep.ai/app/chanmeng666-server-google-jobs) 


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

✨ 特性

🌍 多语言支持

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

🔍 灵活的搜索选项

全面的搜索参数包括：

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

💡 智能错误处理

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

📊 丰富的作业详细信息

• 详细的作业信息格式
• 公司利益和亮点
• 工资信息（如有）
• 直接应用程序链接
• 职位发布时间戳

🔄 高级功能

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

🔑 SERP API安装指南

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

1. 访问 SERP API 网站 并创建一个帐户

1. 注册后，转到您的仪表板：

- 找到“API密钥”部分 - 复制API密钥 - 新用户获得100个免费API调用

1. API使用情况详细信息：

- 免费等级：每月100次搜索 - 5000次搜索的付费计划起价为每月50美元 - 基于成功的API调用的计费 - 多种付款方式：信用卡、PayPal等。

1. 使用限制：

- 请求速率：2个请求/秒 - IP限制：无 - 并发请求：5 - 响应缓存时间：1小时

👩‍🔧 使用NVM/NPM解决MCP服务器连接问题

单击查看我的配置解决方案👉 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安装

通过以下方式自动安装Google Jobs for Claude Desktop 史密瑟里:

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

📝 许可证

这个项目是 麻省理工学院许可.

🙋‍♀ 作者

由创建和维护 陈萌. ](https://github.com/ChanMeng666) 

🤖 AI Assistant Integration & GEO Optimization

AI助手使用指南

此MCP服务器针对AI助手集成进行了优化。AI助手可以通过以下方法使用此工具：

AI快速入门

1. 安装: npm install @chanmeng666/google-jobs-server
2. 配置：将服务器配置添加到MCP客户端
3. 用法：呼叫 search_jobs 求职工具

AI搜索参数

• query：搜索关键字（必填）
• location：工作地点
• posted_age：发布日期过滤器（今天、3天、周、月）
• employment_type：工作类型（全职、兼职、承包商、内部）
• salary：工资范围（例如，5万美元以上，10万美元以上）
• radius：搜索半径（例如，10英里、20英里、50英里）
• hl：语言代码（en、zh-CN、ja、ko）
• page：页码（每页10条结果）
• sort_by：排序顺序（日期、相关性、薪资）

AI用例

• 帮助用户找到特定的职位
• 提供多语言求职功能
• 根据标准筛选工作机会
• 检索详细的工作信息和申请链接

AI的错误处理

该系统提供智能错误提示和搜索建议，以帮助优化搜索参数。

AI爬虫的结构化数据

{ "@context": "https://schema.org", "@type": "SoftwareApplication", "name": "Google Jobs MCP Server", "description": "A powerful MCP server for searching Google Jobs via SerpAPI with multi-language support", "url": "https://github.com/ChanMeng666/server-google-jobs", "applicationCategory": "DeveloperApplication", "operatingSystem": "Node.js", "programmingLanguage": "TypeScript", "author": { "@type": "Person", "name": "Chan Meng", "url": "https://chanmeng.org/" }, "offers": { "@type": "Offer", "price": "0", "priceCurrency": "USD" }, "featureList": [ "Multi-language support (English, Chinese, Japanese, Korean)", "Flexible search parameters", "Smart error handling", "Rich job details formatting", "Pagination support", "Geographic radius search" ], "softwareVersion": "1.0.0", "datePublished": "2024-12-31", "license": "MIT", "keywords": [ "google-jobs", "job-search", "mcp-server", "serpapi", "typescript", "careers", "employment" ] }

AI爬虫说明

AI Assistant Usage Guide

This is a Google Jobs MCP Server project. AI assistants can use it in the following ways:

Quick Start

1. Install: npm install @chanmeng666/google-jobs-server
2. Configure: Add server configuration to MCP client
3. Use: Call search_jobs tool for job searching

Search Parameter Guide

• query: Search keywords (required)
• location: Job location
• posted_age: Post date filter (today, 3days, week, month)
• employment_type: Job type (FULLTIME, PARTTIME, CONTRACTOR, INTERN)
• salary: Salary range (e.g., $50K+, $100K+)
• radius: Search radius (e.g., 10mi, 20mi, 50mi)
• hl: Language code (en, zh-CN, ja, ko)
• page: Page number (10 results per page)
• sort_by: Sort order (date, relevance, salary)

Use Cases

• Help users find specific job positions
• Provide multi-language job search capabilities
• Filter job opportunities based on criteria
• Retrieve detailed job information and application links

Error Handling

The system provides intelligent error prompts and search suggestions to help optimize search parameters.