Outreach Pipeline

Overview

Outreach Pipeline is a Python-based automation tool that streamlines the process of identifying potential leads, generating personalized outreach emails, and delivering them automatically.

The pipeline integrates multiple services:

• Ocean.io for discovering relevant companies.
• Prospeo for finding decision-makers and verified work email addresses.
• Ollama for generating personalized email content using a local LLM.
• Brevo for sending transactional emails.

The goal is to automate B2B outreach while maintaining personalization and email deliverability.

---

Features

Company Discovery

Uses the Ocean.io API to discover companies that match specific business criteria.

Retrieved information may include:

• Company name
• Company domain
• Industry details
• Business metadata

These domains are used as inputs for lead generation.

---

Lead Generation

Uses the Prospeo API to identify professionals associated with a company.

Workflow:

1. Search people using a company domain.
2. Extract person_id values.
3. Enrich each profile using Prospeo.
4. Retrieve verified work email addresses.

Information obtained:

• Full Name
• Job Title
• LinkedIn Profile URL
• Verified Work Email

---

AI-Powered Personalization

Uses Ollama with a local Large Language Model (LLM) to generate customized outreach messages.

Benefits:

• No external AI API costs
• Data remains local
• Personalized email content at scale

Generated outputs:

• Subject Line
• Email Body

---

Email Delivery

Uses the Brevo Transactional Email API to send outreach emails.

Capabilities:

• Dynamic recipients
• Personalized content
• HTML email formatting
• Delivery monitoring

---

Workflow

Ocean.io ↓ Company Domains ↓ Prospeo Search Person ↓ Person IDs ↓ Prospeo Enrich Person ↓ Verified Emails ↓ Ollama ↓ Personalized Subject + Body ↓ Brevo ↓ Email Sent

---

Project Structure

outreach-pipeline/
│
├── main.py
├── ocean.py
├── prospeo.py
├── ollama_user.py
├── brevo_user.py
│
├── .env
├── .gitignore
├── requirements.txt
│
└── README.md

---

Prerequisites

• Python 3.10+
• Ocean.io API Key
• Prospeo API Key
• Brevo API Key
• Ollama Installed Locally

---

Environment Variables

Create a .env file in the project root:

OCEAN_API_KEY=your_ocean_api_key

PROSPEO_API_KEY=your_prospeo_api_key

BREVO_API_KEY=your_brevo_api_key

---

Installation

Clone the repository:

git clone https://github.com/your-username/outreach-pipeline.git
cd outreach-pipeline

Create a virtual environment:

python -m venv venv

Activate the environment:

Windows

venv\Scripts\activate

Linux / macOS

source venv/bin/activate

Install dependencies:

pip install -r requirements.txt

---

Setting Up Ollama

Install Ollama from:

https://ollama.com

Verify installation:

ollama --version

Download a model:

ollama pull llama3

Start Ollama:

ollama serve

---

Running the Pipeline

Execute:

python main.py

The pipeline will:

1. Fetch company domains from Ocean.io.
2. Find decision-makers using Prospeo.
3. Retrieve verified email addresses.
4. Generate personalized emails using Ollama.
5. Send emails through Brevo.

---

API Rate Limits

Prospeo Search Endpoint

• 1 request per second
• 20 requests per minute

Prospeo Enrich Endpoint

• 1 request per second
• 20 requests per minute

To avoid rate-limit errors:

import time

time.sleep(1.1)

between Prospeo requests.

---

Error Handling

The project currently handles:

• No results returned by Prospeo
• Missing person IDs
• Missing email addresses
• API rate limits
• Invalid enrichment requests
• Brevo API exceptions

---

Future Improvements

• Bulk email campaigns
• Retry mechanism
• CSV export
• Lead scoring
• CRM integration
• Campaign analytics
• Email open tracking
• Email click tracking

---

Tech Stack

• Python
• Ocean.io API
• Prospeo API
• Ollama
• Brevo
• Requests
• python-dotenv

---

Disclaimer

This project is intended for ethical business outreach and educational purposes.

Users are responsible for complying with:

• GDPR
• CAN-SPAM regulations
• Local email marketing laws
• Recipient opt-out requirements

Avoid sending unsolicited or spam emails.