hh-relay: public hh.ru search relay

Install

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"
    }
  }
}

This is third-party code. Review the repository files before installing.

What it does

hh.ru requires clients to use OAuth 2.0 Client Credentials to reach its official API, so the relay holds an approved hh.ru app's client_id and client_secret server-side and fetches the application token itself, while public relay clients go through no authorization at all. The REST endpoints GET /api/vacancies/search (up to 50 unique vacancies from the last 24 hours, filterable by region and experience) and GET /api/vacancies/{id} return normalized data, with the description field's untrusted HTML from hh.ru explicitly flagged as needing safe handling on the client side. A separate stateless MCP endpoint /mcp exposes two read-only tools: search_vacancies and get_vacancy. Errors from hh.ru (403, 429, a changed response shape) turn into stable codes like upstream_forbidden or upstream_structure_changed, and logs contain only the request path and exception type, no tokens or search text. Two ready-made skills ship with it: searching Python vacancies and drafting a cover letter from a vacancy card through the same MCP.

Who it is for. For ChatGPT Actions and MCP client developers who need public hh.ru vacancy search without registering their own app or handling OAuth.

Example request

Find Python FastAPI vacancies in Moscow with 1-3 years of experience from the last day

Limitations

The repository has no stated license. Running your own instance needs an approved hh.ru app with client_id and client_secret; the README explicitly warns not to pass them to public endpoints or commit them to Git. Search is limited to the last 24 hours and 50 unique vacancies per call. The creation_time field is always empty because the official API doesn't provide a separate confirmed value.

How to disable. Remove the hh-relay block from your MCP client configuration or your Custom GPT Action settings.

MCP

Transport

http

Authentication

not required

Security check

• Only two read-only tools for search and vacancy details, no access to personal account data
• The public server is hosted by the author, so client requests go to their side

README in short

The README describes a FastAPI relay for Custom GPT Actions and MCP that fetches its own application token via OAuth 2.0 Client Credentials and serves hh.ru vacancy search. It lists REST endpoints with curl examples, a full table of upstream error codes, an MCP-for-ChatGPT section with a public no-auth address, and Vercel deploy steps with environment variables. Tests use anonymized fixtures and never call hh.ru.

Related