Skip to content

feat: add FSBO real estate lead generation module - #4

Open
chazam41892-gif wants to merge 1 commit into
kaymen99:mainfrom
chazam41892-gif:feat/fsbo-real-estate-lead-generation
Open

feat: add FSBO real estate lead generation module#4
chazam41892-gif wants to merge 1 commit into
kaymen99:mainfrom
chazam41892-gif:feat/fsbo-real-estate-lead-generation

Conversation

@chazam41892-gif

Copy link
Copy Markdown

Summary

This PR adds a complete FSBO (For Sale By Owner) real estate lead generation pipeline to the sales outreach automation system. It allows the system to discover homeowners selling without a real estate agent, analyze seller motivation, and generate personalized outreach materials.

What's Included

New Components

File Purpose
src/tools/fsbo_tools.py FSBO property search via Serper API + LLM extraction
src/fsbo_lead_loader.py FSBOLeadLoader implementing LeadLoaderBase
src/prompts_fsbo.py Real estate-specific LLM prompts
src/fsbo_nodes.py Processing nodes for FSBO workflow
src/fsbo_graph.py LangGraph workflow
docs/real-estate-lead-generation.md Full documentation

Extended Files

  • src/state.py -- Added FSBOLeadData, FSBOPropertyData, FSBOReport, FSBOGraphState
  • src/structured_outputs.py -- Added FSBOSellerEmail model

Architecture

The FSBO workflow follows the same LangGraph pattern as the existing outreach automation:

discover_fsbo_listings -> check_for_remaining_leads
| (found leads)
analyze_property -> score_seller_lead
| (qualified)
generate_seller_outreach_email -> generate_seller_interview_script
|
save_reports -> loop back

Design Decisions

  • Reuses existing infrastructure: Serper API, Gemini LLM, LangGraph framework
  • No new dependencies: All functionality uses existing packages
  • Extends LeadLoaderBase: FSBOLeadLoader can be dropped into OutReachAutomation
  • Scoring gate: Only sellers scoring 5.0+/10 proceed to outreach generation

Adds a complete FSBO (For Sale By Owner) real estate lead generation
pipeline to the sales outreach automation system:

- FSBO listing discovery via web search + LLM extraction
- Property analysis and seller motivation assessment
- Seller lead scoring with configurable criteria
- Personalized outreach email and interview script generation
- Full LangGraph workflow (discover → analyze → score → outreach)
- FSBOLeadLoader implementing LeadLoaderBase interface
- Comprehensive documentation with usage examples

New files:
  src/tools/fsbo_tools.py         - FSBO property search & extraction
  src/fsbo_lead_loader.py         - FSBOLeadLoader (LeadLoaderBase)
  src/prompts_fsbo.py             - Real estate LLM prompts
  src/fsbo_nodes.py               - FSBO workflow processing nodes
  src/fsbo_graph.py               - FSBO LangGraph workflow
  docs/real-estate-lead-generation.md - Documentation

Modified:
  src/state.py                    - Added FSBO data models
  src/structured_outputs.py       - Added FSBOSellerEmail model
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant