HN Who is hiring

hn-hiring-mcp

月例の Hacker News **「Ask HN: Who is hiring?」**スレッドを、型付きの検索可能な求人 API に変換する MCP サーバーです。

毎月、何百もの企業が自由形式のコメントで求人情報を投稿しています。HN 独自の API では ID によるアイテムの取得しかできないため、*「給与を明記したヨーロッパのリモート Python 職」や「Rust の需要は伸びているか？」*といった質問はできません。このサーバーは各投稿を構造化フィールド（企業、職種、勤務地、リモート／ハイブリッド／出社、給与、ビザ、テクノロジー）に解析し、すべての MCP クライアントで使える読み取り専用ツールを 4 つ提供します。

ツール

ツール	機能
list_hiring_threads	最新の月例スレッドと ID、コメント数を返します。
search_jobs	1 か月分を検索します。フリーテキスト、location、work_mode、technologies、has_salary、visa_sponsorship、sort、limit／offsetに対応します。簡潔な概要を返します。
get_job	ID で指定した投稿の全文と解析済みフィールドを返します。
hiring_trends	月ごとに、各テクノロジーに言及した投稿の割合と、リモート／ハイブリッド／出社の件数を返します。

すべてのツールは入力および出力（structuredContent）の JSON Schema を宣言し、readOnlyHint が注釈されており、モデルが読み取れる明確なエラーを返します。

INVALID_INPUT: Unknown technology "cobol". Known technologies: Python, TypeScript, … For anything else use the free-text "query".
NOT_FOUND: HN item 49922569 is not a top-level job post in a "Who is hiring?" thread.
UPSTREAM_ERROR: HN API answered 503 while loading thread list. Try again later.

インストール

Node.js 22 以降が必要です。

Claude Code

claude mcp add hn-hiring -- npx -y hn-hiring-mcp

Claude Desktop：claude_desktop_config.jsonに追加します （macOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json）。

{
  "mcpServers": {
    "hn-hiring": {
      "command": "npx",
      "args": ["-y", "hn-hiring-mcp"]
    }
  }
}

その他の MCP クライアントでは、stdio サーバーとして npx -y hn-hiring-mcp を実行します。

使用例

Claude Desktop での簡略化したセッション（2026 年 10 月のデータ）：

あなた： 今月の Who is hiring から、給与を明記したリモートの Python 求人を探してください。

Claude が呼び出し search_jobs({ "technologies": ["Python"], "work_mode": "remote", "has_salary": true })

Claude： 2026 年 10 月のスレッドには、Python に言及するリモート求人が 37 件あり、そのうち 22 件は給与を明記しています。

1. NeuralFrame：シニアバックエンドエンジニア、医療データパイプライン（Python + Rust）。 リモート（米国限定、ビザスポンサーなし）、17 万～21 万ドル + 株式報酬。 HN の投稿
2. …

あなた： 今年、MCP の経験に対する需要は変化しましたか？

Claude が呼び出し hiring_trends({ "technologies": ["MCP", "Python", "TypeScript"], "months": 6 })

Claude： はい。MCP に言及する投稿は 5 月の 2.5% から 10 月には 4.5% に増加しました（6 月の最低時は 1.3%）。一方、Python（22～27%）と TypeScript（20～24%）は横ばいでした。

仕組み

• データソース： 公開されている HN Algolia API。Firebase API に約 400 件リクエストする代わりに、1 回のリクエストでスレッド全体（求人投稿約 250 件）を取得します。
• リクエストの配慮： リクエストは直列化され、少なくとも 1 秒間隔で送信されます。識別用の User-Agent を設定し、429／5xx の場合は 1 回再試行します。
• キャッシュ： 応答はメモリとディスク（~/.cache/hn-hiring-mcp。HN_HIRING_MCP_CACHE_DIR で変更可能。または off）にキャッシュされます。45 日より古いスレッドは変更されないため保持され、当月分は 1 時間ごとに更新されます。求人投稿への返信はキャッシュ前に除外されます。
• 解析（src/parse.ts）では、スレッド独自の慣例である Company | Role | Location | REMOTE | Salary に従い、— 区切り、括弧内の勤務地、- で記された給与範囲にも対応します。テクノロジーの検出（src/technologies.ts）は慎重に行われ、「Go ahead and apply」は Go と判定しません。投稿は自由形式のテキストのため、フィールドは可能な範囲での解析結果です。確認用として headline と hn_url は常に用意されています。

プライバシーと範囲

• 読み取り専用です。アカウントの作成やログインは不要で、本人に代わって応募することもありません。
• 投稿内のメールアドレス（name [at] company [dot] comやパズル形式のものを含む）は[email on HN]に置き換えられます。ユーザーはhn_urlから元の投稿にアクセスして応募します。
• 投稿者のHNユーザー名は返されません。

開発

npm install
npm test            # vitest, against recorded fixtures only; no network
npm run typecheck
npm run build
node scripts/smoke.ts search_jobs '{"query":"rust","limit":3}'   # live call through a real MCP client
node scripts/record-fixtures.ts                                   # refresh fixtures (anonymised, trimmed)

サーバーテストでは、メモリ内トランスポートを介して実際のMCP Clientをサーバーに接続するため、Claudeと同じ方法でスキーマ、検証、エラーマッピングをテストできます。

ライセンス

MIT