boss-agent-cli は何をしますか？
🤖 AIエージェント向けローカルアシストBOSS直聘CLI — 求人検索、福利厚生フィルタリング、ショートリスト作成、JSONエンベロープ出力に対応。デフォルトで低リスクかつコンプライアンスを遵守。
概要
boss-agent-cli は、AIエージェントがBOSS直聘の求人データに安全かつ効率的にアクセスするためのコマンドラインインターフェースです。このツールは、ローカル環境で動作し、API呼び出しを抽象化して、AIエージェントが直接利用しやすい形式でデータを提供します。
主な機能
- 求人検索: キーワード、場所、給与範囲などで求人を検索できます。
- 福利厚生フィルタリング: リモートワーク、健康保険、柔軟な勤務時間などの福利厚生に基づいて結果を絞り込みます。
- ショートリスト作成: 気になる求人をショートリストに保存し、後で確認できます。
- JSONエンベロープ出力: すべての出力は標準化されたJSONエンベロープ形式で提供され、AIエージェントが容易に解析できます。
- 低リスクデフォルト: デフォルト設定では、APIの利用制限を尊重し、低リスクな操作のみを実行します。
インストール
npm install -g boss-agent-cli
または、ソースからビルド:
git clone https://github.com/can4hou6joeng4/boss-agent-cli.git
cd boss-agent-cli
npm install
npm run build
使用法
認証
BOSS直聘のAPIキーを環境変数に設定します:
export BOSS_API_KEY="your_api_key_here"
基本的な検索
boss-agent-cli search --keyword "フロントエンドエンジニア" --location "北京"
福利厚生フィルタリング
boss-agent-cli search --keyword "リモート" --welfare "リモートワーク,柔軟な勤務時間"
ショートリストの管理
# ショートリストに追加
boss-agent-cli shortlist add --job-id 12345
# ショートリストを表示
boss-agent-cli shortlist list
JSON出力の例
{
"status": "success",
"data": [
{
"jobId": "12345",
"title": "フロントエンドエンジニア",
"company": "テック株式会社",
"salary": "20K-40K",
"welfares": ["リモートワーク", "健康保険", "ストックオプション"]
}
],
"meta": {
"totalCount": 1,
"page": 1,
"pageSize": 20
}
}
設定
設定ファイル (~/.boss-agent-cli/config.json) でデフォルトの動作をカスタマイズできます:
{
"defaultLocation": "上海",
"defaultPageSize": 10,
"safeMode": true,
"rateLimit": 5
}
コンプライアンスと注意事項
- このツールはBOSS直聘の利用規約を遵守するように設計されています。
- デフォルトでは読み取り専用操作のみを許可します。
- レート制限はAPIの制限を尊重するように設定されています。
- 大量のデータを取得する場合は、BOSS直聘の公式ドキュメントを参照し、適切な利用を心がけてください。
開発者向け情報
AIエージェントと統合する場合、以下の環境変数を使用して動作を制御できます:
| 環境変数 | 説明 | デフォルト値 |
|---|---|---|
BOSS_API_KEY | APIキー | なし (必須) |
BOSS_SAFE_MODE | 安全モードを有効化 | true |
BOSS_RATE_LIMIT | 1分あたりの最大リクエスト数 | 10 |
BOSS_LOG_LEVEL | ログレベル (debug, info, warn, error) | info |
ライセンス
MIT