What is ai-job-scraper?

AI Job Hunt Agent is a tool that automates the job search process from start to finish. It reads a resume file you provide, searches the web for matching remote roles, uses Claude to score each job posting against your actual background, and writes a tailored cover letter for every job it decides is worth applying to. All of the results show up in a local web dashboard you can review in a browser. The pipeline runs in four steps. First, Claude reads your resume.md file and pulls out your target roles, key skills, and search queries. Second, a service called Firecrawl runs those search queries and scrapes the matching job board pages. Third, Claude scores every posting from 0 to 100 based on things like how well your skills match, seniority level, whether the role is genuinely remote, how fresh the listing is, and any warning signs, then gives an apply or skip verdict. Fourth, for every job marked apply, Claude drafts a short cover letter with a suggested angle. Nothing about your profession is hardcoded, so it can work for developers, designers, virtual assistants, writers, accountants, or marketers, since everything is derived from your own resume. Under the hood it is a Python and FastAPI backend with a single HTML file dashboard built with plain JavaScript and Tailwind, so there is no separate frontend build step. Setup requires Python 3.10 or newer, the Claude Code command line tool installed and signed in, and a Firecrawl API key. You install the requirements, copy the example environment file and add your Firecrawl key, then drop your own resume.md into the project folder, which stays on your machine and is never committed to the repository. You can run it either through the web dashboard, which shows live progress, or headlessly from the command line. Results land in an output folder as a scored jobs file, a file with every raw scraped listing, and a folder of cover letters. A config file lets you add or change which job boards and subreddits it searches, since the defaults cover general sites like LinkedIn and Indeed alongside a set of profession neutral subreddits.