job-hunter

name: job-hunter description: | Automated job hunting skill that searches jobs via JobSpy (LinkedIn guest API, free) and JSearch (RapidAPI/Google Jobs, 200 req/month free), matches them to your resume using scoring, generates personalized cover letters, and saves results to Obsidian.

Triggers: /job-hunt, "find jobs", "job search", "hunt for jobs"

Job Hunter Skill

Automates your job search: scrapes LinkedIn, Indeed, and 100+ job boards daily, scores every posting against your resume, and saves a ranked tracker to Obsidian. No LinkedIn account needed.

Quick Start

First-Time Setup

1. Set up virtual environment:

   bash ~/.claude/skills/job-hunter/scripts/setup_venv.sh
   

2. Configure preferences:

   ~/.venv/job-hunter/bin/python3 ~/.claude/skills/job-hunter/scripts/setup_config.py
   

3. Set your resume path (PDF, DOCX, or TXT)

4. Set Obsidian vault path

Usage

Run the job hunt:

/job-hunt

Or with specific options:

/job-hunt --keywords "software engineer" --location "San Francisco"

How It Works

Two complementary providers run on a smart schedule:

On days both run, results are merged and deduplicated. On off-days, JobSpy runs alone.

Workflow

When invoked, the skill executes these steps:

1. Load Configuration

• Read config from ~/.config/job-hunter/config.json
• Validate paths and optional API keys

2. Read Resume

• Load resume from configured path
• Extract key skills for matching

3. Search Jobs — JobSpy (daily) + JSearch (every 2 days)

JobSpy hits LinkedIn's undocumented public guest API — no login, no API key, returns full job descriptions (~60 results/run).

JSearch queries Google Jobs via RapidAPI, aggregating postings from LinkedIn, Indeed, Dice, Remotive, and 100+ company career pages (~100 results/run).

The scheduler uses a state file (~/.job-hunter-jsearch-last-run) to decide whether JSearch runs. If both run, their outputs are merged and deduplicated:

JobSpy  ~60 jobs ─┐
                  ├─ deduplicate → ~130–160 unique jobs
JSearch ~100 jobs─┘

4. Score against resume

Each job is scored 0–100 based on skill keyword matching:

• +5 per skill match (Python, SQL, machine learning, etc.)
• Bonus: role alignment (+15), healthcare domain (+10), EHR tools (+8), remote (+5)
• Skills are extracted automatically from your resume (PDF/DOCX/TXT)

5. Save Job Tracker to Obsidian

Writes Job Tracker - YYYY-MM-DD.md with all jobs scoring > 70, sorted by score descending. Idempotent — skips if today's file already exists.

| # | Score | Title | Company | Salary | Remote | Source | Link |
|---|-------|-------|---------|--------|--------|--------|------|
| 1 | 100   | Data Engineer II | Dana-Farber Cancer Institute | - | Yes | Indeed | [Apply](url) |
| 2 | 100   | Senior Health Data Informaticist | Veeva Systems | - | Yes | Linkedin | [Apply](url) |

6. Wait for User Selection — STOP HERE

After saving the tracker:

"Saved X jobs to Job Tracker - YYYY-MM-DD.md in Obsidian. Review the file and tell me which numbers you'd like cover letters for (e.g. '1, 3')."

Never auto-generate cover letters. Always wait for user to select.

7. Generate Cover Letters

~/.venv/job-hunter/bin/python3 ~/.claude/skills/job-hunter/scripts/generate_cover_letters.py \
  --jobs /path/to/scored_jobs.json \
  --indices "1,3"

Saves to Cover Letters/YYYY-MM-DD/Company - Title.md in your Obsidian vault.

Configuration Reference

Config file: ~/.config/job-hunter/config.json

{
  "jsearch_api_key": "your-rapidapi-key",
  "search_provider": "jobspy",
  "resume_path": "/path/to/resume.pdf",
  "obsidian_vault": "~/Documents/Obsidian Vault/job-hunter",
  "user_name": "Your Name",
  "search": {
    "keywords": ["data analyst", "healthcare data analyst", "research analyst"],
    "location": "Boston, MA",
    "remote": true,
    "time_range": "week",
    "max_results_per_query": 20,
    "job_domains": ["linkedin.com", "indeed.com", "glassdoor.com"]
  }
}

Key Fields

Scripts

Obsidian Structure

job-hunter/
├── Job Tracker - 2026-02-28.md   # Today's tracker
├── Job Tracker - 2026-02-27.md   # Yesterday's tracker
├── Cover Letters/
│   ├── 2026-02-28/
│   │   ├── Dana-Farber - Data Engineer II.md
│   │   └── Veeva Systems - Senior Health Data Informaticist.md
│   └── 2026-02-27/

Scheduling

Set up a daily cron to run the full pipeline automatically:

# Run job hunt daily at 10am
0 10 * * * bash ~/.claude/skills/job-hunter/scripts/daily_job_hunt.sh

The script decides internally whether to also run JSearch (every 2 days). To force a JSearch run:

rm ~/.job-hunter-jsearch-last-run

API Usage & Cost

Troubleshooting

No jobs found

• Broaden search keywords in config
• Check ~/.job-hunter.log for errors

JSearch API errors

• Verify key at rapidapi.com
• Check monthly usage (200 free requests)
• Delete ~/.job-hunter-jsearch-last-run to retry

Glassdoor 400 errors in logs

• Known upstream issue in JobSpy — non-fatal, LinkedIn/Indeed results still collected

Virtual environment issues

• Re-run bash ~/.claude/skills/job-hunter/scripts/setup_venv.sh
• Requires Python 3.10+