boss-agent-cli

boss-agent-cli

BOSS 直聘の求職 CLI。AI エージェント向けに設計されています。32 個のコマンドで、検索、絞り込み、挨拶、コミュニケーション、パイプライン、履歴書の最適化まで、求職の全プロセスをカバーします。Bash から boss コマンドを呼び出し、stdout の JSON を解析して求職操作を進めます。

Codex 環境でのデフォルト設定

Codex サンドボックスでは、デフォルトで書き込み可能なデータディレクトリを使用します。

boss --data-dir /tmp/boss-agent-codex --json <command>

• デフォルトの ~/.boss-agent に依存しないでください。このディレクトリは Codex サンドボックス内で書き込み不可の場合があります
• 安定した JSON エンベロープを返すため、--json を明示的に付けてください
• すべてのコマンドで /tmp/boss-agent-codex を共通して使用します

ローカルにログイン状態がすでにあるものの、/tmp/boss-agent-codex が空の場合は、先に一度だけ移行してください。

mkdir -p /tmp/boss-agent-codex
if [ ! -f /tmp/boss-agent-codex/auth/session.enc ] && [ -f ~/.boss-agent/auth/session.enc ]; then
  cp -R ~/.boss-agent/auth /tmp/boss-agent-codex/
fi

サンドボックスのネットワーク制限によってコマンドが失敗した場合（典型的な症状：DNS/network error、zhipin.com にアクセスできない）は、コマンドのパラメーターを変更したり手順をスキップしたりせず、同じ boss コマンドに昇格権限を申請して再実行してください。

インストールの前提条件

このスキルを実行するには、boss コマンドが使用可能である必要があります。使用できない場合は、ユーザーに次の実行を案内してください。

uv tool install boss-agent-cli
patchright install chromium    # QR httpx 模式可省略此步

インストールを検証するには、boss schema を実行します（JSON 形式の機能説明が返されるはずです）。

エージェントの判断ツリー

用户意图 → 选择命令链
│
├─ "帮我找工作"
│   → boss status → boss search "关键词" --city X --welfare "Y"
│   → boss detail <sid> → boss greet <sid> <jid>
│
├─ "有什么新职位？"
│   → boss watch run <name>  (已有监控)
│   → boss recommend         (个性化推荐)
│
├─ "我的求职进展怎样？"
│   → boss pipeline → boss follow-up → boss digest
│
├─ "帮我优化简历"
│   → boss ai analyze-jd → boss ai polish → boss ai optimize
│
├─ "查看沟通记录"
│   → boss chat → boss chatmsg <sid> → boss chat-summary <sid>
│
├─ "登录/环境有问题"
│   → boss doctor → boss login
│
└─ "不知道能做什么"
    → boss schema  (返回全部能力 JSON)

出力プロトコル

すべてのコマンドは stdout に JSON を出力します。形式は固定です。

{
  "ok": true,
  "schema_version": "1.0",
  "command": "命令名",
  "data": {},
  "pagination": null,
  "error": null,
  "hints": {"next_actions": ["下一步建议"]}
}

• ok=false の場合は error.code を読み取ってエラーの種類を判断します。error.recovery_action には修復コマンドが含まれます
• hints.next_actions には、エージェントが直接実行できる次のコマンドが含まれます
• stderr はログ／進捗情報なので、無視してかまいません
• exit code 0 = 成功、1 = 失敗

呼び出し手順

必ず次の順序で操作してください。

1. boss --json status         → 检查登录态
2. boss --json login          → 若未登录（四级降级：Cookie → CDP → QR → patchright）
3. boss --json search <关键词>  → 搜索职位
   boss --json recommend       → 或获取推荐
4. boss --json detail <sid>    → 查看详情
5. boss --json greet <sid> <jid> → 打招呼
6. boss --json pipeline        → 追踪进度
7. boss --json digest          → 每日摘要

Codex 環境では、すべてのコマンドに --data-dir /tmp/boss-agent-codex を付けてください

検索前の環境フォールバック

• boss search／boss recommend／boss greet はブラウザーチャネルに依存しており、純粋な httpx ではありません
• 直前の関連コマンドで NETWORK_ERROR が発生した場合、すぐに「スキルのパラメーターが間違っている」または「未ログイン」と判断しないでください
• 先に boss --data-dir /tmp/boss-agent-codex --json doctor を実行してください
• network=ok でも browser_channel=warn または cdp=warn の場合、コマンドは headless patchright にフォールバックすることを意味します。この場合、ページの事前読み込みタイムアウトやリスク管理に引っかかる可能性が高くなります
• 再試行する前に、ブラウザーチャネルを修復してください。--remote-debugging-port=9222 を付けて Chrome を起動するか、Bridge を接続します。status／doctor も失敗した場合に限り、data dir、ログイン状態、またはネットワークを改めて調査してください

コマンド一覧（32 個）

boss schema を実行すると、すべてのコマンド定義を取得できます。個々のコマンドのヘルプは boss <cmd> --help を実行してください。

基本

