npm i -g @linktwin/cli

LinkTwin CLI: acorta y gestiona enlaces desde la línea de comandos.

La CLI de LinkTwin lleva los enlaces cortos y los deep links a tu terminal. Crea, edita y analiza enlaces, gestiona códigos QR, colecciones, dominios y píxeles, y automatízalo todo con comandos sencillos y salida JSON. Pensada para desarrolladores, scripts y CI.

npm install -g @linktwin/cli
Ver todos los comandos
  • Node.js 18 o superior
  • Licencia MIT, en npm
  • Programable con --json
maya@studio: ~/links

Sesión de ejemplo con comandos reales y formatos de salida.

Hecho para desarrolladores

Deja de cambiar de contexto para acortar un enlace.

Vives en la terminal. Abrir un panel para crear un enlace, o escribir a mano las llamadas a la API para un script rápido, te ralentiza. La CLI de LinkTwin pone la creación de enlaces, el deep linking y las analíticas a un solo comando de distancia.

Pasos para lograrlo

  • Panel
  • LinkTwin CLI
Acorta un enlace con un alias
Lista tus enlaces con más clics
Contado para alguien que ya inició sesión y tiene una terminal abierta. Cada bloque es una acción.
La tarea La forma antigua Con la CLI de LinkTwin
Crear un enlace Salir de la terminal para ir al panel linktwin links create <url>
Iniciar sesión Escribir curl + autenticación para cada script Un inicio de sesión y luego solo comandos
Trabajo masivo Sin operaciones masivas sencillas Crea y elimina en masa con facilidad
Automatización Difícil de integrar en CI --json + variable de entorno = listo para CI

Empezar

Listo y funcionando en dos comandos

Requiere Node.js 18+. Tu clave de API se guarda localmente en ~/.linktwin/config.json.

Terminal 
# 1. Instala (Node.js 18 o superior)
npm install -g @linktwin/cli

# 2. Autentícate (pega tu clave de API)
linktwin login

# 3. Crea tu primer enlace
linktwin links create https://example.com --custom hello

¿Usas IA? Prueba el servidor MCP. ¿Escribes tu propia integración? Lee la documentación de la API.

De dónde sale tu clave de API

La CLI busca las credenciales en este orden y usa la primera que encuentra, así que un job de CI puede anular tu inicio de sesión guardado sin tocarlo.

  1. Flags--api-key --base-url
  2. Variables de entornoLINKTWIN_API_KEY LINKTWIN_BASE_URL
  3. Inicio de sesión guardado~/.linktwin/config.json, escrito por linktwin login y legible solo por ti (modo 0600).
  4. URL base predeterminadahttps://linktw.in

Comandos

Todo, desde un solo comando

Un comando específico para cada parte de tu flujo de trabajo con enlaces. Todos los comandos también aceptan las opciones globales --json, --api-key, --base-url.

linktwin stats

Analíticas por enlace y de toda la cuenta: clics, países, referentes, dispositivos y tendencias.

  • linktwin stats link <id>

    Analíticas de un solo enlace (ID o URL corta)

    • --timezone
  • linktwin stats dashboard

    KPIs agregados de la cuenta y tendencia de clics

    • -p, --period 1d|1w|1m|1y|max
    • --timezone
  • linktwin stats detailed

    Analíticas detalladas de la cuenta con desgloses

    • -r, --range 1d|7d|30d|max|custom
    • --start
    • --end
    • --collections
    • --timezone
  • linktwin stats trend

    Distribución de clics por hora o por día (tendencia diaria)

    • -p, --period
    • --timezone
Ejemplo de salida 
$ linktwin stats dashboard --period 1m
Dashboard
Total clicks:  4370
Unique clicks: 3915
Top country:   United States
Top referrer:  https://l.instagram.com
Total links:   9
Growth %:      64.22

linktwin collections

Organiza enlaces en colecciones y asígnalos en masa.

  • linktwin collections list

    Lista las colecciones

    • -l, --limit
    • --page
  • linktwin collections get <id>

    Lista los elementos de una colección

    • -l, --limit
    • --page
  • linktwin collections create <name>

    Crea una colección

    • --description
    • --color <hex>
    • --slug
    • --public
    • --starred
  • linktwin collections update <id>

    Actualiza una colección

    • --name
    • --description
    • --color
    • --public <bool>
    • --starred <bool>
  • linktwin collections assign <collectionId> <linkIds>

    Agrega o quita enlaces de una colección (IDs de enlace separados por comas)

    • --remove
  • linktwin collections delete <id>

    Elimina una colección (los elementos se desasignan, no se eliminan)

    • -y, --yes
Ejemplo de salida 
$ linktwin collections assign 4 1221,1222,1223
✓ Added 3, removed 0 link(s).

linktwin domains

Agrega y gestiona tus dominios personalizados con tu marca.

  • linktwin domains list

    Lista todos los dominios disponibles (estándar y de marca)

    • -l, --limit
    • --page
  • linktwin domains add <domain>

    Agrega un dominio de marca (incluye http:// o https://)

    • --redirect-root
    • --redirect-404
  • linktwin domains update <id>

    Actualiza un dominio de marca

    • --redirect-root
    • --redirect-404
  • linktwin domains delete <id>

    Elimina un dominio de marca

    • -y, --yes
Ejemplo de salida 
$ linktwin domains add https://go.mayamakes.shop --redirect-root https://mayamakes.shop
✓ Added domain https://go.mayamakes.shop (id 12).

linktwin pixels

Crea píxeles de retargeting y adjúntalos a enlaces.

  • linktwin pixels list

    Lista los píxeles de retargeting

    • -l, --limit
    • --page
  • linktwin pixels get <id>

    Muestra un píxel y sus enlaces asignados

    • -l, --limit
    • --page
  • linktwin pixels create

    Crea un píxel de retargeting

    • -t, --type fbpixel|gtmpixel|…
    • -n, --name
    • --tag
    • --event
  • linktwin pixels update <id>

    Actualiza un píxel

    • --tag
    • -n, --name
    • --event
  • linktwin pixels assign <pixelId> <linkIds>

    Agrega o quita un píxel en enlaces (IDs de enlace separados por comas)

    • --remove
  • linktwin pixels delete <id>

    Elimina un píxel

    • -y, --yes
Ejemplo de salida 
$ linktwin pixels create --type fbpixel --name "Meta pixel" --tag 1234567890
✓ Created pixel Meta pixel (id 4).

linktwin qr

Genera y gestiona códigos QR para cualquier enlace.

  • linktwin qr list

    Listar Códigos QR

    • -l, --limit
    • --page
  • linktwin qr get <id>

    Muestra un código QR y sus analíticas de escaneos

  • linktwin qr create

    Crea un código QR

    • -t, --type text|vcard|link|email|phone|sms|wifi
    • -d, --data
    • --background
    • --foreground
    • --logo
  • linktwin qr update <id>

    Actualiza un código QR

    • -d, --data
    • --background
    • --foreground
    • --logo
  • linktwin qr delete <id>

    Elimina un código QR

    • -y, --yes
Ejemplo de salida 
$ linktwin qr create --type link --data https://linktw.in/desk-tour
✓ Created QR code https://linktw.in/qr/a58f79 (id 3).

Cuenta

Guarda tu clave una vez, comprueba qué cuenta estás usando y mira de dónde vienen tus credenciales.

  • linktwin login

    Guarda tu clave de API de LinkTwin y la URL base

    • -k, --key
    • -u, --url
    • --no-verify
  • linktwin logout

    Eliminar las credenciales guardadas

  • linktwin whoami

    Muestra la cuenta actual, el plan y el uso

  • linktwin config

    Muestra de dónde se leen las credenciales

Ejemplo de salida 
$ linktwin whoami
Account
Email:      [email protected]
Plan:       Large
User ID:    57842
Links used: 9
Clicks:     4370
Base URL:   https://linktw.in

Pensada para scripts, cron jobs y CI.

Los mismos comandos funcionan en un script de shell, una tarea programada o un pipeline de build. Agrega --json para obtener una salida que puedes procesar, y pasa tu clave como variable de entorno.

  • --json en cualquier comando imprime la respuesta en bruto de la API, lista para jq.
  • LINKTWIN_API_KEY y LINKTWIN_BASE_URL anulan el inicio de sesión guardado, así que CI nunca necesita linktwin login.
  • Los comandos de eliminación no se ejecutan sin --yes, así que un script nunca borra enlaces por accidente.
  • Cualquier error sale con el código 1 e imprime el motivo en stderr, así que un paso que falla detiene tu pipeline.
jq 
# Tus 5 enlaces con más clics, como clics y URL corta
linktwin links list --order clicks_desc --limit 5 --json \
  | jq -r '.data.urls[] | "\(.clicks)\t\(.shorturl)"'
Creación masiva 
# Un enlace corto para cada URL de urls.txt
while read -r url; do
  linktwin links create "$url" --json | jq -r '.shorturl'
done < urls.txt
Segmentación 
# Segmentación geográfica y parámetros UTM, pasados como JSON
linktwin links create https://example.com --custom promo \
  --data '{"geotarget":[{"location":"Canada","link":"https://example.ca"}],
           "parameters":[{"name":"utm_source","value":"newsletter"}]}'
