MCPcopy Index your code
hub / github.com/ZackHu-2001/apply-bot

github.com/ZackHu-2001/apply-bot @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
125 symbols 275 edges 34 files 0 documented · 0%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Apply Bot

AI-powered job application assistant - describe what you want, it handles the rest.

License: MIT

Website | Video Demo | Setup Guide | Issues


Video Demo

Apply Bot Demo


Features

  • Natural Language Control - Just describe the jobs you want
  • Real Browser Integration - Uses your actual browser session
  • Privacy-First - All data stored locally
  • Smart Filtering - Whitelist/blacklist companies, skip certain jobs
  • Application Tracking - Track all submissions in one place
  • Session Logging - Detailed logs of AI actions and reasoning

Quick Example

You: "Apply to Software Engineer positions in Vancouver posted in last 24 hours on LinkedIn"

Bot: Searches, filters, and applies automatically based on your resume and preferences.

Requirements

  • Node.js 21+
  • Chrome/Edge browser
  • MCP-compatible AI tool (Claude Desktop, Cursor, VSCode, Windsurf, etc.)

Quick Start

# Clone the repo
git clone https://github.com/ZackHu-2001/apply-bot.git
cd apply-bot

# Install dependencies
npm install

# Start the dashboard & backend service
npm run start

See the full Setup Guide for detailed instructions.

Tech Stack

  • Frontend: React + TypeScript + Tailwind CSS
  • Backend: Express.js
  • Browser Automation: Playwright MCP Server
  • AI: Any MCP-compatible LLM

Project Structure

apply-bot/
├── src/           # React frontend
├── data/          # Local data storage
│   ├── applied.json      # Application records
│   ├── knowledge.json    # AI memory
│   ├── prompts.json      # Prompt templates
│   ├── job-filters.json  # Filter settings
│   └── logs.json         # Session logs
└── server.js      # Express backend

Contributing

PRs welcome! See Contributing Guide.

License

MIT - see LICENSE


Disclaimer: Use responsibly and comply with platform terms of service.

Extension points exported contracts — how you extend this code

ApplyFilters (Interface)
(no doc)
src/types/filters.ts
LayoutProps (Interface)
(no doc)
src/components/Layout.tsx
Application (Interface)
(no doc)
src/pages/Dashboard.tsx
FiltersState (Interface)
(no doc)
src/store/filtersStore.ts
PlaywrightConnectionStatus (Interface)
(no doc)
src/hooks/usePlaywrightConnection.ts
JobApplication (Interface)
(no doc)
src/types/filters.ts
SwitchProps (Interface)
(no doc)
src/components/ui/switch.tsx
KnowledgeEntry (Interface)
(no doc)
src/pages/KnowledgeBase.tsx

Core symbols most depended-on inside this repo

cn
called by 26
src/lib/utils.ts
handleFilterChange
called by 10
src/pages/Config.tsx
fetchJobFilters
called by 7
src/pages/Config.tsx
fetchPrompts
called by 5
src/pages/Prompts.tsx
setApplications
called by 4
src/utils/storage.ts
applyTheme
called by 4
src/store/themeStore.ts
getThemeLabel
called by 3
src/components/Sidebar.tsx
fetchResumes
called by 3
src/pages/Config.tsx

Shape

Function 102
Interface 23

Languages

TypeScript100%

Modules by API surface

src/pages/Config.tsx21 symbols
src/pages/Prompts.tsx14 symbols
src/pages/KnowledgeBase.tsx13 symbols
src/utils/storage.ts10 symbols
src/pages/Logs.tsx9 symbols
src/pages/Applications.tsx9 symbols
src/pages/Dashboard.tsx7 symbols
src/pages/Scheduler.tsx6 symbols
src/pages/Monitor.tsx5 symbols
src/store/themeStore.ts4 symbols
src/hooks/usePlaywrightConnection.ts4 symbols
src/components/Sidebar.tsx3 symbols

For agents

$ claude mcp add apply-bot \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact