tarunlnmiit/autopilot-jobhunt

**Your AI job agent. Finds, scores, and drafts applications — while you sleep.**
> Scans 130+ company careers pages nightly → scores every role against your resume with an LLM → sends you the top matches on Telegram → drafts a tailored resume + cover letter on demand.
>
> 🔒 **Drafts only — never applies.** You review every draft and submit applications yourself. See PRIVACY.md for exactly what data leaves your machine.
**Seen by 90K+ people** — the Instagram reel that launched it.
Published on PyPI and listed on the Official MCP Registry (io.github.tarunlnmiit/autopilot-jobhunt), Glama (Quality A), and Smithery (MCPB bundle).
**📖 Full setup guide with Claude Code MCP integration → SETUP.md**
> ### ⭐ Star this repo if it helps you land a job
> This tool is free, open source, and runs entirely on your machine — no subscription, no credit card. The only "payment" I ask: **if it surfaces a role you apply to (or land), drop a star.** It takes one click, costs you nothing, and it's the single thing that pushes the project in front of the next person grinding through 130 careers pages by hand. **⭐ Star it here →**
---
How it works
**The scoring prompt uses your actual resume** — not keywords. The LLM reads your full work history and the job description, then explains in one sentence why you fit or don't. No more guessing.
What a scan result looks like
What the Telegram notification looks like
---
What it does
---
Usage modes
Both modes use the same config and produce the same output.
Quick start
Option A — pip install
Option B — clone (recommended if you want to customize companies or contribute)
**For the full walkthrough** — API key setup, Claude Code MCP registration, rate limit details, and troubleshooting — see **SETUP.md**.
📚 Documentation
Step-by-step guides live in docs/:
| Guide | Covers |
|---|---|
| Install | pip / from source / autopilot init scaffolding |
| LLM providers | OpenRouter fallback chain, Claude CLI (keyless), Anthropic API |
| API keys | TinyFish + OpenRouter keys, where each goes |
| Companies & scanning | companies.json, discovery + scoring, scan pacing |
| Integrations | Telegram notifications |
| MCP server & Skill | Drive the hunt from Claude Code |
| Config & scoring | Candidate profile, min_score, top_n |
| Troubleshooting | Every error we've hit, and the fix |
| Testing checklist | Reproducible independent verification |
API keys needed
| Service | Cost | Required | Where to get it |
|---|---|---|---|
| **TinyFish** | **Free** — no credit card | Always | agent.tinyfish.ai |
| **OpenRouter** | **Free** — 4-model fallback chain | Unless using Claude CLI / Anthropic | openrouter.ai |
| **Telegram** | Free | Optional | @BotFather on Telegram |
---
Claude Code / MCP integration
Use autopilot-jobhunt as an MCP server inside **Claude Code** (CLI) or **Claude Desktop**.
Step 1: Install with MCP support
Step 2: Register with Claude Code
**Option A — one command:**
**Option B — edit ~/.claude.json manually:**
> **Note:** cwd must point to the cloned repo — the server reads config.json and companies.json from there.