API ВЕГА

Сервер Redfin MCP

Размещённый сервер Model Context Protocol (MCP), который предоставляет Claude, Cursor, Windsurf и любому другому MCP-клиенту два инструмента Redfin только для чтения. Ищите объекты недвижимости в продаже, аренде и среди проданных с теми же фильтрами, которые Redfin показывает посетителям, а также получайте полную страницу объекта в структурированном формате JSON. Лицензия MLS и собственный хостинг не требуются.

Сервер получает данные с общедоступных страниц Redfin, доступных посетителям без входа в аккаунт.

1 000 бесплатных кредитов каждый месяц — банковская карта не нужна. При тарифе 5 кредитов за вызов этого хватит на 200 запросов к Redfin.

https://mcp.hasdata.com/mcp?apis=redfin

Содержание

  • Что понадобится

  • Быстрый старт

  • Примеры запросов

  • Инструменты

  • Ошибки и сценарии сбоя

  • Стоимость, бесплатный тариф и ограничения

  • Выбор инструмента

  • Сравнение с другими решениями

  • FAQ

  • Ссылки HasData

  • Разработка

  • Участие в проекте

  • Лицензия

Что понадобится

MCP-клиент и API-ключ HasData, который можно бесплатно создать в панели управления. Банковская карта не требуется. Бесплатного тарифа хватит примерно на 200 вызовов в месяц при стоимости 5 кредитов за вызов. Это удалённый сервер, поэтому проще всего подключиться к нему по URL, указав заголовок x-api-key. Запускать контейнер не нужно. Клиенты, работающие только по протоколу stdio, подключаются к серверу через лёгкий лаунчер, опубликованный в npm как @hasdata/redfin-mcp и в PyPI как hasdata-redfin-mcp. Он описан ниже.

Быстрый старт

URL сервера одинаков для всех клиентов. Мы проверили настройку в Claude Code и Claude Desktop. Для остальных клиентов приведены примеры в формате, указанном в их документации для удалённых серверов.

ПолеЗначение
URLhttps://mcp.hasdata.com/mcp?apis=redfin
ТранспортHTTP, с поддержкой потоковой передачи
Заголовок авторизацииx-api-key: HASDATA_API_KEY

Клиенты с поддержкой OAuth можно подключить по тому же URL и выполнить вход, не сохраняя ключ в конфигурационном файле.

Claude Code

claude mcp add --transport http redfin "https://mcp.hasdata.com/mcp?apis=redfin" \
  --header "x-api-key: HASDATA_API_KEY"

Claude Desktop

Откройте Settings, затем Connectors, выберите Add custom connector, вставьте https://mcp.hasdata.com/mcp?apis=redfin и выполните вход.

Если вы настраиваете подключение через файл конфигурации, учтите, что Claude Desktop загружает только локальные серверы stdio. Поэтому для доступа к удалённому серверу понадобится лаунчер stdio. Эту роль выполняет пакет @hasdata/redfin-mcp; ключ он получает из переменной окружения. Добавьте следующий фрагмент в claude_desktop_config.json:

