本文内容
Mireye Land Search 与 Enrich API：MCP、定价与地块筛选
头图插画：© 2026 Wavect。
实用的土地搜索智能体，应该给出一份可以继续核查的候选清单：地块身份明确、筛选标准清楚、证据可追溯，并且列出尚未解决的问题。Mireye 新推出的 Land Search 与 Enrich API，通过 REST 和模型上下文协议（MCP）为这类工作流提供了基础能力。
Mireye 在发布公告中表示，平台覆盖超过 1.6 亿个美国地块，提供 550 个可用数据字段，已索引数十亿个数据点，Fetch 历史调用量超过 400 万次。这些数字来自厂商。实际值得关注的变化，是地块发现、指定地块的数据丰富，以及受支持的公共位置字段免费访问这三项能力的结合。
核查日期：。我们审阅了官方文档，并获取了三个公开字段目录。我们没有执行需要身份验证的地块搜索，没有测试延迟，也没有独立审计全美覆盖情况。下文提供的是建议工作流和按公开单价计算的成本示例。
Mireye Search、Enrich 与 Fetch：智能体应该调用哪个 API？
用 Search 发现地块，用 Enrich 调查已选定的地块，用 Fetch 获取已知位置的受支持公共数据。端点不仅决定费用，也决定能够获得什么证据。
| 操作 | 适合的输入起点 | 返回内容 | 用量价格 |
|---|---|---|---|
| Search | 州、面积以及其他受支持的条件 | 匹配的地块及所选字段值 | 每个完成的结果页 0.20 美元 |
| Enrich | 一个美国地址或坐标 | 地块匹配结果，以及附有来源、置信度和解读提示的所选字段 | 每个匹配地块 0.02 美元，至少返回一个字段才计费 |
| Fetch | 已知位置及符合条件的公共字段 | 附有字段级来源和状态的结构化公共数据 | 通过标准身份验证方式访问时免费 |
| Ask | 关于某个位置的自然语言问题 | 附有引用的生成式回答 | 每个完成的回答 0.10 美元 |
当前定价页列出了注册赠送的一次性 10 美元余额，且无到期时间。付费套餐每月 49 美元起，包含用量额度，并降低 Search 和 Enrich 的单价。套餐名为 Free，不代表其中的地块操作也免费。
免费 Fetch 不包含受许可限制的地块记录，包括地块身份、所有权、地块边界和地块用途分区，也不包含依赖这些记录的计算。身份验证和容量限制仍然适用。另一个不需要 API 密钥的 x402 支付通道，每次成功的 Fetch 调用收费 0.001 USDC。因此，说明“Fetch 免费”时，还需要交代访问方式和字段范围。
用 Mireye 生成一份地块候选清单要多少钱？
按 Free 套餐单价计算，五个完成的 Search 结果页，加上 20 次符合计费条件的 Enrich 调用，Mireye 用量费合计为 1.40 美元。这是预算示例，并非找到 20 个合适地块的实测成本。
| 步骤 | 假设 | 计算 |
|---|---|---|
| 发现候选地块 | 五个付费 Search 结果页 | 5 × 0.20 = 1.00 美元 |
| 调查入围地块 | 20 次 Enrich 操作，每次至少返回一个字段 | 20 × 0.02 = 0.40 美元 |
| 补充公共位置数据 | 通过标准身份验证方式进行符合免费范围的 Fetch 调用 | Fetch 用量费为 0.00 美元 |
| Mireye 小计 | 仅含上述操作 | 1.40 美元 |
Search 的页面价格包含该页请求的输出字段。通过 Search 返回一个字段，不会自动另收一次 Enrich 费用。每页返回的地块数可能少于请求数量，也可能为零；这个示例没有假设五页都会返回满额结果，也没有假设搜索已穷尽所有匹配项。模型 token、工作流运行、付费驾车路线计算以及人工调查，均不包含在上述小计中。
按这些单价计算，如果全部用于一种操作，10 美元欢迎余额相当于 50 个 Search 结果页，或 500 次符合计费条件的 Enrich 操作。评估生产系统的经济性时，应衡量每个验收通过的智能体结果成本：如果地块匹配或证据还需要返工，API 调用便宜本身意义有限。
宣传中的 550 个字段都能用来筛选吗？
不能把发布时的字段总数直接当作筛选参数规范。我们获取的公开目录版本为 0.18.0，各端点的字段数量如下：
这些目录涵盖的集合不同，因此不能仅凭总数差异认定发布数字有误。更有用的是，Search 字段发现接口区分了 filter_ops 和 returnable。在获取的目录中，parcel_flood_sfha_fraction 可以返回，但没有筛选运算符。智能体应该请求该字段，再评估返回值，不能自行编造服务端筛选条件。
查询目录不需要身份验证，也不收费。通过 MCP，可以调用 mireye_list_fields，指定对应的 endpoint，并按需添加搜索词。构建工作流时应查询目录，避免把发布时的字段数量永久写死在应用逻辑中。
如何通过 MCP 将 Mireye 接入 Claude Code？
官方支持的 MCP 连接托管于 https://api.mireye.com/mcp，采用 Streamable HTTP 和 OAuth。在 Claude Code 中执行：
claude mcp add --transport http --scope user mireye-earth https://api.mireye.com/mcp然后打开 /mcp 并完成授权。其他客户端需要支持该远程传输方式及授权流程。旧版本地适配器和设备登录方式已经停用。
Search 与 Enrich 的授权还取决于当前条款和许可数据访问权限。已有连接可能需要重新授权，旧 OAuth 授权不会自动获得新权限。直接 HTTP 调用的 API 密钥与托管 MCP 的 OAuth 令牌承担不同角色。
为美国地块筛选建立有明确边界的 MCP 工作流
1. 把需求转化为明确条件
以太阳能项目初筛为例，先指定县、面积范围，以及第一轮审核需要的证据。把硬性要求与偏好分开。“面积为 100 至 1,000 英亩”是明确条件；“电网接入条件良好”则需要定义衡量指标，并进一步核查。即使界面已本地化，请求中的面积仍应使用 API 要求的英亩单位。
托管工具的调用规范要求将付费操作的请求体放在 req 内，并将 idempotency_key 放在同一级。下面是发给 mireye_search 的请求示例，并非一次实际 API 调用的结果：
{
"req": {
"filters": [
{"field": "state2", "op": "eq", "value": "AZ"},
{"field": "county", "op": "eq", "value": "04013"},
{"field": "pvd_gisacre", "op": "between", "value": [100, 1000]}
],
"fields": ["owner", "zoning", "parcel_flood_sfha_fraction"],
"limit": 10,
"max_cost_usd": "0.20"
},
"idempotency_key": "az-parcel-screen-example-page-001"
}县 FIPS 代码保留为字符串，以免丢失前导零。洪水覆盖比例在这里作为输出字段请求。开始新搜索时应更换示例中的操作键；重试同一请求时则保留原键。
2. 分别跟踪搜索完整性与支出
Search 参考文档要求提供州筛选条件，每页默认返回 10 个地块，最多 100 个。返回的是先找到的匹配项，因此排序需要由智能体自行完成。
- 只要
next_cursor不为 null，就应继续翻页，即使当前页结果不足或为空；如果达到工作流总预算，则按预算停止。 - 翻页时保持筛选条件和请求字段不变。每个新页面使用新的操作键，重试则复用原键和原请求体。
- 读取
remarks，检查是否存在未完成的核查或不可用字段。即使游标已表示最后一页，完整性警告依然有效。 - 客户端超时应至少设为 210 秒。游标一小时后过期，不同页面也不是同一个冻结的数据快照。
max_cost_usd 限制的是单次操作费用。我们建议的控制逻辑还会统计页数、累计计费回执，并在达到整次运行预算时停止。如果提前结束，报告应写明“已检查候选项中的较优选择”，并记录停止原因，不应宣称找到了全美最优地块。
3. 合并 Search 和 Enrich 数据前，先确认地块身份
Enrich 会将地址或坐标重新匹配到地块，并非直接把 Search 返回的 APN 当作保证正确的关联键。Search 保存的 analysis_point 可能位于地块边界之外，因此新的空间匹配可能指向另一处地块。
按照官方身份核对流程，应先确认结果已匹配，再比较地块编号、地址、州和县 FIPS 代码，确认一致后再合并证据。无法确定的匹配应留待审核。不同县可能使用相同的 APN，而一个看起来合理的地址也不足以证明是同一地块。
直接在 Search 中请求所需字段，可以避免第二次匹配。当需要字段级来源、置信度和解读提示时，再单独调用 Enrich。除了决策字段，还应请求身份比对所需的字段。
附有来源的地块结果，究竟能证明什么？
应完整保留各端点的证据结构。Fetch 区分 ok、absent 和 failed，并在可用时提供来源 URL、获取时间和数据集年代。即使 fetched_at 很新，也不代表底层旧数据集已经更新。Search 返回普通字段值；单独调用 Enrich 时，不可用字段可能被省略，它也不提供 Fetch 那样完整的状态结构。
我们的工程原则是，将未知、false 和零保留为不同状态。只有响应或经过核查的来源确实提供链接和日期时，才把它们加入证据。不要根据来源名称编造引用 URL。
字段定义说明了空间范围的重要性：within_floodplain_polygon 描述的是一个点，而 parcel_flood_sfha_fraction 涉及完整地块边界。实用的智能体应在排序和文字结论中都保留这一区别。
| 观察到的信号 | 合理的下一步 |
|---|---|
| 采样点未显示已制图的风险 | 先核查整个地块与风险区的重叠及数据覆盖，再对整块土地作出判断。 |
| 缺少土地用途分区或所有权字段 | 获取相关记录，在此之前保留未决状态。 |
| 附近有变电站或输电线路 | 核查对应电力公司、接入流程及具体项目要求。 |
| 刚获取到较旧的数据集 | 保留两个日期，并判断决策是否需要更新的记录。 |
FEMA 的洪水分区说明指出，较低风险区域仍然存在风险，而风险未确定表示缺少分析。FERC 的发电项目并网说明将初步信息与接入研究、网络升级区分开。我们据此得出的初筛判断很直接：距离近，本身不能证明有可用的电网容量。
如何为太阳能、储能或数据中心项目重新排序地块？
先按明确的硬性要求筛选，再用明确偏好对符合条件的候选地块排序，并单独评估证据完整性。不要把缺失证据当成有利的零值，反而让数据不全的地块获得更高评分。
设想三个太阳能项目候选地块。A 符合面积要求，且已有审核过的风险证据。B 的地形看起来有吸引力，但缺少全地块洪水评估结果。C 不符合已确认的面积要求。A 可以进入已评估的候选清单，B 应进入待核查队列，C 则按记录的原因排除。如果只用一个综合分数，就会掩盖这些决定为何不同。
候选清单的每一行都应便于下一位处理者接手：地块身份、评估位置、已满足的要求、偏好得分及其规则版本、支持来源、不可用证据、搜索完整性说明，以及下一项核查行动。只保存获准使用的证据，并在分享结果时遵守适用的数据使用条款。
太阳能、电池储能和数据中心需要不同的选址需求。开发团队应先定义项目特有的电力、用地、通达性及运营要求，再选择字段和权重。仅因为两类项目都关心电网情况，就把太阳能评分直接用于数据中心，会让智能体朝错误目标优化。
Mireye 自己发布的得州太阳能车棚示例，很好地展示了这个问题。该项目用自定义程序搜索得州公开地块文件，再批量调用 Fetch，对 1,187 个场地进行筛选，并公开讨论了多轮 Fetch 调用、重复机会以及未经验证的评分公式。部分缺失的 ERCOT 排队数据，实际上对应 ERCOT 服务范围以外的场地。这说明，对 null 扣分之前应先检查数据是否适用于该位置。该项目是厂商演示，并非新 Search/Enrich API 的基准测试，也不是 Wavect 的性能测试结果。
什么情况下值得评估 Mireye？
当智能体需要发现美国地块，并为人工选址或收购流程整理结构化证据时，Mireye 值得评估。可以先在真正相关的县和使用场景中开展限定范围的试点，衡量地块匹配是否正确、必要字段是否可用、哪些证据仍未解决、审核后的候选清单质量，以及总成本。
文档中的地理覆盖范围以美国为主。驾车时间工具额外支持加拿大，不等于地块数据也覆盖加拿大。德语、西班牙语或中文界面，也不会把地块数据集扩展到这些国家。
生产集成需要连接数据契约、排序规则、支出限制和人工审核交接。Wavect 的AI 集成服务涵盖周边应用开发；我们的企业 MCP 授权指南则解释更广泛的访问权限边界。