SF

strelov1/freehire-mcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

16 stars 6 forks 品質 84 トレンド 41MIT

無料のジョブ API 上で MCP サーバー — MCP ホストから IT ジョブを検索、フィルタリング、適用します.

概要

無料のジョブ API 上で MCP サーバー。 MCP ホスト — Claude デスクトップ、Claude コード、または互換性のあるエージェント — ブラウザーなしで、個人 API キーで認証できます。 投稿は、会社のキャリアボードから直接クロールされます。 — 3.3M + は294K企業全体での役割を開き、1つのスキーマに正規化し、スタック、シニア、地域、作業モード(ライブ数字)でタグ付けされています。 これは、シェルコマンドの代わりにMCPツールとして公開された、同じAPI、同じ認証情報を、Freehire CLI:同じAPIをミラーリングします。 読み取り専用ジョブ検索ツールもリモートで[https://freehire.me/api/v1/mcp] (実行可能なHTTP) で提供しています。 Claudeコードでは、プラグインとしてインストールします。 他のホストでは、URLをカスタムリモートコネクターとして追加します。 インストール不要 — ホストは npx で実行されます。 ホストの MCP 設定 (Claude デスクトップ → 、Claude コードの ~/.claude.json ) に追加します。 ウェブアプリ(freehire.me→アカウントメニュー→)でfhk ...キーを作成します.

概要(AI 翻訳)

Freehire 上の MCP サーバー ジョブ API MCP ホスト — Claude デスクトップ、Claude コード、または互換性のあるエージェント — ブラウザなしでITジョブを検索、フィルタリング、および適用、認証 個人的な API キー。 投稿は、会社キャリアボードから直接クロールされます — 3.3M + オープン 294K企業を横断する役割は、1つのスキーマに正規化し、積み重ね、優先順位とタグ付けされ、 地域と作業モード(ライブ図)

それはフリーハイルCLIを映します: シェルコマンドの代わりにMCPツールとして公開された同じAPI、同じ認証情報。

インストール

ホストエンドポイント(インストールなし、キーなし)

読み取り専用のジョブ検索ツールもリモートで提供 [[https://freehire.me/api/v1/mcp] (実行可能なHTTP)。 Claudeコードでは、プラグインとしてインストールします。

他のホストでは、URLをカスタムリモートコネクターとして追加します。

##ローカルサーバ(npm)

グローバルインストール不要 — ホストは [npx]] で実行します。 ホストのMCPに追加 設定(Claude Desktop → Settings → Developer → config を編集するか、 [~/.claude.json クロードコードの場合:

ウェブアプリ(freehire.me→アカウントメニュー→APIキー)で[[fhk_…キーを作成します。 Freehire CLI ([freehire auth login]) を既に使用している場合は、[env]** を省略できます

このページは 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" } } } }