search_notes

macOS

Zweck

Durchsucht Apple Notes nach Titel oder Inhalt. Paginiert: „limit“ ist auf 100 pro Aufruf begrenzt, also pagen Sie mit „offset“, anstatt nach einem größeren limit zu fragen. Die Antwort enthält „total“ (wie viele Notizen insgesamt mit der Abfrage übereinstimmen) und „has_more“, sodass eine begrenzte Seite niemals mit der vollständigen Antwort verwechselt wird – Seite, bis „has_more“ falsch ist, was genau ist, selbst wenn „total_is_estimated“ angibt, dass die Anzahl nur eine Untergrenze ist. Um jede Übereinstimmung zu durchlaufen, übergeben Sie order="id" – siehe den Bestellparameter.

Erforderliche Eingaben

• query

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

• Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

{
  "properties": {
    "limit": {
      "default": "20",
      "description": "Matches per page (default 20, capped at 100). To get more, page with offset.",
      "type": "integer"
    },
    "offset": {
      "default": "0",
      "description": "How many matches to skip (default 0). An offset past the end returns an empty page with has_more=false, not an error.",
      "minimum": 0,
      "type": "integer"
    },
    "order": {
      "default": "modified",
      "description": "order: \"modified\" (default) sorts newest-modified first — what you want to SHOW someone, but NOT safe for paging: modification date changes, so a note edited between two calls jumps to the front and another note is pushed past your cursor and never returned. \"id\" sorts by the note's immutable store id — stable, never renumbered, new notes append at the end — so use order=\"id\" to walk an entire library page by page: edits and insertions mid-crawl are safe with it. One case it cannot cover, because pages are addressed by offset: if a note is DELETED mid-crawl, every note after the hole shifts one slot back and the note that was on the page boundary is skipped, silently. If completeness matters, re-run the crawl and reconcile against total, or crawl while nothing is deleting notes.",
      "type": "string"
    },
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für search_notes. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

{
  "query": "launch checklist"
}