obsidian_search_notes

Obsidian · macOS · Windows

Efecto: lectura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Busca en las notas de una bóveda de Obsidian por texto (`query`: título y texto de la nota, sin distinguir mayúsculas), por etiqueta (`tag`: #etiquetas en línea y etiquetas del frontmatter; una etiqueta también coincide con sus etiquetas anidadas), o por ambos. Devuelve la ruta de cada nota dentro de la bóveda, el título, la primera línea coincidente y las etiquetas, ordenadas por ruta, `limit` por página; cuando has_more es true, pasa next_offset como `offset` para la página siguiente. Lee los archivos Markdown: Obsidian no necesita estar en ejecución.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en inglés — macOS

{
  "properties": {
    "limit": {
      "description": "Notes per page (default 20, max 100).",
      "type": "integer"
    },
    "offset": {
      "description": "Notes to skip (default 0): the next_offset of the previous page.",
      "type": "integer"
    },
    "query": {
      "description": "Text to find in note titles and text. Optional when `tag` is given.",
      "type": "string"
    },
    "tag": {
      "description": "Tag to match, with or without #. Optional when `query` is given.",
      "type": "string"
    },
    "vault": {
      "description": "Vault name or id from obsidian_list_vaults. Optional when there is only one vault.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para obsidian_search_notes. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "limit": 20,
  "query": "launch checklist",
  "tag": "project",
  "vault": "Demo Vault"
}

Windows