Saltar al contenido
Todas las publicaciones

climcpapi

Un acortador de URLs con CLI para desarrolladores y agentes de IA

Acorta URLs desde la terminal con la CLI de Linkdash. Comparte archivos y fragmentos, haz pruebas A/B, segmenta visitantes y conecta agentes de IA por MCP.

Igor Kirnosov10 min de lectura

Una terminal creando un enlace corto de Linkdash con el comando linkdash links create

Linkdash es un acortador de URLs que manejas desde la terminal. Un solo comando convierte una URL, un archivo o un fragmento de texto en un enlace corto con seguimiento en lida.sh e imprime el resultado como JSON, listo para pasarlo por una pipe a lo que quieras. Las mismas operaciones están disponibles en una API HTTP y como servidor MCP, así que un agente de IA puede crear, actualizar y medir enlaces con exactamente las mismas herramientas que usas tú.

Esta guía recorre toda la CLI: cómo instalarla, acortar tu primer enlace, compartir archivos, proteger enlaces, hacer pruebas A/B, enrutar visitantes por país o dispositivo y leer analíticas sin abrir un navegador.

El panel de Linkdash con una lista de enlaces cortos, con su tipo, slug, destino y estado

Instala la CLI de Linkdash

La CLI es un paquete de npm y necesita Node.js 20 o posterior.

npm i -g linkdash-cli

Funciona igual con pnpm add -g linkdash-cli o bun add -g linkdash-cli. El comando que instala es linkdash.

Luego crea una cuenta e inicia sesión en la CLI, en un solo paso:

linkdash auth create

Esto abre la página de registro en tu navegador. Cuando ya tienes la cuenta, apruebas el código que aparece en tu terminal y la CLI queda con la sesión iniciada. Si ya tienes una cuenta, usa linkdash auth login. linkdash auth whoami confirma qué cuenta estás usando, y la referencia de la CLI lista todos los comandos y flags.

La sesión se guarda en ~/.config/linkdash/config.json con permisos solo para el propietario. Para CI u otros entornos sin interfaz, define LINKDASH_TOKEN con el token de sesión de ese archivo en una máquina donde hayas iniciado sesión, y trátalo como cualquier otro secreto.

Acorta una URL desde la línea de comandos

linkdash links create --url https://example.com/pricing --slug pricing
{
  "id": "pricing",
  "url": "https://lida.sh/pricing",
  "kind": "url",
  "variants": [
    { "name": "main", "kind": "url" }
  ]
}

Esa es toda la interfaz: los comandos exitosos imprimen JSON en stdout y los errores imprimen texto plano en stderr con código de salida 1. No hay un flag --json porque JSON es la única salida. Eso hace que la CLI sea fácil de usar en scripts. Para copiar un enlace corto nuevo directo al portapapeles en macOS:

linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy

Algunos flags que vas a usar todo el tiempo:

  • --slug define la ruta pública. Los slugs usan letras minúsculas, dígitos y guiones internos, hasta 64 caracteres. Si lo omites, Linkdash genera uno.
  • --name es una etiqueta privada que solo ves tú, útil para encontrar enlaces más tarde.
  • --tag se puede repetir, así que --tag launch --tag q4 le pone dos etiquetas a un enlace.
  • --utm-source, --utm-medium, --utm-campaign, --utm-term y --utm-content agregan parámetros de campaña al destino.

Lista y busca lo que creaste con linkdash links list --q pricing --tag launch.

Comparte un archivo o un fragmento de texto

Los enlaces cortos no son solo para URLs. El mismo comando sube un archivo o guarda un fragmento:

linkdash links create --file ./board-deck.pdf --slug board-deck --expires 7d
linkdash links create --text "Release checklist: tag, build, smoke test, announce" --tag launch

Un enlace de archivo les ofrece una descarga a los visitantes, con vista previa para imágenes y video. Un enlace de texto muestra el fragmento en una página con un botón para copiar. Ambos tienen seguimiento como cualquier otro enlace, así que puedes ver quién abrió tu presentación y cuándo. Para reemplazar el archivo de un enlace existente sin cambiar la URL:

linkdash links update board-deck --file ./board-deck-v2.pdf

Controla quién puede abrir un enlace

Cada enlace puede tener sus propias reglas de acceso:

linkdash links create --url https://example.com/decks/q4-2026 \
  --slug q4-deck \
  --password "$DECK_PASSWORD" \
  --expires 14d \
  --max-openings 50
  • --password pide una contraseña a los visitantes antes de abrir el enlace.
  • --starts y --expires aceptan una duración como 30m, 24h o 7d, o una fecha ISO. Antes de su hora de inicio, un enlace no resuelve en absoluto.
  • --max-openings pausa el enlace después de esa cantidad de aperturas, algo útil para descargas de un solo uso.

