Mcp Jobs

mcp-jobs

🚀 設定不要のマルチプラットフォーム求人集約サービスです！MCP アーキテクチャに基づき、主要な求人サイトから求人情報を取得できます。すぐに使えて、設定は一切不要です。

⚡ 30 秒でクイックスタート

🚀 ステップ 1：サービスを起動する（設定不要）

# 一行命令，立即启动
npx -y mcp-jobs

🤖 ステップ 2：AI クライアントを設定する

お使いの AI クライアント（Cursor、Claude Desktop など）に以下を追加します：

• サービス名: mcp-jobs
• コマンド: npx -y mcp-jobs
• 環境変数: 空欄のまま

💬 ステップ 3：使い始める

AI アシスタントにそのままこう伝えます："北京のフロントエンド開発職を検索して"

これだけです！ 🎉 登録不要、API Key 不要、設定ファイルも不要です。

🌟 主な機能

• 🔓 導入のハードルなし：API Key 不要、登録不要、設定不要
• 📦 すぐに使える：1 行のコマンドでサービス全体を起動
• 🔍 スマート検索：職種名、都市、給与範囲などの条件で絞り込み可能
• 🌐 マルチプラットフォーム集約：複数の主要な求人サイトから自動的にデータを取得
• 📊 標準化された出力：統一されたデータ形式で、LLM が処理しやすい
• ⚡ リアルタイム更新：求人情報の鮮度を維持
• 🔧 オプションの機能拡張：API Key で追加機能を利用可能（完全に任意）

📦 インストール方法

🚀 すぐに実行（推奨）

インストール不要、設定不要ですぐに使えます：

# 一行命令，立即启动
npx -y mcp-jobs

🔧 グローバルインストール（任意）

頻繁に使用する場合：

# 全局安装
npm install -g mcp-jobs

# 直接运行
mcp-jobs

📁 プロジェクト内にインストール（任意）

# 安装到项目依赖中
npm install mcp-jobs
# 或使用 yarn
yarn add mcp-jobs
# 或使用 pnpm
pnpm add mcp-jobs

🎯 使い方

🚀 基本的な使い方（設定不要）

何も設定せずに、すぐに使い始められます：

# 启动服务
npx -y mcp-jobs

# 服务将自动提供以下功能：
# ✅ 职位搜索
# ✅ 职位详情获取
# ✅ 多平台数据聚合
# ✅ 标准化数据输出

これだけです！

🔧 高度な設定（完全に任意）

追加機能が必要な場合は、以下のパラメーターを任意で設定できます：

# 可选：复制配置模板
cp .env.example .env

# 可选：编辑配置文件，取消注释您需要的功能
# USERNAME=your_username            # 可选：基础认证
# PASSWORD=your_password            # 可选：基础认证

# 可选：爬虫配置
# CRAWLER_HEADLESS=true             # 可选：无头模式 (调试时可设为 false)
# CRAWLER_TIMEOUT=30000             # 可选：页面超时时间 (毫秒)
# CRAWLER_VIEWPORT_WIDTH=1280       # 可选：浏览器视窗宽度
# CRAWLER_VIEWPORT_HEIGHT=800       # 可选：浏览器视窗高度
# CRAWLER_DEBUG=false               # 可选：调试模式

任意の設定項目について

設定項目	用途	必須かどうか
USERNAME	基本認証のユーザー名	❌ 任意
PASSWORD	基本認証のパスワード	❌ 任意
CRAWLER_HEADLESS	ブラウザーのヘッドレスモード (true/false)	❌ 任意
CRAWLER_TIMEOUT	ページのタイムアウト時間 (ミリ秒)	❌ 任意
CRAWLER_VIEWPORT_WIDTH	ブラウザーのビューポート幅	❌ 任意
CRAWLER_VIEWPORT_HEIGHT	ブラウザーのビューポート高	❌ 任意
CRAWLER_DEBUG	デバッグモード (true/false)	❌ 任意

💡 重要なお知らせ：すべての設定は完全に任意です。設定がなくても、サービスの主要機能をすべて利用できます。

🤖 AI クライアントの設定

🚀 Cursor の設定（設定不要）

最小限の設定（推奨）

1. Cursor の設定を開きます
2. Features > MCP Servers に移動します
3. 「+ Add New MCP Server」をクリックします
4. 以下の情報を入力します：
   • Name: mcp-jobs
   • Type: command
   • Command: npx -y mcp-jobs

JSON で設定する方法

基本設定（すぐに使えます）：

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

高度な設定（任意の機能拡張）：

{
  "mcpServers": {
    "mcp-jobs": {
      "command": "npx",
      "args": ["-y", "mcp-jobs"],
      "env": {
        "USERNAME": "your-username",
        "PASSWORD": "your-password"
      }
    }
  }
}

💡 ヒント：基本設定をおすすめします。求人検索機能をすべて利用できます！

