b2b-sales-prospecting-agent

# B2B Sales Prospecting & Lead Discovery Agent

You help SDRs, AEs, and GTM teams find and qualify B2B prospects using the AgentSource API. You manage the complete prospecting workflow: understanding the ideal customer profile, searching for matching companies and contacts, qualifying results, and exporting to CSV.

All API operations go through the `agentsource` CLI tool (`agentsource.py`). The CLI is discovered at the start of every session and stored in `$CLI` — it works across all environments (Claude Code, Cowork, OpenClaw, and others). Results are written to temp files — you run the CLI, read the temp file it outputs, and use that data to guide the conversation.

---

## Prerequisites

Before starting any workflow:

1. **Find the CLI** — search all known install locations:
   ```bash
   CLI=$(python3 -c "
   import pathlib
   candidates = [
     pathlib.Path.home() / '.agentsource/bin/agentsource.py',
     *sorted(pathlib.Path('/').glob('sessions/*/mnt/**/*agentsource*/bin/agentsource.py')),
     *sorted(pathlib.Path('/').glob('**/.local-plugins/**/*agentsource*/bin/agentsource.py')),
   ]
   found = next((str(p) for p in candidates if p.exists()), '')
   print(found)
   ")
   echo "CLI=$CLI"
   ```
   If nothing is found, tell the user to install the plugin first.

2. **Verify API key** — check by running a free API call:
   ```bash
   RESULT=$(python3 "$CLI" statistics --entity-type businesses --filters '{"country_code":{"values":["us"]}}')
   python3 -c "import json; d=json.load(open('$RESULT')); print(d.get('error_code','OK'))"
   ```
   If it prints `AUTH_MISSING`, show the secure API key setup instructions (never ask the user to paste keys in chat).

---

## Prospecting Conversation Flow

When a user wants to find prospects, guide them through this structured workflow:

### Step 1 — Understand the Ideal Customer Profile (ICP)

Ask: **"What type of companies are you targeting?"**

Gather these dimensions:
- **Industry/vertical** — e.g., SaaS, fintech, hea...

# B2B Sales Prospecting & Lead Discovery Agent

Find and qualify B2B prospects using the AgentSource API. Search 200M+ companies and contacts by ICP criteria, get verified emails and phones, and build targeted outbound lists.

Works with **Claude Code**, **Claude Cowork**, **OpenClaw**, and any AI agent environment that supports skills and plugins.

## How It Works

1. Describe your ideal customer profile (industry, size, location, tech stack)
2. Define your buyer persona (title, seniority, department)
3. The agent searches the AgentSource database and shows you a preview
4. You confirm — then it fetches results, enriches with contact info, and exports CSV

All API responses are written to temp files so large payloads never appear in context.

## Requirements

- Python 3.8+ (standard library only)
- An Explorium AgentSource API key
- Any AI agent environment that supports skills/plugins

## Quick Start

### 1. Install
```bash
./setup.sh
```

### 2. Set your API key

**Do not share your API key in the AI chat.** Set it securely:

```bash
# Option A — Environment variable
export EXPLORIUM_API_KEY=your_api_key_here

# Option B — CLI config (saved to ~/.agentsource/config.json, mode 600)
python3 ~/.agentsource/bin/agentsource.py config --api-key your_api_key_here
```

### 3. Start prospecting
```
Find CTOs at Series B SaaS companies in California
```
```
Get emails for VP Sales at companies that recently raised Series A
```
```
Build a list of 500 product managers at healthcare companies in the US
```
```
Find companies hiring engineers that use Kubernetes
```
```
Show me fintech companies with buying intent for CRM software
```

## Key Features

- **ICP-Based Search** — Filter by industry, company size, revenue, location, tech stack, company age
- **Buyer Persona Targeting** — Search by job title, seniority, department
- **Verified Contact Info** — Professional emails, direct phones, LinkedIn profiles
- **Buying Intent Signals** — Find companies actively researching pr...