boss-agent-cli：JSONエンベロープで求人検索を束ねるCLI
AI エージェント用のローカル アシスト BOSS Zhipin CLI、検索、福利厚生フィルタリング、候補リスト、JSON エンベロープ出力。デフォルトでは低リスクで準拠しています。
ひと目でわかる
- これは何？
- can4hou6joeng4/boss-agent-cliの`boss search`、`boss schema`、福利厚生ANDフィルター、MCP 73ツール、operating_mode互換をREADME事実で整理します。
- 誰に向いている？
- BOSS直聘で求人をローカル比較したい求職者や、MCP経由で検索だけをエージェントに渡したい開発者向き。自動応募や一括挨拶の完全自動化、掲載情報の正確性保証には向きません。
- 商用利用できる？
- できます。MIT は寛容なライセンスで、著作権表示とライセンス表示を残せば、使用・改変・販売が可能です。
- 今もメンテナンスされている？
- されています。最後のコミットは 2 日前です。
- 何の言語で書かれている？
- 主に Python です（GitHub の言語統計による）。
回答はプロジェクトの GitHub データ（最終同期：2026年9月14日）と当サイトの分析に基づくもので、法的助言ではありません。
オープンソース詳細解説
operating_mode互換とNOT_SUPPORTEDの境界
READMEの「运行边界」節は、履歴設定operating_mode=assisted|researchが引き続き互換である一方、両モードとも実装済み能力を呼び出せ、モード級COMPLIANCE_BLOCKEDは発生しないと説明しています。未実装能力はNOT_SUPPORTED、認証失効・口座リスク・ネットワークエラーは構造化エラーと復旧アクションを返すとREADMEは述べます。長流程はtimeout、retry、予算、checkpoint、stopで制御されます。
これは旧READMEの「デフォルトで挨拶・応募をブロック」説明から更新されている点に注意が必要です。評価では`boss status`でログイン状態を確認し、意図しない書き込み操作がNOT_SUPPORTEDではなく成功しないかを、READMEのCapability Matrix（docs/capability-matrix.md）と`boss schema`出力で照合するのが具体手順です。 追加段落：README一次情報に基づき、本リポジトリの公開範囲はドキュメントとソースに限定されます。star数やfork数はGitHubメタデータ由来の注目指標であり、機能保証やSLAを意味しません。導入判断では、READMEが示す具体コマンド・設定キー・バージョン番号を手元環境で再現し、期待する入出力が得られるかを記録してください。READMEに無い性能数値、互換マトリックス、セキュリティ監査結果は推測で補わず、issue/リリースノート/公式サイトで確認できる事実だけを採用記録に残します。
福利厚生ANDマッチとsearch/show/detail
READMEは8次元フィルター付きキーワード検索と、`search` `show` `detail`によるキャッシュ結果の番号参照をコア能力として挙げます。差別化は`--welfare "双休,五险一金"`で、自動ページング補抓、AND論理の真マッチ、`--sort score`によるローカルスコア並べ替えがREADMEに記載されています。
検証では`boss search "Golang" --city 广州 --welfare "双休,五险一金"`を固定入力として実行し、stdout JSONのpaginationとdata件数を保存してください。次に`boss detail <security_id>`で1件だけ詳細を取得し、福利項目がAND条件を満たすか手動で突合します。掲載情報の完全性や鮮度はCLI出力だけでは保証されません。 追加段落：README一次情報に基づき、本リポジトリの公開範囲はドキュメントとソースに限定されます。star数やfork数はGitHubメタデータ由来の注目指標であり、機能保証やSLAを意味しません。導入判断では、READMEが示す具体コマンド・設定キー・バージョン番号を手元環境で再現し、期待する入出力が得られるかを記録してください。READMEに無い性能数値、互換マトリックス、セキュリティ監査結果は推測で補わず、issue/リリースノート/公式サイトで確認できる事実だけを採用記録に残します。
uv tool installとpatchright chromium
推奨インストールは`uv tool install boss-agent-cli`の後、`patchright install chromium`です。READMEはブラウザ内核をユーザー主动ログインとローカルエクスポートのみに使うと説明しています。クイックスタートは`boss doctor`、`boss login`、`boss status`の順で、続けて検索・shortlist操作がREADMEに列挙されています。
すべてのコマンドはstdoutに`{ok, data, pagination, error, hints}`エンベロープのみを出力し、`ok`と終了コード0/1で成否を判断します。stderrはログ用です。READMEは39トップレベルコマンドと9リクルーター子コマンドを`boss schema`が能力真源として公開すると述べます。隔離環境では上記3コマンドを順に実行し、chromium起動ログと`~/.boss-agent/config.json`生成を確認してください。 追加段落：README一次情報に基づき、本リポジトリの公開範囲はドキュメントとソースに限定されます。star数やfork数はGitHubメタデータ由来の注目指標であり、機能保証やSLAを意味しません。導入判断では、READMEが示す具体コマンド・設定キー・バージョン番号を手元環境で再現し、期待する入出力が得られるかを記録してください。READMEに無い性能数値、互換マトリックス、セキュリティ監査結果は推測で補わず、issue/リリースノート/公式サイトで確認できる事実だけを採用記録に残します。
boss-mcpと73ツールのAgent統合
MCP統合はREADMEで推奨ルートです。Claude Desktop/Cursor向け設定例は`uvx --from boss-agent-cli[mcp] boss-mcp`です。Docker Composeでは`BOSS_UID=$(id -u) BOSS_GID=$(id -g) docker compose run --rm boss-mcp`とあり、镜像は意図的にブラウザ内核を含まず、先にホストで`boss login`し`~/.boss-agent`をマウントする必要があります。
subprocessルートは`boss schema`で自己記述を取得しstdout JSONを解析します。Python埋め込みは`from boss_agent_cli import AuthManager, BossClient`です。MCP公開時は呼び出し元に求人データと`~/.boss-agent/`への書き込み権限をどこまで渡すかを限定し、`boss-mcp --data-dir ./.boss-agent`でプロジェクト隔離を試してください。
Platform zhipin/zhilian/qianchengレジストリ
READMEのプラットフォーム表では、BOSS直聘（zhipin）がデフォルトで求職者・招聘者双方対応、智联（zhilian）は求職者側読取+招聘者agent browser/CDP V1、前程（qiancheng）は未接続スタブ登録でNOT_SUPPORTEDとされています。切替は`boss --platform zhilian search "Python"`または`boss config set platform zhilian`です。
`boss hr ...`はデフォルト招聘者プラットフォームzhipin-recruiterのみとREADMEは明記しています。智联招聘者側は`boss --platform zhilian --role recruiter agent ...`経由です。複数サイト一括自動化を期待する前に、対象プラットフォーム列とNOT_SUPPORTED応答を`boss platforms`出力で確認してください。
crawl runとSQLite checkpoint
批量采集は`uv sync --extra crawl`追加インストールが必要です。独立`<data-dir>/crawl/chrome-profile`を使い、日常Chrome profileを乗っ取らないとREADMEは説明しています。例として`boss crawl configure --max-requests 20 --max-details 50 --max-seconds 600 --max-retries 1`と`boss crawl run "AI" --city 杭州 --pages 3 --with-detail`がREADMEにあります。
crawl runはSQLite断点とJSON/CSV/XLSX増分产物を保存し、请求数・详情数・墙钟时间・重试に予算制約があるとREADMEは述べます。Hook使用時は`--hook-profile`と`SHA256SUMS`付きディレクトリの同時指定が必須です。大規模収集を試す前に上記予算値を小さく固定し、`boss crawl status`と产物ファイルを監査してください。
MITライセンスと利用規約免責
リポジトリはMIT LICENSEで、著作権2026 can4hou6joeng4です。READMEは学習とローカル支援のみを目的とし、適用法令・BOSS直聘利用規約・プライバシーポリシー順守をユーザーに求める免責を追加しています。セキュリティ保証、本番準備性、サポートコミットメントはREADMEにありません。
`~/.boss-agent/`には暗号化トークン、検索キャッシュ、shortlist、履歴書、AI設定が含まれるとREADMEのアーキテクチャ節は説明しています。共有端末ではディレクトリ権限と`boss config`のエクスポート先を確認し、個人データを扱う前に上記免責と自組織のコンプライアンス要件を照合してください。
編集部の結論
BOSS直聘で求人をローカル比較したい求職者や、MCP経由で検索だけをエージェントに渡したい開発者向き。自動応募や一括挨拶の完全自動化、掲載情報の正確性保証には向きません。最初に`boss doctor`と`boss search "Golang" --city 广州 --welfare "双休,五险一金"`を実行し、stdoutの`{ok,data,error}`エンベロープと`~/.boss-agent/`保存内容を確認してから利用範囲を決めてください。
コミュニティノート