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 --json a cualquier comando para obtener la respuesta bruta de la API en lugar de una tabla formateada.
  • Ejecuta linkly schema para 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 --help a 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

Linkly CLI logo
Linkly CLI logo

Rastrea 500 clics mensuales con todas las funciones incluidas.