关于 TrueFixR Storm Data API
TrueFixR Storm Data API 提供美国地址级风暴历史、近期事件记录,以及基于模型的天气和灾害预测。面向保险公司、理赔员、物业管理者及数据或 AI Agent 开发者,支持 REST 和 MCP 访问。
主要功能
- 01查询地址自 2003 年以来的风暴历史
- 02获取地址附近近期风暴记录
- 03预测 10 类灾害风险
- 04查询点位天气与逐小时预报
- 05按县和灾害类型筛选
- 06提供免费预览与参考回执
适用场景
- 01查看物业周边的风暴记录
- 02筛查地址的预测风险
- 03查询当前天气和短期降雨
- 04按县查找近期风暴线索
MCP 相关
该 API 可通过 MCP 服务供 Claude、ChatGPT 等兼容客户端使用,向 MCP 客户端提供风暴、天气和预测数据集。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
https://mcp.atlasunited.io/mcpclaude mcp add --transport http truefixr-atlascast-truefixr https://mcp.atlasunited.io/mcp{"mcpServers":{"truefixr-atlascast-truefixr":{"type":"http","url":"https://mcp.atlasunited.io/mcp"}}}在 Cursor 中打开{"servers":{"truefixr-atlascast-truefixr":{"type":"http","url":"https://mcp.atlasunited.io/mcp"}}}在 VS Code 中打开{"mcpServers":{"truefixr-atlascast-truefixr":{"type":"http","url":"https://mcp.atlasunited.io/mcp"}}}{"mcpServers":{"truefixr-atlascast-truefixr":{"serverUrl":"https://mcp.atlasunited.io/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
6| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| lat | number | 否 | 十进制度数表示的纬度。 |
| lon | number | 否 | 十进制度数表示的经度。 |
| days | integer | 否 | 支持此参数的数据集的回溯天数。 |
| kind | string | 否 | 仅适用于 dataset=at_risk。将范围缩小到“schools”或“businesses”。 |
| limit | integer | 否 | 实际付费拉取的最大记录数(默认值为 2000;各数据集仍有实际上限,例如 storms 的上限为 5000)。 |
| peril | string | 否 | 风暴/风险类型筛选器。用于 dataset=storms 和 dataset=risk(缩小到一种风暴类型;请使用免费预览中 storm_types 下返回的确切名称),也用于 dataset=at_risk(缩小到一个危险类别,含义不同;请查看该数据集自身预览中的实际取值)。常见的 storms/risk 取值:HAIL、THUNDERSTORM_WIND、FLASH_FLOOD、HEAVY_RAIN、FLOOD、TORNADO。 |
| state | string | 否 | 2 个字母的美国州代码,例如 TX。 |
| county | string | 否 | 县名,不含“County”一词,例如 Dallas。 |
| format | enum | 否 | 响应格式。json(默认值)或 csv。json | csv |
| months | integer | 否 | 仅适用于 dataset=storms。返回按月分桶的历史总数,而非单条线索,范围为最近 N 个月。 |
| window | enum | 否 | 仅适用于 dataset=risk。预测时间范围。默认值为 24h。24h | 48h | 3d | 5d | 7d | 10d |
| address | string | 否 | 街道地址,适用于 dataset=address。 |
| dataset | enum | 否 | 目标数据集。默认值为 storms。storms | risk | address | coverage | facilities | wildfire | at_risk | daily | history | weather | hazard_score |
| details | boolean | 否 | 仅适用于 dataset=weather(按地址获取基于模型的天气)。true = 完整的当前天气状况数据,费用为 $0.0002/次调用。false(默认值)= 免费精简响应,无需账户。对于此数据集,相当于 addresses=true。 |
| category | string | 否 | 仅适用于 dataset=facilities。设施类别筛选条件。 |
| counties | string | 否 | 逗号分隔的县名(最多 15 个)及州名,用于汇总多个县的数据。仅提供免费预览。 |
| addresses | boolean | 否 | false = 免费预览。true = 按地址提供记录——需要使用用户自己的 Atlas United Data API 账户密钥(Authorization 标头),或通过 x402 付款(参见下方的 x_payment 参数);使用 x402 方式无需账户。 |
| radius_mi | number | 否 | 仅适用于 dataset=history。搜索半径,单位为英里。默认值为 5,最大值为 25。 |
| x_payment | string | 否 | 可选。已签名的 x402 协议付款载荷(base64),用于在 Base 网络上以 USDC 付款,购买一次按地址提取的数据。若 addresses=true 且未提供 API 密钥或 x_payment,响应将返回 HTTP 402 和完整的付款说明(pay_to 地址、金额、网络);Agent 可据此构造此载荷并重试。 |
| hours_ahead | integer | 否 | 仅适用于 dataset=weather(按地址获取基于模型的逐小时预报)。预测未来 0–48 小时,而非当前天气状况;将自动匹配到最接近的可用预报时次,响应中的 forecast_hour_used 会准确说明实际使用的时次。 |
| date_of_loss | string | 否 | 仅适用于 dataset=history。YYYY-MM-DD。以此日期为中心生成报告——返回该日期当天及前后记录到的实际天气事件,供参考。此报告不用于判定任何索赔是否有效。 |
| max_severity | number | 否 | 测得严重程度上限。 |
| min_severity | number | 否 | 测得严重程度下限(例如,1.5 = 1.5 英寸冰雹)。请在预览中查看 severity_by_type,了解实际单位。 |
详细介绍
Atlas United 风暴数据 API:覆盖全美各地址的 ML 预测和风暴历史
Atlas United 为全美各地址(纬度/经度)构建风险模型,包含每个地点的所有信息。本仓库介绍该 API:提供未来 24 小时至 10 天的地址级风暴预测,以及自 2003 年以来该地址报告的所有风暴。按地址付费,无需签约。
AtlasCast 是 Atlas United 的预测模型套件:针对 10 种灾害提供概率式地址级预测,每天更新 4 次。TrueFixR 负责风暴数据:按地址提供已报告和雷达探测到的风暴历史。与 NOAA 或 NWS 无关联。
五款产品
| # | 产品 | dataset= | 价格 |
|---|---|---|---|
| 1 | 按地址提供 ML 风暴预测 | risk | 每个地址 $0.05 |
| 2 | 按地址提供基于模型的天气 | weather | 精简响应免费;设置 details=true 后每次调用 $0.0002 |
| 3 | 按地址提供基于模型的逐小时预测 | weather,并设置 hours_ahead(0 到 48) | 每次调用 $0.0002 |
| 4 | 按地址查询风暴历史:自 2003 年以来已报告和雷达探测到的事件 | history | 每条事件记录 $0.05,每份报告最低 $10 |
| 5 | 按地址查询过往风暴线索:过去 365 天内已报告和雷达探测到的事件 | storms | 每个地址 $0.05 |
产品 1 至 3 为模型输出。产品 4 和 5 为与地址匹配的记录事件。
1. 按地址提供 ML 风暴预测
针对 10 种灾害(龙卷风、冰雹、风、山洪、强降雨、冬季风暴、冰冻、沿海风暴潮、飓风和野火)提供概率式地址级预测,预测时效为 24 小时至 10 天,每天更新 4 次。AtlasCast 为每种灾害分别使用一个机器学习模型。模型按时间顺序训练,并使用留出的已报告事件进行验证;输入仅限于预测发布时间时可用的信息。
每条地址记录都包含建筑物重置成本和该地址的估算人数,以及风暴类型、预测时间、风险标签和历史受灾次数。重置成本是重建建筑物的费用,而非市场价值。时间窗口:24h、48h、3d、5d、7d、10d。可按县、灾害类型和时间窗口筛选。免费预览会显示数量、各灾害类型的总数、县级等级预览,以及确切费用。预测描述的是可能发生的情况,而非必然发生的情况。
2. 按地址提供基于模型的天气
提供美国任意坐标点的天气信息:当前状况、正在生效的恶劣天气警报和短期降雨展望。无需账户即可免费获取精简响应。设置 details=true,即可通过每次调用 $0.0002 获取包含 170 多个变量的完整数据。
3. 按地址提供基于模型的逐小时预测
在天气数据集中添加 hours_ahead(0 到 48),即可获取预测时段的天气,而非当前状况。响应会在 forecast_hour_used 中报告实际采用的小时。逐小时预测包含较少的核心字段。每次调用 $0.0002。
4. 按地址查询风暴历史:自 2003 年以来已报告和雷达探测到的事件
查询单处房产的长期记录:自 2003 年至今,在指定半径内报告或由雷达探测到的每起风暴事件,涵盖 11 个类别(冰雹、风、洪水、闪电、龙卷风、飓风、冬季风暴、极端高温和低温、干旱、野火、沿海灾害)。每条记录包含事件日期、类型、测得时的强度、距离(英里)和县。记录可供引用,并提供 reference_id。可选的 date_of_loss 模式会显示某个日期该地址附近是否有事件报告或由雷达探测到,并列出该日期之前和之后的事件。这是已报告和雷达探测到的事件记录,不是损失评估。
5. 按地址查看过去风暴:过去 365 天内报告或雷达探测到的事件
按地址记录过去 365 天内在各地址处或附近报告或由雷达探测到的风暴事件,可按县、灾害类型和严重程度筛选。每条记录包含事件时间(UTC)、类型、实测或雷达估算的严重程度及其单位、距离和重复命中次数。免费预览会显示数量、严重程度范围和确切费用。此数据并非损失评估。
访问方式
| 方式 | 适用场景 |
|---|---|
| REST API | 预付费 API 密钥(起价 $25),Authorization: Bearer <key> |
| MCP 服务 | Claude、ChatGPT 和其他兼容 MCP 的 AI 客户端 |
| x402 | 自主 AI Agent:在 Base 上使用 USDC 按请求付费,无需账户 |
两种方式的价格相同。每个数据集都提供免费预览,可在付费前查看数量和确切价格。每个付费响应都会附带一个 reference_id 收据,且 24 小时内相同的付费查询不会重复计费。
端点
GET https://data.truefixr.com/v1/data
POST https://data.truefixr.com/v1/data (same params as a JSON body, keeps addresses out of URLs)
| 参数 | 说明 |
|---|---|
dataset | risk、weather、history、storms,以及 address、hazard_score、facilities、wildfire(县级)、at_risk、daily、coverage |
state / county | 2 个字母的州代码 / 县名 |
peril | 按灾害类型缩小范围,例如 HAIL、FLASH_FLOOD、HEAVY_RAIN、TORNADO |
window | 仅适用于 risk:24h、48h、3d、5d、7d、10d |
hours_ahead | 仅适用于 weather:0 至 48 |
addresses | 免费预览时省略。付费查询时设为 true(weather 使用 details=true) |
limit | 返回的最大记录数(对于价格为 $0.05 的数据集,limit=10 的样本价格为 50 美分) |
format | json 或 csv |
不带参数调用该端点,可获取实时的机器可读菜单。各数据集的完整详情:数据集。
批量端点
| 端点 | 位置上限 | 价格 |
|---|---|---|
POST /v1/weather/batch | 500 | 每个位置 $0.0002 |
POST /v1/portfolio/risk | 500 | 每个位置 $0.05(县级预报状态,非地址级) |
面向 AI Agent
没有 API 密钥且无需人工介入的 Agent,可通过 x402 按次付费:
- 请求付费查询,例如
GET https://data.truefixr.com/v1/data?dataset=storms&county=Dallas&state=TX&addresses=true&limit=1。 - 收到包含确切价格的 HTTP 402 响应。
- 在 Base 上签署 USDC 付款(
eip155:8453),并在请求中加入付款标头后重试。 - 获取数据。无需注册,无需密钥。
清单:/.well-known/x402.json。Agent 文档:llms.txt。
数据诚实性
- 预报描述的是可能发生的情况,而非必然发生的情况。
- 在地址处或附近报告或由雷达探测到的风暴,不等同于房产检查、损失评估或维修估价。
structure_value是重置成本(重建所需的费用),不是市场价值。- 与 NOAA 或 NWS 无关联。
适用对象
保险公司、理赔员、应急管理部门、物业管理公司、修复服务商、太阳能行业,以及数据和 AI Agent 构建者。
文档
- 数据集:所有数据集、价格、免费预览和示例
- 示例数据:精简后的真实响应
- 适用对象:面向不同受众的使用场景
- 您将获得的内容:每个地址的两种视图,以及数据诚实性
- 比较
- 代码示例:curl、Python、JavaScript、x402 和 MCP
- 行业证据
链接
- API 文档和注册:https://atlasunited.io/api 和 https://truefixr.com/api
- MCP 服务:https://mcp.atlasunited.io/mcp
- 公司:https://truefixr.com
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。