Puedes pausar y reanudar un enlace en cualquier momento con linkdash links update q4-deck --status paused y --status active.

Haz una prueba A/B con un enlace corto

En Linkdash, cada enlace es un contenedor de una o más variantes. Una variante es un destino (una URL, un archivo o un texto) con su propio peso y sus propias reglas. Un enlace normal tiene una sola variante llamada main. Agrega más y el enlace corto reparte su tráfico entre ellas:

linkdash links create --slug launch \
  --variant control --url https://example.com/pricing \
  --variant annual-first --url "https://example.com/pricing?view=annual"

Los flags que van después de cada --variant pertenecen a esa variante hasta la siguiente. El tráfico se reparte según el peso, que por defecto es 1, así que el ejemplo de arriba es una prueba 50/50. Dale --weight 3 a una variante para enviarle el triple de tráfico.

La asignación es persistente por defecto: un visitante que regresa sigue recibiendo la misma variante, que es lo que quieres para una prueba justa. Cuando cambies el experimento, linkdash links update launch --restart-split vuelve a repartir a todos una vez.

Un enlace de Linkdash con dos variantes, control y annual-first, que reparte el tráfico entre dos páginas de precios

Las estadísticas llegan por variante, así que puedes compararlas directamente:

linkdash links stats launch --last 7d

El arreglo variants de la salida reporta visits, visitors, downloads y plays de cada variante. Más sobre estadísticas abajo.

Enruta visitantes por país, dispositivo o parámetro de consulta

Las variantes también pueden tener condiciones. Agrega --when a una variante y solo los visitantes que coincidan podrán recibirla. Así, un enlace corto se convierte en un enrutador. Por ejemplo, un enlace que envía los teléfonos a la tienda de apps correcta:

linkdash links create --slug get-app \
  --variant ios \
    --url https://apps.apple.com/app/example/id000000000 \
    --when os=ios \
  --variant android \
    --url "https://play.google.com/store/apps/details?id=com.example" \
    --when os=android \
  --variant web \
    --url https://example.com/app

Cuando un visitante abre el enlace, las variantes cuyas condiciones coinciden forman el grupo. Si ninguna coincide, se usan las variantes sin condiciones, así que web en el ejemplo atrapa a todos los que no usan iOS ni Android.

Un enlace de Linkdash que envía a los visitantes a App Store en iOS, a Google Play en Android y a una página web a todos los demás

Puedes filtrar por:

Clave Coincide con Ejemplo
country Códigos de país ISO --when country=DE,AT,CH
device mobile, tablet, desktop --when device=mobile
os windows, macos, android, ios, linux, other --when os=ios
browser edge, chrome, firefox, safari, other --when browser=safari
language Etiquetas de idioma, por prefijo --when language=de
referrer El host de referencia --when referrer=twitter.com

Repite --when para exigir varias condiciones a la vez. --when country=DE,AT --when device=mobile coincide con visitantes móviles de Alemania o Austria.

Las variantes también pueden filtrar por la query string del visitante, así que un mismo enlace puede comportarse distinto según dónde lo compartiste. lida.sh/launch?src=newsletter puede enviar a los lectores del newsletter a un lugar especial:

linkdash links variants add launch --name newsletter \
  --url https://example.com/pricing/newsletter \
  --when param:src=newsletter

Las reglas de parámetros admiten igual a (=), distinto de (!=), contiene (~=), empieza con (^=), termina con ($=), uno de (=a|b), presente (param:ref?) y ausente (param:!ref). Si prefieres que los parámetros del visitante pasen al destino, crea el enlace con --forward-params.

El panel tiene los mismos controles, con un selector de países que busca por nombre, así que no necesitas recordar que Eslovenia es SI:

Selección de países de destino para una variante en el panel de Linkdash, con Alemania y Austria seleccionadas

Lee las analíticas de clics desde la terminal

linkdash links stats launch --last 7d

La salida incluye el total de visits, downloads y plays, la cantidad de visitas en el intervalo que pediste (visitsInLast), los countries y referrers de donde vinieron esas visitas, un desglose por variants y una lista visitors con la hora, el país, el dispositivo, el navegador y el referente de cada visita reciente. --last acepta una duración como 24h o 30d, y por defecto es 24h.

Linkdash no guarda las direcciones IP de los visitantes. La dirección se usa para obtener el país del visitante y para derivar un identificador anónimo de visitante que cambia cada día, y luego se descarta.

Para reaccionar a los clics en el momento, registra un webhook. Linkdash envía eventos firmados link.visit, link.download y link.play a cualquier endpoint HTTPS:

