SF

strelov1/freehire-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

16 stars 6 forks 품질 84 트렌드 41MIT

MCP server over the freehire job API — 검색, 필터, 그리고 모든 MCP 호스트에서 IT 작업에 적용.

개요

MCP 서버에서 freehire job API. 그것은 모든 MCP 호스트 - Claude Desktop, Claude Code 또는 호환 에이전트 - 브라우저없이, 개인 API 키로 인증. Postings는 회사 경력을 쌓은 보드에서 직선으로 크롤링됩니다. - 3.3M +는 294K 회사 전역의 역할을 열고, 하나의 스키마로 정상화하고 스택, 고위, 지역 및 작업 모드 (라이브 인물) 태그. 그것은 Freehire CLI를 미러: 같은 API, 같은 자격 증명, 쉘 명령 대신 MCP 도구로 노출. read-only job search tools는 https://freehire.me/api/v1/mcp] (Streamable HTTP)에서 원격으로 제공됩니다. Claude Code에서 플러그인으로 설치하십시오. 다른 호스트에서, 사용자 정의 원격 커넥터로 URL을 추가합니다. 글로벌 설치가 필요 없습니다 - 호스트는 npx를 통해 실행됩니다. 호스트의 MCP 구성 (Claude Desktop → 또는 ~/.claude.json for Claude Code)에 추가하십시오. fhk ... 웹 앱의 키 생성 (freehire.me → 계정 메뉴 → ).

개요(AI 번역)

MCP 서버 일 API. 그것은 어떤 MCP 호스트를하자 — Claude Desktop, Claude Code, 또는 호환 에이전트 — ** 연구, 필터 및 IT 작업에 적용 ** 브라우저없이, 인증 개인 API 키. Postings는 회사 커리어 보드에서 직선으로 크롤링됩니다 - 3.3M + 오픈 294K 회사 전체에 걸쳐 역할, 하나의 스키마로 정상화하고 스택, 고위성 태그, 지역 및 작업 모드 (라이브 인물).

그것은 freehire CLI를 미러: 동일한 API, 동일한 자격 증명, 쉘 명령 대신 MCP 도구로 노출.

설치

Hosted endpoint (설치 없음, 키 없음)

읽기 전용 구직 도구도 원격으로 제공됩니다. https://freehire.me/api/v1/mcp (Streamable HTTP). Claude Code에서 플러그인으로 설치하십시오.

다른 호스트에서, 사용자 정의 원격 커넥터로 URL을 추가합니다.

로컬 서버 (npm)

글로벌 설치가 필요 없습니다 - 호스트는 npx를 통해 실행됩니다. 호스트의 MCP에 추가 구성 (Claude Desktop → ** 설정 → 개발자 → 편집 구성**, 또는 ~/.claude.json 클레드 코드의 경우:

웹 앱의 fhk_… 키 생성 (freehire.me → 계정 메뉴 → ** API 키**). 이미 프리히어 CLI(freehire auth login])를 사용한다면, **[T5]]**를 사용할 수 있습니다

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

freehire MCP server

An MCP server over the freehire job API. It lets any MCP host — Claude Desktop, Claude Code, or a compatible agent — search, filter, and apply to IT jobs without a browser, authenticating with a personal API key. Postings are crawled straight from company career boards — 3.3M+ open roles across 294K companies, normalized into one schema and tagged with stack, seniority, region and work mode (live figures).

It mirrors the freehire CLI: same API, same credentials, exposed as MCP tools instead of shell commands.

Install

Hosted endpoint (no install, no key)

The read-only job search tools are also served remotely at https://freehire.me/api/v1/mcp (Streamable HTTP). In Claude Code, install it as a plugin:

/plugin install freehire --marketplace strelov1/freehire-mcp

In other hosts, add the URL as a custom remote connector.

Local server (npm)

No global install needed — the host runs it via npx. Add it to your host’s MCP configuration (Claude Desktop → Settings → Developer → Edit config, or ~/.claude.json for Claude Code):

{
  "mcpServers": {
    "freehire": {
      "command": "npx",
      "args": ["-y", "freehire-mcp"],
      "env": { "FREEHIRE_TOKEN": "fhk_xxxxxxxx" }
    }
  }
}

Create the fhk_… key in the web app (freehire.me → account menu → API keys). If you already use the freehire CLI (freehire auth login), you can omit env — the server reads the same ~/.freehire/creds.json.

Authentication

The token and API base URL resolve with precedence env → ~/.freehire/creds.json → default https://freehire.me:

What Sources
Token FREEHIRE_TOKEN → creds file
API base URL FREEHIRE_API_URL → creds file → https://freehire.me

The server only reads the credentials file (it never writes it — logging in stays the CLI’s job). If no token is configured, tools return a clear “not authenticated” error rather than the server failing to start.

Tools

Tool Purpose
whoami Authenticated user (verify the key).
profile The candidate’s saved job-search profile (skills, preferences, contact-free CV).
facets The filter/skill vocabulary: every facet’s live values with counts. Call first.
search Keyword + facet job search; returns jobs with their full description as markdown and the total match count.
market_fit Score a skill list against live market demand (coverage + gaps).
job A single job’s full content by slug.
check_jobs_open Whether postings are still open (up to 50 slugs). Run it on a shortlist before presenting it.
similar_jobs Postings most similar to one posting.
GitHub에서 전체 README 보기

설치

npx -y freehire-mcp
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "freehire": { "command": "npx", "args": ["-y", "freehire-mcp"], "env": { "FREEHIRE_TOKEN": "fhk_xxxxxxxx" } } } }