@striderlabs/mcp-redfin 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +123 -0
- package/dist/index.js +21238 -0
- package/package.json +40 -0
package/README.md
ADDED
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
# @striderlabs/mcp-redfin
|
|
2
|
+
|
|
3
|
+
An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that provides real estate search capabilities via Redfin, using Playwright for browser automation.
|
|
4
|
+
|
|
5
|
+
## Features
|
|
6
|
+
|
|
7
|
+
- **search_homes** — Search listings by location with rich filters (price, beds, baths, sqft, property type, status)
|
|
8
|
+
- **get_property_details** — Fetch full property details from a Redfin listing URL or property ID
|
|
9
|
+
- **get_estimate** — Retrieve the Redfin Estimate (AVM) for any address
|
|
10
|
+
|
|
11
|
+
## Installation
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
npm install -g @striderlabs/mcp-redfin
|
|
15
|
+
# Install Playwright browsers (first-time setup)
|
|
16
|
+
npx playwright install chromium
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## Usage with Claude Desktop
|
|
20
|
+
|
|
21
|
+
Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
|
|
22
|
+
|
|
23
|
+
```json
|
|
24
|
+
{
|
|
25
|
+
"mcpServers": {
|
|
26
|
+
"redfin": {
|
|
27
|
+
"command": "mcp-redfin"
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
## Tools
|
|
34
|
+
|
|
35
|
+
### `search_homes`
|
|
36
|
+
|
|
37
|
+
Search for home listings on Redfin.
|
|
38
|
+
|
|
39
|
+
**Parameters:**
|
|
40
|
+
| Name | Type | Required | Description |
|
|
41
|
+
|------|------|----------|-------------|
|
|
42
|
+
| `location` | string | ✅ | City, zip, neighborhood, or address |
|
|
43
|
+
| `filters.minPrice` | number | — | Minimum price (USD) |
|
|
44
|
+
| `filters.maxPrice` | number | — | Maximum price (USD) |
|
|
45
|
+
| `filters.minBeds` | number | — | Minimum bedrooms |
|
|
46
|
+
| `filters.maxBeds` | number | — | Maximum bedrooms |
|
|
47
|
+
| `filters.minBaths` | number | — | Minimum bathrooms |
|
|
48
|
+
| `filters.propertyType` | string | — | `house`, `condo`, `townhouse`, `multi-family`, `land` |
|
|
49
|
+
| `filters.status` | string | — | `for-sale` (default), `for-rent`, `sold` |
|
|
50
|
+
| `filters.minSqft` | number | — | Minimum square footage |
|
|
51
|
+
| `filters.maxSqft` | number | — | Maximum square footage |
|
|
52
|
+
|
|
53
|
+
**Example:**
|
|
54
|
+
```json
|
|
55
|
+
{
|
|
56
|
+
"location": "Austin, TX",
|
|
57
|
+
"filters": {
|
|
58
|
+
"minPrice": 400000,
|
|
59
|
+
"maxPrice": 700000,
|
|
60
|
+
"minBeds": 3,
|
|
61
|
+
"propertyType": "house"
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
### `get_property_details`
|
|
69
|
+
|
|
70
|
+
Get detailed info for a specific Redfin listing.
|
|
71
|
+
|
|
72
|
+
**Parameters:**
|
|
73
|
+
| Name | Type | Required | Description |
|
|
74
|
+
|------|------|----------|-------------|
|
|
75
|
+
| `id` | string | ✅ | Redfin property URL or listing ID |
|
|
76
|
+
|
|
77
|
+
**Example:**
|
|
78
|
+
```json
|
|
79
|
+
{
|
|
80
|
+
"id": "https://www.redfin.com/TX/Austin/1234-Main-St-78701/home/987654"
|
|
81
|
+
}
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
---
|
|
85
|
+
|
|
86
|
+
### `get_estimate`
|
|
87
|
+
|
|
88
|
+
Get the Redfin Estimate (automated valuation) for a property.
|
|
89
|
+
|
|
90
|
+
**Parameters:**
|
|
91
|
+
| Name | Type | Required | Description |
|
|
92
|
+
|------|------|----------|-------------|
|
|
93
|
+
| `address` | string | ✅ | Full property address |
|
|
94
|
+
|
|
95
|
+
**Example:**
|
|
96
|
+
```json
|
|
97
|
+
{
|
|
98
|
+
"address": "1600 Pennsylvania Ave NW, Washington, DC 20500"
|
|
99
|
+
}
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
---
|
|
103
|
+
|
|
104
|
+
## Development
|
|
105
|
+
|
|
106
|
+
```bash
|
|
107
|
+
git clone https://github.com/striderlabs/mcp-redfin
|
|
108
|
+
cd mcp-redfin
|
|
109
|
+
npm install
|
|
110
|
+
npx playwright install chromium
|
|
111
|
+
npm run dev # run with tsx
|
|
112
|
+
npm run build # bundle with esbuild → dist/index.js
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
## Notes
|
|
116
|
+
|
|
117
|
+
- Uses headless Chromium via Playwright; respects Redfin's public-facing UI.
|
|
118
|
+
- Results depend on Redfin's current page structure and may require selector updates over time.
|
|
119
|
+
- Not affiliated with or endorsed by Redfin.
|
|
120
|
+
|
|
121
|
+
## License
|
|
122
|
+
|
|
123
|
+
MIT — © Strider Labs
|