PARAGON × CLAUDE
Pull live MLS via the Paragon Connect API, embed against listings, and query the entire market with Claude. Built for operators who want their own AI on top of the MLS.
OVERVIEW.
A Python CLI and library that authenticates against Paragon, streams listings into a local vector store, and exposes a Claude-backed query interface. Ask for comps, neighborhood summaries, listing diffs over time. Run it locally for one agent, or deploy as a service for the whole team.
INSTALL.
# Install via pip pip install ballistic-paragon-claude # Authenticate paragon-claude auth login # Pull a market into the local index paragon-claude sync --market "YVR" --since "7d"
FEATURES.
STREAMING PULLS
Incremental sync. Pulls only what changed since last run. Built for large MLS markets.
SEMANTIC SEARCH
Listing remarks, public remarks, and structured fields embedded into a local vector index.
CLAUDE INTERFACE
Natural language queries over the index. Comps, market summaries, anomaly detection.
LISTING DIFF
Snapshot listings over time. Detect price drops, status changes, photo updates automatically.
CSV / JSON OUT
Pipe query results into spreadsheets, dashboards, or downstream tools. CLI-native.
LOCAL FIRST
Index lives on your machine. Your MLS data does not leave your box unless you ship it.
QUICKSTART.
from paragon_claude import Client client = Client(market="YVR") # Find comparable listings via natural language results = client.query( "3-bed townhomes in Kitsilano sold in the last 90 days under $2M with a private outdoor space", limit=20 ) for listing in results: print(f"{listing.mls_id} — ${listing.price:,} — {listing.dom}d")
CONFIGURATION.
| KEY | TYPE | DESCRIPTION |
|---|---|---|
| PARAGON_USER REQ | string | Your Paragon Connect username. Provided by your MLS board. |
| PARAGON_PASS REQ | string | Paragon password. Store via the OS keychain, not in env. |
| ANTHROPIC_API_KEY REQ | string | API key for Claude queries. Required for the natural language interface. |
| MARKET_AREAS | string[] | Comma-separated market codes. Defaults to your Paragon account scope. |
| INDEX_PATH | path | Where to store the local vector index. Defaults to ~/.paragon-claude/index. |
| SYNC_INTERVAL | duration | Background sync cadence when running as a service. e.g. "15m", "1h". |
USE CASES.
COMP ANALYSIS
Pull live comps for a listing presentation. Filter by anything in remarks, not just structured fields.
BUYER SEARCH
Run buyer criteria as a natural language query. Surfaces matches a stock search would miss.
MARKET REPORTS
Weekly auto-generated market summary for any neighborhood. Pipe straight into your newsletter.
PRICE DROP ALERTS
Watch a saved query. Get notified when a matching listing drops price or changes status.