Skip to content

Repository files navigation

JobScanner

Job dating app for Mistral MCP Hackathon - An MCP server that helps users find jobs, personalize their CV, and automate job applications.

Setup & API Keys

Required API Keys

ServiceKeyHow to GetPurpose
RapidAPIRAPIDAPI_KEY1. Visit RapidAPI
2. Sign up/login
3. Subscribe to JSearch API
4. Get your API key
Job search functionality
BrowserbaseBROWSERBASE_API_KEY
BROWSERBASE_PROJECT_ID
1. Visit Browserbase
2. Create account
3. Create a project
4. Get API key and project ID
Browser automation for form filling
Google AIMODEL_API_KEY1. Visit Google AI Studio
2. Create API key
AI-powered form completion
AWSAWS_ACCESS_KEY_ID
AWS_SECRET_ACCESS_KEY
1. AWS Console → IAM
2. Create user with S3 permissions
3. Generate access keys
File storage for CV templates

Environment Setup

  1. Create a .env file in the project root:
RAPIDAPI_KEY=your-rapidapi-key-here
BROWSERBASE_API_KEY=your-browserbase-key-here
BROWSERBASE_PROJECT_ID=your-project-id-here
MODEL_API_KEY=your-gemini-key-here
AWS_ACCESS_KEY_ID=your-aws-access-key
AWS_SECRET_ACCESS_KEY=your-aws-secret-key
  1. Load environment variables:
# Option 1: Load from .env file (if using python-dotenv)
python -c "from dotenv import load_dotenv; load_dotenv()"# Option 2: Export manuallyexport RAPIDAPI_KEY="your-key"export BROWSERBASE_API_KEY="your-key"# ... etc

External Tools & Services

ServiceLibrary/PackagePurpose
JSearch APIhttpxJob search and listings
BrowserbasebrowserbaseHeadless browser automation
Stagehandstagehand-pyAI-powered form filling
Google Geministagehand-pyAI model for form completion
AWS S3boto3File storage and hosting
Overleaf-LaTeX compilation service
Vercel BlobhttpxResume file storage

Available Tools

ToolDescriptionExternal Dependencies
search_jobsSearch for job offers using multiple queriesRapidAPI JSearch
fetch_urlFetch content from any URLNone
fill_application_formAuto-fill job application formsBrowserbase, Stagehand, Gemini
add_job_application_entryTrack job applications locallyNone
get_job_application_entriesExport tracked applications as CSVNone
update_user_infoUpdate professional informationNone
read_user_infoRead stored professional infoNone
list_templatesList available CV templatesNone
read_templateRead LaTeX CV template filesNone
upload_tex_then_compile_with_overleafUpload LaTeX to AWS and create Overleaf linkAWS S3
create_texGenerate LaTeX files from contentNone

Running

python main.py

Architecture

This MCP server integrates multiple services to provide end-to-end job search assistance:

  • Job Discovery: Uses RapidAPI's JSearch for comprehensive job listings
  • CV Personalization: LaTeX templates with Overleaf integration
  • Application Automation: Browserbase + Stagehand for automated form filling
  • File Storage: AWS S3 for CV hosting, Vercel Blob for resume storage
  • AI Enhancement: Google Gemini for intelligent form completion

About

Mistral MCP Hackathon – Top 6 Finalist & Community Vote 2nd Place 🏆

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages