Google Jobs MCP Server

Реализация сервера Model Context Protocol (MCP), которая обеспечивает возможности поиска Google Jobs через интеграцию SerpAPI. Имеет многоязыковую поддержку, гибкие параметры поиска и интеллектуальную обработку ошибок.

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

✨ Особенности

🌍 Поддержка нескольких языков

Полная поддержка локализации для английского, китайского, японского и корейского языков с автоматическим определением языка и резервным вариантом.

🔍 Гибкие параметры поиска

Комплексные параметры поиска, включая:

• Должность и ключевые слова
• Местоположение с фильтрацией по радиусу
• Тип занятости (полная, неполная занятость и т.д.)
• Фильтры диапазона зарплат
• Фильтрация даты публикации
• Сортировка результатов

💡 Умная обработка ошибок

• Комплексная проверка входных данных
• Полезные сообщения об ошибках и предложения
• Автоматические предложения по уточнению поиска
• Обработка ограничения скорости

📊 Подробная информация о работе

• Подробное форматирование информации о вакансии
• Преимущества и особенности компании
• Информация о зарплате (при наличии)
• Прямые ссылки на приложения
• Временные метки размещения вакансий

🔄 Расширенные функции

• Поддержка пагинации
• Несколько вариантов сортировки
• Поиск по географическому радиусу
• Фильтрация по типу занятости

🔑 Руководство по настройке API SERP

Перед началом работы вам необходимо получить ключ API SERP:

1. Посетите сайт SERP API и создайте учетную запись.
2. После регистрации перейдите в свою панель управления:
   • Найдите раздел «Ключ API».
   • Скопируйте свой ключ API
   • Новые пользователи получают 100 бесплатных вызовов API
3. Подробности использования API:
   • Бесплатный уровень: 100 поисков в месяц
   • Платные планы начинаются от 50 долларов в месяц за 5000 поисков.
   • Выставление счетов на основе успешных вызовов API
   • Несколько способов оплаты: кредитная карта, PayPal и т. д.
4. Ограничения по использованию:
   • Скорость запросов: 2 запроса/секунду
   • Ограничения по IP: нет
   • Одновременные запросы: 5
   • Время кэширования ответа: 1 час

👩‍🔧 Решение проблем с подключением MCP-серверов с помощью NVM/NPM

Нажмите, чтобы просмотреть мое решение по конфигурации 👉 https://github.com/modelcontextprotocol/servers/issues/76

🚀 Быстрый старт

1. Установить зависимости:

2. Настройте среду: Измените файл claude_desktop_config.json следующим образом (измените пути в соответствии с вашей системой):

3. Сборка сервера:

4. Запустите сервер:

Поиск неисправностей

1. Ключевые проблемы API:

• Проверьте ключ в конфигурации
• Проверьте ключевой статус на панели инструментов SERP API
• Подтвердите, что у ключа есть оставшаяся квота

2. Проблемы поиска:

• Проверить формат параметров поиска
• Проверьте сетевое подключение
• Проверьте поддержку кода страны/языка

📦 Установка

Установка через Smithery

Чтобы автоматически установить Google Jobs для Claude Desktop через Smithery :

Ручная установка

@chanmeng666/google-jobs-server

Запуск оценок

Пакет evals загружает клиент mcp, который затем запускает файл index.ts, поэтому нет необходимости перестраиваться между тестами. Вы можете загрузить переменные среды, указав префикс команды npx. Полную документацию можно найти здесь .

💻 Технологический стек

📖 API-документация

Сервер реализует протокол контекста модели и предоставляет инструмент поиска работы со следующими параметрами:

• query : Строка поискового запроса (обязательно)
• location : Место работы (необязательно)
• posted_age : Фильтр по дате публикации (необязательно)
• employment_type : Фильтр по типу работы (необязательно)
• salary : Фильтр диапазона зарплат (необязательно)
• radius : Географический радиус поиска (необязательно)
• hl : Код языка (необязательно)
• page : Номер страницы (необязательно)
• sort_by : Порядок сортировки (необязательно)

🔧 Развитие

📝 Лицензия

Этот проект имеет лицензию MIT .

🙋‍♀ Автор

Создано и поддерживается Чан Мэн .