convez.ai
MCP ServerBusca & PesquisaIntermediário
ChanMeng666

Google Jobs MCP Server

ChanMeng666/server-google-jobs

Busca avançada de vagas Google Jobs via MCP com suporte multilíngue

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que integra busca de vagas do Google Jobs via SerpAPI, oferecendo suporte multilíngue e filtros avançados de pesquisa. Permite buscar vagas por título, localização, tipo de emprego, faixa salarial e data de publicação, com tratamento robusto de erros e paginação.

Instalação

$npx convez-ai ChanMeng666/server-google-jobs

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
25
Forks
10
Acompanhando
1
Saúde
100%
Último commit
há 2 semanas
Versão
—
Issues abertas
5
Contribuidores
7

Casos de uso

  • Integrar busca de empregos em aplicações Claude
  • Automatizar pesquisas de vagas por critérios específicos
  • Construir assistentes de recrutamento ou carreira

Veredito

MCP server bem estruturado com integração SerpAPI funcional e suporte multilíngue. Implementação sólida para buscas de emprego, embora dependa de chave API externa paga e foco limitado a Google Jobs apenas.

README

A tradução para o português deste README ainda está na fila.

MseeP.ai Security Assessment Badge

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.

Ask DeepWiki

MseeP.ai Security Assessment Badge Verified on MseeP

👉Try It Now!👈

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

屏幕截图 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:

  1. Visit SERP API website 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:
npm install
  1. 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"
    }
  }
}
  1. Build the server:
npm run build
  1. Start the server:
npm start

Troubleshooting

  1. API Key Issues:
  • Verify key in configuration
  • Check key status in SERP API dashboard
  • Confirm key has remaining quota
  1. 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:

npx -y @smithery/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

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.

OPENAI_API_KEY=your-key  npx mcp-eval src/evals/evals.ts src/index.ts

💻 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

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

AI Crawler Instructions


Ver o original no GitHub

Bom para

Relacionados