In diesem Beitrag
Mireye Land Search und Enrich API: MCP, Preise und Grundstückssuche
Header-Illustration: © 2026 Wavect.
Ein hilfreicher Agent für die Grundstückssuche liefert eine Vorauswahl, die Menschen weiterprüfen können: eindeutig identifizierte Grundstücke, nachvollziehbare Auswahlkriterien, belegte Daten und offene Fragen. Mireyes neue Land Search und Enrich API stellt dafür Bausteine über REST und das Model Context Protocol (MCP) bereit.
In der Ankündigung zum Produktstart nennt Mireye mehr als 160 Millionen US-Flurstücke, 550 verfügbare Datenfelder, Milliarden indexierter Datenpunkte und vier Millionen bisherige Fetch-Aufrufe. Das sind Anbieterangaben. Praktisch relevant ist die Kombination aus Grundstückssuche, Datenanreicherung für ausgewählte Objekte und kostenlosem Zugriff auf unterstützte öffentliche Standortdaten.
Geprüft am : Wir haben die Originaldokumentation ausgewertet und die drei öffentlichen Feldkataloge abgerufen. Authentifizierte Grundstückssuchen, Latenzmessungen und eine unabhängige Prüfung der landesweiten Abdeckung waren nicht Teil dieser Recherche. Die folgenden Abläufe sind Vorschläge; die Kostenbeispiele sind Rechenmodelle.
Mireye Search, Enrich oder Fetch: Welche API braucht der Agent?
Search findet Grundstücke, Enrich untersucht ein ausgewähltes Grundstück und Fetch liefert unterstützte öffentliche Fakten zu einem bekannten Standort. Der Endpunkt bestimmt sowohl die verfügbaren Nachweise als auch die Abrechnung.
| Operation | Ausgangspunkt | Ergebnis | Nutzungspreis |
|---|---|---|---|
| Search | US-Bundesstaat, Fläche und weitere unterstützte Kriterien | Passende Flurstücke und ausgewählte Feldwerte | 0,20 USD pro abgeschlossener Ergebnisseite |
| Enrich | Eine US-Adresse oder Koordinate | Grundstückszuordnung und ausgewählte Felder mit Quelle, Vertrauensstufe und Interpretationshinweisen | 0,02 USD pro zugeordnetem Grundstück, wenn mindestens ein Feld zurückgegeben wird |
| Fetch | Bekannter Standort und zulässige öffentliche Felder | Strukturierte öffentliche Daten mit Herkunft und Status je Feld | Kostenlos beim regulären authentifizierten Zugriff |
| Ask | Eine Standortfrage in natürlicher Sprache | Generierte Antwort mit Quellenverweisen | 0,10 USD pro abgeschlossener Antwort |
Die aktuelle Preisseite nennt ein einmaliges Startguthaben von 10 USD ohne Ablaufdatum. Bezahlte Tarife beginnen bei 49 USD monatlich und enthalten Nutzungsguthaben sowie niedrigere Search- und Enrich-Preise. Auch im Free-Tarif sind Grundstücksoperationen kostenpflichtig.
Kostenloses Fetch umfasst keine lizenzierten Grundstücksdatensätze mit Grundstückskennungen, Eigentümerdaten, Grundstücksgrenzen und grundstücksbezogenen Zonenfestlegungen sowie davon abhängige Berechnungen. Authentifizierung und Kapazitätsgrenzen gelten weiterhin. Der separate x402-Zahlungsweg ohne API-Schlüssel kostet 0,001 USDC je erfolgreichem Fetch-Aufruf. Bei der Aussage „Fetch ist kostenlos“ müssen deshalb Zugriffsweg und Datenumfang mitgedacht werden.
Was kostet eine Grundstücksvorauswahl mit Mireye?
Im Free-Tarif kosten fünf abgeschlossene Search-Seiten plus 20 abrechenbare Enrich-Aufrufe insgesamt 1,40 USD an Mireye-Nutzung. Das ist ein beispielhaftes Budget, kein gemessener Preis für das Finden von 20 geeigneten Grundstücken.
| Schritt | Annahme | Berechnung |
|---|---|---|
| Kandidaten suchen | Fünf kostenpflichtige Search-Seiten | 5 × 0,20 USD = 1,00 USD |
| Vorauswahl untersuchen | 20 Enrich-Operationen mit jeweils mindestens einem zurückgegebenen Feld | 20 × 0,02 USD = 0,40 USD |
| Zusätzliche öffentliche Standortdaten prüfen | Zulässige reguläre authentifizierte Fetch-Aufrufe | 0,00 USD für Fetch |
| Mireye-Zwischensumme | Nur diese Operationen | 1,40 USD |
Search schließt die für die jeweilige Seite angeforderten Ausgabefelder ein. Ein über Search zurückgegebenes Feld löst nicht automatisch eine zusätzliche Enrich-Gebühr aus. Eine Seite kann weniger Treffer als angefordert oder gar keine liefern. Das Beispiel setzt weder fünf vollständig gefüllte Seiten noch eine vollständige Suche voraus. Modell-Tokens, Orchestrierung, kostenpflichtige Fahrzeitberechnungen und menschliche Prüfung sind nicht in der Zwischensumme enthalten.
Das Startguthaben von 10 USD entspricht bei diesen Preisen rechnerisch 50 Search-Seiten oder 500 abrechenbaren Enrich-Operationen, wenn es vollständig für eine dieser Operationen verwendet wird. Im Produktivbetrieb zählen die Kosten pro akzeptiertem Agentenergebnis: Ein günstiger Aufruf hilft wenig, wenn Grundstückszuordnung oder Nachweise anschließend korrigiert werden müssen.
Lassen sich alle 550 beworbenen Felder durchsuchen?
Die Gesamtzahl aus der Ankündigung ist kein Filterschema. Unser Abruf der öffentlichen Kataloge lieferte Version 0.18.0 mit folgenden Beständen je Endpunkt:
- Search-Katalog: 529 zurückgebbare Einträge, davon 510 mit mindestens einem Filteroperator.
- Enrich-Katalog: 525 Felder.
- Fetch-Katalog: 351 Felder.
Diese Bestände sind unterschiedliche Mengen. Ein Vergleich ihrer Summen widerlegt deshalb nicht die Zahl aus der Ankündigung. Für die Implementierung ist die Unterscheidung zwischen filter_ops und returnable im Search-Katalogvertrag hilfreicher. Im abgerufenen Katalog war parcel_flood_sfha_fraction als Ausgabe verfügbar, hatte aber keine Filteroperatoren. Ein Agent sollte diesen Wert anfordern und anschließend auswerten, statt einen serverseitigen Filter zu erfinden.
Die Katalogabfrage ist kostenlos und erfordert keine Authentifizierung. Über MCP verwenden Sie mireye_list_fields mit dem passenden endpoint und optional einem Suchbegriff. Prüfen Sie den Katalog beim Aufbau des Ablaufs; fest eingebaute Feldzahlen vom Produktstart sind keine belastbare Grundlage für die Anwendungslogik.
Wie verbinden Sie Mireye per MCP mit Claude Code?
Der unterstützte MCP-Zugang liegt unter https://api.mireye.com/mcp und verwendet Streamable HTTP mit OAuth. Für Claude Code:
claude mcp add --transport http --scope user mireye-earth https://api.mireye.com/mcpÖffnen Sie anschließend /mcp und schließen Sie die Autorisierung ab. Andere Clients müssen den Remote-Transport und den Autorisierungsablauf unterstützen. Die früheren Anleitungen für lokale Adapter und Device Login sind abgelöst.
Die Berechtigung für Search und Enrich hängt außerdem von den aktuellen Nutzungsbedingungen und dem Zugriff auf lizenzierte Daten ab. Bestehende Verbindungen können eine erneute Autorisierung benötigen; ein alter OAuth-Grant erhält die neuen Rechte nicht automatisch. API-Schlüssel für direkte HTTP-Aufrufe und OAuth-Tokens für das gehostete MCP haben unterschiedliche Aufgaben.
Ein begrenzter MCP-Ablauf für die Grundstückssuche in den USA
1. Das Briefing in eindeutige Kriterien übersetzen
Für eine beispielhafte Solar-Vorprüfung beginnen Sie mit einem bestimmten County, einem Flächenbereich und den Nachweisen für die erste Bewertung. Trennen Sie feste Anforderungen von Präferenzen. „Zwischen 100 und 1.000 Acres“ ist ein eindeutiger Filter. „Guter Netzzugang“ benötigt eine definierte Messgröße und weitere Prüfung. Auch bei einer deutschen Oberfläche müssen Anfragen die vorgesehenen US-Flächeneinheiten beibehalten.
Der Vertrag der gehosteten Tools legt kostenpflichtige Anfrageobjekte unter req ab; idempotency_key steht daneben. Dieses Beispiel ist eine Anfrage an mireye_search, kein aufgezeichnetes API-Ergebnis:
{
"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"
}Der County-FIPS-Code bleibt eine Zeichenkette, damit seine führende Null erhalten bleibt. Der Überflutungsflächenanteil wird als Ausgabe angefordert. Verwenden Sie für eine neue Suche einen neuen Operationsschlüssel; bei einer Wiederholung derselben Anfrage behalten Sie ihn bei.
2. Suchabschluss und Ausgaben getrennt verfolgen
Laut Search-Referenz ist ein Bundesstaatenfilter erforderlich. Standardmäßig kommen zehn Treffer pro Seite zurück, maximal sind 100 möglich. Die API liefert die zuerst gefundenen Treffer; die Rangfolge muss der Agent selbst bilden.
- Folgen Sie
next_cursor, solange der Wert nicht null ist, auch nach einer kurzen oder leeren Seite. Ein erreichtes Gesamtbudget kann einen früheren Stopp erfordern. - Behalten Sie Filter und angeforderte Felder über alle Seiten bei. Jede neue Seite benötigt einen neuen Operationsschlüssel; Wiederholungen verwenden den ursprünglichen Schlüssel und Anfrageinhalt.
- Prüfen Sie
remarksauf unvollständige Prüfungen und nicht verfügbare Felder. Ein abschließender Cursor hebt eine Warnung zur Vollständigkeit nicht auf. - Planen Sie auf Clientseite mindestens 210 Sekunden ein. Cursor laufen nach einer Stunde ab; die Seiten bilden keinen eingefrorenen Datenstand.
max_cost_usd begrenzt eine einzelne Operation. Unser vorgeschlagener Controller zählt zusätzlich Seiten, summiert Abrechnungsbelege und stoppt am Gesamtbudget des Durchlaufs. Bei einem vorzeitigen Stopp sollte der Bericht von den „besten der untersuchten Kandidaten“ sprechen und den Abbruchgrund nennen. Eine Aussage über die besten Grundstücke im gesamten Land wäre nicht gedeckt.
3. Vor dem Zusammenführen von Search und Enrich die Identität prüfen
Enrich ordnet eine Adresse oder Koordinate einem Grundstück zu. Die APN aus Search wird nicht einfach als garantierter Verknüpfungsschlüssel übernommen. Der gespeicherte analysis_point kann außerhalb der Grundstücksgrenze liegen. Eine erneute räumliche Zuordnung kann deshalb ein anderes Objekt ergeben.
Folgen Sie der dokumentierten Identitätsprüfung: Verlangen Sie eine erfolgreiche Zuordnung und vergleichen Sie Grundstücksnummer, Adresse, Bundesstaat und County-FIPS, bevor Sie Nachweise zusammenführen. Unsichere Zuordnungen bleiben zur Prüfung offen. APNs können sich in verschiedenen Countys wiederholen; eine plausibel wirkende Adresse beweist die Identität nicht.
Ausgewählte Werte direkt über Search anzufordern vermeidet diese zweite Zuordnung. Nutzen Sie separates Enrich, wenn Sie Quelle, Vertrauensstufe und Interpretationshinweise je Feld benötigen. Fordern Sie neben den Entscheidungsfeldern auch die Identitätsfelder für den Abgleich an.
Was belegt ein Grundstücksergebnis mit Quellen tatsächlich?
Erhalten Sie die Nachweisstruktur des jeweiligen Endpunkts. Fetch unterscheidet ok, absent und failed und liefert Quellen-URLs, Abrufzeitpunkte sowie, soweit verfügbar, den zugrunde liegenden Datenstand. Ein aktuelles fetched_at macht einen älteren Datensatz nicht aktuell. Search gibt einfache Werte zurück; separates Enrich kann nicht verfügbare Felder weglassen und besitzt nicht die vollständige Statusstruktur von Fetch.
Unsere technische Regel lautet: Unbekannt, falsch und die Zahl 0 bleiben verschiedene Zustände. Ergänzen Sie Quellenlinks und Datumsangaben nur dort, wo die Antwort oder eine geprüfte Quelle sie tatsächlich liefert. Aus einem Quellennamen sollte kein vermeintlicher Beleglink erfunden werden.
Die Felddefinitionen verdeutlichen den räumlichen Bezug: within_floodplain_polygon beschreibt einen Punkt, während parcel_flood_sfha_fraction die vollständige Grundstücksfläche betrifft. Ein hilfreicher Agent bewahrt diesen Unterschied sowohl in der Bewertung als auch im Bericht.
| Beobachtung | Sinnvoller nächster Schritt |
|---|---|
| Keine kartierte Gefahr am Messpunkt | Überlagerung und Datenabdeckung für die gesamte Fläche prüfen, bevor eine Aussage zum ganzen Grundstück getroffen wird. |
| Fehlendes Feld zur Zonenfestlegung oder zum Eigentümer | Den relevanten Datensatz anfordern und die Entscheidung offenhalten. |
| Umspannwerk oder Übertragungsleitung in der Nähe | Zuständigen Netzbetreiber, Anschlussprozess und Projektanforderungen untersuchen. |
| Kürzlich abgerufener älterer Datensatz | Beide Zeitangaben erhalten und prüfen, ob die Entscheidung neuere Daten benötigt. |
Die FEMA-Erläuterungen zu Hochwasserzonen zeigen: Auch Zonen mit geringerem Risiko sind nicht risikofrei; ein unbestimmtes Risiko bedeutet eine fehlende Analyse. Die FERC-Erläuterung zum Anschluss von Erzeugungsanlagen unterscheidet Vorabinformationen von Anschlussstudien und Netzausbauten. Daraus folgt für unsere Vorprüfung: Räumliche Nähe allein belegt keine nutzbare Netzkapazität.
Wie sollte ein Agent Grundstücke für Solar, Speicher oder Rechenzentren bewerten?
Filtern Sie zuerst eindeutige Anforderungen. Bewerten Sie danach geeignete Kandidaten anhand ausdrücklicher Präferenzen und beurteilen Sie die Vollständigkeit der Nachweise separat. Fehlende Informationen dürfen nicht als günstiger Nullwert belohnt werden.
Betrachten wir drei hypothetische Solarkandidaten. Grundstück A erfüllt die Flächenanforderung und besitzt geprüfte Gefahrennachweise. Grundstück B hat ein attraktives Geländeprofil, aber kein flächenweites Hochwasserergebnis. Grundstück C verfehlt eine bestätigte Flächenanforderung. A kann in die bewertete Vorauswahl, B in eine Prüfliste und C wird mit dokumentierter Begründung ausgeschlossen. Ein einziger Mischwert würde diese unterschiedlichen Gründe verdecken.
Jede Zeile der Vorauswahl sollte der nächsten Person helfen: Grundstücksidentität, untersuchter Standort, erfüllte Anforderungen, Präferenzwert samt Regelversion, Quellen, fehlende Nachweise, Hinweise zur Suchvollständigkeit und nächste Prüfschritte. Speichern Sie zulässige Nachweise und berücksichtigen Sie bei der Weitergabe die jeweiligen Datennutzungsbedingungen.
Solarprojekte, Batteriespeicher und Rechenzentren brauchen unterschiedliche Briefings. Legen Sie projektspezifische Anforderungen an Stromversorgung, Fläche, Erschließung und Betrieb fest, bevor Sie Felder oder Gewichte auswählen. Ein Solar-Score wird durch den gemeinsamen Netzbezug nicht automatisch zu einer geeigneten Bewertung für ein Rechenzentrum.
Mireyes eigene Solarcarport-Demonstration aus Texas zeigt, warum diese Prüfungen wichtig sind. Sie durchsucht öffentliche Grundstücksdateien aus Texas mit eigenem Code und nutzt danach Fetch-Batch-Aufrufe. Sie ist somit kein Benchmark der neuen Search- und Enrich-Endpunkte. Das Projekt beschreibt die Prüfung von 1.187 Standorten und legt wiederholte Fetch-Durchläufe, doppelte Chancen und eine nicht validierte Bewertungsformel offen. Einige fehlende ERCOT-Warteschlangenwerte betreffen Standorte außerhalb des ERCOT-Gebiets. Prüfen Sie deshalb zuerst die Anwendbarkeit, bevor ein null-Wert einen Punktabzug auslöst. Das Projekt ist eine Anbieterdemonstration, keine Leistungsmessung von Wavect.
Wann ist Mireye eine sinnvolle Option?
Mireye ist einen Test wert, wenn ein Agent US-Grundstücke finden und strukturierte Nachweise für die menschliche Standortauswahl oder Akquisition zusammenstellen soll. Beginnen Sie mit einem begrenzten Pilotprojekt in den relevanten Countys und Anwendungsfällen. Messen Sie korrekte Grundstückszuordnung, Verfügbarkeit notwendiger Felder, offene Nachweise, geprüfte Qualität der Vorauswahl und Gesamtkosten.
Der dokumentierte geografische Umfang konzentriert sich auf die USA. Die zusätzliche Kanada-Abdeckung der Fahrzeitwerkzeuge belegt keine kanadische Grundstücksabdeckung. Eine deutsche, spanische oder chinesische Oberfläche erweitert den Grundstücksdatenbestand nicht auf diese Länder.
Für eine produktive Integration müssen Datenvertrag, Bewertungsregeln, Ausgabenlimits und Übergabe zur Prüfung zusammenpassen. Wavects KI-Integration deckt die umgebende Anwendungsentwicklung ab. Unser Leitfaden zur MCP-Autorisierung im Unternehmen erklärt die übergeordnete Zugriffsarchitektur.