Lead Guardian — Real Estate Lead Response Skill#

AI-powered lead response and qualification for real estate agents.

Description#

Lead Guardian helps real estate agents respond to leads instantly, qualify them automatically, and route hot leads for immediate follow-up. Works via SMS, email, or CRM webhook integration.

Capabilities#

• Instant Response — Reply to new leads within 60 seconds
• AI Qualification — Extract buying/selling intent, timeline, pre-approval status, price range
• Hot Lead Detection — Identify ready-to-buy leads and alert agents immediately
• Conversation Tracking — Full history of lead interactions
• CRM Integration — Connect with Follow Up Boss, KW Command, and others

Use Cases#

1. After-Hours Coverage — Respond to leads when you're unavailable
2. Lead Qualification — Filter tire-kickers from serious buyers
3. Speed to Lead — Beat competitors with instant response
4. Consistent Follow-Up — Never miss a lead

Requirements#

• Twilio account (for SMS)
• OpenRouter API key (for AI)
• Optional: CRM webhook URL

Quick Start#

bash

# Install dependencies
pip install flask twilio requests python-dotenv

# Configure
export TWILIO_ACCOUNT_SID="your_sid"
export TWILIO_AUTH_TOKEN="your_token"
export TWILIO_PHONE_NUMBER="+1xxxxxxxxxx"
export OPENROUTER_API_KEY="your_key"
export AGENT_PHONE="+1xxxxxxxxxx"

# Run
python app.py

Configuration#

Environment Variables#

VariableRequiredDescriptionTWILIO_ACCOUNT_SIDYesTwilio account SIDTWILIO_AUTH_TOKENYesTwilio auth tokenTWILIO_PHONE_NUMBERYesYour Twilio phone numberOPENROUTER_API_KEYYesFor AI responsesAGENT_PHONENoPhone to alert for hot leads

Hot Lead Criteria#

A lead is flagged as "hot" when:

• Timeline is "immediate" or "1-3 months"
• Pre-approved for mortgage
• Explicitly requests an agent

Qualification Questions#

The AI naturally extracts:

1. Direction — Buying, selling, or both
2. Timeline — When they want to move
3. Pre-approval — Mortgage status (if buying)
4. Price Range — Budget (if buying)

API Endpoints#

EndpointMethodDescription/smsPOSTTwilio webhook for incoming SMS/api/leadsGETList all leads/api/leads/:id/messagesGETGet conversation history/api/leads/:id/handoffPOSTMark lead as handed off/GETAdmin dashboard

Cost#

~$30/month for 500 leads

• Twilio number: $1/month
• SMS (1,000 messages): $10
• Claude Haiku API: $15-20

Files#

text

lead-guardian/
├── SKILL.md          # This file
├── app.py            # Main Flask application
├── leads.db          # SQLite database (created on run)
└── .env.example      # Environment template

Credits#

Built by KW Sacramento Metro AI Team.

License#

MIT