search_notes

macOS

Finalidade

Pesquisa Apple Notes por título ou conteúdo. Paginado: `limit` tem um limite de 100 por chamada, então page com `offset` em vez de solicitar um limit maior. A resposta contém `total` (quantas notas correspondem à consulta ao todo) e `has_more`, portanto, uma página limitada nunca é confundida com a resposta completa - página até que `has_more` seja falsa, o que é exato mesmo quando `total_is_estimated` diz que a contagem é apenas um limite inferior. Para acompanhar cada partida, passe order="id" — veja o parâmetro order.

Entradas obrigatórias

• query

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

• Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

{
  "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"
}

Exemplo documental

Exemplo de documentação para search_notes. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

{
  "query": "launch checklist"
}