Happy slice of mcp pizzaMCP.pizza

JobHuntBot

MCP.Pizza Chef: Raymon-boy-pal

JobHuntBot lets you organize your entire job search using an AI-driven workflow combined with a local progress dashboard. It works with AI coding assistants like Cursor or Claude Code to read your resumes and instructions, find job leads, help draft applications, and track progress in a browser-based dashboard on your own computer. It requires some setup but no special accounts, and always asks you before submitting applications to keep control safe.

Notes
Other
Web/Research

Use This MCP client To

Track all my job applications in one place Find and classify new job leads automatically Keep a local dashboard of application progress Get AI help drafting application materials Manage follow-ups and interview schedules Control when to submit applications Review blockers and triage issues in my job hunt

README

JobHuntBot

English below · 中文 在下方

An agent-led job application workflow and local progress-tracking dashboard. It works with any AI coding agent that can read a file and follow written instructions (Claude Code, Codex CLI, Cursor, etc.) — there's no special integration required, you just point the agent at SKILL.md and tell it to follow the workflow. It turns scattered job hunting into a repeatable system: candidate profile, screening rules, resume strategy, application execution, blocker triage, follow-up, and a browser-based dashboard to see it all at a glance.

This is not a one-click auto-apply bot. It is a structured workflow plus explicit safety boundaries — the agent stops and asks before guessing anything identity-, legal-, or compensation-related, and before it clicks final submit on any application.

What's in this repo

SKILL.md                        Core agent workflow and safety contract — start here
references/
  setup-workflow.md             Step-by-step onboarding the agent should follow
  application-playbook.md       Browser/ATS handling playbook (forms, uploads, CAPTCHA, etc.)
  safety-and-boundaries.md      Privacy, consent, and what should never be automated
templates/
  candidate_profile.template.json    Your facts: identity, contact, work authorization, targets
  application_rules.template.md      What to prioritize, consider, skip, or hand off to you
  resume_routing.template.md        Which resume/version to use for which role family
  answer_bank.template.md           Reusable truthful answers for common application questions
  experience_bank.template.md       Which internships/projects to feature per role family and JD
  dashboard-template/               Empty CSV dashboard + field reference (see its README.md)
dashboard/                       A ready-to-run local dashboard (same CSV schema as the template)
  server.js                     Zero-dependency static file server (Node.js, no npm install)
  dashboard.html                 The dashboard UI itself
  start-dashboard.bat / .sh     One-click launcher (Windows / macOS-Linux)
  *.csv                          Empty starter data files

Quick Start

JobHuntBot FAQ

Can I use this to organize and track my job applications?
Yes — JobHuntBot helps you manage your job search workflow and track progress locally with a dashboard.
Can I use this to automatically submit job applications?
Partially — it assists with application steps but always asks you to confirm before submitting any application to keep control and safety.
Which apps can I use JobHuntBot with?
It works with AI coding agents like Cursor, Claude Code, and Codex CLI that can read files and follow instructions.
Do I need an API key or special account to use JobHuntBot?
No — you just need to set it up with your AI agent and have browser access for submitting applications.
How hard is it to set up JobHuntBot?
Setup involves copying and pasting a small config snippet and preparing your materials folder, so it’s a moderate, copy-paste-config level.
Can I use JobHuntBot without browser automation?
Yes — you can do lead-finding and dashboard tracking without browser control, but submitting applications requires browser access.
Does JobHuntBot keep my personal data safe?
Yes — it stops and asks before handling sensitive info like identity or compensation, ensuring you stay in control.