
strelov1/freehire-mcp
Developer toolsこのページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る
無料のジョブ 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. |
インストール
npx -y freehire-mcp設定
{
"mcpServers": {
"freehire": {
"command": "npx",
"args": ["-y", "freehire-mcp"],
"env": { "FREEHIRE_TOKEN": "fhk_xxxxxxxx" }
}
}
}