music_search_library

macOS

Propósito

Busca en las canciones de la biblioteca de Música del usuario. `field` limita la búsqueda a title, artist o album; el valor por defecto, any, busca en todos los campos de texto que busca la propia búsqueda de la app Música. Devuelve el id, el título, el artista, el álbum y la duración de cada canción; el id es lo que toman music_playback y music_add_to_playlist. Solo se busca en la biblioteca, no en el catálogo de Apple Music. Abre la app Música cuando está cerrada.

Entradas obligatorias

• query

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

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.

{
  "properties": {
    "field": {
      "description": "Where to look (default any).",
      "enum": [
        "any",
        "title",
        "artist",
        "album"
      ],
      "type": "string"
    },
    "limit": {
      "description": "Tracks to return (default 25, max 100).",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "query": {
      "description": "Text to look for.",
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para music_search_library. 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.

{
  "field": "title",
  "limit": 10,
  "query": "Moonlight Sonata"
}