Linkly CLI
Linkly CLI es una herramienta de línea de comandos para gestionar tu cuenta de Linkly desde la terminal. Crea enlaces cortos, obtén analíticas de clics, gestiona dominios personalizados, maneja webhooks y exporta datos — sin dejar tu shell ni escribir código de API.
Está construido sobre la Linkly API y se ejecuta en macOS, Linux y Windows.
Instalación
La CLI requiere Node.js 20 o superior. Instálalo globalmente con npm:
npm install -g @linkly-link-shortener/cli
Esto añade un comando linkly a tu sistema. Confirma que funciona:
linkly --help
Iniciando sesión
La CLI admite dos formas de iniciar sesión. Solo necesitas hacerlo una vez — tus credenciales se guardan de forma segura en tu máquina y se reutilizan en cada ejecución.
Para iniciar sesión con una clave API, ejecuta:
linkly auth login --api-key
Se te pedirá que pegues tu clave API, que puedes encontrar en la configuración de tu cuenta de Linkly.
Para iniciar sesión con OAuth en su lugar, ejecuta:
linkly auth login
Esto abre tu navegador para que puedas aprobar el acceso — no hay clave API que copiar.
Comprueba tu estado o cierra sesión en cualquier momento:
linkly auth status
linkly auth logout
Creando y gestionando enlaces
Crea, busca, inspecciona, actualiza y elimina enlaces cortos:
linkly links create --url https://example.com --name "Spring promo"
linkly links list --search promo
linkly links get 12345
linkly links update 12345 --url https://example.com/new
linkly links delete 12345
Analíticas de clics
Ve totales de clics agrupados por país, navegador, plataforma y más — o como una serie temporal en un rango de fechas:
linkly analytics by country
linkly analytics timeseries --start 2026-01-01 --end 2026-01-31
Dominios personalizados
Lista tus dominios personalizados o añade uno nuevo:
linkly domains list
linkly domains create links.example.com
Códigos QR y exportación de datos
Descarga el código QR de un enlace, o exporta tus enlaces y datos de clics como CSV o JSON:
linkly links qr 12345 --output qr.png
linkly links export --format csv --output links.csv
linkly analytics export --format csv --output clicks.csv
Webhooks
Suscribe una URL para recibir eventos de clics en tiempo real para un único enlace o un espacio de trabajo completo:
linkly webhooks add https://example.com/hook --link 12345
Trabajando con múltiples espacios de trabajo
Si tu cuenta tiene más de un espacio de trabajo, establece uno por defecto:
linkly workspaces list
linkly workspaces use 42
También puedes dirigirte a un espacio de trabajo específico para un único comando con la opción --workspace.
Salida JSON para scripts
Añade --json a cualquier comando para obtener la respuesta bruta de la API en lugar de una tabla formateada — útil para piping en herramientas como jq:
linkly links list --json
Obteniendo ayuda
Cada comando tiene ayuda integrada. Ejecuta linkly --help para una descripción general, o añade --help a cualquier comando para ver sus opciones y ejemplos:
linkly links create --help
Usando la CLI con agentes de IA
Los asistentes de codificación que pueden ejecutar comandos de shell — como Claude Code o Cursor — pueden conducir la CLI de Linkly directamente.
- Añade
--jsona cualquier comando para obtener la respuesta bruta de la API en lugar de una tabla formateada. - Ejecuta
linkly schemapara imprimir el árbol completo de comandos — cada comando, argumento y opción — como JSON, para que un asistente pueda descubrir lo que la CLI puede hacer. - Añade
--helpa cualquier comando para ver sus opciones y ejemplos.
Si tu asistente de IA no puede ejecutar comandos de shell, usa el Servidor MCP de Linkly en su lugar — conecta asistentes como Claude y ChatGPT a tu cuenta de Linkly directamente.
Artículos relacionados
Rastrea 500 clics mensuales con todas las funciones incluidas.