Lever Automation
Claude Code から直接 Lever ATS での採用業務を自動化します。求人情報の管理、候補者パイプラインの追跡、要求人員の更新、オポチュニティの検索を、ターミナルから離れずに行えます。
ツールキットドキュメント: composio.dev/toolkits/lever
セットアップ
- Composio MCP サーバーを設定に追加します:
https://rube.app/mcp - Lever コマンドを実行すると、Lever アカウントの接続が求められます。エージェントが OAuth リンクを提供するので、認証を行ってください。
- 必要な操作（求人情報、オポチュニティ、要求人員の読み取り/書き込みアクセス）に十分なスコープが Lever API キーに付与されていることを確認してください。
コアワークフロー
1. 求人情報の一覧とフィルタリング
状態、チーム、部署、場所、雇用形態でオプションのフィルタリングを行い、すべての求人情報を取得します。
ツール: LEVER_LIST_POSTINGS
主なパラメータ:
state--published、internal、closed、draft、pending、rejectedでフィルタリングteam、department、location、commitment-- 組織属性で結果を絞り込みlimit(1-100) とoffset-- 大量の求人情報をページネーションtag-- 求人タグでフィルタリング
プロンプト例: 「Lever で公開中のエンジニアリング求人をすべてリストアップして」
2. 候補者オポチュニティの閲覧
採用パイプライン内のすべてのオポチュニティを、パイプライン分析と候補者追跡のための豊富なフィルタリング機能とともにリスト表示します。
ツール: LEVER_LIST_OPPORTUNITIES
主なパラメータ:
posting_id、stage_id、tag-- 求人、パイプラインステージ、タグでフィルタリングemail、contact_id-- 特定の候補者のオポチュニティを検索archived-- アーカイブ状態でフィルタリング (true/false)created_at_start、created_at_end-- 日付範囲フィルタリング (ISO 8601)expand--applications、contact、owner、stage、stageChanges、sources、sourcedByを完全なオブジェクトに展開
プロンプト例: 「Senior Engineer 求人の、連絡先詳細を含むすべてのアクティブなオポチュニティを表示して」
3. オポチュニティ詳細の取得
連絡先情報、ステージ進行、ソース、応募情報など、単一の候補者オポチュニティの包括的な詳細を取得します。
ツール: LEVER_GET_OPPORTUNITY
主なパラメータ:
opportunity(必須) -- 一意のオポチュニティ UIDexpand-- カンマ区切りの展開フィールド:contact、stage、owner
プロンプト例: 「オポチュニティ 31c9716c-d4e3-47e8-a6a1-54078a1151d6 の連絡先とステージを展開して詳細を取得して」
4. 要求人員の管理
要求人員を作成、一覧表示、更新、削除して、人員計画と採用ニーズを追跡します。
ツール: LEVER_LIST_REQUISITIONS、LEVER_GET_REQUISITION、LEVER_UPDATE_REQUISITION、LEVER_DELETE_REQUISITION
更新には以下のフィールドが必要です:
requisition(必須) -- 要求人員の UUIDrequisitionCode(必須) --REQ-001のような一意のコードname(必須) -- 要求人員のタイトルheadcountTotal(必須) -- ポジション数 (最低1)status--openまたはclosed- オプション:
hiringManager、owner、department、team、location、compensationBand
プロンプト例: 「要求人員 REQ-001 を更新して、人員数を3に増やし、ステータスを公開中に変更して」
5. パイプラインステージの表示
Lever アカウントに設定されているすべての採用パイプラインステージを取得します。
ツール: LEVER_LIST_STAGES
主なパラメータ:
limit(1-100) -- 1ページあたりの最大アイテム数offset-- 前回のレスポンスからのページネーショントークン
プロンプト例: 「Lever アカウントのパイプラインステージをすべてリストアップして」
6. タグの管理
候補者、オポチュニティ、求人情報を分類するために使用されるすべてのタグを一覧表示します。
ツール: LEVER_LIST_TAGS
主なパラメータ:
limit-- 1ページあたりの最大アイテム数offset-- ページネーショントークン
プロンプト例: 「Lever のすべての候補者タグを表示して」
既知の落とし穴
- 大規模データセットにはページネーションが必要:
LEVER_LIST_OPPORTUNITIESとLEVER_LIST_POSTINGSはデフォルトで1ページあたり最大100件の結果を返します。レスポンス内のoffsetトークンを常に確認し、反復処理を行って完全な結果を取得してください。 - Expand パラメータの形式:
LEVER_LIST_OPPORTUNITIESのexpandフィールドは文字列の配列を受け入れますが、LEVER_GET_OPPORTUNITYとLEVER_GET_REQUISITIONではカンマ区切りの文字列を受け入れます。各ツールの正確なスキーマに従ってください。 - 要求人員の更新は完全置換:
LEVER_UPDATE_REQUISITIONは、1つのフィールドだけを変更する場合でも、すべての必須フィールド (requisitionCode、name、headcountTotal) が必要です。最初にLEVER_GET_REQUISITIONで現在の要求人員を必ず取得してください。 - タイムスタンプ: オポチュニティの日付フィルターは ISO 8601 形式を使用しますが、
LEVER_LIST_POSTINGSのupdated_at_startはミリ秒単位の Unix タイムスタンプを使用します。 - 接続スコープ: 書き込み操作（要求人員の更新/削除）は、読み取りが成功しても、API トークンに必要な権限がない場合は失敗します。
クイックリファレンス
| ツールスラッグ | 説明 |
|---|---|
LEVER_LIST_POSTINGS | 状態、チーム、部署でフィルタリングしてすべての求人情報を一覧表示 |
LEVER_LIST_OPPORTUNITIES | パイプラインフィルタリングで候補者オポチュニティを一覧表示 |
LEVER_GET_OPPORTUNITY | 単一のオポチュニティの詳細情報を取得 |
LEVER_GET_REQUISITION | ID で単一の要求人員を取得 |
LEVER_LIST_REQUISITIONS | ステータス/コードフィルタリングですべての要求人員を一覧表示 |
LEVER_UPDATE_REQUISITION | 既存の要求人員を更新（完全置換） |
LEVER_DELETE_REQUISITION | 要求人員を削除/アーカイブ |
LEVER_LIST_STAGES | すべてのパイプラインステージを一覧表示 |
LEVER_LIST_TAGS | 分類用のすべてのタグを一覧表示 |
Powered by Composio