SerpAPI 統合により Google Jobs の検索機能を提供する、Model Context Protocol(MCP)サーバー実装です。多言語サポート、柔軟な検索パラメータ、スマートなエラー処理を備えています。
https://github.com/user-attachments/assets/8f6739e1-7db7-4171-88b4-59c6290a4c72
✨ 特徴
🌍 多言語サポート
自動言語検出とフォールバックにより、英語、中国語、日本語、韓国語の完全なローカリゼーションをサポートします。
🔍 柔軟な検索オプション
包括的な検索パラメータには以下が含まれます:
職種とキーワード
半径フィルタリングによる場所
雇用形態(フルタイム、パートタイムなど)
給与範囲フィルター
投稿日フィルタリング
結果の並べ替え
💡 スマートなエラー処理
包括的な入力検証
役立つエラーメッセージと提案
自動検索絞り込み提案
レート制限の処理
📊 豊富な求人詳細
詳細な求人情報のフォーマット
会社の特典とハイライト
給与情報(入手可能な場合)
直接申請リンク
求人掲載タイムスタンプ
🔄高度な機能
ページネーションのサポート
複数の並べ替えオプション
地理的半径検索
雇用形態のフィルタリング
🔑 SERP API セットアップガイド
始める前に、SERP API キーを取得する必要があります。
SERP APIウェブサイトにアクセスしてアカウントを作成してください
登録後、ダッシュボードに移動します。
「APIキー」セクションを見つけます
APIキーをコピーする
新規ユーザーは100回のAPI呼び出しが無料
API 使用の詳細:
無料枠: 月間100回の検索
有料プランは月額50ドルからで、検索回数は5000回まで。
成功したAPI呼び出しに基づく課金
複数の支払い方法: クレジットカード、PayPal など。
使用制限:
リクエストレート: 2 リクエスト/秒
IP制限: なし
同時リクエスト数: 5
レスポンスキャッシュ時間: 1時間
👩🔧 NVM/NPM を使用した MCP サーバー接続の問題の解決策
私の構成ソリューションを見るにはクリックしてください👉 https://github.com/modelcontextprotocol/servers/issues/76
🚀 クイックスタート
依存関係をインストールします:
npm install環境を構成する:
claude_desktop_config.jsonを次の内容で変更します (システムに応じてパスを調整します)。
{
"google-jobs": {
"command": "D:\\Program\\nvm\\node.exe",
"args": ["D:\\github_repository\\path_to\\dist\\index.js"],
"env": {
"SERP_API_KEY": "your-api-key"
}
}
}サーバーを構築します。
npm run buildサーバーを起動します。
npm startトラブルシューティング
API キーの問題:
構成内のキーを確認する
SERP APIダッシュボードでキーのステータスを確認する
キーに残りのクォータがあることを確認する
検索の問題:
検索パラメータの形式を検証する
ネットワーク接続を確認する
国/言語コードのサポートを確認する
📦 インストール
Related MCP server: MCP Server for Google Search
Smithery経由でインストール
Smithery経由で Claude Desktop に Google Jobs を自動的にインストールするには:
npx -y @smithery/cli install @chanmeng666/google-jobs-server --client claude手動インストール
@chanmeng666/google-jobs-server
# Using npm
npm i @chanmeng666/google-jobs-server
# or
npm install @chanmeng666/google-jobs-server
# Using yarn
yarn add @chanmeng666/google-jobs-server
# Using pnpm
pnpm add @chanmeng666/google-jobs-server評価の実行
evalsパッケージはmcpクライアントをロードし、index.tsファイルを実行するため、テスト間でリビルドする必要はありません。npxコマンドの先頭に環境変数をロードすることもできます。完全なドキュメントはこちらでご覧いただけます。
OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/index.ts💻 技術スタック
📖 APIドキュメント
サーバーはモデルコンテキストプロトコルを実装し、次のパラメータを持つ求人検索ツールを公開します。
query: 検索クエリ文字列(必須)location: 勤務地(オプション)posted_age: 投稿日フィルター(オプション)employment_type: 職種フィルター(オプション)salary: 給与範囲フィルター(オプション)radius: 地理的な検索半径(オプション)hl: 言語コード(オプション)page: ページ番号(オプション)sort_by: 並べ替え順(オプション)
🔧 開発
# Run in development mode
npm run dev
# Run type checking
npm run typecheck
# Build for production
npm run build📝 ライセンス
このプロジェクトはMIT ライセンスです。
🙋♀ 著者
Chan Mengによって作成および管理されています。