YubHub

YubHub MCP サーバー

キャリアページを構造化された求人フィードに変換します。Claude、Cursor、または任意の MCP クライアントから利用できます。

---

クイックスタート

YubHub の API、フィード、およびこのサーバーの開発者向けドキュメントは、yubhub.co/developers にあります。

まず、Pro Publisher プランの YubHub アカウントが必要です。このサーバーでは API キーを使用します。アカウントページにアクセスして、User ID と API key（必須）を確認してください。

Claude Desktop

Claude Desktop の設定ファイルを開きます。

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

"mcpServers" の中に次のブロックを追加します。

{
  "mcpServers": {
    "yubhub": {
      "command": "npx",
      "args": ["-y", "@houtini/yubhub"],
      "env": {
        "YUBHUB_USER_ID": "your-user-id",
        "YUBHUB_API_KEY": "yh_your_api_key_here"
      }
    }
  }
}

Claude Desktop を再起動します。これで完了です。Claude に「YubHub のフィードを一覧表示して」と頼めば、データが表示されるはずです。

Cursor / VS Code

同様に、MCP 設定に設定を追加し、同じ環境変数を指定して npx -y @houtini/yubhub を実行するよう設定します。

できること

YubHub はキャリアページを監視します。企業の求人 URL を指定すると、募集中のすべての職種を検出して求人情報をスクレイピングし、AI で情報を補完（タイトルの正規化、カテゴリのタグ付け、給与の抽出、企業調査）して、XML フィードとして公開します。

この MCP サーバーを使えば、AI アシスタント内からこのワークフローを完全に制御できます。フィードの作成、実行の開始、求人の確認、ダッシュボードの表示、市場統計の閲覧が可能です。ブラウザーのタブを開く必要はありません。

パイプライン

Careers page URL
  → Discovery (ATS API / sitemap / crawl)
    → Scraping (page content extraction)
      → Enrichment (AI structuring + company research)
        → XML feed (ready for job boards, aggregators, your own site)

対応する ATS プラットフォームには、Greenhouse、Lever、Workable、Workday、Oracle HCM、SmartRecruiters、Ashby、Pinpoint、Phenom などがあります。公開 API を提供するプラットフォーム（Greenhouse、Lever、Workable、Pinpoint）では、検出時のスクレイピングを完全に省略し、直接情報を補完します。

ツール

4 つの分野にわたる 22 個のツールがあります。

フィード管理

ツール	機能
list_feeds	すべての求人フィードを取得します
create_feed	キャリアページの URL からフィードを作成します
get_feed	実行履歴や求人件数など、フィードの詳細を取得します
show_feed_dashboard	1 つのフィードのインタラクティブなビジュアルダッシュボードを表示します
show_all_feeds_dashboard	すべてのフィード、統計、XML リンクをまとめた概要ダッシュボードを表示します
trigger_feed_run	求人の検出を開始します
update_feed	フィード名、タグ、またはソース URL を変更します
delete_feed	フィードとその求人をすべて削除します
delete_jobs	フィードの求人をすべて削除します（フィードは保持されます）

スケジュール

ツール	機能
get_feed_schedule	自動実行のスケジュールと次回の実行時刻を確認します
enable_feed_auto_run	自動実行を有効にします（デフォルト：毎週）
disable_feed_auto_run	自動実行を無効にします

求人

ツール	機能
list_jobs	フィードの求人を一覧表示します。ステータスで絞り込むこともできます
get_job	タイトル、企業、勤務地、給与、スキル、説明など、求人の詳細を取得します
retry_failed_jobs	失敗した求人を再試行のためにキューに追加します

市場統計

ツール	説明
get_stats_overview	概要データ：求人総数、企業数、稼働中のフィード数
get_top_companies	求人数と最近の活動状況に基づく企業ランキング
get_categories	分野別の求人数と経験レベルの内訳
get_top_titles	求人数が多い職種名
get_title_trends	需要が増加または減少している職種名（2週間の比較）
get_work_arrangements	リモート、ハイブリッド、出社の割合
get_experience_levels	初級、中級、上級の割合

環境変数

変数	必須	説明
YUBHUB_USER_ID	はい	YubHub のユーザー ID
YUBHUB_API_KEY	はい	アカウントページで取得できる API キー
YUBHUB_ADMIN_API_URL	いいえ	API エンドポイント（デフォルトは https://api.yubhub.co）

会話例

あなた： Mercedes F1 の採用情報（https://www.mercedesamgf1.com/careers）のフィードを作成してください。

Claude： 完了しました。ID feed_abc123 でフィードを作成しました。実行を開始しますか？

あなた： はい、お願いします。

Claude： 検出を開始しました。数分後に状況を確認します。

あなた： どうなりましたか？

Claude： 47件の求人が見つかりました。42件の拡充に成功し、5件は処理中です。カテゴリー別の内訳は次のとおりです……

ヒント： 最良の結果を得るには、フィードの作成時に求人の URL の例を指定してください。YubHub がそのサイトの求人掲載 URL のパターンを特定しやすくなり、検出精度が大幅に向上します。create_feed の省略可能な exampleJobUrl パラメーターとして渡すことができます。

開発

git clone https://github.com/houtini-ai/yubhub.git
cd yubhub
npm install
npm run build

サーバーは TypeScript を dist/ にコンパイルし、stdio MCP サーバーとして実行されます。ソースは src/ にあります。

src/
├── index.ts                # MCP server, tool definitions and handlers
├── api-client.ts           # REST client for the YubHub API
├── dashboard-generator.ts  # React-based interactive dashboard builder
└── types.ts                # TypeScript interfaces

ローカルでの実行

YUBHUB_USER_ID=your-id YUBHUB_API_KEY=yh_your_key node dist/index.js

または、npx を使わずに、ビルド済みの出力を MCP クライアントの接続先に指定してください。

コントリビューション

イシューやプルリクエストを歓迎します。ツールを追加したり、動作を変更したりする場合は、実際の YubHub アカウントでテストしてください。

リンク

• YubHub — プラットフォーム
• 開発者向けドキュメント — API、フィード、MCP
• ドキュメント — ドキュメント一式
• MCP 仕様 — Model Context Protocol

ライセンス

MIT — 詳細は LICENSE をご覧ください。