GitHub Actions 
# Un paso del flujo de trabajo: un enlace corto para cada versión
- name: Short link for the release notes
  env:
    LINKTWIN_API_KEY: ${{ secrets.LINKTWIN_API_KEY }}
  run: |
    npm install -g @linktwin/cli
    linktwin links create "https://example.com/releases/${{ github.ref_name }}" --json

Preguntas sobre la CLI

Todo sobre la herramienta de línea de comandos de LinkTwin. ¿Todavía tienes preguntas? Contáctanos.

¿Qué es la CLI de LinkTwin?

La CLI de LinkTwin es una herramienta de línea de comandos, el comando linktwin, para acortar y gestionar enlaces desde tu terminal. Puedes crear enlaces cortos y deep links, gestionar colecciones, dominios de marca, píxeles de retargeting y códigos QR, y consultar las analíticas de clics sin abrir el panel. Todos los comandos admiten salida --json para scripts y automatización.

¿Cómo instalo la CLI de LinkTwin?

Instálala desde npm con npm install -g @linktwin/cli. Necesita Node.js 18 o superior. Luego ejecuta linktwin login, pega tu clave de API y ya puedes crear enlaces desde la línea de comandos.

¿La CLI del acortador de URLs es gratuita?

La CLI en sí es gratis y tiene licencia MIT. Funciona a través de la API de LinkTwin, y el acceso a la API está disponible en todos los planes. Puedes crear primero una cuenta gratis y mejorar tu plan cuando necesites la API.

¿Puedo usar la CLI en scripts y CI?

Sí. Pasa --json a cualquier comando para obtener una salida legible por máquinas que puedes enviar a jq, y autentícate sin ningún prompt definiendo la variable de entorno LINKTWIN_API_KEY. Eso hace que la CLI encaje bien en pipelines de build, cron jobs y la creación masiva de enlaces.

¿La CLI puede crear deep links, no solo enlaces cortos?

Sí. Cada enlace que creas se abre en la app correcta en un teléfono, como YouTube, Amazon o Spotify. La CLI también configura la segmentación por país, dispositivo e idioma, las pruebas A/B, los parámetros UTM y los dominios de marca. Pasa la segmentación avanzada como JSON con el flag --data.

¿Dónde obtengo mi clave de API?

Inicia sesión en LinkTwin y abre Configuración, o Herramientas e integraciones y luego Herramienta CLI, en tu panel. Copia tu clave de API y ejecuta linktwin login, o defínela como la variable de entorno LINKTWIN_API_KEY. La clave se muestra cuando tu plan incluye acceso a la API.

¿Qué comandos tiene la CLI de LinkTwin?

login, logout, whoami y config para tus credenciales, además de seis grupos de comandos: links, stats, collections, domains, pixels y qr. Ejecuta linktwin seguido de cualquier comando y --help para ver todas sus opciones.

¿Cómo me refiero a un enlace en un comando?

Usa su ID numérico o su URL corta, por ejemplo linktwin stats link linktw.in/desk-tour. La URL corta funciona con o sin https://. Encontrarás ambos en la salida de linktwin links list.

Una API key, tres formas de construir

La API REST, el servidor MCP y la CLI usan la misma API key y gestionan los mismos enlaces.

Acorta tu próximo enlace sin salir de la terminal

Instala la CLI de LinkTwin y empieza a gestionar enlaces desde tu shell.

npm install -g @linktwin/cli

El acceso a la API está disponible en todos los planes. Ver planes