AI Workflow Lead Gen — AI skill for Claude Code

AI Workflow Lead Generation System

A configurable, agentic lead generation system showcasing **XPOZ MCP** + **Claude Code** capabilities.

This system autonomously finds and analyzes potential customers for AI workflow automation products by searching Twitter for users expressing buying intent, pain points, and competitor frustrations.

---

🚀 Quick Start

**Prerequisites:**

• Claude Code CLI with XPOZ MCP server configured
• Python 3.8+ with pandas and numpy (pip install -r requirements.txt)

**Run the workflow:**

Execute the workflow in config/workflow_instructions.md

Claude will autonomously:

1. Read configuration files to understand search parameters
2. Execute XPOZ searches across multiple strategies
3. Download and process complete datasets
4. Generate Python code to score and filter leads
5. Perform deep LLM analysis on top candidates
6. Export ranked leads with actionable insights

**Output:** `output/leads_YYYY-MM-DD.csv` with 50 ranked leads

---

📁 Project Structure

ai-workflow-lead-gen/
├── config/                          # All customization happens here
│   ├── workflow_instructions.md     # Step-by-step workflow for Claude
│   ├── search_config.yaml           # Search strategies, keywords, filters
│   ├── analysis_prompt.txt          # LLM analysis criteria
│   └── output_template.yaml         # Output CSV structure
│
├── temp/                            # Runtime files (created during execution)
├── output/                          # Final CSV exports
├── requirements.txt                 # Python dependencies
└── README.md

**Key design principle:** All logic is in configuration files. Claude reads these at runtime and executes autonomously - no hardcoded scripts.

---

🎯 What This System Showcases

XPOZ MCP Capabilities

**Keyword Search with Aggregations:**

• getTwitterUsersByKeywords - Boolean OR queries across multiple keywords
• Built-in aggregation fields: relevantTweetsCount, relevantTweetsLikesSum,