ATTOM — данные о недвижимости и недвижимом имуществе

ATTOM (ранее Onboard) — коммерческий поставщик данных о недвижимости, охватывающий 99% жилых и многоквартирных участков в США. Данные лежат в основе налоговых записей, оценок (AVM), аналогов, истории владения, демографии районов и карт рисков (наводнения, лесные пожары). Это то, на чём строится большинство продуктов аналитики недвижимости.

Часть Pipeworx — MCP-шлюза, подключающего ИИ-агентов к 1476+ живым источникам данных.

Почему это важно для ИИ-агентов

Всё, что касается конкретной недвижимости в США — её стоимость, налоги, история продаж, владелец, последняя цена продажи — исходит из ATTOM. Данные коммерческого уровня с национальным покрытием; конкурирующие публичные источники (публичные данные Zillow, сайты окружных оценщиков) имеют неравномерное покрытие и несогласованные схемы.

Типичные сценарии использования:

• Запрос AVM. «Сколько стоит 123 Main St?» → attom_avm({address1, address2}) → автоматическая оценка с доверительным интервалом.

• История налогов. «Каким был налог на недвижимость?» → attom_tax_history → ежегодные налоговые оценки.

• Аналоги. «Сколько стоили похожие дома поблизости?» → attom_comps.

• Контекст рынка. «Что типично для этого мегаполиса?» → attom_market_stats.

Для единого комплексного обзора используйте составной инструмент housing_property_report из Housing Vertical — он объединяет AVM ATTOM + налоги + рыночные данные Altos + данные FEMA о наводнениях.

Related MCP server: mcp-server-attom

Аутентификация

ATTOM — платный коммерческий API. Два варианта:

1. Собственный ключ: получите ключ ATTOM напрямую на https://api.developer.attomdata.com, передайте через _apiKey:

   attom_avm({
     address1: "123 Main St",
     address2: "Denver, CO 80202",
     _apiKey: "your-attom-api-key"
   })

2. Pipeworx Housing Vertical: оформите подписку на pipeworx.io/account, и Pipeworx возьмёт на себя отношения с ATTOM. _apiKey не нужен; вызовы списываются с вашего аккаунта Pipeworx.

Вариант с вертикалью проще, если вы используете ATTOM вместе с FRED, BLS, Altos и FEMA — всё упаковано вместе.

Покрытие и актуальность

• Покрытие: ~155 млн жилых участков, плюс коммерческие записи в крупных мегаполисах. Национальное.

• Частота обновления: данные окружных оценщиков обновляются по мере обновления записей округами (различается — большинство обновляется ежегодно, некоторые чаще). AVM пересчитываются ежемесячно. Задержка связана с ATTOM, а не с Pipeworx.

• Нормализация адресов: ATTOM требователен к адресам. Используйте address1 для части с улицей и address2 для «Город, Штат ИНДЕКС» — это работает наиболее стабильно. Номера квартир, сокращения и абонентские ящики ведут себя по-разному.

Типичные ошибки

• Доверительные интервалы AVM важны. Точечная оценка без доверительного интервала вводит в заблуждение. Всегда сообщайте оба значения. ATTOM даёт valueLow / valueHigh — передавайте оба пользователю.

• История налогов не всегда за текущий год. Округа отчитываются с разной периодичностью. Самый последний год в attom_tax_history может отставать от реальности на 6–18 месяцев.

• Аналоги требуют фильтрации. По умолчанию attom_comps возвращает недавние продажи рядом с адресом, но не фильтрует по сходству. Фильтруйте на стороне клиента по площади, количеству спален, ванных комнат и диапазону дат, чтобы аналоги были полезны.

• Коммерческая и жилая недвижимость. Большинство инструментов ATTOM по умолчанию ориентированы на жилую недвижимость. Коммерческая недвижимость имеет другие схемы; используйте выделенные коммерческие конечные точки (или составной инструмент Housing Vertical, который обрабатывает оба типа).

• Сельские и племенные земли. Существуют пробелы в покрытии для некоторых сельских округов и племенных земель. Если адрес выглядит корректно, но не возвращает совпадений, участок может не входить в покрытие ATTOM.

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

Добавьте в ваш MCP-клиент (Claude Desktop, Cursor, Windsurf и т. д.):

{
  "mcpServers": {
    "attom": {
      "url": "https://gateway.pipeworx.io/attom/mcp"
    }
  }
}

Что именно обслуживает эта конечная точка

tools/list на https://gateway.pipeworx.io/attom/mcp возвращает инструменты из таблицы выше плюс общие мета-инструменты Pipeworx — ask_pipeworx, discover_tools, search_within, remember/recall и остальной набор, общий для всего шлюза. Поэтому количество инструментов, которое вы видите, больше, чем в таблице: конечная точка одного пакета в настоящее время перечисляет примерно 30 общих инструментов вместе с собственными инструментами пакета. Ответ initialize соединения указывает его точный объём и является авторитетным ответом на конкретный день.

Это сделано намеренно, а не случайное мультиплексирование. Мета-инструменты позволяют ограниченному соединению ответить на вопрос, который этот пакет не покрывает — через ask_pipeworx, который маршрутизирует по всему каталогу — без необходимости добавлять второй MCP-сервер. В настоящее время нет способа подключить конечную точку пакета без них; если дополнительные схемы стоят вам больше контекста, чем стоит маршрутизация, подключитесь к полному шлюзу один раз, а не к нескольким конечным точкам пакетов.

Или подключитесь к полному шлюзу Pipeworx, чтобы получить инструменты всех пакетов, перечисленные напрямую, а не только этого:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

Оба URL ведут к одному и тому же шлюзу и к одним и тем же 1476+ источникам данных. Единственное отличие — какие инструменты пакета перечислены напрямую; ask_pipeworx достигает всех из них с любого из них.

Использование с ask_pipeworx

Вместо прямого вызова инструментов вы можете задавать вопросы на простом английском — это работает как на конечной точке пакета выше, так и на полном шлюзе:

ask_pipeworx({ question: "your question about Attom data" })

Шлюз выбирает подходящий инструмент и автоматически заполняет аргументы.

Дополнительно

• Документация и руководства

• pipeworx.io

Лицензия

MIT