ai-job-search-dev/ai-job-search

The job search that runs on your machine. AI job application framework built on Claude Code: evaluate postings, tailor CVs, write cover letters, prep interviews. Fork it and own it.

AI Job Search – AI を活用した求人応募アシスタント

概要 – セルフホスト型ワークフローで、Claude Code(Anthropic のコードアシスタント CLI)をフルスタックの求職コンパニオンに変えます。個人のキャリアプロフィールを保存し、求人ボードをスクレイピングし、適合性を自動評価し、LaTeX の CV とカバーレターを作成し、レビューエージェントに批評させ、最終的に送信可能な PDF を生成できます。コアコマンドは /setup、/scrape、/apply です。補助コマンドは、面接準備、結果追跡、Notion/Gmail 同期、スキルギャップ分析、カスタムテンプレートを処理します。


主要な概念と仕組み

  1. プロフィール作成 (/setup) – 既存のドキュメント(CV PDF、LinkedIn エクスポート、卒業証書など)をインポートするか、面接形式の質問に回答します。データは documents/ に保存され、.claude/skills/job-application-assistant/ の Claude スキルファイルで使用されます。
  2. 求人検索 (/scrape) – TypeScript/Bun で書かれたポータル固有の CLI ツール(Jobindex、Jobnet、Jobbank、LinkedIn、freehire.me など)のセットを実行します。結果は重複排除され、04-job-evaluation.md で定義された 5 次元の適合フレームワークに対してスコアリングされます。
  3. 応募 (/apply <url>) –
    • 求人情報(または貼り付けられた説明)を解析します。
    • 適合性をスコアリングし、続行するか決定します。
    • 組み込みテンプレート(cv/main_example.tex、cover_letters/cover.cls)を使用して LaTeX で CV とカバーレターを作成します。
    • 会社を調査してフィードバックを提供するレビューアー Claude エージェントを起動します。
    • レビューアーが満足するまで反復し、PDF をコンパイルします(CV は lualatex、カバーレターは xelatex)。
    • オプションの ATS チェック(pypdf または pdftotext)を実行して、PDF が機械可読であることを確認します。
  4. 応募後ツール –
    • /interview は STAR 例と模擬面接を含む準備パックを構築します。
    • /outcome は面接結果を記録し、資料をアーカイブし、丁寧なフォローアップを作成できます。
    • /rank は新しくスクレイピングされた求人をバッチスコアリングし、候補リストを返します。
    • /expand は公開ソース(GitHub、Kaggle など)からプロフィールを充実させます。
    • /upskill はスキルギャップヒートマップと学習計画を生成します。
    • /html-report は job_search_tracker.csv からオフラインダッシュボードを作成します。
    • /notion-sync と /gmail-sync は、Notion のオプションの読み取り専用ビューと Gmail からの自動ステータス検出を提供します。

前提条件(README に記載)

  • Claude Code CLI(有料の Anthropic サブスクリプションまたは API クレジットが必要)。
  • Python 3.10+。
  • Bun(ポータル検索 CLI 用)。
  • LaTeX ディストリビューション(lualatex と xelatex を含む)(TeX Live、MacTeX、TinyTeX、または MiKTeX)。追加パッケージは SETUP.md にリストされています。
  • オプション:pypdf(ATS チェック用)と PDF テキスト抽出ツール(poppler-utils または pdftotext)。

クイックスタートフロー(README から)

# 1. Fork してクローン(個人データを保存する場合はプライベートフォークを維持)
gh repo fork MadsLorentzen/ai-job-search --clone
cd ai-job-search

# 2. ポータル CLI をインストール(各 .agents/skills/*/cli/ で bun install を実行)
python3 tools/install_portal_clis.py

# 3. Claude Code でプロフィールを初期化
claude   # Claude Code REPL を開く
/setup   # ウィザードに従う – ドキュメントをインポートするか質問に回答

# 4. 一致する求人を検索
/scrape

# 5. 選択した求人に応募(URL または貼り付けられた説明)
/apply https://jobindex.dk/job/1234567

README には、視覚的なガイダンスのための YouTube ウォークスルーへのリンクもあります。


ファイルレイアウト(高レベル)

  • CLAUDE.md – トップレベルの候補者プロフィールとワークフロールール。
  • .claude/commands/ – 各スラッシュコマンドのマークダウン定義。
  • .claude/skills/ – コアの「job-application-assistant」スキルとサポートスキル(job-scraper、upskill)。
  • .agents/skills/ – 個々の求人ポータル CLI ツール。
  • cv/、cover_letters/ – LaTeX テンプレート。
  • documents/ – 個人の CV、LinkedIn エクスポート、卒業証書、推薦状、過去の応募書類を置く場所。
  • tools/ – CI、スキル lint、PDF 検証、給与検索などのヘルパースクリプト。
  • job_search_tracker.csv – HTML ダッシュボードにデータを提供するスプレッドシート。
  • SETUP.md – 詳細なインストールおよび構成ガイド。

誰がこれを使うべきか?

  • 大規模言語モデルアシスタントを使用して、応募を自動化し再現可能な方法で調整したい専門家。
  • ローカルの Python/Bun/LaTeX スタックを実行でき、すでに Claude Code サブスクリプションを持っている求職者。
  • 新しいポータルスキル(/add-portal)を追加してフレームワークを他の市場に拡張したい開発者。

注意事項とセキュリティノート(README による)

  • ワークフローは求人情報をサンドボックス化しません。隠しテキストや指示のような行を削除しますが、送信前に取得したコンテンツを確認する必要があります。
  • /setup によって書き込まれた個人データは追跡されたファイルに保存されます。データを公開したくない場合は、リポジトリをプライベートに保ってください。
  • Claude Code は有料サービスです。無料層はありません。
  • このプロジェクトは Anthropic とは提携していません。スポンサーシップの主張は詐欺です。

結論: AI Job Search は、Claude Code を活用して生の求人リストを洗練されたモデルレビュー済みの応募 PDF に変換する、具体的でオープンソースの自動化パイプラインであり、追跡、面接準備、スキル開発のための豊富な補助ツールを備えています。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト