Server Google Jobs

2 forks

3 stars

Free

What is server-google-jobs

server-google-jobs is a Model Context Protocol (MCP) server developed by ChanMeng666. It provides an efficient way to search for job listings on Google Jobs through integration with SerpAPI. This server is designed to offer flexible and comprehensive job search capabilities with support for multiple languages. It utilizes the latest technologies such as TypeScript and Node.js to deliver a robust and reliable service.

How to Use server-google-jobs

Using server-google-jobs involves a few straightforward steps to set up and operate:

Set Up the Environment: Install the necessary dependencies using Node Package Manager (npm). Configure your environment by creating a configuration file (claude_desktop_config.json) and including your SERP API key.
```
npm install
```
```
{
  "google-jobs": {
    "command": "path_to_node",
    "args": ["path_to_index.js"],
    "env": {
      "SERP_API_KEY": "your-api-key"
    }
  }
}
```
Build the Server: Compile the server using the build command to prepare it for operation.
```
npm run build
```
Start the Server: Launch the server to begin handling job search requests.
```
npm start
```

Key Features of server-google-jobs

🌍 Multi-Language Support

Automatically detects and supports multiple languages including English, Chinese, Japanese, and Korean.

🔍 Flexible Search Options

Offers a wide range of search parameters to refine job searches:
- Job title and keywords
- Location-based filtering with radius options
- Employment type (full-time, part-time, etc.)
- Salary range
- Post date and result sorting

💡 Smart Error Handling

Provides robust input validation and helpful error messages.
Includes suggestions for search refinements and handles rate limits gracefully.

📊 Rich Job Details

Displays detailed job information, including benefits, salary details, and direct application links.
Offers job posting timestamps for accurate information.

🔄 Advanced Features

Supports pagination and multiple sorting options.
Features geographic radius search and employment type filtering to enhance search precision.

server-google-jobs is a powerful tool for anyone looking to streamline their job search process. It is designed with user-friendliness and flexibility in mind, making it an ideal choice for developers and non-technical users alike.

Google Jobs MCP Server 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. 👉Try It Now!👈 屏幕截图 2024-12-31 183813 屏幕截图 2024-12-31 183754 屏幕截图 2024-12-31 180734 屏幕截图 2024-12-31 182106

✨ 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:

Visit SERP API website and create an account
After registration, go to your Dashboard:

Locate the "API Key" section
Copy your API key
New users get 100 free API calls

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.

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 👉

🚀 Quick Start

Install dependencies:

npm install

Configure environment: Modify your claude_desktop_config.json with the following content (adjust paths according to your system):

 "google-jobs": {
 "command": "D:\\Program\\nvm\\node.exe",
 "args": ["D:\\github_repository\\path_to\\dist\\index.js"],
 "env": {
 "SERP_API_KEY": "your-api-key"

Build the server:

npm run build

Start the server:

npm start

Troubleshooting

API Key Issues:

Verify key in configuration
Check key status in SERP API dashboard
Confirm key has remaining quota

Search Issues:

Validate search parameters format
Check network connectivity
Verify country/language code support

📦 Installation

Installing via

To install Google Jobs for Claude Desktop automatically via :

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

Manual Installation

@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

💻 Tech Stack

TypeScript NodeJS MCP

📖 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

# 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.

🙋‍♀ Author

Created and maintained by Chan Meng. GitHub LinkedIn

How to Use

To use the server-google-jobs, follow these steps:

Visit https://github.com/ChanMeng666/server-google-jobshttps://github.com/ChanMe...
Follow the setup instructions to create an account (if required)
Connect the MCP server to your Claude Desktop application
Start using server-google-jobs capabilities within your Claude conversations

Additional Information

Created

December 31, 2024

Company

ChanMeng666

Related MCP Servers

Start building your own MCP Server

Interested in creating your own MCP Server? Check out the official documentation and resources.

Learn More

Server Google Jobs

What is server-google-jobs

How to Use server-google-jobs

Key Features of server-google-jobs

🌍 Multi-Language Support

🔍 Flexible Search Options

💡 Smart Error Handling

📊 Rich Job Details

🔄 Advanced Features

✨ Features

🌍 Multi-Language Support

🔍 Flexible Search Options

💡 Smart Error Handling

📊 Rich Job Details

🔄 Advanced Features

🔑 SERP API Setup Guide

👩‍🔧 Solution for MCP Servers Connection Issues with NVM/NPM

🚀 Quick Start

Troubleshooting

📦 Installation

Installing via

Manual Installation

💻 Tech Stack

📖 API Documentation

🔧 Development

📝 License

🙋‍♀ Author

How to Use

Additional Information

Created

Company

Related MCP Servers

Web_Search_MCP

Upsonic

MCP DEEPwebresearch

Start building your own MCP Server