Attom

ATTOM — 房地产与不动产数据

ATTOM（前身为 Onboard）是一家商业不动产数据提供商，覆盖美国 99% 的独栋和多户住宅地块。其数据涵盖税务记录、估值（AVM）、可比房产、所有权历史、社区人口统计数据和风险图层（洪水、野火）。大多数房地产分析产品都以这些数据为基础。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1872+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供商没有关联，也未获其认可或发布。

这对 AI Agent 有何意义

关于美国某处具体房产的信息——其价值、税费、出售历史、所有者，以及最近的成交价——都来自 ATTOM。它提供具有全国覆盖范围的商业级数据；其他公开数据源（Zillow 公开数据、县评估员网站）覆盖不全，且数据结构不一致。

常见用例：

• AVM 查询。 “123 Main St 值多少钱？”→ attom_avm({address1, address2}) → 返回带有置信区间的自动估值。
• 税费历史。 “这处房产的税费是多少？”→ attom_tax_history → 返回年度税费评估数据。
• 可比房产。 “附近类似的房子卖了多少钱？”→ attom_comps。
• 市场背景。 “这个都市区的典型情况如何？”→ attom_market_stats。

如需通过一次调用获取综合视图，请使用住房垂直领域的 housing_property_report 组合工具——它整合了 ATTOM AVM、税费、Altos 市场数据和 FEMA 洪水数据。

身份验证

ATTOM 是付费商业 API。有两种方式：

1. 自带密钥：直接在 https://api.developer.attomdata.com 获取 ATTOM 密钥，并通过 _apiKey 传入：

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

2. Pipeworx 住房垂直领域：在 pipeworx.io/account 订阅，由 Pipeworx 代为接入 ATTOM。无需 _apiKey；调用费用计入你的 Pipeworx 账户。

如果你同时使用 ATTOM、FRED、BLS、Altos 和 FEMA，垂直领域选项更简单——这些服务都已打包在一起。

覆盖范围与数据时效

• 覆盖范围：约 1.55 亿处住宅地块，另包含主要都市区的商业记录。覆盖全国。
• 更新频率：县级评估员数据会随各县更新记录而更新（频率不一——多数每年更新，有些更新得更频繁）。AVM 每月重新校准。延迟来自 ATTOM，而非 Pipeworx。
• 地址标准化：ATTOM 对地址格式很挑剔。街道部分使用 address1，“城市，州缩写 邮编”使用 address2——这种格式最稳定。公寓号、缩写和邮政信箱的处理方式都略有不同。

常见问题

• AVM 估值区间很重要。 不带置信区间的点估值会造成误导。务必同时报告两者。ATTOM 会提供 valueLow / valueHigh——请将二者都传递给用户。
• 税费历史不一定包含当前年度。 各县的报告频率不同。attom_tax_history 中最新年份的数据可能比实际情况落后 6–18 个月。
• 可比房产需要筛选。 默认情况下，attom_comps 会返回地址附近的近期成交记录，但不会按相似度筛选。请在客户端按面积、卧室数、浴室数和日期范围筛选，才能让可比房产数据发挥作用。
• 商业房产与住宅房产。 大多数 ATTOM 工具默认针对住宅。商业房产使用不同的数据结构；请使用专用的商业端点（或使用可同时处理两者的住房垂直领域组合工具）。
• 乡村和部落土地。 部分乡村县和部落土地存在覆盖缺口。如果看似有效的地址没有匹配结果，该地块可能不在 ATTOM 的覆盖范围内。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

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

此端点实际提供的内容

https://gateway.pipeworx.io/attom/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、 discover_tools、search_within、remember/recall 和网关级工具集中的其余工具。因此，你看到的工具数量会多于此表：目前，单个工具包端点除了列出工具包自身的工具，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是当天情况的权威答案。

这是有意为之，并非意外的多路复用。元工具可以让限定范围的连接回答此工具包未涵盖的问题——通过跨整个目录路由请求的 ask_pipeworx 实现——无需额外添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义耗费的上下文超过路由功能带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

也可以连接完整的 Pipeworx 网关，直接列出每个工具包的工具，而不只是此工具包的工具：

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

两个 URL 都连接到同一个网关和相同的 1872+ 个数据源。唯一的区别在于，哪个工具包的工具会被直接列出；从任一端点都可以通过 ask_pipeworx 访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

此工具包需要你提供自己的 API 密钥（_apiKey）——我们不会为它代理 API 密钥，因此没有可在缺少密钥时运行的 curl 命令。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/attom_property_detail。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经过网关往返：

{
  "mcpServers": {
    "attom": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-attom"]
    }
  }
}

或者直接运行以确认它可以启动：

npx -y @pipeworx/mcp-attom

它通过 stdin/stdout 使用 MCP 协议，并针对仅限此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接会添加的任何共享元工具。源码相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

你可以用通俗英语提问，而不是直接调用工具——这既适用于上面的工具包端点，也适用于完整网关：

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

网关会选择合适的工具，并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT