$ fym library playlistsNAME SERVICE SONGS Road Trip spotify 112 Deep Focus apple-music 64 Late Night tidal 38
Tu música, con scripts.
fym lleva la app web de Free Your Music a tu terminal. Transfiere playlists entre 12 servicios, usa las herramientas de playlist, sigue las transferencias y exporta informes. Incluido en Free Your Music Pro. Sin app de escritorio: basta con Node.js 20 o superior.
npm i -g @freeyourmusic/cliEmpieza con cuatro comandos
npm i -g @freeyourmusic/cli
fym login
fym services connect spotify
fym library playlistsfym login abre freeyourmusic.com/app/cli con un código corto. Inicia sesión con email, Apple o Google, comprueba el código y toca Permitir. En un servidor sin navegador, añade --no-browser y abre el enlace en tu móvil.
Los comandos que más usarás
Hay un comando para cada operación de la API web de Free Your Music. Ejecuta fym help para verlos todos y añade --help a cualquier comando para ver sus opciones.
BIBLIOTECA Y BÚSQUEDA
fym statusfym accounts listfym library playlists --account-id <id>fym library tracks --account-uuid <id> --entity-type playlists --collection-raw-id <playlist>fym search --account-id <id> --q "phoebe bridgers"fym playlists create --account-id <id> --name "Road Trip"fym stats section get --section <section> --range <range> --account-id <id>TRANSFERENCIAS Y SINCRONIZACIÓN
fym transfers create --input @transfer.jsonfym transfers listfym transfers progressfym transfers set-sync --transfer-uuid <id> --enabled truefym matches unmatchedfym exports create --input @export.jsonfym watchHERRAMIENTAS DE PLAYLIST
fym playlists preview --account-id <id> --playlist-id <playlist> --tool @dedupe.jsonfym playlists apply-tool --account-id <id> --playlist-id <playlist> --tool @dedupe.jsonfym playlists edits --account-id <id> --playlist-id <playlist> --ops @ops.jsonfym playlists merge --input @merge.json --yesfym playlists versions --account-id <id> --playlist-id <playlist>fym playlists restore --account-id <id> --playlist-id <playlist> ...fym insights playlist --account-id <id> --playlist-id <playlist>Hecha para scripts
Añade --json a cualquier comando y pasa la respuesta a jq, a un script o a un agente. El código de salida le dice a tu script qué pasó: 2 significa volver a iniciar sesión, 4 significa que el comando necesita Pro, 5 significa ir más despacio.
fym library playlists --json | jq -r '.items[] | "\(.trackCount)\t\(.name)"'Seguro en cron y CI
Define FYM_TOKEN con un token de cuenta y la CLI nunca abre un navegador. Los comandos que borran o reemplazan datos, como playlists delete o una fusión, se detienen si no añades --yes, así que un script no puede borrar nada por accidente.
¿CLI o servidor MCP?
| Ideal para | CLI: scripts, tareas cron y CI. MCP: un chat con Claude, Cursor o Cline. |
|---|---|
| Inicio de sesión | La misma aprobación en el navegador. Ambos comparten una sesión en tu ordenador. |
| Salida | CLI: tablas, o JSON con --json. MCP: resultados de herramientas estructurados. |
| Funciones | Las mismas: todo lo que puede hacer la app web de Free Your Music. |
La misma cuenta, las mismas reglas. Elige el que mejor encaje con la tarea, o usa los dos.
Gratis y Pro
En la app web de Free Your Music y en las apps móviles: conecta tus servicios, transfiere playlists, canciones favoritas, álbumes y artistas hasta 10.000 canciones en total, elige sustitutos para las canciones sin coincidencia, usa las estadísticas y exporta las canciones que no se transfirieron.
El servidor MCP y la CLI. Mantén las transferencias sincronizadas. Edita, ordena, mezcla, quita duplicados, divide, fusiona y restaura playlists. Análisis de playlists.
Privacidad
La CLI y el servidor MCP se ejecutan en tu ordenador. Llaman a la API de Free Your Music por HTTPS con la sesión de tu cuenta, que se guarda en ~/.fym/credentials.json y que solo tu usuario puede leer. Tus credenciales de los servicios de música se quedan cifradas en los servidores de Free Your Music y nunca llegan a tu app de IA. Los resultados de las herramientas sí van a tu app de IA, y lo que haga con ellos depende de su configuración y de su proveedor de modelos.
Dale a tu asistente las llaves de tu música.
Copia un comando, reinicia tu app de IA y pídele que inicie tu sesión.
npx -y @freeyourmusic/mcp install --host=claude-desktopEscribe en ~/Library/Application Support/Claude/claude_desktop_config.json
Cierra Claude Desktop por completo (cmd+Q en macOS) y vuelve a abrirlo. Las herramientas aparecen bajo el servidor freeyourmusic.