$git clone https://github.com/debytesio/claude-plugin-jobhunterAI-powered job search plugin for Claude Code — multi-platform scraping, visa checks, salary analysis, ranked Excel exports
| 1 | <div align="center"> |
| 2 | |
| 3 | <img src="docs/images/debytes-logo.png" alt="DeBytes" width="80"> |
| 4 | |
| 5 | # Job Hunter |
| 6 | |
| 7 | **AI-powered job search for Claude Code** |
| 8 | |
| 9 | Search 14 job platforms across UK and France. Score every listing against your profile — skills, salary, visa, commute — and export a professional Excel report. |
| 10 | |
| 11 | *The job search autopilot recruiters don't want you to have.* |
| 12 | |
| 13 | [](https://github.com/debytesio/claude-plugin-jobhunter) |
| 14 | [](LICENSE) |
| 15 | [](https://github.com/debytesio/claude-plugin-jobhunter/releases) |
| 16 | []() |
| 17 | []() |
| 18 | |
| 19 | [](https://linkedin.com/company/debytes) |
| 20 | [](https://x.com/debytesio) |
| 21 | [](https://discord.gg/8BZZ2fQGhu) |
| 22 | |
| 23 | </div> |
| 24 | |
| 25 | <br> |
| 26 | |
| 27 | <div align="center"> |
| 28 | <img src="docs/images/cli-pipeline-results.png" alt="Job Hunter — pipeline results with Top 5 ranked jobs" width="800"> |
| 29 | <p><em>Full pipeline: 84 jobs scored, 16 financially viable, Top 5 ranked by composite score</em></p> |
| 30 | </div> |
| 31 | |
| 32 | ## Why Job Hunter? |
| 33 | |
| 34 | Most job search tools stop at scraping. Job Hunter goes further — it brings **ATS-grade analysis** to your side of the table: the same requirements matching, skill extraction, and experience parsing that recruiters use, now working for you. |
| 35 | |
| 36 | - **One command, 1,000+ jobs analysed** — parallel scraping across 14 platforms, deduplication, JD enrichment, and 8-dimension AI scoring |
| 37 | - **Real financial analysis** — country-specific tax, NI/social contributions, and commute costs calculated so you see your actual take-home before applying |
| 38 | - **Company intelligence** — employer ratings, visa sponsor verification (140k+ UKVI register), and recruitment agency detection built in |
| 39 | - **One command, full pipeline** — 450 jobs scraped, enriched, scored, and exported in under 10 minutes |
| 40 | |
| 41 | ## Quick Start |
| 42 | |
| 43 | ### 1. Install |
| 44 | |
| 45 | ``` |
| 46 | /plugin marketplace add debytesio/claude-plugins |
| 47 | /plugin install job-hunter@debytes |
| 48 | ``` |
| 49 | |
| 50 | ### 2. Run |
| 51 | |
| 52 | ``` |
| 53 | /job-hunter:find-jobs examples/job-expectations-example-gb.json |
| 54 | ``` |
| 55 | |
| 56 | A sample resume and expectations file are included — try it out of the box. First run opens your browser to authenticate with DEB Cloud (free trial, no card required). |
| 57 | |
| 58 | ## How It Works |
| 59 | |
| 60 | ``` |
| 61 | Expectations JSON |
| 62 | | |
| 63 | v |
| 64 | +-----------+ +-----------+ +-----------+ +-----------+ |
| 65 | | Scrape |-->| Dedup & |-->| Enrich |-->| Score | |
| 66 | | 14 boards | | Filter | | JDs | | 8 dims | |
| 67 | +-----------+ +-----------+ +-----------+ +-----------+ |
| 68 | | |
| 69 | +----------------------------------------------+ |
| 70 | v |
| 71 | +-----------+ +-----------+ +-----------------------+ |
| 72 | | Company |-->| Financial |-->| Excel Report | |
| 73 | | Checks | | Analysis | | 5 sheets, 21 columns | |
| 74 | +-----------+ +-----------+ +-----------------------+ |
| 75 | ``` |
| 76 | |
| 77 | <div align="center"> |
| 78 | <img src="docs/images/cli-scraping.png" alt="Parallel scraping with real-time progress" width="800"> |
| 79 | <p><em>Parallel scraping across 6 workers with real-time progress and credit tracking</em></p> |
| 80 | </div> |
| 81 | |
| 82 | ## Key Capabilities |
| 83 | |
| 84 | | Capability | Description | |
| 85 | |------------|-------------| |
| 86 | | **JD Enrichment** | Fetches and parses full job descriptions — extracts requirements, tech stack, seniority signals, and years of experience | |
| 87 | | **8-Dimension Scoring** | Role, skills, requirements, experience, seniority, salary, location, visa — AI-scored per job | |
| 88 | | **ATS-Grade Matching** | Requirements coverage, tech stack overlap, and experience fit — the same analysis recruiters run on your CV | |
| 89 | | **Financial Viability** | Tax + NI + commute = real take-home per job, per country. Know before you apply. | |
| 90 | | **Company Checks** | Employer ratings, UKVI visa sponsor status, and agency detection — in one step | |
| 91 | | **Smart Dedup** | Cross-platform deduplication so the same job from 3 boards appears once | |
| 92 | | **Session Persistence** | Checkpoints at every step — resume interrupted searches automatically | |
| 93 | | **Multi-Country** | UK (GBP, PAYE/NI) and France (EUR, impot/cotisations) — more countries planned | |
| 94 | |
| 95 | ## Output |
| 96 | |
| 97 | A polished Excel workbook with 5 sheets: |
| 98 | |
| 99 | | Sheet | Content | |
| 100 | |-------|---------| |
| 101 | | **{Role Name}** | Top matches for each target role, ranked by composite score | |
| 102 | | **All Results** | Every scored listing, sorted by score | |
| 103 | | **Score Breakdown** | Full 8-dimension scores + enrichment data | |
| 104 | | **Summary** | Search statistics, financial targets, per-city viable |