Linkly CLI
O Linkly CLI é uma ferramenta de linha de comando para gerenciar sua conta Linkly a partir do terminal. Crie links encurtados, puxe análises de cliques, gerencie domínios personalizados, manipule webhooks e exporte dados — sem sair do seu shell ou escrever código de API.
Ele é construído na Linkly API e funciona em macOS, Linux e Windows.
Instalação
O CLI requer Node.js 20 ou mais recente. Instale-o globalmente com npm:
npm install -g @linkly-link-shortener/cli
Isso adiciona um comando linkly ao seu sistema. Confirme se está funcionando:
linkly --help
Fazendo 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 de API, execute:
linkly auth login --api-key
Você será solicitado a colar sua chave de 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 de API para copiar.
Verifique seu status ou faça logout a qualquer momento:
linkly auth status
linkly auth logout
Criando e gerenciando links
Crie, procure, inspecione, atualize e delete links encurtados:
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 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ção 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 de um único link ou de um workspace inteiro:
linkly webhooks add https://example.com/hook --link 12345
Trabalhando com múltiplos workspaces
Se sua conta tiver mais de um workspace, defina um padrão:
linkly workspaces list
linkly workspaces use 42
Você também pode direcionar um workspace 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 canalizar para ferramentas como jq:
linkly links list --json
Obtendo ajuda
Cada 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 de IA
Assistentes de codificação que podem executar comandos shell — como Claude Code ou Cursor — podem conduzir o Linkly CLI diretamente.
- Adicione
--jsona qualquer comando para obter a resposta bruta da API em vez de uma tabela formatada. - Execute
linkly schemapara imprimir a árvore completa de comandos — cada comando, argumento e opção — como JSON, para que um assistente possa descobrir o que o CLI pode fazer. - Adicione
--helpa qualquer comando para ver suas opções e exemplos.
Se seu assistente de IA não conseguir executar comandos shell, use o Linkly MCP Server — ele conecta assistentes como Claude e ChatGPT à sua conta Linkly diretamente.
Artigos relacionados
Rastreie 500 cliques mensais com todos os recursos incluídos.