apply-job

求人応募エージェント

複数のチャネルを通じて採用担当者に連絡する、自動求人応募システムです。

クイックスタート

/apply-job <url>              # Apply to specific job
/apply-job search <query>     # Search and batch apply
/apply-job outreach <url>     # Recruiter outreach only
/apply-job status             # View statistics
/apply-job score <url>        # Score job fit only

必要なセットアップ

初めて使用する前に、以下のファイルが存在することを確認してください。

ファイル	用途
$APPLIER_HOME/data/profile.json	個人情報（テンプレートから作成）
$APPLIER_HOME/data/applications.json	応募状況の追跡
$APPLIER_HOME/resume/master_resume.md	職務経歴書の完全版
$APPLIER_HOME/templates/cover_letter.md	カバーレターのテンプレート
$APPLIER_HOME/templates/cold_email.md	コールドメールのテンプレート

$APPLIER_HOME = ~/job-applier-agent（クロスプラットフォーム対応）

インストール手順については、SETUP.md を参照してください。

---

基本原則

AUTO-PROCEED モード

• 定型的な手順では、確認を求めないでください
• すぐに実行してください — ワークフロー全体を自動的に進めます
• 停止するのは、ログインが必要な場合、CAPTCHA、重大なエラー、適合スコアが 5.0 未満の場合のみです

⚠️ 連絡の順序（重要）

1. Find recruiters on LinkedIn (names, titles, URLs)
2. Discover email addresses (WebSearch company email pattern)
3. Send cold emails via Gmail FIRST
4. THEN send LinkedIn connection requests
5. Track everything in applications.json

メール = 主な連絡手段（返信率が高い）。LinkedIn = 副次的な連絡手段。

---

ワークフロー：求人 URL から応募

ステップ 1：求人情報を抽出

1. Navigate to job URL with Playwright
2. Capture page snapshot
3. Extract: title, company, location, requirements
4. Identify key skills/technologies

ステップ 2：求人との適合度をスコア化（各項目 0～10）

• 技術的適合度：スキルの一致率
• 職位の適合度：経験レベルに適しているか
• 勤務地：リモート／現地／転居
• ミッション：会社の方針との適合性

スコアが 5.0 以上 → 自動で続行 | スコアが 5.0 未満 → ユーザーに通知

ステップ 3：職務経歴書を調整

1. Read $APPLIER_HOME/resume/master_resume.md
2. Reorder projects by relevance to JD
3. Emphasize matching skills (use JD keywords)
4. Save to $APPLIER_HOME/applications/<Company>/

ルール：スキルを偽って追加しないでください。実績を捏造しないでください。順序の変更や強調のみにとどめてください。

ステップ 4：カバーレターを作成

1. Read $APPLIER_HOME/templates/cover_letter.md
2. Research company (WebFetch)
3. Personalize for role + company
4. Keep to 250-350 words
5. Save to $APPLIER_HOME/applications/<Company>/

ステップ 5：応募フォームに自動入力

プラットフォームに応じて Playwright を使ってフォームに入力します。

• LinkedIn の「簡単応募」
• 企業の採用ページ（Greenhouse、Lever、Workday、ADP など）
• 職務経歴書をアップロードし、入力欄がある場合はカバーレターを追加

ステップ 6：応募状況を記録してスクリーンショットを撮影

1. Take confirmation screenshot
2. Update $APPLIER_HOME/data/applications.json
3. Update stats

ステップ 7：採用担当者に連絡

詳しい連絡手順については、WORKFLOWS.md を参照してください。

概要：

1. LinkedIn で企業の採用担当者を検索（3 人以上）
2. WebSearch でメールアドレスを特定（企業のメールアドレス形式を利用）
3. Gmail でコールドメールを送信（テンプレートを使用）
4. メール送信後、LinkedIn でつながり申請を送信
5. すべての連絡履歴を applications.json に記録

---

採用担当者の連絡先を特定

一般公開されている連絡先情報のみを使用してください。

1. Check the recruiter's LinkedIn profile for contact info
2. Check the company careers page for recruiter contact details
3. Use the company's public contact form if no direct contact is available

---

プロフィールの設定

個人データはすべて $APPLIER_HOME/data/profile.json から取得します。

{
  "personal": {
    "name": "Your Name",
    "email": "[email protected]",
    "phone": "123-456-7890",
    "location": "City, State"
  },
  "links": {
    "website": "https://yoursite.com",
    "linkedin": "linkedin.com/in/you",
    "github": "github.com/you"
  },
  "education": {
    "school": "University Name",
    "degree": "BS Computer Science",
    "gpa": "3.9",
    "graduation": "May 2026"
  },
  "headline": "Your professional headline",
  "top_skills": ["Python", "React", "AWS"],
  "flagship_project": {
    "name": "Project Name",
    "description": "Brief description",
    "users": "100+"
  },
  "work_auth": true,
  "willing_to_relocate": true,
  "location_preference": ["Remote", "NYC", "SF"]
}

完全なテンプレートについては、profile-template.json を参照してください。

---

応募状況の追跡

$APPLIER_HOME/data/applications.json のスキーマ：

{
  "applications": [{
    "id": "company-date-001",
    "company": "Company Name",
    "role": "Job Title",
    "url": "https://...",
    "platform": "linkedin|greenhouse|workday|adp",
    "applied_date": "2026-01-27",
    "status": "applied|interviewed|rejected|offer",
    "fit_score": 7.5,
    "cover_letter": true,
    "outreach": [{
      "name": "Recruiter Name",
      "title": "Technical Recruiter",
      "email": "[email protected]",
      "linkedin": "linkedin.com/in/...",
      "email_sent": true,
      "connection_sent": true,
      "date": "2026-01-27"
    }]
  }],
  "stats": {
    "total": 0,
    "applied": 0,
    "interviewed": 0,
    "emailsSent": 0,
    "connectionsSent": 0
  }
}

---

コールドメールのテンプレート

Subject: Referral Request - [Role] Application | [School] [Major] Senior

Hi [First Name],

I just applied for the [Role] position at [Company] and wanted to reach out.

I'm a [Major] senior at [School] ([GPA] GPA) graduating [Graduation].
[Flagship project description with metrics].

[1-2 sentences about why THIS company excites you]

Would appreciate if you could review my application or put in a referral.

Thanks!
[Name]
[Website]
[Phone]

ルール：150 語未満にしてください。会社についての一文は相手に合わせて調整してください。連絡先情報を記載してください。

---

エラー処理

エラー	対応
ログインが必要	ユーザーに通知し、「continue」を待つ
CAPTCHA	ユーザーに通知して待機
レート制限	60 秒待って 1 回再試行し、まだブロックされる場合はスキップ
メール送信失敗	ログに記録し、LinkedIn での連絡を続行
フォーム項目が見つからない	スクリーンショットを撮影し、ユーザーに確認

---

参照ファイル

ファイル	内容
WORKFLOWS.md	詳細な手順ごとのワークフロー
SETUP.md	インストールと設定
profile-template.json	プロフィールデータのテンプレート

---

パス変数

変数	デフォルト	説明
$APPLIER_HOME	~/job-applier-agent	ベースディレクトリ
$APPLICATIONS_DIR	$APPLIER_HOME/applications	企業ごとのファイル

クロスプラットフォーム対応：すべての OS でホームディレクトリに展開される ~/ を使用してください。

---

ベストプラクティス

1. まずメール、次に LinkedIn - 接続申請を送る前に、必ずメールを送信します
2. 自動で進める - 質問せずに実行します（重大なエラーを除く）
3. すべて記録する - アクションのたびに applications.json を更新します
4. 個別にカスタマイズする - アウトリーチでは企業の具体的な情報に触れます
5. スクリーンショットを撮る - 記録用に確認画面を保存します
6. 正直であること - スキルや実績を決して捏造しません

---

行数：約280（500行未満 ✓） クロスプラットフォーム対応：はい（~/ パスを使用）✓ ユーザー非依存：はい（profile.json にデータを保存）✓