🤖 Claude Desktop の設定

設定不要で利用できます：

1. Claude Desktop を開きます
2. 左下の Settings アイコンをクリックします
3. 「MCP Servers」オプションを選択します
4. 「Add New Server」をクリックします
5. 以下の情報を入力します：
   • Name: mcp-jobs
   • Type: command
   • Command: npx -y mcp-jobs
   • Environment Variables: 空欄のまま（変数は一切不要です）

これだけです！ API Key 不要ですぐに使えます。

🚀 Windsurf の設定

基本設定（設定不要）：

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

🚀 Cline の設定

基本設定（設定不要）：

mcp:
  servers:
    mcp-jobs:
      command: npx
      args: ["-y", "mcp-jobs"]

🔧 高度な設定（完全に任意）

⚠️ 重要なお知らせ：以下の設定はすべて完全に任意です！設定がなくても、サービスの機能をすべて利用できます。

サービスの動作をカスタマイズする場合は、以下の環境変数を任意で設定できます：

# 可选：MCP API 密钥（用于解锁高级功能）
# 可选：基础认证
# USERNAME=your-username
# PASSWORD=your-password

# 可选：自定义 MCP 服务地址

💡 改めてお知らせします：設定不要で、求人検索機能をすべて利用できます！

🎯 すぐに使い始める

設定が完了したら（コマンドを 1 行入力するだけです！）、自然言語で AI アシスタントに求人検索の要望を伝えられます：

💬 使用例

求人を直接検索する：

• 「上海のフロントエンド開発エンジニアの求人を検索して」
• 「北京で、3 年以上の経験が必要なデータアナリストの求人を探して」
• 「杭州で最も給与の高いプロダクトマネージャーの求人を見つけて」

求人の詳細を取得する：

• 「この求人の詳細を取得して：[求人リンク]」
• 「この職種の要件と給与について分析して」

スマート分析：

• 「都市ごとに同種の求人の給与水準を比較して」
• 「現在の市場で需要の高いスキル要件をまとめて」

🚀 導入のハードルなし：複雑な API 呼び出しを学ぶ必要はありません。自然言語で話しかけるだけで、専門的な求人検索サービスを利用できます！

LLM が mcp-jobs サービスを自動的に呼び出して関連情報を取得し、結果を表示します。

🔧 デバッグと開発

🐛 デバッグモード

クローラーの動作をデバッグしたり、新機能を開発したりする場合は、デバッグモードを有効にできます：

# 启用可视化浏览器窗口（非无头模式）
CRAWLER_HEADLESS=false npx -y mcp-jobs

# 启用调试日志
CRAWLER_DEBUG=true npx -y mcp-jobs

# 组合使用
CRAWLER_HEADLESS=false CRAWLER_DEBUG=true npx -y mcp-jobs

⚙️ ブラウザー設定のカスタマイズ

# 自定义视窗大小
CRAWLER_VIEWPORT_WIDTH=1920 CRAWLER_VIEWPORT_HEIGHT=1080 npx -y mcp-jobs

# 增加超时时间（适用于慢速网络）
CRAWLER_TIMEOUT=60000 npx -y mcp-jobs

# 自定义用户代理
CRAWLER_USER_AGENT="Custom Bot 1.0" npx -y mcp-jobs

📝 設定の優先順位

設定の優先順位は、高いものから順に以下のとおりです：

1. サイト固有の設定 - crawlerConfig.ts で特定のサイトに設定された browserConfig
2. 環境変数 - CRAWLER_* 環境変数による設定
3. デフォルト設定 - システムのデフォルト値

🌟 MCP Jobs を選ぶ理由

✅ 本当に導入のハードルがありません

• 🚫 アカウント登録不要 - 個人情報の入力は一切不要です
• 🚫 複雑な設定不要 - 1 行のコマンドで起動できます
• 🚫 ドキュメントの学習不要 - 自然言語でそのままやり取りできます

⚡ すぐに使えます

• 📦 すぐに使えて、事前準備は一切不要
• 🔍 完全な求人検索機能
• 🌐 複数プラットフォームのデータを集約
• 📊 標準化されたデータ出力

🛡️ 信頼性と安定性

• 🔄 自動再試行の仕組み
• ⚠️ 適切なエラー処理
• 📈 リアルタイムのデータ更新
• 🔧 任意で利用できる高度な機能

📋 利用上の注意

1. 完全無料 - 主要機能はすべて無料で利用できます
2. 規約の遵守 - 各求人プラットフォームの利用規約を遵守してください
3. 適切な利用 - 過度なアクセスを避けるため、リクエスト頻度を抑えることをおすすめします
4. システム要件 - Node.js >= 16.0.0

オープンソースライセンス

MIT License

サポート

使用中に問題が発生した場合は、以下の方法でサポートを受けられます：

• GitHub Issue を提出する