コマンド	用途	主なパラメーター
boss schema	機能の自己説明（32 コマンド + 17 エラーコード）	なし
boss login	4 段階のフォールバックログイン	--timeout --cdp
boss logout	ログアウト	なし
boss status	ログイン状態の確認	なし
boss doctor	環境、認証情報の完全性、ネットワークの診断	なし
boss me	個人情報／履歴書／希望条件／応募状況	--section --deliver-page

検索

コマンド	用途	主なパラメーター
boss search <query>	求人を検索	--city --salary --welfare --experience --education --scale --industry --stage --preset
boss recommend	パーソナライズされたおすすめ	--page
boss detail <sid>	求人の詳細	--job-id（高速経路）
boss show <#>	前回の結果を番号で表示	なし
boss cities	対応都市 40 件	なし

アクション

コマンド	用途	主なパラメーター
boss greet <sid> <jid>	挨拶を送信	--message
boss batch-greet <query>	一括で挨拶を送信（上限 10 件）	--count --dry-run
boss apply <sid> <jid>	応募／すぐにコミュニケーション（冪等）	なし
boss exchange <sid>	電話番号／WeChat を交換	なし

コミュニケーション

コマンド	用途	主なパラメーター
boss chat	コミュニケーション一覧	--from --days --export
boss chatmsg <sid>	チャットメッセージ	--page
boss chat-summary <sid>	構造化された要約	なし
boss mark <sid>	ラベル管理	--label
boss interviews	面接の招待	なし
boss history	閲覧履歴	なし

パイプライン

コマンド	用途	主なパラメーター
boss pipeline	求職パイプライン	なし
boss follow-up	フォローアップのリマインダー	なし
boss digest	毎日の要約	なし
boss watch add/list/remove/run	増分モニタリング	検索条件
boss shortlist add/list/remove	候補者プール	<sid>
boss preset add/list/remove	検索プリセット	パラメーターの組み合わせ

履歴書と AI

コマンド	用途	主なパラメーター
boss resume	ローカルの履歴書管理	サブコマンド：init/list/show/edit/delete/export/import/clone/diff
boss ai config	AI サービスの設定	--provider --model --api-key
boss ai analyze-jd	求人要件の分析	なし
boss ai polish	履歴書の推敲	なし
boss ai optimize	求人に合わせた最適化	なし
boss ai suggest	求職のアドバイス	なし
boss ai reply	採用担当者への返信案	--context --resume --tone
boss ai interview-prep	JD に基づく模擬面接の質問生成	--resume --count
boss ai chat-coach	チャット履歴に基づくコミュニケーションのアドバイス	--resume --style

システム

コマンド	用途	主なパラメーター
boss config list/set/reset	設定管理	設定キーと値
boss clean	キャッシュの削除	--dry-run --all --days
boss export <query>	結果のエクスポート	--format csv/json --output --count

福利厚生による絞り込み（主要機能）

ユーザーが福利厚生に関する条件（例：「週休 2 日が必要」「五険一金」）を指定した場合は、--welfare パラメーターを使用します。

boss --json search "golang" --city 广州 --welfare "双休,五险一金"

• カンマ区切り = AND ロジック。すべての条件を満たす必要があります
• ページを自動でめくり、各求人の福利厚生タグと説明を確認します
• 結果には welfare_match フィールドが含まれ、一致した情報源を示します
• よく使うキーワード：週休 2 日、五険一金、年末賞与、食事手当、住宅手当、定期健康診断、ストックオプション、残業手当

错误处理

错误码	含义	处理方式
AUTH_REQUIRED	未登录	执行 boss login
AUTH_EXPIRED	登录过期	执行 boss login
TOKEN_REFRESH_FAILED	Token 刷新失败	执行 boss login
RATE_LIMITED	频率过高	等待后重试
ACCOUNT_RISK	风控拦截	CDP Chrome 重试
NETWORK_ERROR	网络错误	重试一次
AI_NOT_CONFIGURED	AI 未配置	boss ai config
AI_API_ERROR	AI 调用失败	重试
INVALID_PARAM	参数错误	修正参数重试
ALREADY_GREETED	已打过招呼	跳过
ALREADY_APPLIED	已投递	跳过
GREET_LIMIT	今日次数用完	告知用户明天再试
JOB_NOT_FOUND	职位不存在	告知用户
RESUME_NOT_FOUND	简历不存在	检查名称

行为规则

1. 先检查登录态：每次操作前调用 boss status，失败则 boss login
2. 福利要求用 --welfare：用户说"要双休"→ --welfare "双休"
3. 无需额外 sleep：工具内置高斯分布请求延迟
4. 批量打招呼先 dry-run：boss batch-greet ... --dry-run 让用户确认
5. 解析 JSON 不解析文本：用 ok 字段判断成败
6. 未指定关键词用 recommend：用户说"推荐职位"→ boss recommend
7. 导出用 export：用户说"导出"、"下载列表"→ boss export
8. 展示结果含福利：welfare 字段是列表，向用户展示时列出
9. 遇到沙箱网络错误先提权重试：不要在 DNS/网络受限时报"工具不可用"
10. 求职进度用 pipeline：用户问"进展怎样"→ boss pipeline + boss digest