apply-job

name	apply-job
description	Automated job applications with AI-powered resume tailoring, cover letters, and recruiter outreach via email and LinkedIn.
license	MIT
metadata	{"author":"theaayushstha1","version":"3.2.0"}
allowed-tools	["Read","Write","Edit","Glob","Grep","WebFetch","WebSearch","mcp__playwright__browser_navigate","mcp__playwright__browser_snapshot","mcp__playwright__browser_click","mcp__playwright__browser_type","mcp__playwright__browser_fill_form","mcp__playwright__browser_file_upload","mcp__playwright__browser_take_screenshot","mcp__playwright__browser_wait_for","mcp__playwright__browser_press_key"]

Job Application Agent

Automated job application system with multi-channel recruiter outreach.

Quick Start

/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

Setup Required

Before first use, ensure these files exist:

File	Purpose
$APPLIER_HOME/data/profile.json	Your personal info (from template)
$APPLIER_HOME/data/applications.json	Application tracking
$APPLIER_HOME/resume/master_resume.md	Your complete resume
$APPLIER_HOME/templates/cover_letter.md	Cover letter template
$APPLIER_HOME/templates/cold_email.md	Cold email template

$APPLIER_HOME = ~/job-applier-agent (cross-platform)

See SETUP.md for installation instructions.

---

Core Principles

AUTO-PROCEED Mode

• DO NOT ask for confirmation at routine steps
• JUST DO IT - proceed through entire workflow automatically
• ONLY STOP for: login walls, CAPTCHA, critical errors, fit score < 5.0

⚠️ Outreach Order (CRITICAL)

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

Email = PRIMARY (higher response rate). LinkedIn = SECONDARY.

---

Workflow: Apply to Job URL

Step 1: Extract Job Description

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

Step 2: Score Job Fit (0-10 each)

• Technical Fit: Skills match percentage
• Level Match: Appropriate for experience level
• Location: Remote/local/relocation
• Mission: Company alignment

Score >= 5.0 → AUTO-PROCEED | Score < 5.0 → Notify user

Step 3: Tailor Resume

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>/

Rules: Never add fake skills. Never fabricate metrics. Only reorder/emphasize.

Step 4: Generate Cover Letter

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>/

Step 5: Auto-Fill Application

Use Playwright to fill forms based on platform:

• LinkedIn Easy Apply
• Company career pages (Greenhouse, Lever, Workday, ADP, etc.)
• Upload resume, add cover letter if field exists

Step 6: Track & Screenshot

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

Step 7: Recruiter Outreach

See WORKFLOWS.md for detailed outreach steps.

Summary:

1. Search LinkedIn for company recruiters (3+ people)
2. Discover emails via WebSearch (company email pattern)
3. Send cold emails via Gmail (use template)
4. Send LinkedIn connections (after emails)
5. Track all outreach in applications.json

---

Recruiter Contact Discovery

Use publicly available contact information only:

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

---

Profile Configuration

All personal data comes from $APPLIER_HOME/data/profile.json:

{
  "personal": {
    "name": "Your Name",
    "email": "[e-mail]",
    "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"]
}

See profile-template.json for full template.

---

Application Tracking

$APPLIER_HOME/data/applications.json schema:

{
  "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": "[e-mail]",
      "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
  }
}

---

Cold Email Template

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]

Rules: Under 150 words. Personalize company line. Include contact info.

---

Error Handling

Error	Action
Login required	Notify user, wait for "continue"
CAPTCHA	Notify user, wait
Rate limit	Wait 60s, retry once, skip if still blocked
Email failed	Log, continue with LinkedIn
Form field missing	Screenshot, ask user

---

Reference Files

File	Content
WORKFLOWS.md	Detailed step-by-step workflows
SETUP.md	Installation & configuration
profile-template.json	Profile data template

---

Path Variables

Variable	Default	Description
$APPLIER_HOME	~/job-applier-agent	Base directory
$APPLICATIONS_DIR	$APPLIER_HOME/applications	Per-company files

Cross-platform: Use ~/ which expands to home directory on all OS.

---

Best Practices

1. Email FIRST, LinkedIn SECOND - Always send emails before connections
2. AUTO-PROCEED - Don't ask, just do (except critical errors)
3. Track everything - Update applications.json after every action
4. Personalize - Reference specific company details in outreach
5. Screenshot - Capture confirmation for records
6. Be honest - Never fabricate skills or metrics

---

Line Count: ~280 (under 500 ✓) Cross-Platform: Yes (uses ~/ paths) ✓ User-Agnostic: Yes (data in profile.json) ✓