Jobspy MCP Server

🚀 JobSpy MCP サーバー

このサーバーは、モデルコンテキストプロトコル（MCP）を利用し、JobSpy ツールを使って、Claude などの AI アシスタントが複数の求人プラットフォームで職位を検索できるようにします。

✨ 主な機能

• Indeed、LinkedIn、Glassdoor などの複数のプラットフォームで職位を検索できます。
• キーワード、場所、時間で職位情報を絞り込むことができます。
• AI で処理できる構造化データを返します。
• JSON と CSV 形式の出力結果をサポートしています。

📦 インストール

前提条件

• Node.js 16 以上
• Python 3.6 以上
• インストール済みの JobSpy ツール

インストール手順

# リポジトリをクローンする
git clone https://github.com/yourusername/jobspy-mcp-server.git
cd jobspy-mcp-server

# 依存関係をインストールする
npm install

# JobSpy 環境を設定する
pip install jobspy

📚 ドキュメント

設定

サーバーは自動的に JobSpy スクリプトの場所を探し、以下の環境変数で設定できます。

設定方法

1. コマンドラインで直接設定

   export JOBSPY_DOCKER_IMAGE=jobspy-mcp-server:latest
   export JOBSPY_ACCESS_TOKEN=your_access_token
   

2. .env ファイルを作成する プロジェクトのルートディレクトリに .env ファイルを作成し、以下の内容を追加します。

   JOBSPY_DOCKER_IMAGE=jobspy-mcp-server:latest
   JOBSPY_ACCESS_TOKEN=your_access_token
   

使用方法

サーバーを起動する

npm start

Claude Desktop との統合

設定ファイルに以下の内容を追加して、Claude との統合をサポートします。

{
  "claude": {
    "enabled": true,
    "apiKey": "your_claude_api_key"
  }
}

SSE 伝送のサポート

サーバーはリアルタイムストリーミング処理機能を提供しています。以下は接続のサンプルコードです。

const eventSource = new EventSource('http://localhost:9423/sse');

eventSource.addEventListener('message', function(e) {
    console.log('データ:', e.data);
});

API インターフェース

職位を検索する

curl -X POST "http://localhost:9423/api" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "search_jobs",
    "params": {
      "search_term": "ソフトウェアエンジニア",
      "location": "カリフォルニア州サンフランシスコ",
      "site_names": "indeed,linkedin",
      "results_wanted": 10,
      "format": "json"
    }
  }'

利用可能なツール

職位を検索する（search_jobs）

パラメータの説明

使用例

24時間以内に投稿された、ボストンの上級ソフトウェアエンジニアの職位を探したい。

Docker のサポート

イメージをビルドする

docker build -t jobspy-mcp-server .

コンテナを実行する

docker run -p 9423:9423 jobspy-mcp-server

開発環境

開発モードで実行する

npm run dev

テストを実行する

npm test

⚠️ 重要提示

翻訳中は、技術用語とコード例は正確性と操作性を保つために変更しないでください。