{
  "mcpServers": {
    "redfin": {
      "command": "npx",
      "args": ["-y", "@hasdata/redfin-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

Чтобы использовать Python вместо Node, замените лаунчер на пакет PyPI, который uvx запускает без предварительной установки:

{
  "mcpServers": {
    "redfin": {
      "command": "uvx",
      "args": ["hasdata-redfin-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

Cursor

Добавьте конфигурацию в ~/.cursor/mcp.json, чтобы использовать её во всех проектах, или в .cursor/mcp.json — для одного проекта:

{
  "mcpServers": {
    "redfin": {
      "url": "https://mcp.hasdata.com/mcp?apis=redfin",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

Windsurf

Используйте файл ~/.codeium/windsurf/mcp_config.json. В Windsurf поле называется serverUrl, а не url:

{
  "mcpServers": {
    "redfin": {
      "serverUrl": "https://mcp.hasdata.com/mcp?apis=redfin",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

VS Code

Добавьте конфигурацию в файл .vscode/mcp.json в рабочей области:

{
  "servers": {
    "redfin": {
      "type": "http",
      "url": "https://mcp.hasdata.com/mcp?apis=redfin",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

Примеры запросов

Каждый из этих запросов использует один инструмент. Два инструмента вызываются по очереди, если второму нужен URL, который возвращает первый.

  • Найди дома с тремя спальнями на продажу в 78741 стоимостью до $500,000 и отсортируй их по цене за квадратный фут.

  • Что было продано в Остине за последние три месяца и как это соотносится с объектами, выставленными на продажу сейчас?

  • Открой полную страницу этого объекта на Redfin и кратко опиши его состояние по тексту объявления.

  • В каких объектах в Остине, сдаваемых в аренду, разрешено держать собак и есть стиральная машина и сушилка?

  • Покажи дома на продажу в школьном округе Austin Independent School District, где назначенная начальная школа имеет рейтинг не ниже 8.

  • Найди требующие ремонта дома в этом почтовом индексе, построенные до 1970 года и размещённые на Redfin более 30 дней.

Запрос с указанием района или рынка передаётся инструменту поиска. Если в запросе есть URL Redfin, сразу используется инструмент получения данных об объекте. Поиск по полному адресу — третий сценарий; он описан ниже. В этом случае инструмент возвращает данные об одном объекте, а не список.

Инструменты

ИнструментЧто возвращает
hasdata_redfin_listing_getRealEstateListingsДанные каждого объекта: адрес, URL Redfin, цена, количество спален и ванных комнат, площадь, размер участка, год постройки, срок размещения на рынке, статус, координаты, фотографии, номер MLS и сведения об HOA; и…. 5 кредитов за вызов
hasdata_redfin_property_getPropertyDetailsАдрес, цена продажи или текущая цена, история цен, оценка Redfin, количество спален и ванных комнат, площадь, размер участка, год постройки, тип объекта, сведения об HOA, срок размещения на рынке, рейтинги школ, налоги…. 5 кредитов за вызов

Два инструмента; 5 кредитов за каждый успешный вызов.

Получить объявления о недвижимости на Redfin

hasdata_redfin_listing_getRealEstateListings

Возвращает страницу объявлений для указанного местоположения. Если в качестве местоположения передан полный адрес, возвращаются данные об одном объекте.

Обязательны два параметра. Остальная схема соответствует фильтрам Redfin.

ПараметрТипОбязательныйПримечания
keywordstringдаПочтовый индекс, город, район, школа, школьный округ, название жилого комплекса или полный адрес
typestringдаforSale, forRent или sold
sortstringrecommended, newest, oldest, priceLowToHigh, priceHighToLow, bedrooms, bathrooms, lotSize, squareFeetPrice и другие варианты
pagenumberНомер страницы результатов, начиная с 1

Названия фильтров повторяют вложенную структуру, которую Redfin использует внутри системы, но представлены в виде плоских строк с подчёркиваниями. Поэтому передавать их нужно точно так, как они указаны в схеме. price_min_ и price_max_ задают диапазон цен, beds_min_ и beds_max_ — количество спален, а monthlyPayment_interestRate_ — параметры ипотечного кредита. Двойное подчёркивание обозначает массив.

Основные фильтры:

ПараметрТипПримечания
price_min_ / price_max_numberДиапазон цен
beds_min_ / beds_max_numberКоличество спален
bathsstringМинимальное количество ванных комнат: от one до four, а также oneAndHalf и twoAndHalf
homeTypes__arrayhouse, townhouse, townhome, condo, land, multiFamily, mobile, coOp, apartment, other. Допустимые значения зависят от type
statusOptions__arrayactive, comingSoon, contingentPending
listingType_category___arraybyAgent, byOwnerFsbo, newConstruction, foreclosures
timeOnRedfinstringОт newListing до moreThan45Days
soldWithinOptionstringПериод продажи: от lastOneWeek до lastFiveYear. См. предупреждение ниже
yearBuilt_min_ / yearBuilt_max_stringГод из фиксированного набора значений: от 1940 до 2026
forSaleSquareFeet_min_ / _max_stringПлощадь из фиксированного набора значений: от 750 до 10000
lotSize_min_ / lotSize_max_stringРазмер участка от 2000 sqft до 100 acres; формат значений фиксированный
cost_hoa_numberМаксимальный ежемесячный взнос HOA
cost_priceReduced_stringСрок снижения цены: от inTheLastDay до moreThan120Days
homeFeatures_options___arraywaterfront, hasAView, fireplace, fixerUpper, guestHouse, elevator, greenHome, accessibleHome и другие варианты
homeFeatures_poolType_stringprivatePool, communityPool, privateOrCommunityPool, noPrivatePool
homeFeatures_keywordSearch_stringПроизвольный текст для поиска в описаниях объявлений
schools_greatSchoolRating_numberМинимальная оценка GreatSchools — от 1 до 10
transportScores_walkScore_numberМинимальная оценка walk score — от 1 до 100
rentalAmenities__arrayinUnitWasherDryer, parkingAllowed, utilitiesIncluded, furnished, pool и другие варианты
pets__arraydogsAllowed, catsAllowed
moveInDatestringMM/DD/YYYY

В ответе на поиск по рынку содержится объект searchInformation с полем totalResults, массив properties из 40 элементов и объект pagination с полями currentPage, nextPage и картой otherPages. Для объекта, выставленного на продажу или уже проданного, возвращаются поля id, mlsId, url, homeType, status, price, beds, baths, area, yearBuilt, daysOnSite, addressRaw, разобранный адрес address, latitude, longitude, description, atAGlanceFacts и photos.

Структура atAGlanceFacts зависит от типа ответа. В строке результатов поиска это список кратких характеристик объекта, а в ответе с данными об объекте — список пар factLabel и factValue. Код, рассчитанный на один вариант структуры, не будет работать с другим.

{
  "id": 31625298,
  "mlsId": "2190201772333567097",
  "url": "https://www.redfin.com/TX/Austin/1721-Deerfield-Dr-78741/home/31625298",
  "homeType": "House",
  "status": "FOR_SALE",
  "price": 675000,
  "beds": 3,
  "baths": 2,
  "area": 1667,
  "yearBuilt": 1963,
  "daysOnSite": 0,
  "addressRaw": "1721 Deerfield Dr, Austin, TX 78741",
  "address": { "street": "1721 Deerfield Dr", "city": "Austin", "state": "TX", "zipcode": "78741" },
  "latitude": 30.231372,
  "longitude": -97.734893,
  "atAGlanceFacts": ["Hill country views", "2020 roof", "Stainless appliances"]
}

В результатах поиска аренды возвращается объект здания, а не отдельное жильё, поэтому ответ на запрос с type: forRent имеет другую структуру. Поля price, beds, baths и area представлены объектами { min, max }, содержащими диапазоны значений для доступных квартир. В ответ также включаются поля propertyName, availableUnits, agentEmail и agentPhone, но отсутствуют mlsId, homeType, yearBuilt и daysOnSite.

{
  "id": "31510362",
  "propertyName": "The Sonata",
  "status": "FOR_RENT",
  "availableUnits": 12,
  "price": { "min": 745, "max": 1300 },
  "beds": { "min": 1, "max": 2 },
  "baths": { "min": 1, "max": 2 },
  "area": { "min": 474, "max": 976 },
  "addressRaw": "1070 Mearns Meadow Blvd, Austin, TX 78758"
}

Получить подробные сведения об объекте Redfin

hasdata_redfin_property_getPropertyDetails

Возвращает полную страницу объекта по его URL на Redfin.

ПараметрТипОбязательныйПримечания
urlstringдаURL объекта на Redfin, полученный с помощью инструмента поиска

Ответ содержит объект property. Помимо всех полей, доступных в результатах поиска, в него входят propertyDetails, schools, nearby, agentInfo, viewsActivity, openHouseSchedule, updatedAt, объект geo и полный список фотографий photos. Например, для объекта ниже в списке 61 фотография.

propertyDetails содержит характеристики объекта, сгруппированные по разделам parking, interior, exterior, utilities и publicFacts. Каждый раздел представляет собой массив именованных подразделов, а каждый подраздел — массив пар label и value. Такая структура повторяет представление информации на странице, а не описывает её в виде типизированного объекта. Чтобы найти характеристику, ориентируйтесь на её название, а не на позицию в массиве.

В schools.assignedSchools перечислены школы, закреплённые за адресом. Для каждой указаны greatSchoolsRating, parentRating, distanceInMiles и флаг servesHome. Последнее поле показывает, обслуживает ли школа именно этот адрес.

{
  "id": 31625298,
  "homeType": "Single Family Residential",
  "status": "COMING SOON",
  "price": 675000,
  "beds": 3,
  "baths": 2,
  "area": 1667,
  "yearBuilt": 1963,
  "geo": { "latitude": 30.231372, "longitude": -97.734893 },
  "updatedAt": "Sep 9, 2026 4:04 AM",
  "viewsActivity": { "views": 98, "favorites": 5 },
  "agentInfo": {
    "agentName": "Lilly Rockwell",
    "agentPhoneNumber": "512-413-1975",
    "brokerName": "Compass",
    "brokerPhoneNumber": ""
  },
  "propertyDetails": {
    "parking": [{ "parkingInformation": [{ "label": "Has Garage", "value": "yes" }] }],
    "utilities": [{ "utilitiesInformation": [{ "label": "Has Air Conditioning", "value": "yes" }] }]
  },
  "schools": { "assignedSchools": [{ "greatSchoolsRating": 6, "parentRating": 5, "servesHome": true }] }
}

Ошибки и нестандартные сценарии

Учитывайте возможные ошибки и нестандартное поведение — не рассчитывайте, что всё всегда будет работать по идеальному сценарию.

soldWithinOption ограничивает поиск проданных объектов временным интервалом, но без type: sold этот параметр ничего не меняет. Интервалы вложены друг в друга, как и следовало ожидать: результаты за неделю составляют лишь небольшую часть результатов за год для того же рынка. Если указать type: sold без soldWithinOption, Redfin вернёт данные за свой период по умолчанию — последние три месяца. Поиски проданных объектов и объектов в продаже возвращают непересекающиеся наборы: один объект не появится в обоих результатах.

Инструмент поиска возвращает данные в трёх разных форматах — формат зависит от ключевого слова. При поиске по рынку ответ содержит searchInformation, properties и pagination. При поиске по полному адресу или названию здания возвращается один объект property без массива properties, searchInformation и pagination. Результаты поиска аренды имеют формат диапазонов, показанный выше. Перед перебором результатов проверьте наличие properties.

totalResults показывает общее количество результатов, которое на крупном рынке может исчисляться тысячами. На одной странице размещается 40 объявлений, а в pagination.otherPages перечислены остальные страницы. Для одного города их может быть несколько сотен. Запросы к глубоким страницам работают, но для полного обхода рынка нужен отдельный вызов на каждую страницу. Если важнее экономить ресурсы, чем получить исчерпывающую выборку, ограничьте поиск по почтовому индексу, ценовому диапазону или типу жилья.

В результатах поиска проданных объектов нет отдельного поля для цены продажи. В поле price указана цена, отображаемая для соответствующего статуса: цена объекта в продаже и цена проданного объекта попадают в одно и то же поле. Всегда проверяйте поле status.

В ответе с данными объекта есть сведения, которых нет в результатах поиска. priceHistory и taxHistory содержат списки событий, redfinEstimate — оценочную стоимость и данные об объектах для сравнения, а propertyDetails объединяет сведения, похожие на данные оценщика, в разделе publicFacts, а также разделы parking, interior, exterior, financial и utilities. В строке результатов поиска этих данных нет, поэтому для вопросов об истории объекта нужно запрашивать его данные отдельно.

nearby.pointsOfInterest содержит сведения о ближайших местах, а не о сопоставимых продажах. Категории в categories берутся из стороннего набора данных о местах и часто бывают неверными: например, офис краткосрочных займов может быть помечен как бар. Используйте названия и координаты, но не доверяйте категориям.

openHouseSchedule может быть массивом с пустым объектом, если на странице есть этот раздел, но в нём нет дат. Проверяйте содержимое массива, а не только его длину.

brokerPhoneNumber и другие поля агента могут содержать пустую строку, а не null. Считайте пустую строку отсутствующим значением.

В результатах с данными также есть requestMetadata.id. Его полезно указывать при обращении в поддержку.

Тарифы, бесплатный план и лимиты

Каждый вызов инструмента Redfin стоит 5 кредитов, если он выполнен успешно. Размер ответа на стоимость не влияет: страница с 40 объявлениями и данные одного объекта обходятся одинаково.

Бесплатный план включает 1 000 кредитов в месяц без привязки карты — этого хватит на 200 вызовов Redfin по базовому тарифу. Кредиты обновляются в начале расчётного периода, поэтому агент с небольшим объёмом запросов может пользоваться бесплатным планом постоянно.

Платные планы начинаются от $59 в месяц за 200 000 кредитов — это 40 000 вызовов. Цена за единицу снижается с ростом объёма: от $1.48 за 1 000 вызовов на начальном плане до $0.60 на Basic и $0.41 на планах Growth. Актуальные цены указаны на странице с тарифами.

План также определяет допустимое количество одновременных запросов. Бесплатный план позволяет выполнять 1 запрос за раз, Startup — 5, Basic — 15, а планы Growth — от 50 до 500. Для фоновых задач настройте повторные попытки с увеличением задержки при ответе 429: агент, который последовательно обрабатывает список объектов, достигнет лимита раньше, чем вы успеете заметить проблему.

Запрос с ответом, отличным от 200, не тарифицируется. Успешный вызов, который ничего не нашёл, всё равно считается вызовом.

Выбор инструмента

Начните с того, что указано в запросе. Для поиска по рынку, почтовому индексу или школьному округу используйте инструмент поиска. Если у вас есть URL Redfin, сразу вызывайте инструмент для получения данных объекта. Использовать поиск, чтобы найти уже известный вам URL, — самый распространённый способ потратить вызов впустую.

Затем выберите инструмент с учётом требуемой глубины данных. Результатов поиска достаточно для ранжирования, сравнения цен и анализа рынка; в них уже есть цена, количество спален и ванных комнат, площадь, год постройки и число дней на сайте. Только инструмент для получения данных объекта возвращает блок характеристик, закреплённые за ним школы и сведения об агенте по объявлению. Его стоит вызывать для каждого интересующего вас объекта, а не для каждой строки результатов.

Фильтруйте данные на стороне сервера. Схема точно повторяет панель фильтров Redfin, поэтому запрос вроде «три спальни, дешевле $500k, построен до 1970 года, в этом почтовом индексе» можно выполнить одним вызовом с четырьмя параметрами. Не нужно загружать несколько страниц, а затем фильтровать их локально.

Сравнение с альтернативами

У Redfin нет общедоступного API, поэтому основная альтернатива — лента MLS или IDX.

Лента MLS или IDXЭтот сервер
ДоступЛицензированная брокерская компания или сотрудничество с агентомКлюч API
НастройкаЗаявка, договор и проверка соответствия требованиям для каждой MLSОдин заголовок
ОхватОдна MLS на ленту, всего их сотни по странеВсе данные, которые публикует Redfin, в одном месте
Проданные объектыПолная история, если это разрешено MLSНедавний период, показываемый Redfin
АрендаЧасто отдельная лента или данные отсутствуютТот же инструмент, результаты в формате диапазонов
Распространение данныхОграничено условиями договораВы сами отвечаете за проверку ограничений
СтоимостьПлата за настройку и ежемесячная оплата для каждой MLSПлатно после исчерпания бесплатного плана, 5 кредитов за вызов

Решающим фактором часто становится доступ. Лента MLS — авторитетный источник, но для работы с ней нужна лицензия, которую разработчик не может просто приобрести. Поэтому она не подходит для исследований, прототипов и задач, выполняемых агентом от вашего имени. Если у вас уже есть лента MLS как у брокерской компании, она полнее и актуальнее — используйте её.

Часто задаваемые вопросы

Существует ли официальный MCP-сервер Redfin?

Redfin не выпускает ни MCP-сервер, ни общедоступный API. Этот сервер поддерживается HasData и получает данные из общедоступных страниц Redfin.

Что такое MCP-сервер Redfin?

MCP-сервер предоставляет инструменты, которые может вызывать AI-клиент. Этот сервер преобразует результаты поиска Redfin и страницы объектов в JSON, с которым агент может работать, без браузера и библиотеки для парсинга в вашем стеке.

Нужна ли мне лицензия MLS или аккаунт Redfin?

Нет. Для работы нужен только ключ HasData.

Почему поиск по адресу возвращает один объект, а не список?

Потому что Redfin сопоставляет полный почтовый адрес со страницей конкретного объекта, а не с набором результатов. Инструмент передаёт этот результат без изменений, поэтому ответ содержит один объект property в том же формате, что и результат вызова инструмента для получения данных объекта. Это удобно, если у вас есть адрес, но нет URL.

Как получить все объявления в городе?

Нужно загружать страницы по одной — на каждую потребуется отдельный вызов. Для города в totalResults указывается общее количество результатов, а за один раз возвращаются 40 объявлений. Поэтому для крупного рынка понадобятся сотни вызовов, а не один запрос. Если ограничить поиск по почтовому индексу, ценовому диапазону или типу жилья, можно получить тот же охват с помощью меньшего количества более узких запросов. Обычно это удобнее.

Можно ли отфильтровать проданные объекты по дате?

Пока это ненадёжно. type: sold работает и возвращает данные за установленный Redfin период по умолчанию — последние три месяца. Однако soldWithinOption не преобразуется в фильтр, который принимает Redfin, и при его передаче возвращаются активные объявления со статусом SOLD. Не используйте этот параметр, пока проблему не исправят.

Есть ли данные об аренде?

Да, для этого используется type: forRent. Ожидайте получить результат в формате диапазонов, а не в формате отдельного жилья: объект аренды обычно представляет собой здание с несколькими доступными квартирами.

Можно ли использовать этот сервер вместе с другими API HasData?

Да. Один ключ подходит для всех сервисов, а один endpoint обслуживает их через параметр apis. Укажите для клиента ?apis=redfin,zillow, чтобы получить оба набора инструментов в одном подключении, или перейдите по адресу mcp.hasdata.com/api/mcp, чтобы посмотреть полный каталог.

Есть ли у HasData связь с Redfin?

Нет. HasData — независимый сервис, не связанный с Redfin и не одобренный и не спонсируемый этой компанией. Redfin — товарный знак соответствующего владельца. Инструменты работают только с общедоступными данными. Вы несёте ответственность за использование результатов в соответствии с условиями Redfin и применимым законодательством.

Соблюдение требований и персональные данные

Объявления могут содержать контактные данные агентов. Для объекта в продаже в agentInfo указываются имя и прямой номер телефона, а для аренды возвращаются agentEmail и agentPhone. Эти данные относятся к конкретным людям и опубликованы ими в профессиональном контексте, но это не выводит их из-под действия GDPR или CCPA. Отдельные правила регулируют маркетинговые обращения, а агенты по недвижимости часто становятся их целью. Поэтому перед созданием списка контактов проверьте свои обязательства. Для анализа рынка эти поля не нужны вовсе.

Ссылки HasData

Другие MCP-серверы HasData: Google Search, Google Maps, Google Trends, Google Flights, DuckDuckGo, YouTube, TikTok, Instagram, Amazon, Shopify, Yelp, Zillow, Airbnb, Booking.com, Indeed.

Разработка

Запускной скрипт служит простым stdio-мостом к удалённому серверу, поэтому ничего собирать не нужно.

npm install
HASDATA_API_KEY=your_key_here npm test

Тесты в test/ проверяют контракт инструментов — то, что может измениться без коммита в этом репозитории. Они проверяют, что ?apis=redfin возвращает ожидаемое количество инструментов, их имена не меняются, каждый инструмент по-прежнему объявляет обязательные параметры и содержит описание, перечисления фильтров, описанные в этом README, совпадают с доступными в схеме, а используемый ключ действительно принимается. Последняя проверка вызывает инструмент в реальных условиях и расходует 5 кредитов — такова цена контрольной проверки, которая может завершиться ошибкой по обоснованной причине.

Набор проверок контракта также запускается по расписанию каждую неделю: список инструментов на стороне сервиса может измениться, даже если в этом репозитории никто ничего не меняет.

Участие в разработке

Если таблица инструментов, пример ответа или описанное поведение не соответствуют действительности, сообщите об этом в issue. Для таких сообщений предусмотрен специальный шаблон. Будем рады и pull request с исправлениями, а также предложениями по улучшению запускного скрипта.

Лицензия

MIT. Подробнее — в файле LICENSE.