Skill
redfin
Search Redfin homes for sale via internal Stingray endpoints, sync to local SQLite, and run workflows the website doesn't expose — saved-search diff, $/sqft net-HOA ranking, sold comps, multi-region trends.
When to use redfin
Choose if
You're inside the US and want an agent loop that runs real-estate workflows Redfin's website doesn't expose — saved-search diff via `watch`, price-drop surfacing via `drops`, value-per-dollar ranking, columnar shortlist comparison, comparable-sales pulls collapsed from "20 minutes of polygon-clicking" into one command. Alternative: hitting Zillow / Realtor.com manually loses the multi-region trend analytics and the local-SQLite snapshot model.
Avoid if
Your agent runs outside the US (Redfin geo-blocks non-US IPs with HTTP 403 — explicit scope limit in the README). Also avoid if you need account-bound features (saved homes, alerts, agent dashboard) or ToS-sensitive deployment — the unauthenticated Stingray + Chrome-TLS fingerprint approach may run afoul of Redfin's terms.
Risk Flags
- HIGH scope Geo-restricted to US IPs only — non-US callers receive HTTP 403. Agents running in non-US regions (most managed AI infrastructure) will get blanket 403s with no per-call workaround.
- MEDIUM runtime Relies on unauthenticated Stingray endpoints with AWS-WAF evasion via Chrome TLS fingerprint. Stable today; brittle to upstream changes if Redfin tightens bot detection — agents should monitor for sudden 403 spikes.
- MEDIUM rate_limit Conservative 1 req/s default with adaptive backoff on 429. Stingray endpoints cap at 350 rows per request; `export` auto-slices price bands to work around the limit but heavy regional sweeps take time.
- LOW scope Account-only features (saved homes, alerts, agent dashboard) are intentionally out of scope. Read-only — no offers, no inquiries, no mutation through this surface.
Cost
Type: Free · Free tier: The CLI is MIT-licensed and free. No authentication required — Redfin's public Stingray endpoints are unauthenticated. The catch is geo-fencing, not cost.
Install
Default
go install github.com/mvanhorn/printing-press-library/library/other/redfin/cmd/redfin-pp-cli@latest
# No authentication. Must be invoked from a US IP — non-US callers
# receive HTTP 403 from Redfin's edge.
Estimated time to first success: ~15 min
Dependencies
Minimum runtime: Go 1.26.3+ (or pre-built binary for macOS/Unix; no npm path in this entry)
Distribution
- Repository
- https://github.com/mvanhorn/printing-press-library
- License
- MIT