Linkly CLI

La Linkly CLI es una herramienta de línea de comandos para administrar tu cuenta de Linkly desde la terminal. Crea enlaces cortos, obtén análisis de clics, administra dominios personalizados, maneja webhooks y exporta datos — sin salir de tu shell ni escribir código API.

Está construida sobre la Linkly API y se ejecuta en macOS, Linux y Windows.

Instalación

La CLI requiere Node.js 20 o superior. Instálala globalmente con npm:

npm install -g @linkly-link-shortener/cli

Esto añade un comando linkly a tu sistema. Confirma que funciona:

linkly --help

Iniciar 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 API key, ejecuta:

linkly auth login --api-key

Se te pedirá que pegues tu API key, que puedes encontrar en los parámetros 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 API key que copiar.

Verifica tu estado o cierra sesión en cualquier momento:

linkly auth status

linkly auth logout

Crear y administrar 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

Análisis 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 clic en tiempo real para un enlace único o un espacio de trabajo completo:

linkly webhooks add https://example.com/hook --link 12345

Trabajar con múltiples espacios de trabajo

Si tu cuenta tiene más de un espacio de trabajo, establece uno predeterminado:

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 API sin procesar en lugar de una tabla formateada — útil para piping a herramientas como jq:

linkly links list --json

Obtener 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

Usar la CLI con agentes de IA

Los asistentes de codificación que pueden ejecutar comandos de shell — como Claude Code o Cursor — pueden controlar la Linkly CLI directamente.

• Añade --json a cualquier comando para obtener la respuesta API sin procesar en lugar de una tabla formateada.
• Ejecuta linkly schema para imprimir el árbol de comandos completo — cada comando, argumento y opción — como JSON, para que un asistente pueda descubrir qué puede hacer la CLI.
• Añade --help a cualquier comando para ver sus opciones y ejemplos.

Si tu asistente de IA no puede ejecutar comandos de shell, usa el Linkly MCP Server en su lugar — conecta asistentes como Claude y ChatGPT a tu cuenta de Linkly directamente.