katazuku-shukatsu
就活の「めんどい」を、あなたのPCの中で片づける。
メールの見張り・予定の登録・提出物の追跡・面接の前夜準備を自動で回し、
「送る・出す・決める」だけをあなたに残す、オープンソースの就活オートパイロットです。
現在はターミナル操作とGoogle Cloudの設定が必要な開発版です。
認証なしのデモで画面を試せます。自分のデータで使う場合は、接続確認と定期実行の登録まで必要です。
カタヅク就活の公式HPでは、ブラウザだけで試せる機能、無料OSSの導入方法、個別導入支援、開発への参加方法を案内しています。
紹介動画(準備中): 公開したらここにリンクを置きます。
English / デモで試す / セットアップ / AIプロバイダ / 参加方法
架空データから集計CSVを作り、Databricksで分析を試す手順は Databricksガイド にまとめています。正本DBや個人情報は自動送信しません。
あなたはどちら?
Windowsポータブル試用版は、Node/npmなしで初回設定と架空データの8画面閲覧を開けます。
ビルド・実機検証と対応範囲を確認してください。Google本人認証・実同期・定期登録・コード署名は未検証または未対応です。
AIの利用料は、あなた自身の ChatGPT プラン(Sign in with ChatGPT)・Claude Code・Codex、または API キーで払います。
katazuku 側のサーバや課金はありません。正本DBとローカルの閲覧データは、あなたのPCに保存します。
Googleとの通信や、選択したAIプロバイダへの情報送信は発生します。AIへ渡す情報は各ワークフローの --dry-run と AIプロバイダ で確認できます。
何ができるか
| 機能 | 中身 | AI | つなぐもの |
|---|
| メール見張り(毎時) | 未読を見張り、面接案内・結果・提出依頼など緊急なものだけ返信下書き・カレンダー登録・通知 | ツールを使えるAI(Claude Code / Codex) | Gmail・カレンダー |
| 毎朝の選考同期 | メールを読み取り専用で取得 → AIが選考の動きを構造化 → 検証してから正本DBへ反映 | どれでも(ChatGPT プラン / API キーも可) | Gmail |
| きょうやること(毎朝) | 本人がやることを最大3件に。送り忘れの下書き・締切の作業ブロック(時刻入り)・故障報告 | ツールを使えるAI | Gmail・カレンダー |
| 前夜ブリーフ(毎晩) | 明日の面接の相手・前回の記録・想定問答をまとめる。予定が無い日はAIを呼ばない | ツールを使えるAI | Gmail |
| カレンダー同期(30分) | カレンダー → 正本DB。空き判定は「空き / 重複 / 不明」で、情報不足を空きと扱わない | 不要(判断が要る予定だけAI) | カレンダー |
| 提出物台帳 | 誓約書・証明書・ES などを成果物1件ずつ追跡し、完了するまで毎日再評価 | 不要 | — |
| 番犬(4時間) | 自動処理が止まっていないか・AIの利用枠が全滅していないかを見張る | 不要 | — |
| ハーネス改善ループ | run台帳を匿名化した最小観測へ変え、失敗を合成回帰caseにしてbaseline比較する。合格候補も人がrevisionを確認するまで反映しない | 不要 | — |
| 閲覧アプリ8本 | きょう / 選考 / 企業 / メール / 人 / 面接準備 / プロフィール / 効果 | 不要 | — |
| 面談の録音(任意・Windows) | オンライン面談を相手の声つきで録る | 不要 | — |
| 安全なローカルログイン(任意・Windows) | DPAPIで保護した資格情報を隔離Chromeへだけ入力。origin・テナントパスを再検査し、MFA/CAPTCHA/規約同意では停止 | 不要 | 本人が登録した採用サービス |
| ブラウザ操作計画(開発者向け) | 生値・任意JavaScriptなしの型付き計画。dry-runは無操作、実行は正本・本人承認hash・外部冪等キー・再照合が一致した専用Executorだけ | 不要 | 規約確認済みのサイトadapter |
| Gemini Spark 連携(任意) | スマホから予定・選考状況を聞く | 不要 | 自分の Cloudflare |
| katazuku MCP(任意) | Muse・Codex・Claude Codeから正本を読み、明示scopeで冪等入力と承認提案を行う。利用者のMuseアカウントが対象メールボックスに対応する場合は、毎回承認・action hash・Sent再照合付きのemail connector経路を使える。未対応のiCloudはprivate adapterへ分離する。フォーム提出と採用ポータル送信も、汎用workflow契約で本人承認・外部冪等キー・監査を必須にする。remote用OAuth gatewayもセルフホスト可能 | 不要 | 対応MCPクライアント・任意で自分のCloudflare |
詳しい動きは docs/WORKFLOWS.md、AIの選び方は docs/AI-PROVIDERS.md。
MCPはMCPガイド、MuseはMuse接続ガイド、安全なWindowsログインはローカル認証ブローカー、ブラウザ実行の共通境界はブラウザ操作計画、運用を失敗から改善する仕組みはハーネス改善ループを参照してください。private版との差と意図的な秘密境界は追随台帳に固定しています。
やらないこと(コードで止めている安全境界)
- 定常処理は第三者へ自動送信しない。 通常は下書きまで。明示的に固定した宛先・本文を本人が承認した場合だけ、専用ExecutorまたはMuseの毎回承認付きemail connectorが同じaction hashを一度実行し、Sentを再照合する。
- 定常処理や一般MCPはES・エントリー・フォームの送信、予約確定、辞退を実行しない。 本人が固定内容を承認し、正本・action hash・外部冪等キー・直前再照合が一致した専用Executorだけが1回実行できます。
- Web適性検査・コーディングテストの代理受験はしない。
- AIにデータベースを直接書かせない。AIの出力は形と網羅性を検証してから、決まった規則で反映します。
詳しくは SECURITY.md。
しくみ
flowchart LR
G[("Google<br/>Gmail / Calendar")]
A["外部AI provider<br/>ChatGPT プラン / Claude Code / Codex / API"]
subgraph PC["あなたのPC(正本・実行・閲覧)"]
direction TB
S["スケジューラ<br/>タスクスケジューラ / cron / launchd"] --> W["ワークフロー<br/>scripts/workflow.ts"]
W -->|自分のOAuthで読み取り| G
W -->|プロンプト| A
A -->|厳格JSON| V["検証<br/>Schema・網羅性・暴走ブレーキ"]
V --> DB[("正本DB<br/>SQLite 1ファイル")]
DB --> SNAP["snapshot.json"] --> APPS["閲覧アプリ8本<br/>(見る窓)"]
A -.->|下書き・予定作成だけ| G
end
YOU(["あなた"]) -->|送る・出す・決める| G
- 正本は1つ(ローカルの SQLite)。アプリ・カレンダーは「見る窓」です。
- 戻せる。 バックアップはSQLite整合性と参照を検査して既存ファイルを上書きせず作り、復元も稼働中の正本を置換せず新しいパスへ作ります。
- 書き手はエージェントだけ。 状態は遷移規則(
transition())を必ず通して更新し、変化は台帳に残ります。
- AIは取り替えられる。 未ログイン・利用枠切れなど「何もしていない失敗」のときだけ、次のAIへ切り替えます。
デモで試す(資格情報ゼロ)
Node.js 22.13以降の22系、または24以降(推奨 24)が必要です。
git clone https://github.com/kokotatan/katazuku-shukatsu.git
cd katazuku-shukatsu
npm run demo
架空のデータでホーム画面がブラウザに開きます。8画面へ同じローカルURLから移動できます。
アカウント接続もAIも使いません。初回は8画面の依存導入・ビルドがあるため数分〜十数分かかります。
2回目からは既存ビルドを使い、ソースが変わった画面だけビルドし直します。パッケージ取得にはインターネットが必要です。
別のアプリから始めるなら npm run demo -- insight。ブラウザを自動で開かない場合は --no-open、
ポートが使用中なら npm run demo -- --port 4174 を使います。停止は Ctrl+C。
デモは実データや正本DBを読みません。自分のデータを見るときはセットアップ後に npm start を実行します。
朝のまとめ・前夜の準備はホーム、成果物ごとの未完了提出物は「今日やること」から確認できます。
ほかに手元で試せること:
npm test # 架空データで全部の規則を検証
npm run seed # 架空の正本DBを組み立てて表示
npm run workflow -- asa --dry-run # 朝のまとめのプロンプトと、使うAIの順番を表示(外部に触れない)
自分のデータで使う
docs/SETUP.md の順に進めます。流れは次のとおりです。
最初に npm run init を実行すると、リポジトリ外のOS利用者別領域へ空の正本DBを作成します。
再実行しても既存データを消さず、必要なマイグレーションだけを適用します。保存先を変える場合は
KATAZUKU_DB、または npm run init -- /absolute/path/to/katazuku.db を使います。
This is the beginning of the README. Read the rest at the original. Read the full README ↗
