Outreachr

This project automates the process of finding and drafting outreach messages to recruiters using a multi-agent system powered by CrewAI.

Setup

1. Install Dependencies:

   pip install -r requirements.txt

2. Environment Variables: Create a .env file in the root directory or set the variables.

   Required:

   • OPENAI_API_KEY: API key for your LLM provider (e.g., OpenAI).

   Optional:

   • TAVILY_API_KEY: API key for Tavily Search (required for real search).
   • MOCK_SEARCH: Set to True (case-insensitive) to use mock search results (no API key needed).
   • DATABASE_URL: Connection string for SQLAlchemy (defaults to sqlite:///recruiter_outreach.db).

Usage

Run the script with the company name and target role:

python main.py --company "Google" --role "Software Engineer"

How it Works

1. Cache Check: Checks the local database for recent outreach (last 24 hours).
2. Research Agent: Finds recruiters using Tavily (or mock data).
3. Ranking Agent: Selects the top 3 relevant recruiters.
4. Copywriter Agent: Drafts a personalized LinkedIn DM for each.
5. Output: Prints the result as JSON and saves it to the database.

Output Format

The output is a JSON list:

[
  {
    "recruiter_name": "Name",
    "linkedin_url": "URL",
    "reason_for_ranking": "Reason...",
    "draft_message": "Message..."
  }
]