Server Google Jobs

🚀 Google Recruitment MCP Server

This is a Google recruitment tool server based on the Model Context Protocol (MCP). Here is the complete project documentation.

🚀 Quick Start

Installation Steps

1. Install dependencies:

npm install

2. Configure the environment: Modify your claude_desktop_config.json file and add the following content (adjust according to the system path):

{
  "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 project:

npm run build

4. Start the service:

npm start

✨ Features

Characteristics

• Support multi - language search
• Geographical location filtering
• Time range screening
• Job type screening
• Salary range limitation
• Automated pagination loading
• High - performance response

Use Cases

• Recruitment headhunters
• Human resources departments
• Self - employed job seekers
• Employment service agencies

📦 Installation

Environment Variables

• SERP_API_KEY: Required. An API Key obtained from the SERP official website.

Parameter Configuration

Add the following fields to claude_desktop_config.json:

"google-jobs": {
  "command": "...",
  "args": [...],
  "env": {
    "SERP_API_KEY": "..."
  }
}

💻 Usage Examples

Query Parameters

Achieve flexible recruitment searches through the following parameters:

• query: Search keywords (required)
• location: Work location (optional)
• posted_age: Posting duration (optional)
• employment_type: Employment type (optional)
• salary: Salary range (optional)
• radius: Geographical radius (optional)
• hl: Language code (optional)
• page: Pagination number (optional)
• sort_by: Sorting method (optional)

📚 Documentation

Troubleshooting

Common Errors

1. API Key verification failed:

   • Check if the API Key in the configuration file is correct.
   • Confirm that the API Key is activated in the SERP background.

2. Search results are empty:

   • Check the format and range of the query parameters.
   • Is the network connection normal?

🔧 Technical Details

📄 License

This project is licensed under the MIT License.

👨‍💻 Author Information

Created and maintained by Chan Meng.