Linkly CLI

O Linkly CLI é uma ferramenta de linha de comando para gerenciar sua conta Linkly no terminal. Crie links curtos, obtenha análises de cliques, gerencie domínios personalizados, gerencie webhooks e exporte dados — sem deixar seu shell ou escrever código de API.

Ele é construído sobre a Linkly API e funciona em macOS, Linux e Windows.

Instalação

O CLI requer Node.js 20 ou mais recente. Instale globalmente com npm:

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

Isso adiciona um comando linkly ao seu sistema. Confirme que está funcionando:

linkly --help

Fazer login

O CLI suporta duas formas de fazer login. Você só precisa fazer isso uma vez — suas credenciais são salvas com segurança em sua máquina e reutilizadas a cada execução.

Para fazer login com uma chave API, execute:

linkly auth login --api-key

Você será solicitado a colar sua chave API, que você pode encontrar nas configurações de sua conta Linkly.

Para fazer login com OAuth em vez disso, execute:

linkly auth login

Isso abre seu navegador para que você possa aprovar o acesso — não há chave API para copiar.

Verifique seu status ou saia a qualquer momento:

linkly auth status

linkly auth logout

Criando e gerenciando links

Crie, procure, inspecione, atualize e delete links curtos:

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álises de cliques

Visualize totais de cliques agrupados por país, navegador, plataforma e muito mais — ou como uma série temporal em um intervalo de datas:

linkly analytics by country

linkly analytics timeseries --start 2026-01-01 --end 2026-01-31

Domínios personalizados

Liste seus domínios personalizados ou adicione um novo:

linkly domains list

linkly domains create links.example.com

Códigos QR e exportações de dados

Baixe o código QR de um link, ou exporte seus links e dados de cliques como CSV ou 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

Inscreva uma URL para receber eventos de clique em tempo real para um único link ou um espaço de trabalho inteiro:

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

Trabalhando com vários espaços de trabalho

Se sua conta tem mais de um espaço de trabalho, defina um padrão:

linkly workspaces list

linkly workspaces use 42

Você também pode direcionar um espaço de trabalho específico para um único comando com a opção --workspace.

Saída JSON para scripts

Adicione --json a qualquer comando para obter a resposta bruta da API em vez de uma tabela formatada — útil para encadear em ferramentas como jq:

linkly links list --json

Obtendo ajuda

Todo comando tem ajuda integrada. Execute linkly --help para uma visão geral, ou adicione --help a qualquer comando para ver suas opções e exemplos:

linkly links create --help

Usando o CLI com agentes IA

Assistentes de codificação que podem executar comandos shell — como Claude Code ou Cursor — podem conduzir o Linkly CLI diretamente.

• Adicione --json a qualquer comando para obter a resposta bruta da API em vez de uma tabela formatada.
• Execute linkly schema para imprimir a árvore de comandos completa — cada comando, argumento e opção — como JSON, para que um assistente possa descobrir o que o CLI pode fazer.
• Adicione --help a qualquer comando para ver suas opções e exemplos.

Se seu assistente de IA não puder executar comandos shell, use o Linkly MCP Server em vez disso — ele conecta assistentes como Claude e ChatGPT à sua conta Linkly diretamente.