hh-relay: публичный релей поиска hh.ru

Установка

npx skillfoxx add mcp/hh-relay

claude mcp add --transport http hh-relay https://hh-relay.vercel.app/mcp

{
  "mcpServers": {
    "hh-relay": {
      "type": "http",
      "url": "https://hh-relay.vercel.app/mcp"
    }
  }
}

{
  "mcpServers": {
    "hh-relay": {
      "url": "https://hh-relay.vercel.app/mcp"
    }
  }
}

code --add-mcp '{"name":"hh-relay","type":"http","url":"https://hh-relay.vercel.app/mcp"}'

{
  "servers": {
    "hh-relay": {
      "type": "http",
      "url": "https://hh-relay.vercel.app/mcp"
    }
  }
}

codex mcp add hh-relay --url https://hh-relay.vercel.app/mcp

[mcp_servers.hh-relay]
url = "https://hh-relay.vercel.app/mcp"

gemini mcp add -s user -t http hh-relay https://hh-relay.vercel.app/mcp

{
  "mcpServers": {
    "hh-relay": {
      "httpUrl": "https://hh-relay.vercel.app/mcp"
    }
  }
}

{
  "mcpServers": {
    "hh-relay": {
      "serverUrl": "https://hh-relay.vercel.app/mcp"
    }
  }
}

{
  "mcpServers": {
    "hh-relay": {
      "type": "streamableHttp",
      "url": "https://hh-relay.vercel.app/mcp"
    }
  }
}

{
  "mcpServers": {
    "hh-relay": {
      "type": "streamable-http",
      "url": "https://hh-relay.vercel.app/mcp"
    }
  }
}

{
  "mcp": {
    "hh-relay": {
      "type": "remote",
      "url": "https://hh-relay.vercel.app/mcp"
    }
  }
}

{
  "context_servers": {
    "hh-relay": {
      "url": "https://hh-relay.vercel.app/mcp"
    }
  }
}

{
  "mcpServers": {
    "hh-relay": {
      "url": "https://hh-relay.vercel.app/mcp"
    }
  }
}

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

hh.ru требует у клиентов OAuth 2.0 Client Credentials для доступа к своему официальному API, поэтому relay сам хранит client_id и client_secret одобренного приложения hh.ru на сервере и получает application token, а публичные клиенты relay авторизацию не проходят вовсе. REST-эндпоинты GET /api/vacancies/search (до 50 уникальных вакансий за последние 24 часа, с фильтром по региону и опыту) и GET /api/vacancies/{id} отдают нормализованные данные, а поле description с недоверенным HTML от hh.ru явно помечено как требующее безопасной обработки на стороне клиента. Отдельный stateless MCP-эндпоинт /mcp дает два read-only инструмента: search_vacancies и get_vacancy. Ошибки от hh.ru (403, 429, смена схемы ответа) превращаются в стабильные коды вроде upstream_forbidden или upstream_structure_changed, а в логи попадает только путь запроса и тип исключения, без токенов и поискового текста. В комплекте два готовых скилла: поиск python-вакансий и подготовка сопроводительного письма по карточке вакансии через тот же MCP.

Для кого. Для разработчиков ChatGPT Actions и MCP-клиентов, которым нужен публичный поиск вакансий hh.ru без собственной регистрации приложения и OAuth-обвязки.

Пример запроса к агенту

Найди вакансии Python FastAPI в Москве с опытом 1-3 года за последние сутки

Ограничения

Лицензия в репозитории не указана. Нужно одобренное приложение hh.ru с client_id и client_secret, чтобы поднять собственный экземпляр, README прямо предупреждает не передавать их в публичные endpoint'ы и не класть в Git. Поиск ограничен последними 24 часами и 50 уникальными вакансиями за раз. Поле creation_time всегда пустое, потому что официальный API не отдает отдельное подтвержденное значение.

Как отключить. Уберите блок hh-relay из конфигурации MCP клиента или из настроек Custom GPT Action.

MCP

Транспорт

http

Авторизация

не нужна

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

• Только два read-only инструмента поиска и карточки вакансии, доступа к личным данным аккаунта нет
• Публичный сервер размещен у автора, запросы клиента уходят на его сторону

Коротко о README

README описывает FastAPI relay для Custom GPT Action и MCP, который сам получает application token по OAuth 2.0 Client Credentials и отдает поиск вакансий hh.ru. Перечислены REST-эндпоинты с примерами curl, полный список кодов ошибок upstream, раздел про MCP для ChatGPT с публичным адресом без авторизации и шаги деплоя на Vercel с переменными окружения. Тесты используют обезличенные fixtures и не обращаются к hh.ru.

Похожие