En este artículo
Mireye Land Search y Enrich API: MCP, precios y preselección de parcelas
Ilustración de cabecera: © 2026 Wavect.
Un agente de búsqueda de terrenos útil debe entregar una preselección que una persona pueda investigar: parcelas identificables, criterios de selección explícitos, pruebas trazables y preguntas pendientes. La nueva API Land Search y Enrich de Mireye ofrece componentes para ese flujo mediante REST y el Model Context Protocol (MCP).
En su anuncio de lanzamiento, Mireye declara más de 160 millones de parcelas en Estados Unidos, 550 campos de datos disponibles, miles de millones de datos indexados y cuatro millones de llamadas históricas a Fetch. Son cifras del proveedor. La novedad práctica es la combinación de búsqueda de parcelas, enriquecimiento de propiedades seleccionadas y acceso gratuito a los campos públicos de ubicación compatibles.
Comprobado el : revisamos la documentación primaria y consultamos los tres catálogos públicos de campos. No ejecutamos búsquedas de parcelas autenticadas, ni medimos la latencia ni auditamos de forma independiente la cobertura nacional. Los ejemplos siguientes son propuestas de flujos y cálculos de costes.
Mireye Search, Enrich y Fetch: ¿qué API debe usar un agente?
Usa Search para encontrar parcelas, Enrich para investigar una parcela seleccionada y Fetch para obtener datos públicos compatibles de una ubicación conocida. El endpoint determina tanto las pruebas disponibles como el coste.
| Operación | Punto de partida adecuado | Qué recibes | Precio por uso |
|---|---|---|---|
| Search | Estado, superficie en acres y otros requisitos compatibles | Parcelas coincidentes y valores de los campos seleccionados | 0,20 USD por página completada |
| Enrich | Una dirección o coordenada de Estados Unidos | Una parcela identificada y campos seleccionados con fuente, confianza e indicaciones para interpretarlos | 0,02 USD por parcela identificada cuando se devuelve al menos un campo |
| Fetch | Una ubicación conocida y campos públicos incluidos en el acceso gratuito | Datos públicos estructurados con procedencia y estado por campo | Gratuito mediante el acceso autenticado estándar |
| Ask | Una pregunta sobre una ubicación en lenguaje natural | Una respuesta generada con citas | 0,10 USD por respuesta completada |
La página de precios actual ofrece un saldo inicial único de 10 USD sin caducidad. Los planes de pago parten de 49 USD al mes, con uso incluido y tarifas inferiores para Search y Enrich. El nombre del plan Free no implica que sus operaciones sobre parcelas sean gratuitas.
Fetch gratuito excluye los registros de parcelas bajo licencia, incluidos la identidad de la parcela, la titularidad, los límites de la parcela y su zonificación, así como los cálculos que dependen de esos registros. La autenticación y los límites de capacidad siguen siendo obligatorios. La vía de pago x402, independiente y sin clave API, cuesta 0,001 USDC por llamada a Fetch completada correctamente. Por tanto, «Fetch gratuito» requiere precisar el método de acceso y los campos incluidos.
¿Cuánto cuesta una preselección de parcelas con Mireye?
Con las tarifas del plan Free, cinco páginas de Search completadas y 20 llamadas facturables a Enrich cuestan 1,40 USD de uso de Mireye. Es un presupuesto ilustrativo, no el coste medido de encontrar 20 propiedades adecuadas.
| Paso | Supuesto | Cálculo |
|---|---|---|
| Encontrar candidatas | Cinco páginas de Search de pago | 5 × 0,20 USD = 1,00 USD |
| Investigar las finalistas | 20 operaciones de Enrich que devuelven al menos un campo cada una | 20 × 0,02 USD = 0,40 USD |
| Consultar más datos públicos de ubicación | Llamadas autenticadas estándar a Fetch con campos incluidos en el acceso gratuito | 0,00 USD de uso de Fetch |
| Subtotal de Mireye | Solo estas operaciones | 1,40 USD |
Search incluye los campos de salida solicitados en cada página. Devolver un campo mediante Search no añade automáticamente un cargo separado de Enrich. Una página puede devolver menos parcelas de las solicitadas, incluso ninguna; el ejemplo no presupone cinco páginas completas ni una búsqueda exhaustiva. Los tokens del modelo, la orquestación, los cálculos de desplazamiento de pago y la investigación humana quedan fuera de este subtotal.
El saldo de bienvenida de 10 USD equivale, por cálculo, a 50 páginas de Search o 500 operaciones facturables de Enrich con estas tarifas, si se dedica íntegramente a una sola operación. Para evaluar los costes en producción, mide el coste por resultado aceptado del agente: una llamada API barata aporta poco valor si hay que corregir la identificación de la parcela o sus pruebas.
¿Se pueden usar como filtros los 550 campos anunciados?
No utilices la cifra total del lanzamiento como esquema de filtros. Nuestra consulta de los catálogos públicos devolvió la versión 0.18.0, con estos inventarios específicos por endpoint:
- Catálogo de Search: 529 entradas que pueden devolverse, de las cuales 510 tenían al menos un operador de filtro.
- Catálogo de Enrich: 525 campos.
- Catálogo de Fetch: 351 campos.
Son conjuntos distintos, por lo que comparar sus totales no demuestra que la cifra del lanzamiento sea incorrecta. Lo útil es que el contrato de consulta de campos de Search distingue entre filter_ops y returnable. En el catálogo consultado, parcel_flood_sfha_fraction podía devolverse, pero no tenía operadores de filtro. El agente debe solicitar ese resultado y evaluarlo después, en lugar de inventar un filtro en el servidor.
Consultar los catálogos es gratuito y no requiere autenticación. Mediante MCP, usa mireye_list_fields con el endpoint correspondiente y, opcionalmente, un término de búsqueda. Consulta el catálogo al construir un flujo; evita incorporar de forma permanente los recuentos del lanzamiento a la lógica de la aplicación.
¿Cómo se conecta Mireye con Claude Code mediante MCP?
La conexión MCP compatible está alojada en https://api.mireye.com/mcp y usa Streamable HTTP y OAuth. Para Claude Code:
claude mcp add --transport http --scope user mireye-earth https://api.mireye.com/mcpDespués, abre /mcp y completa la autorización. Los demás clientes deben admitir el transporte remoto y el flujo de autorización. Las instrucciones anteriores para el adaptador local y el inicio de sesión mediante dispositivo están retiradas.
La autorización de Search y Enrich también depende de las condiciones actuales y de los permisos para datos bajo licencia. Las conexiones existentes pueden necesitar una nueva autorización; una autorización OAuth anterior no obtiene los nuevos permisos automáticamente. Las claves API para HTTP directo y los tokens OAuth del MCP alojado cumplen funciones distintas.
Un flujo MCP con límites definidos para preseleccionar terrenos en Estados Unidos
1. Convierte los requisitos del proyecto en restricciones explícitas
Para un ejemplo de preselección solar, empieza por un condado concreto, un intervalo de superficie en acres y las pruebas necesarias para una primera revisión. Separa los requisitos obligatorios de las preferencias. «Entre 100 y 1000 acres» es un filtro explícito; «buen acceso a la red eléctrica» necesita una medida definida y más investigación. Mantén los acres estadounidenses en las solicitudes aunque la interfaz esté traducida.
El contrato de las herramientas alojadas coloca el cuerpo de las solicitudes de pago dentro de req, con idempotency_key al mismo nivel. Este ejemplo es una solicitud a mireye_search, no un resultado registrado de la 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"
}El código FIPS del condado se mantiene como cadena de texto para conservar el cero inicial. La fracción de superficie inundable se solicita como salida. Sustituye la clave de operación ilustrativa al iniciar una búsqueda nueva; consérvala al reintentar la misma solicitud.
2. Controla por separado la finalización y el gasto
La referencia de Search exige un filtro de estado y establece un tamaño de página predeterminado de 10 y un máximo de 100. Devuelve las primeras coincidencias, por lo que el agente debe aplicar su propia clasificación.
- Continúa mientras
next_cursorno sea nulo, incluso después de una página corta o vacía, salvo que el presupuesto total del flujo obligue a detenerse. - Mantén los mismos filtros y campos solicitados entre páginas. Cada página nueva necesita una clave de operación nueva; los reintentos reutilizan la clave y el cuerpo originales.
- Lee
remarkspara detectar comprobaciones incompletas o campos no disponibles. Un cursor final no elimina por sí solo una advertencia sobre resultados incompletos. - Permite al menos 210 segundos en el cliente. Los cursores caducan tras una hora y las páginas no representan una instantánea fija.
max_cost_usd limita una operación individual. El controlador que proponemos también cuenta las páginas, acumula los recibos de uso y se detiene al alcanzar un presupuesto total por ejecución. Si se detiene antes de terminar, el informe debe indicar «las mejores entre las candidatas examinadas» y registrar el motivo. No debe afirmar que ha encontrado las mejores parcelas de todo el país.
3. Confirma la identidad antes de combinar Search y Enrich
Enrich vincula una dirección o coordenada con una parcela; no se limita a aceptar el APN de Search como clave de unión garantizada. El analysis_point almacenado por Search puede quedar fuera del límite de la parcela y, por tanto, una nueva coincidencia espacial puede identificar otra propiedad.
Sigue la comprobación de identidad documentada: exige un resultado con coincidencia y compara el número de parcela, la dirección, el estado y el código FIPS del condado antes de fusionar las pruebas. Conserva las coincidencias inciertas para su revisión. Los APN pueden repetirse entre condados, y una dirección plausible no basta para demostrar la identidad.
Solicitar los valores seleccionados directamente en Search evita esa segunda búsqueda de coincidencias. Usa Enrich por separado cuando necesites la fuente, la confianza y las indicaciones de interpretación de cada campo. Solicita tanto los campos de identidad necesarios para comparar como los campos que sustentan la decisión.
¿Qué demuestra realmente un resultado de parcela con fuentes?
Conserva intacta la estructura de pruebas del endpoint. Fetch distingue entre ok, absent y failed, y ofrece las URL de las fuentes, las fechas de consulta y la antigüedad del conjunto de datos cuando están disponibles. Un fetched_at reciente no actualiza los datos originales de un conjunto antiguo. Search devuelve valores simples; Enrich independiente puede omitir campos no disponibles y no expone toda la estructura de estados de Fetch.
Nuestra regla de ingeniería es conservar desconocido, falso y cero como estados distintos. Añade enlaces a fuentes y fechas solo cuando la respuesta o una fuente comprobada los proporcione. No inventes una URL de cita a partir de la etiqueta de una fuente.
Las definiciones de los campos hacen especialmente importante el alcance espacial: within_floodplain_polygon describe un punto, mientras que parcel_flood_sfha_fraction se refiere al contorno completo. Un agente útil conserva esa distinción tanto en su clasificación como en sus explicaciones.
| Señal observada | Siguiente paso razonable |
|---|---|
| Ningún peligro cartografiado en el punto muestreado | Comprueba la superposición y la cobertura de toda la parcela antes de hacer una afirmación sobre el conjunto de la propiedad. |
| Campo de zonificación o titularidad ausente | Solicita el registro pertinente y deja la decisión pendiente. |
| Subestación o línea de transmisión cercana | Investiga la compañía eléctrica correspondiente, el proceso de conexión y los requisitos del proyecto. |
| Consulta reciente de un conjunto de datos antiguo | Conserva ambas fechas y determina si la decisión necesita un registro más reciente. |
La guía de zonas inundables de FEMA explica que las zonas de menor riesgo siguen teniendo riesgo y que un riesgo indeterminado significa que falta el análisis. La explicación de FERC sobre la interconexión de generadores distingue entre la información preliminar, los estudios de conexión y las mejoras de la red. Nuestra inferencia para la preselección es directa: la proximidad por sí sola no demuestra que exista capacidad de red utilizable.
¿Cómo debe un agente reclasificar terrenos para proyectos solares, almacenamiento o centros de datos?
Filtra primero los requisitos claros y después ordena las candidatas que los cumplen mediante preferencias explícitas y una evaluación separada de las pruebas disponibles. No favorezcas la ausencia de pruebas tratándola como un cero favorable.
Considera tres candidatas solares hipotéticas. La parcela A cumple el requisito de superficie y cuenta con pruebas de peligros revisadas. La parcela B parece atractiva por su terreno, pero carece de un resultado de inundación que cubra toda la parcela. La parcela C incumple un requisito de superficie confirmado. A puede entrar en la preselección evaluada, B queda pendiente de revisión y C se excluye por el motivo registrado. Una única puntuación combinada ocultaría por qué esas decisiones son distintas.
Haz que cada fila de la preselección resulte útil para quien continúe el trabajo: identidad de la parcela, ubicación evaluada, requisitos cumplidos, puntuación de preferencias y su versión, fuentes de respaldo, pruebas no disponibles, notas sobre la exhaustividad de la búsqueda y siguiente comprobación. Almacena las pruebas permitidas y respeta las condiciones de uso de los datos aplicables al compartir resultados.
Los proyectos solares, el almacenamiento en baterías y los centros de datos necesitan requisitos distintos. Antes de elegir campos o ponderaciones, el responsable del proyecto debe definir sus necesidades específicas de potencia, terreno, acceso y operación. Reutilizar una puntuación solar para un centro de datos solo porque ambos necesitan contexto de la red da al agente un objetivo engañoso.
La propia demostración de Mireye sobre marquesinas solares en Texas busca en archivos públicos de parcelas de Texas mediante código específico y después realiza llamadas por lotes a Fetch; no es una prueba comparativa de las nuevas API Search y Enrich. Describe la evaluación preliminar de 1187 ubicaciones y detalla pasadas repetidas de Fetch, oportunidades duplicadas y una fórmula de puntuación no validada. Algunos valores ausentes de la cola de ERCOT corresponden a ubicaciones fuera de su territorio. Esto justifica comprobar la aplicabilidad antes de penalizar un nulo. El proyecto es una demostración del proveedor, no un resultado de rendimiento medido por Wavect.
¿Cuándo merece la pena evaluar Mireye?
Merece la pena evaluar Mireye cuando un agente necesita encontrar parcelas en Estados Unidos y reunir pruebas estructuradas para un proceso de selección de ubicaciones o adquisición dirigido por personas. Empieza con un piloto acotado a los condados y casos de uso que te interesan. Mide la identificación correcta de las parcelas, la disponibilidad de los campos necesarios, las pruebas pendientes, la calidad de la preselección revisada y el coste total.
El alcance geográfico documentado se centra en Estados Unidos. La cobertura adicional de Canadá de las herramientas de tiempos de conducción no implica cobertura de parcelas canadienses. Una interfaz en alemán, español o chino no amplía el conjunto de parcelas a esos países.
Para una integración en producción, conecta el contrato de datos, las reglas de clasificación, los límites de gasto y el traspaso a revisión. El servicio de integración de IA de Wavect cubre el trabajo de aplicación que rodea a la API; nuestra guía de autorización MCP para empresas explica el marco de acceso más amplio.