search_nodes

LesenSeit v1.0

Sucht nach Knoten (Instanzen) im Modell. Filtern Sie nach Typ, Name, Beschreibung, Eigenschaftswerten oder Ordner. Gibt Zusammenfassungen zurück – für vollständige Informationen verwenden Sie get_node_details. Jede Zusammenfassung enthält jetzt einen updated_at-Zeitstempel (ISO 8601 UTC) zur Änderungserkennung.

Parameter

Name	Typ	Pflichtfeld	Standard	Beschreibung
`node_type`	`String`	—		[search_nodes] Ergebnisse auf Knoten dieses Typnamens filtern (Groß-/Kleinschreibung wird beim Abgleich mit Metamodell-Typnamen ignoriert).
`name_contains`	`String`	—		[search_nodes] Nur Knoten zurückgeben, deren Label diesen Text enthält (Groß-/Kleinschreibung wird ignoriert).
`limit`	`Number`	—	50	[search_nodes] Maximale Anzahl zurückgegebener Ergebnisse. Standard: 50, Maximum: 200.
`description_contains`	`String`	—		[search_nodes] Nur Knoten zurückgeben, deren Beschreibung diesen Text enthält.
`folder_id`	`String`	—		[search_nodes] Ergebnisse auf Knoten innerhalb dieses Ordners beschränken (UUID).
`locale`	`String`	—		[search_nodes] Optionaler Gebietsschema-Code (z. B. 'de', 'en') für übersetzte Labels und Beschreibungen.
`properties`	`Object`	—		[search_nodes] Nach Eigenschaftswerten filtern. Schlüssel sind Eigenschaftsnamen, Werte sind Suchausdrücke (Teilstring-Abgleich).
`offset`	`Number`	—	0	[search_nodes] Die ersten N Ergebnisse für die Paginierung überspringen.
`tags_match`	`String`	—	any	Ob ein Knoten einen beliebigen der aufgeführten Tags tragen muss (Standard) oder alle. Einer von: any, all.
`tags`	`Array<String>`	—		Gibt nur Knoten zurück, die diese Tags tragen. Groß- und Kleinschreibung wird ignoriert. Eine leere Liste trifft auf nichts zu statt auf alles. Verwenden Sie list_tags, um zu sehen, welche Tags das Modell bereits verwendet.

Beispielanfrage

{"node_type": "Feature", "properties": {"status": "planned"}, "limit": 50}

Beispielantwort

{"total_count": 12, "nodes": [{"id": "uuid-1", "label": "OAuth Integration", "type": "Feature", "preview": "status: planned, priority: 1", "updated_at": "2026-06-11T10:30:00Z"}]}