README.md

---
title: LinkedIn Profile Finder & Verifier
emoji: 🔍
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 4.44.0
app_file: app.py
pinned: false
license: mit
---

# LinkedIn Profile Finder & Verifier

An AI-powered tool that finds and verifies LinkedIn profiles for specific roles at companies using advanced search and verification algorithms.

## Features

- 🤖 **Dual AI Agents**: Uses GPT-4o-mini for intelligent candidate finding and verification
- 🚀 **Parallel Processing**: Fast verification with concurrent API calls
- 📊 **Structured Outputs**: Reliable parsing with Pydantic validation
- 🔍 **Advanced Search**: SerpAPI integration with comprehensive logging
- ✅ **Smart Verification**: Confidence-based scoring with detailed reasoning
- 🧹 **Intelligent Parsing**: Automatic company name cleaning and optimization

## How to Use

1. **Enter Company Name**: Input the target company (e.g., "Ameriprise", "Goldman Sachs")
2. **Add Website (Optional)**: Company website for better matching accuracy
3. **Select Role**: Choose from engineering, product, sales, finance, or legal
4. **Run Search**: Get top 5 verified LinkedIn profiles with confidence scores

## Technology Stack

- **Frontend**: Gradio for interactive web interface
- **AI Models**: OpenAI GPT-4o-mini for cost-effective processing
- **Search**: SerpAPI for LinkedIn profile discovery
- **Validation**: Pydantic for structured data handling
- **Processing**: Concurrent execution for optimal performance

## Configuration

The app uses environment variables for API keys:
- `OPENAI_API_KEY`: Required for AI processing
- `SERPAPI_API_KEY`: Required for LinkedIn search

## Version

Current version: v2.6.5-patch with intelligent company name cleaning and parallel processing optimizations.