Google Jobs MCP Server
by ChanMeng666
README.md
[](https://mseep.ai/app/chanmeng666-server-google-jobs)
<div align="center">
<h1><img src="public/server-google-jobs.svg" width="80px"><br/>Google Jobs MCP Server</h1>
<img src="https://img.shields.io/badge/TypeScript-007ACC?style=flat&logo=typescript&logoColor=white"/>
<img src="https://img.shields.io/badge/Node.js-43853D?style=flat&logo=node.js&logoColor=white"/>
<img src="https://img.shields.io/badge/MCP-Server-blue?style=flat"/>
<img src="https://img.shields.io/badge/License-MIT-brightgreen?style=flat"/>
<a href="https://smithery.ai/server/@chanmeng666/google-jobs-server"><img alt="Smithery Badge" src="https://smithery.ai/badge/@chanmeng666/google-jobs-server"></a>
</div>
<br/>
A Model Context Protocol (MCP) server implementation that provides Google Jobs search capabilities via SerpAPI integration. Features multi-language support, flexible search parameters, and smart error handling.
[](https://deepwiki.com/ChanMeng666/server-google-jobs)
[](https://mseep.ai/app/chanmeng666-server-google-jobs)
[](https://mseep.ai/app/df679562-50ad-4615-ac3c-a509c27583f0)
<a href="https://glama.ai/mcp/servers/bijbpfhrbx">
<img width="380" height="200" src="https://glama.ai/mcp/servers/bijbpfhrbx/badge" alt="Google Jobs Server MCP server" />
</a>
<br/>
[](https://smithery.ai/server/@chanmeng666/google-jobs-server)
<br/>
https://github.com/user-attachments/assets/8f6739e1-7db7-4171-88b4-59c6290a4c72
# ✨ Features
### 🌍 Multi-Language Support
Full localization support for English, Chinese, Japanese and Korean with automatic language detection and fallback.
### 🔍 Flexible Search Options
Comprehensive search parameters including:
- Job title and keywords
- Location with radius filtering
- Employment type (full-time, part-time, etc.)
- Salary range filters
- Post date filtering
- Results sorting
### 💡 Smart Error Handling
- Comprehensive input validation
- Helpful error messages and suggestions
- Automatic search refinement suggestions
- Rate limit handling
### 📊 Rich Job Details
- Detailed job information formatting
- Company benefits and highlights
- Salary information when available
- Direct application links
- Job posting timestamps
### 🔄 Advanced Features
- Pagination support
- Multiple sorting options
- Geographic radius search
- Employment type filtering
# 🔑 SERP API Setup Guide
Before getting started, you'll need to obtain a SERP API key:
1. Visit [SERP API website](https://serpapi.com/) and create an account
2. After registration, go to your Dashboard:
- Locate the "API Key" section
- Copy your API key
- New users get 100 free API calls
3. API Usage Details:
- Free tier: 100 searches per month
- Paid plans start at $50/month for 5000 searches
- Billing based on successful API calls
- Multiple payment methods: Credit Card, PayPal, etc.
4. Usage Limits:
- Request Rate: 2 requests/second
- IP Restrictions: None
- Concurrent Requests: 5
- Response Cache Time: 1 hour
# 👩🔧 Solution for MCP Servers Connection Issues with NVM/NPM
Click to view my configuration solution 👉 https://github.com/modelcontextprotocol/servers/issues/76
# 🚀 Quick Start
1. Install dependencies:
```bash
npm install
```
2. Configure environment:
Modify your `claude_desktop_config.json` with the following content (adjust paths according to your system):
```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"
}
}
}
```
3. Build the server:
```bash
npm run build
```
4. Start the server:
```bash
npm start
```
## Troubleshooting
1. API Key Issues:
- Verify key in configuration
- Check key status in SERP API dashboard
- Confirm key has remaining quota
2. Search Issues:
- Validate search parameters format
- Check network connectivity
- Verify country/language code support
# 📦 Installation
## Installing via Smithery
To install Google Jobs for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@chanmeng666/google-jobs-server):
```bash
npx -y @smithery/cli install @chanmeng666/google-jobs-server --client claude
```
## Manual Installation
<img src="https://cdn.simpleicons.org/npm/CB3837" height="14"/> <a href="https://www.npmjs.com/package/@chanmeng666/google-jobs-server">@chanmeng666/google-jobs-server</a>
```bash
# 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
```
## Running evals
The evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found [here](https://www.mcpevals.io/docs).
```bash
OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts
```
# 💻 Tech Stack
# 📖 API Documentation
The server implements the Model Context Protocol and exposes a job search tool with the following parameters:
- `query`: Search query string (required)
- `location`: Job location (optional)
- `posted_age`: Post date filter (optional)
- `employment_type`: Job type filter (optional)
- `salary`: Salary range filter (optional)
- `radius`: Geographic search radius (optional)
- `hl`: Language code (optional)
- `page`: Pagination number (optional)
- `sort_by`: Sort order (optional)
# 🔧 Development
```bash
# Run in development mode
npm run dev
# Run type checking
npm run typecheck
# Build for production
npm run build
```
# 📝 License
This project is [MIT licensed](./LICENSE).
# 🙋♀ Author
Created and maintained by [Chan Meng](https://chanmeng.org/).
[](https://github.com/ChanMeng666)
[](https://www.linkedin.com/in/chanmeng666/)
<details>
<summary>🤖 AI Assistant Integration & GEO Optimization</summary>
## AI Assistant Usage Guide
This MCP server is optimized for AI assistant integration. AI assistants can use this tool through the following methods:
### Quick Start for AI
1. **Installation**: `npm install @chanmeng666/google-jobs-server`
2. **Configuration**: Add server configuration to MCP client
3. **Usage**: Call the `search_jobs` tool for job searching
### Search Parameters for AI
- `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)
### AI 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 for AI
The system provides intelligent error prompts and search suggestions to help optimize search parameters.
## Structured Data for AI Crawlers
<script type="application/ld+json">
{
"@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"
]
}
</script>
## AI Crawler Instructions
<script type="text/llms.txt">
## 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.
</script>
</details>
---
<!-- CHAN MENG PERSONAL BRAND -->
<div align="center">
<a href="https://github.com/ChanMeng666" target="_blank">
<img src="./.github/brand/chan-meng-logo.svg" alt="Chan Meng" width="160" />
</a>
<p><strong>Chan Meng</strong><br/>Need a custom app like this one? I build them — let's talk.</p>
<a href="mailto:chanmeng.dev@gmail.com"><img src="https://img.shields.io/badge/Email-chanmeng.dev@gmail.com-EA4335?style=flat-square&logo=gmail&logoColor=white" alt="Email Chan Meng"/></a>
<a href="https://github.com/ChanMeng666"><img src="https://img.shields.io/badge/GitHub-ChanMeng666-181717?style=flat-square&logo=github&logoColor=white" alt="Chan Meng on GitHub"/></a>
</div>
<!-- /CHAN MENG PERSONAL BRAND -->
TDQS
B3.3/5.0
Scored across 1 tool
Disambiguation5/5
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.
Naming Consistency5/5
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.
Tool Count2/5
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.
Completeness2/5
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
ActivityInactive
ResponsivenessNo issues