BalaGaneshKumar

Job Hunter Agent Phase 2

Development community

SOURCE https://github.com/BalaGaneshKumar/Job-Hunter-Agent-Phase-2

Description

Phase 2 rebuild of a job-hunting dashboard built entirely by prompting Claude, with no programming background. Scraping is replaced with official job APIs (Adzuna, JSearch, JobsPipe) and SQLite storage — a fully documented, ToS-compliant local tool for tracking applications.

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

Job Hunter Agent — Phase 2

A personal job-search dashboard: fetches job listings via legitimate job-board APIs (no scraping), stores them in SQLite, and provides a browser dashboard to review, filter, and track applications end-to-end.

Built with Claude, no prior programming background.

**Phase 1 note:** an earlier version of this project scraped job portals directly with Selenium. That approach was stopped and archived separately because those portals' Terms of Service prohibit automated scraping. Phase 2 is a full rebuild on official APIs (Adzuna, JSearch, JobsPipe) instead.

Features

Scraper Abyss — configure keyword/location/portal combinations and run a background workflow that fetches jobs from live job-board APIs.
Job Odyssey — browse, filter, and triage fetched jobs (Scraped → Eligible / Hold / Ineligible / Blacklist → Applied).
Career Tracker — track applications and job-site credentials in one place, independent of the scraper.
Profile Nexus — a single structured profile (personal info, education, experience, work auth, etc.) reusable across applications.
Workflow Detail — live progress view per workflow run: stages, logs, hold/cancel/retry controls.

Architecture

dashboard_server.py        HTTP server — routes, static page assembly, API endpoints
├── dashboard_ui.py         Shared CSS / page shell
├── dashboard_profile.py    Profile Nexus tab (reads/writes profile.json)
├── dashboard_career.py     Career Tracker tab (Applications + Job Sites)
├── dashboard_jobodyssey.py Job Odyssey tab (job browser/filter/actions)
├── dashboard_scraper.py    Scraper Abyss tab (request builder + workflow list)
├── dashboard_workflow_detail.py  Per-workflow detail page
└── dashboard_log.py        Server console logs + per-tab in-memory activity logs

workflow_engine.py          Background pipeline: fetch → validate → dedupe → store
├── real_adzuna.py           Adzuna API client
├── real_jsearch.py          JSe