linkdash webhooks create --url https://example.com/hooks

El secreto de firma se imprime una sola vez, así que guárdalo de inmediato. Consulta la documentación de webhooks para verificar las firmas.

Deja que los agentes de IA creen enlaces cortos con MCP

Todo lo anterior también está disponible para agentes de IA. Linkdash tiene un servidor MCP remoto en https://api.linkdash.dev/mcp, y sus herramientas replican la CLI: links_create, links_update, links_stats, variants_add, domains_add y las demás, que devuelven el mismo JSON.

Crea una clave de API en el panel, en Claves de API, y luego conecta tu agente. En Claude Code:

claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
  --header "Authorization: Bearer $LINKDASH_API_KEY"

En Cursor, agrégalo a .cursor/mcp.json:

{
  "mcpServers": {
    "linkdash": {
      "url": "https://api.linkdash.dev/mcp",
      "headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
    }
  }
}

En Codex, que lee la clave de la variable de entorno que indiques:

codex mcp add linkdash --url https://api.linkdash.dev/mcp \
  --bearer-token-env-var LINKDASH_API_KEY

A partir de ahí puedes pedir enlaces en lenguaje natural, como “acorta https://example.com/pricing como pricing y etiquétalo launch” o “¿qué variante de launch tuvo más visitantes esta semana?”, y el agente llama a la herramienta correcta. La documentación de MCP también cubre OpenCode.

Si tu agente ya trabaja en una terminal, puede usar la CLI directamente. Instala la skill de agente de Linkdash para que conozca los comandos y los flags:

npx skills add https://linkdash.dev/skills/linkdash/SKILL.md

Usa la API HTTP

Para tu propio código, las mismas operaciones están en una API REST simple en https://api.linkdash.dev/v1, autenticada con la misma clave de API:

curl https://api.linkdash.dev/v1/links \
  -H "Authorization: Bearer $LINKDASH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/pricing", "slug": "pricing" }'

La respuesta tiene la misma forma que la salida de la CLI. La referencia de la API cubre todos los endpoints, incluidas la subida de archivos y las variantes.

Usa tu propio dominio

Por defecto, los enlaces cortos viven en lida.sh. Para servirlos desde tu propio dominio, agrégalo y apunta tu DNS a Linkdash:

linkdash domains add go.example.com
linkdash domains verify go.example.com

Luego crea enlaces en él con --domain go.example.com. Cada dominio personalizado tiene su propio conjunto de slugs, así que go.example.com/launch no choca con el launch de nadie más. La guía de dominios cubre la configuración del DNS, incluida la configuración en un clic para los proveedores que la admiten.

Precios

El plan Free no necesita tarjeta de crédito e incluye 5000 eventos al mes, 1 GB de almacenamiento de archivos, un mes de historial de analíticas y un dominio personalizado. Un evento es una visita, una descarga o una reproducción en uno de tus enlaces, o una escritura como crear o actualizar un enlace. Las lecturas, como listar enlaces u obtener estadísticas, son gratis.

Los planes de pago amplían esos límites: Professional cuesta 18 USD al mes y Growth, 48 USD al mes. Consulta los precios para ver la comparación completa.

Preguntas frecuentes

¿Hay un acortador de URLs gratis con CLI?

Sí. La CLI de Linkdash funciona con el plan Free, que incluye 5000 eventos al mes sin tarjeta de crédito.

¿Puedo usar la CLI de Linkdash en CI?

Sí. Define LINKDASH_TOKEN con un token de sesión y la CLI funciona sin navegador. Como cada comando imprime JSON, puedes crear y actualizar enlaces desde GitHub Actions o cualquier otro pipeline y leer los resultados con jq.

¿Los agentes de IA pueden crear enlaces cortos?

Sí, de tres formas: con el servidor MCP en https://api.linkdash.dev/mcp, con la CLI y la skill de agente de Linkdash instalada, o con la API HTTP. Las tres exponen las mismas operaciones y devuelven el mismo JSON.

¿Linkdash guarda las direcciones IP de los visitantes?

No. Linkdash usa la dirección para obtener el país del visitante y crear un identificador anónimo diario, y luego la descarta. Los propietarios de los enlaces nunca ven direcciones IP.

¿Un enlace corto puede enviar a distintos visitantes a distintas páginas?

Sí. Dale varias variantes a un enlace y agrega a cada una condiciones como país, dispositivo, sistema operativo, idioma, referente o parámetro de consulta. Sin condiciones, las variantes reparten el tráfico según el peso, que es como se hace una prueba A/B.


¿Listo para probarlo? Instala la CLI, ejecuta linkdash auth create y acorta tu primer enlace en menos de un minuto. El inicio rápido tiene todos los pasos.