JobSearch-Agent

# JobSearch Agent

<p align="center">
  <a href="https://www.python.org/downloads/">
    <img src="https://img.shields.io/badge/python-3.10%2B-blue.svg" alt="Python 3.10+">
  </a>
  <a href="https://github.com/sreekar2858/JobSearch-Agent/blob/main/LICENSE">
    <img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT">
  </a>
  <a href="https://github.com/sreekar2858/JobSearch-Agent/issues">
    <img src="https://img.shields.io/github/issues/sreekar2858/JobSearch-Agent" alt="GitHub issues">
  </a>
</p>

An intelligent job search automation system with **LinkedIn scraping**, **AI-powered CV generation**, and **cover letter creation**. Extract detailed job data, company information, and hiring team details with advanced anonymization and proxy support.

## 📋 Table of Contents

- [🚀 Quick Start](#-quick-start)
- [📖 Documentation](#-documentation)
- [⚡ Common Commands](#-common-commands)
- [📁 Project Structure](#-project-structure)
- [⚙️ Configuration](#-configuration)
- [📊 Output & Results](#-output--results)
- [🚦 Best Practices & Guidelines](#-best-practices--guidelines)
- [🔧 Troubleshooting](#-troubleshooting)
- [📚 Documentation & Support](#-documentation--support)
- [🤝 Contributing](#-contributing)
- [📄 License](#-license--disclaimer)

---

## 🚀 Quick Start

### 1. Installation
```bash
git clone https://github.com/sreekar2858/JobSearch-Agent.git
cd JobSearch-Agent
pip install -r requirements.txt
```

### 2. Setup (Optional but Recommended)
Create a `.env` file for enhanced features:
```env
# LinkedIn credentials (for better scraping results)
[email protected]
LINKEDIN_PASSWORD=your_password

# AI API key (for CV/cover letter generation)  
GOOGLE_API_KEY=your_gemini_api_key
```

### 3. Start Scraping
```bash
# LinkedIn job search
python -m src.scraper.search.linkedin_scraper "Software Engineer" "San Francisco" --max-jobs 10

# Get credentials for job sites
python -m src.scraper.buggmenot --website glassdoor.com