--- title: "Mireye 地块搜索 API：MCP、定价与选址筛选" canonical: https://wavect.io/zh/blog/mireye-land-search-enrich-api-mcp/ language: zh description: "了解 Mireye Search、Enrich 和免费 Fetch 如何用于美国地块筛选：MCP 接入、每页费用、1.40 美元预算示例、字段限制、重新排序与证据核查。" image: "https://wavect.io/img/blog/headers/header_mireye-land-search-enrich-api-mcp.png" author: ["Kevin Riedl"] published: "2026-10-23" updated: "2026-10-23" reviewed: "2026-10-23" --- # Mireye Land Search 与 Enrich API：MCP、定价与地块筛选 [**返回**](/zh/blog/overview/) [![Kevin Riedl](/img/team/kevin.webp)](/zh/team/kevin-riedl/) [Kevin Riedl](/zh/team/kevin-riedl/) https://linkedin.com/in/wsdt 10 分钟 阅读 · 2026年10月23日 最近审核 2026年10月23日 [**下一篇**](/zh/blog/ai-agent-cost-per-action-2026/) 要点速览 Mireye Search 用于发现美国地块，Enrich 用于调查已选地块，Fetch 免费提供符合范围的公共位置字段。 按核查时的 Free 套餐单价，Search 每个完成的结果页 0.20 美元，Enrich 每个匹配且至少返回一个字段的地块 0.02 美元。 五页搜索加 20 次符合计费条件的 Enrich 调用，Mireye 用量费合计为 1.40 美元，不含模型和人工成本。 Search 返回先找到的匹配项，应用需要自行排序，并检查字段可筛选性、分页完整性、地块身份和证据缺口。 头图插画：© 2026 Wavect。 实用的土地搜索智能体，应该给出一份可以继续核查的候选清单：地块身份明确、筛选标准清楚、证据可追溯，并且列出尚未解决的问题。Mireye 新推出的 Land Search 与 Enrich API，通过 REST 和模型上下文协议（MCP）为这类工作流提供了基础能力。 Mireye 在 [发布公告](https://www.linkedin.com/posts/ansh-chokshi_introducing-land-search-and-enrich-api-activity-7519083978218180608-9C2E) 中表示，平台覆盖**超过 1.6 亿个美国地块，提供 550 个可用数据字段，已索引数十亿个数据点，Fetch 历史调用量超过 400 万次**。这些数字来自厂商。实际值得关注的变化，是地块发现、指定地块的数据丰富，以及受支持的公共位置字段免费访问这三项能力的结合。 **核查日期：2026年10月23日。**我们审阅了官方文档，并获取了三个公开字段目录。我们没有执行需要身份验证的地块搜索，没有测试延迟，也没有独立审计全美覆盖情况。下文提供的是建议工作流和按公开单价计算的成本示例。 **用 Search 发现地块，用 Enrich 调查已选定的地块，用 Fetch 获取已知位置的受支持公共数据。**端点不仅决定费用，也决定能够获得什么证据。 | 操作 | 适合的输入起点 | 返回内容 | 用量价格 | | --- | --- | --- | --- | | Search | 州、面积以及其他受支持的条件 | 匹配的地块及所选字段值 | 每个完成的结果页 0.20 美元 | | Enrich | 一个美国地址或坐标 | 地块匹配结果，以及附有来源、置信度和解读提示的所选字段 | 每个匹配地块 0.02 美元，至少返回一个字段才计费 | | Fetch | 已知位置及符合条件的公共字段 | 附有字段级来源和状态的结构化公共数据 | 通过标准身份验证方式访问时免费 | | Ask | 关于某个位置的自然语言问题 | 附有引用的生成式回答 | 每个完成的回答 0.10 美元 | [当前定价页](https://www.mireye.com/pricing) 列出了**注册赠送的一次性 10 美元余额，且无到期时间**。付费套餐每月 49 美元起，包含用量额度，并降低 Search 和 Enrich 的单价。套餐名为 Free，不代表其中的地块操作也免费。 免费 Fetch 不包含受许可限制的地块记录，包括地块身份、所有权、地块边界和地块用途分区，也不包含依赖这些记录的计算。身份验证和容量限制仍然适用。另一个不需要 API 密钥的 [x402 支付通道](https://docs.mireye.ai/pricing) ，每次成功的 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 操作。评估生产系统的经济性时，应衡量 [每个验收通过的智能体结果成本](/zh/blog/ai-agent-cost-per-action-2026/) ：如果地块匹配或证据还需要返工，API 调用便宜本身意义有限。 ## 宣传中的 550 个字段都能用来筛选吗？ **不能把发布时的字段总数直接当作筛选参数规范。**我们获取的公开目录版本为 `0.18.0`，各端点的字段数量如下： - [Search 目录](https://api.mireye.com/v1/search/fields) ：529 个可返回条目，其中 510 个至少支持一种筛选运算符。 - [Enrich 目录](https://api.mireye.com/v1/enrich/fields) ：525 个字段。 - [Fetch 目录](https://api.mireye.com/v1/meta/fields) ：351 个字段。 这些目录涵盖的集合不同，因此不能仅凭总数差异认定发布数字有误。更有用的是， [Search 字段发现接口](https://docs.mireye.ai/api-reference/get-search-fields) 区分了 `filter_ops` 和 `returnable`。在获取的目录中，`parcel_flood_sfha_fraction` 可以返回，但没有筛选运算符。智能体应该请求该字段，再评估返回值，不能自行编造服务端筛选条件。 查询目录不需要身份验证，也不收费。通过 MCP，可以调用 `mireye_list_fields`，指定对应的 `endpoint`，并按需添加搜索词。构建工作流时应查询目录，避免把发布时的字段数量永久写死在应用逻辑中。 ## 如何通过 MCP 将 Mireye 接入 Claude Code？ 官方 [支持的 MCP 连接](https://docs.mireye.ai/mcp/installation) 托管于 `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 的授权](https://docs.mireye.ai/authentication) 还取决于当前条款和许可数据访问权限。已有连接可能需要重新授权，旧 OAuth 授权不会自动获得新权限。直接 HTTP 调用的 API 密钥与托管 MCP 的 OAuth 令牌承担不同角色。 ## 为美国地块筛选建立有明确边界的 MCP 工作流 ### 1. 把需求转化为明确条件 以太阳能项目初筛为例，先指定县、面积范围，以及第一轮审核需要的证据。把硬性要求与偏好分开。“面积为 100 至 1,000 英亩”是明确条件；“电网接入条件良好”则需要定义衡量指标，并进一步核查。即使界面已本地化，请求中的面积仍应使用 API 要求的英亩单位。 [托管工具的调用规范](https://docs.mireye.ai/mcp/tools) 要求将付费操作的请求体放在 `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 参考文档](https://docs.mireye.ai/api-reference/search) 要求提供州筛选条件，每页默认返回 10 个地块，最多 100 个。返回的是先找到的匹配项，因此排序需要由智能体自行完成。 - 只要 `next_cursor` 不为 null，就应继续翻页，即使当前页结果不足或为空；如果达到工作流总预算，则按预算停止。 - 翻页时保持筛选条件和请求字段不变。每个新页面使用新的操作键，重试则复用原键和原请求体。 - 读取 `remarks` ，检查是否存在未完成的核查或不可用字段。即使游标已表示最后一页，完整性警告依然有效。 - 客户端超时应至少设为 210 秒。游标一小时后过期，不同页面也不是同一个冻结的数据快照。 `max_cost_usd` 限制的是单次操作费用。我们建议的控制逻辑还会统计页数、累计计费回执，并在达到整次运行预算时停止。如果提前结束，报告应写明“已检查候选项中的较优选择”，并记录停止原因，不应宣称找到了全美最优地块。 ### 3. 合并 Search 和 Enrich 数据前，先确认地块身份 [Enrich 会将地址或坐标重新匹配到地块](https://docs.mireye.ai/api-reference/enrich) ，并非直接把 Search 返回的 APN 当作保证正确的关联键。Search 保存的 `analysis_point` 可能位于地块边界之外，因此新的空间匹配可能指向另一处地块。 按照 [官方身份核对流程](https://docs.mireye.ai/guides/search-and-enrich) ，应先确认结果已匹配，再比较地块编号、地址、州和县 FIPS 代码，确认一致后再合并证据。无法确定的匹配应留待审核。不同县可能使用相同的 APN，而一个看起来合理的地址也不足以证明是同一地块。 直接在 Search 中请求所需字段，可以避免第二次匹配。当需要字段级来源、置信度和解读提示时，再单独调用 Enrich。除了决策字段，还应请求身份比对所需的字段。 ## 附有来源的地块结果，究竟能证明什么？ 应完整保留各端点的证据结构。 [Fetch 区分 `ok`、`absent` 和 `failed`](https://docs.mireye.ai/api-reference/fetch) ，并在可用时提供来源 URL、获取时间和数据集年代。即使 `fetched_at` 很新，也不代表底层旧数据集已经更新。Search 返回普通字段值；单独调用 Enrich 时，不可用字段可能被省略，它也不提供 Fetch 那样完整的状态结构。 我们的工程原则是，将未知、false 和零保留为不同状态。只有响应或经过核查的来源确实提供链接和日期时，才把它们加入证据。不要根据来源名称编造引用 URL。 ![青绿色采样点位于紫色风险带之外，但风险带覆盖了地块边界内的一部分区域](https://wavect.io/img/blog/mireye-point-vs-parcel.svg)单点结果无法描述整个地块。紫色风险带覆盖了地块的一部分，但没有经过青绿色采样点。本图仅为示意，并非真实洪水地图。插画：© 2026 Wavect。 [字段定义](https://docs.mireye.ai/api-reference/enrich-fields) 说明了空间范围的重要性：`within_floodplain_polygon` 描述的是一个点，而 `parcel_flood_sfha_fraction` 涉及完整地块边界。实用的智能体应在排序和文字结论中都保留这一区别。 | 观察到的信号 | 合理的下一步 | | --- | --- | | 采样点未显示已制图的风险 | 先核查整个地块与风险区的重叠及数据覆盖，再对整块土地作出判断。 | | 缺少土地用途分区或所有权字段 | 获取相关记录，在此之前保留未决状态。 | | 附近有变电站或输电线路 | 核查对应电力公司、接入流程及具体项目要求。 | | 刚获取到较旧的数据集 | 保留两个日期，并判断决策是否需要更新的记录。 | FEMA 的 [洪水分区说明](https://www.floodsmart.gov/flood-zones-and-maps/what-is-my-flood-zone) 指出，较低风险区域仍然存在风险，而风险未确定表示缺少分析。FERC 的 [发电项目并网说明](https://www.ferc.gov/explainer-interconnection-final-rule) 将初步信息与接入研究、网络升级区分开。我们据此得出的初筛判断很直接：距离近，本身不能证明有可用的电网容量。 ## 如何为太阳能、储能或数据中心项目重新排序地块？ **先按明确的硬性要求筛选，再用明确偏好对符合条件的候选地块排序，并单独评估证据完整性。**不要把缺失证据当成有利的零值，反而让数据不全的地块获得更高评分。 设想三个太阳能项目候选地块。A 符合面积要求，且已有审核过的风险证据。B 的地形看起来有吸引力，但缺少全地块洪水评估结果。C 不符合已确认的面积要求。A 可以进入已评估的候选清单，B 应进入待核查队列，C 则按记录的原因排除。如果只用一个综合分数，就会掩盖这些决定为何不同。 候选清单的每一行都应便于下一位处理者接手：地块身份、评估位置、已满足的要求、偏好得分及其规则版本、支持来源、不可用证据、搜索完整性说明，以及下一项核查行动。只保存获准使用的证据，并在分享结果时遵守适用的数据使用条款。 太阳能、电池储能和数据中心需要不同的选址需求。开发团队应先定义项目特有的电力、用地、通达性及运营要求，再选择字段和权重。仅因为两类项目都关心电网情况，就把太阳能评分直接用于数据中心，会让智能体朝错误目标优化。 Mireye 自己发布的 [得州太阳能车棚示例](https://github.com/Mireye-Labs/solar-carport-siting/blob/main/README.md) ，很好地展示了这个问题。该项目用自定义程序搜索得州公开地块文件，再批量调用 Fetch，对 1,187 个场地进行筛选，并公开讨论了多轮 Fetch 调用、重复机会以及未经验证的评分公式。部分缺失的 ERCOT 排队数据，实际上对应 ERCOT 服务范围以外的场地。这说明，对 null 扣分之前应先检查数据是否适用于该位置。该项目是厂商演示，并非新 Search/Enrich API 的基准测试，也不是 Wavect 的性能测试结果。 ## 什么情况下值得评估 Mireye？ 当智能体需要发现美国地块，并为人工选址或收购流程整理结构化证据时，Mireye 值得评估。可以先在真正相关的县和使用场景中开展限定范围的试点，衡量地块匹配是否正确、必要字段是否可用、哪些证据仍未解决、审核后的候选清单质量，以及总成本。 [文档中的地理覆盖范围](https://docs.mireye.ai/introduction) 以美国为主。驾车时间工具额外支持加拿大，不等于地块数据也覆盖加拿大。德语、西班牙语或中文界面，也不会把地块数据集扩展到这些国家。 生产集成需要连接数据契约、排序规则、支出限制和人工审核交接。Wavect 的 [AI 集成服务](/zh/services/artificial-intelligence/) 涵盖周边应用开发；我们的 [企业 MCP 授权指南](/zh/blog/enterprise-mcp-authorization-architecture/) 则解释更广泛的访问权限边界。 ## 常见问题 ### Mireye Fetch 完全免费吗？ 通过标准身份验证方式调用 Fetch，符合范围的公共位置字段不收用量费。许可地块数据不属于免费范围，速率和容量限制仍然适用。另一个不需要 API 密钥的 x402 通道，每次成功调用收费 0.001 USDC。 ### Mireye Search 会自动返回最好的土地吗？ Search 返回先找到的匹配地块，并不提供已经排序的候选清单。应用需要定义排序偏好、保留缺失证据，并说明搜索是否检查了所有可用页面，还是因达到预算而停止。 ### 注册赠送的 10 美元会每月重新发放吗？ 不会。核查时的定价页说明，这是一笔没有到期时间的一次性欢迎余额。按 Free 套餐单价计算，如果全部用于一种操作，10 美元可支付 50 个 Search 结果页，或 500 次符合计费条件的 Enrich 操作。 ### 所有 Mireye 字段都能作为 Search 筛选条件吗？ 不能。应检查 Search 目录中的 filter_ops 和 returnable 属性。有些字段可以返回，但不能用于服务端筛选。发布时公布的字段总数并不是 API 请求规范。 ### 可以用 Mireye 查询欧洲或中国的地块吗？ 文档描述的地块产品以美国为主。驾车时间工具额外覆盖加拿大，也不能据此推断有国际地块数据。在为其他市场构建工作流前，应先核实独立的当地数据来源。 ### AI 土地搜索结果能替代尽职调查吗？ 它可以组织初步筛选和支持证据。候选清单仍需接受与具体项目相适应的核查，包括地块身份、来源覆盖情况，以及尚未解决的场地限制。附近有电力线路，或某个风险值缺失，都不能证明项目可以建设。 架构与平台 ## 接下来读什么 对长期交付产生影响的框架、平台与系统设计选择。 [从这里开始**智慧城市软件架构：MQTT、LoRaWAN、Kubernetes 与 Terraform**](/zh/blog/smart-city-architecture-best-practices-2026/) - [git-ai 评测：并行智能体合并与验证](/zh/blog/git-ai-concurrent-agents-merge-verification/) - [PHP2Shell：升级旧版 PHP，还是迁移到 Node.js？](/zh/blog/php2shell-legacy-php-upgrade-migration/) - [企业软件：如何让专项团队与现有系统集成商协作](/zh/blog/enterprise-software-specialist-system-integrator/) - [NVIDIA Run:ai 开源：GPU 编排不等于软件工厂](/zh/blog/nvidia-runai-open-source-gpu-software-factory/) - [GitButler 并行 AI 智能体：多个分支，一个运行中的应用](/zh/blog/gitbutler-parallel-ai-agents-one-workspace/) [下一篇文章**git-ai 评测：并行智能体合并与验证**](/zh/blog/git-ai-concurrent-agents-merge-verification/) [**返回**](/zh/blog/overview/) [![Kevin Riedl](/img/team/kevin.webp)](/zh/team/kevin-riedl/) [Kevin Riedl](/zh/team/kevin-riedl/) https://linkedin.com/in/wsdt 10 分钟 阅读 · 2026年10月23日 最近审核 2026年10月23日 [**下一篇**](/zh/blog/ai-agent-cost-per-action-2026/)