Job Hunter

AI-powered job search for Claude Code

Search 14 job platforms across UK and France. Score every listing against your profile — skills, salary, visa, commute — and export a professional Excel report.

</div> <br> <div align="center"> <img src="docs/images/cli-pipeline-results.png" alt="Job Hunter — pipeline results with Top 5 ranked jobs" width="800"> <p><em>Full pipeline: 84 jobs scored, 16 financially viable, Top 5 ranked by composite score</em></p> </div>

Why Job Hunter?

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.

One command, 1,000+ jobs analysed — parallel scraping across 14 platforms, deduplication, JD enrichment, and 8-dimension AI scoring
Real financial analysis — country-specific tax, NI/social contributions, and commute costs calculated so you see your actual take-home before applying
Company intelligence — employer ratings, visa sponsor verification (140k+ UKVI register), and recruitment agency detection built in

Quick Start

1. Install

/plugin marketplace add debytesio/claude-plugins
/plugin install job-hunter@debytes

2. Run

/job-hunter:find-jobs examples/job-expectations-example-gb.json

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 account).

How It Works

Expectations JSON
       |
       v
+-----------+   +-----------+   +-----------+   +-----------+
|  Scrape   |-->|  Dedup &  |-->|  Enrich   |-->|  Score    |
| 14 boards |   |  Filter   |   |  JDs      |   |  8 dims   |
+-----------+   +-----------+   +-----------+   +-----------+
                                                      |
       +----------------------------------------------+
       v
+-----------+   +-----------+   +-----------------------+
|  Company  |-->| Financial |-->|  Excel Report         |
|  Checks   |   | Analysis  |   |  5 sheets, 21 columns |
+-----------+   +-----------+   +-----------------------+
                                          |
                                          v
                                +-----------------------+
                                |  Web Artifacts        |
                                |  (coming soon)        |
                                +-----------------------+

<div align="center"> <img src="docs/images/cli-scraping.png" alt="Parallel scraping with real-time progress" width="800"> <p><em>Parallel scraping across 6 workers with real-time progress and credit tracking</em></p> </div>

Key Capabilities

| Capability | Description | |------------|-------------| | JD Enrichment | Fetches and parses full job descriptions — extracts requirements, tech stack, seniority signals, and years of experience | | 8-Dimension Scoring | Role, skills, requirements, experience, seniority, salary, location, visa — AI-scored per job | | ATS-Grade Matching | Requirements coverage, tech stack overlap, and experience fit — the same analysis recruiters run on your CV | | Financial Viability | Tax + NI + commute = real take-home per job, per country. Know before you apply. | | Company Checks | Employer ratings, UKVI visa sponsor status, and agency detection — in one step | | Smart Dedup | Cross-platform deduplication so the same job from 3 boards appears once | | Session Persistence | Checkpoints at every step — resume interrupted searches automatically | | Multi-Country | UK (GBP, PAYE/NI) and France (EUR, impot/cotisations) — more countries coming soon | | Web Artifacts | View and manage results on the DEB Cloud portal (coming soon) |

Output

A polished Excel workbook with 5 sheets:

| Sheet | Content | |-------|---------| | {Role Name} | Top matches for each target role, ranked by composite score | | All Results | Every scored listing, sorted by score | | Score Breakdown | Full 8-dimension scores + enrichment data | | Summary | Search statistics, financial targets, per-city viable counts | | Guide | Column explanations, color coding legend, scoring methodology |

Every job title is a clickable link. Non-viable jobs are highlighted in red. Scores are color-coded. Company ratings show source on hover.

<div align="center"> <img src="docs/images/excel-results.png" alt="Excel output — role tab with ranked results" width="800"> <p><em>Ranked results with color-coded scores, financial viability, and clickable links</em></p> </div> <div align="center"> <img src="docs/images/excel-summary.png" alt="Summary sheet" width="500"> <p><em>Structured summary with financial targets and per-city breakdown</em></p> </div>

More countries coming soon — stay tuned.

Supported Platforms

UK — Indeed, LinkedIn, Reed, Totaljobs, CW Jobs, CV-Library, Adzuna

France — Indeed, LinkedIn, Welcome to the Jungle, APEC, HelloWork, Les Jeudis

Pricing

Free 14-day trial with 250 credits — enough for several full searches including scraping, enrichment, and scoring.

Need more? Upgrade at debytes.io/products/cloud.

System Requirements

Python 3.13+
openpyxl

| Platform | Architecture | Minimum Version | |----------|-------------|-----------------| | Windows | x86_64 | Windows 10 | | Linux | x86_64 | Ubuntu 22.04 / Debian 12 / Fedora 38 (glibc 2.35+) | | macOS | ARM64 (Apple Silicon) | macOS 14 Sonoma | | macOS | x86_64 (Intel) | macOS 13 Ventura |

Documentation

Community & Support

Discord — questions, feedback, feature requests
GitHub Issues — bug reports
docs.debytes.io — full documentation

Contributing

We welcome contributions. Please open an issue first to discuss what you'd like to change.

License

Apache-2.0

Documentation · Credits & Pricing · Report a Bug

Built by DeBytes

LinkedIn · GitHub · X

</div>

Claude Plugin Jobhunter

Install / Use

README