Speaker Finder

GDPR/DSGVO compliant speaker discovery tool for research and academic use.

Features

• Multi-source speaker search (keynotes, conferences, TED talks, panels)
• AI-powered relevance scoring with region filtering
• Personalized email draft generation
• GDPR compliant - no email scraping or personal data storage

Installation

git clone https://github.com/GeoLambdaAI/speaker-finder.git
cd speaker-finder
pip install -r requirements.txt
cp .env.example .env
# Edit .env and add your API keys

Configuration

Required API keys in .env:

• SERPER_API_KEY - Get from serper.dev
• MISTRAL_API_KEY - Get from mistral.ai

Usage

CLI

# Basic search
python speaker_finder.py "machine learning"

# With region filter and save drafts
python speaker_finder.py "AI" --region Germany --max 5 --output drafts.txt

# Full options
python speaker_finder.py "climate change" \
    --region "Europe" \
    --max 5 \
    --name "Your Name" \
    --institution "Your Institution" \
    --email "[email protected]" \
    --output drafts.txt

Python API

import asyncio
from speaker_finder import speaker_finder_pipeline, UserProfile, print_progress

async def main():
    user = UserProfile(
        name="Your Name",
        institution="Your Institution",
        contact_email="[email protected]"
    )
    results = await speaker_finder_pipeline(
        "machine learning",
        region="Germany",
        user=user,
        max_results=5,
        on_progress=print_progress
    )
    for r in results:
        print(f"{r.name} - {r.relevance_score}/10")

asyncio.run(main())

CLI Arguments

Argument	Short	Default	Description
query		(required)	Topic to search
--region	-r	None	Region filter
--max	-m	5	Maximum results
--name	-n	Researcher	Your name
--institution	-i	Research Institute	Your institution
--email	-e	[email protected]	Your email
--output	-o	None	Save drafts to file

Output

• Speaker name, title, organization
• Expertise keywords
• Relevance score (1-10)
• Source URL for manual contact lookup
• Personalized email draft template

GDPR Compliance

• No email addresses scraped or stored
• Only publicly available information
• Source URLs provided for manual contact lookup
• User responsible for consent before outreach

How It Works

1. Search - Queries multiple sources for speakers
2. Extract - AI extracts speaker info from results
3. Score - AI scores relevance (topic + region)
4. Draft - Generates personalized email templates

License

AGPL-3.0-or-later - See LICENSE

Author

GeoLambda GmbH

Disclaimer

For research purposes only. Users are responsible for GDPR/DSGVO compliance before contacting individuals.