本地潜在客户生成管道

一个为本地服务企业提供的自动化潜在客户生成和筛选管道,通过多源智能数据丰富客户信息并生成个性化外联。

  • by JSXSTEWART
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 JSXSTEWART/rise-local-lead-creation

使用说明

提升本地潜在客户开发渠道

为本地服务企业提供自动化的潜在客户生成和资格认证管道。该系统发现潜在客户,用情报数据丰富他们,对痛点进行评分,并生成个性化的外展服务。

特性

  • 先导化合物的发现:通过Google Places API自动发现
  • 免费资格预审:本地Docker抓取器在付费富集之前过滤潜在客户
  • AI驱动的分析:视觉分析、技术堆栈评分和痛点检测
  • 成本优化:通过Clay只丰富合格的潜在客户,可节省80%的成本
  • 多源情报:
    • 使用Gemini Vision进行屏幕截图分析
    • PageSpeed性能指标
    • TDLR许可证验证(德克萨斯州)
    • BBB声誉数据
    • 地址验证(住宅与商业)
  • 电子邮件生成:克劳德提供的个性化外展电子邮件

建筑

Discovery → FREE Scrapers → Pre-Qualification → Clay Enrichment → Outreach
              ↑ $0 COST       ↑ FILTER HERE      ↑ QUALIFIED ONLY

服务

服务 端口 描述
TDLR Scraper 8001 德克萨斯州许可证验证
BBB Scraper 8002 更好的商业局查询
PageSpeed API 8003 Google PageSpeed包装器
截图服务 8004 使用Gemini进行可视化分析
所有者提取器 8005 所有者名称提取
地址验证器 8006 住宅/商业支票

快速开始

先决条件

  • Python 3.10+
  • Docker&Docker编写
  • API密钥(请参见 .env.example)

安装

  1. 克隆仓库

    git clone https://github.com/your-org/rise-local-lead-creation.git
    cd rise-local-lead-creation
    
  2. 设置环境变量

    cp .env.example .env
    cp custom_tools/.env.example custom_tools/.env
    # Edit both files with your API keys
    
  3. 启动Docker服务

    cd custom_tools
    docker compose up -d
    
  4. 安装Python依赖项

    pip install -r rise_pipeline/requirements.txt
    
  5. 运行管道

    # Process discovered leads
    python run_prequalification_batch.py --all
    
    # Run Phase 2 intelligence gathering
    python run_phase_2_batch.py --all --batch-size 5
    

项目结构

rise-local-lead-creation/
├── rise_pipeline/           # Core pipeline code
│   ├── pipeline.py          # Main orchestrator
│   ├── services.py          # Service integrations
│   ├── scoring.py           # Pain point scoring
│   ├── models.py            # Data models
│   └── config.py            # Configuration
├── custom_tools/            # Docker services
│   ├── tdlr_scraper/        # Port 8001
│   ├── bbb_scraper/         # Port 8002
│   ├── pagespeed_api/       # Port 8003
│   ├── screenshot_service/  # Port 8004
│   ├── owner_extractor/     # Port 8005
│   ├── address_verifier/    # Port 8006
│   └── docker-compose.yml
├── dashboard/               # Web dashboard
├── docs/                    # Documentation
│   ├── ARCHITECTURE.md      # System design
│   ├── TROUBLESHOOTING.md   # Debug guide
│   ├── DASHBOARD_USAGE.md   # Dashboard guide
│   └── CLAY_WORKFLOW.md     # Clay integration
├── .env.example             # Environment template
└── README.md                # This file

配置

必需的API密钥

服务 目的 来源
数据库 数据库 网站 supabase.com
谷歌页面速度 性能 谷歌云控制台
谷歌双子座 人工智能愿景 AI 工作室
Smarty 地址验证 smarty.com
粘土 铅富集 clay.com
Anthropic 电子邮件生成 console.anthropic.com

看 .env.example 对于所有配置选项。

管道阶段

第一阶段:线索发现

  • 按城市和行业划分的Google Places API搜索
  • 存储在Supabase中的原始线索

第二阶段:免费资格预审

  • 视觉分析(设计质量、移动响应)
  • 技术性能(PageSpeed得分)
  • 许可证验证(德克萨斯州TDLR)
  • 声誉检查(BBB评级、投诉)
  • 地址验证(住宅与商业)

第三阶段:疼痛评分

  • 基于自由数据的分数计算
  • 资格决定:
    • 分数≤3: 拒绝
    • 得分4-5: 边缘的
    • 得分≥6分: 合格的

第4阶段:粘土富集(仅合格)

  • 内置技术栈分析
  • 接触瀑布(Dropcontact→ 猎人→ 阿波罗)

第五阶段:外展

  • 人工智能生成的个性化电子邮件
  • 通过即时/GHL交付

仪表盘

访问仪表板 http://localhost:8080 致:

  • 查看潜在客户数量和资格状态
  • 出口CSVs用于粘土富集
  • 将丰富的数据导入回管道
  • 监控管道进度

文档

发展

运行测试

cd rise_pipeline
python test_pipeline.py
python test_integrations.py

健康检查

curl http://localhost:8001/health  # TDLR
curl http://localhost:8002/health  # BBB
curl http://localhost:8003/health  # PageSpeed
curl http://localhost:8004/health  # Screenshot
curl http://localhost:8005/health  # Owner Extractor
curl http://localhost:8006/health  # Address Verifier

许可证

专有-Rise Local

支持

如有任何问题或疑问,请联系Rise Local团队。