climcpapi
Um encurtador de URLs com CLI para programadores e agentes de IA
Encurte URLs na linha de comandos com a CLI do Linkdash. Partilhe ficheiros e excertos, faça testes A/B, segmente visitantes e use agentes de IA via MCP.
Igor Kirnosov10 min de leitura

O Linkdash é um encurtador de URLs que controla a partir do terminal. Um único comando transforma um URL, um ficheiro ou um excerto de texto num link curto com estatísticas em lida.sh e devolve o resultado em JSON, que pode encaminhar para qualquer outra ferramenta. As mesmas operações estão disponíveis numa API HTTP e como servidor MCP, por isso um agente de IA pode criar, atualizar e medir links com exatamente as mesmas ferramentas que usa.
Este guia percorre toda a CLI: instalá-la, encurtar o primeiro link, partilhar ficheiros, proteger links, fazer testes A/B, encaminhar visitantes por país ou dispositivo e ler estatísticas sem abrir o navegador.

Instalar a CLI do Linkdash
A CLI é um pacote npm e precisa do Node.js 20 ou posterior.
npm i -g linkdash-cli
Funciona da mesma forma com pnpm add -g linkdash-cli ou bun add -g linkdash-cli. O comando instalado é linkdash.
Depois, crie uma conta e inicie sessão na CLI, num só passo:
linkdash auth create
Isto abre a página de registo no navegador. Depois de ter conta, aprove o código apresentado no terminal e a CLI fica com a sessão iniciada. Se já tiver conta, use antes linkdash auth login. linkdash auth whoami confirma que conta está a usar, e a referência da CLI lista todos os comandos e flags.
A sessão fica guardada em ~/.config/linkdash/config.json, com permissões apenas para o proprietário. Para CI ou outros ambientes sem interface, defina LINKDASH_TOKEN com o token de sessão desse ficheiro, a partir de uma máquina onde tenha iniciado sessão, e trate-o como qualquer outro segredo.
Encurtar um URL na linha 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" }
]
}
A interface é só isto: os comandos bem-sucedidos escrevem JSON no stdout e os erros escrevem texto simples no stderr, com código de saída 1. Não há flag --json, porque JSON é o único formato de saída. Isso torna a CLI fácil de usar em scripts. Para copiar um link curto novo diretamente para a área de transferência no macOS:
linkdash links create --url https://example.com/pricing | jq -r .url | pbcopy
Algumas flags que vai usar constantemente:
--slugdefine o caminho público. Os slugs usam letras minúsculas, algarismos e hífenes internos, até 64 caracteres. Se o omitir, o Linkdash gera um.--nameé um nome privado, visível apenas para si, útil para encontrar links mais tarde.--tagpode repetir-se, por isso--tag launch --tag q4dá duas etiquetas a um link.--utm-source,--utm-medium,--utm-campaign,--utm-terme--utm-contentacrescentam parâmetros de campanha ao destino.
Liste e pesquise o que criou com linkdash links list --q pricing --tag launch.
Partilhar um ficheiro ou um excerto de texto
Os links curtos não servem apenas para URLs. O mesmo comando carrega um ficheiro ou guarda um excerto de texto:
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
Um link de ficheiro dá aos visitantes uma transferência, com pré-visualização para imagens e vídeo. Um link de texto mostra o excerto numa página com um botão de copiar. Ambos têm estatísticas como qualquer outro link, por isso pode ver quem abriu a sua apresentação e quando. Para substituir o ficheiro de um link existente sem alterar o URL:
linkdash links update board-deck --file ./board-deck-v2.pdf
Controlar quem pode abrir um link
Cada link pode ter as suas próprias regras de acesso:
linkdash links create --url https://example.com/decks/q4-2026 \
--slug q4-deck \
--password "$DECK_PASSWORD" \
--expires 14d \
--max-openings 50
--passwordpede uma palavra-passe aos visitantes antes de o link abrir.--startse--expiresaceitam uma duração como30m,24hou7d, ou uma data ISO. Antes da hora de início, um link simplesmente não resolve.--max-openingspausa o link após esse número de aberturas, o que é útil para transferências únicas.
Pode pausar e retomar um link a qualquer momento com linkdash links update q4-deck --status paused e --status active.
Fazer um teste A/B a um link curto
No Linkdash, cada link é um contentor de uma ou mais variantes. Uma variante é um destino (um URL, ficheiro ou texto) com o seu próprio peso e regras. Um link normal tem uma única variante chamada main. Adicione mais e o link curto divide o tráfego entre elas:
linkdash links create --slug launch \
--variant control --url https://example.com/pricing \
--variant annual-first --url "https://example.com/pricing?view=annual"
As flags que vêm depois de cada --variant pertencem a essa variante até à seguinte. O tráfego é dividido por peso, que por predefinição é 1, por isso o exemplo acima é um teste 50/50. Dê --weight 3 a uma variante para lhe enviar três vezes mais tráfego.
A atribuição é fixa por predefinição: um visitante que regressa continua a receber a mesma variante, que é o que se pretende num teste justo. Quando mudar a experiência, linkdash links update launch --restart-split volta a distribuir todos uma vez.

As estatísticas chegam por variante, por isso pode compará-las diretamente:
linkdash links stats launch --last 7d
O array variants no resultado indica visits, visitors, downloads e plays para cada variante. Mais sobre estatísticas abaixo.
Encaminhar visitantes por país, dispositivo ou parâmetro de query
As variantes também podem ter condições. Acrescente --when a uma variante e só os visitantes que correspondam a podem receber. Isto transforma um único link curto num router. Por exemplo, um link que envia os telemóveis para a loja de apps certa:
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
Quando um visitante abre o link, as variantes cujas condições correspondem formam o conjunto. Se nenhuma corresponder, são usadas as variantes sem condições, por isso web acima apanha todos os que não estão em iOS nem em Android.

Pode filtrar por:
| Chave | Corresponde a | Exemplo |
|---|---|---|
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 |
Códigos de idioma, por prefixo | --when language=de |
referrer |
O host de origem | --when referrer=twitter.com |
Repita --when para exigir várias condições ao mesmo tempo. --when country=DE,AT --when device=mobile corresponde a visitantes em dispositivos móveis da Alemanha ou da Áustria.
As variantes também podem corresponder à query string do visitante, por isso um único link pode comportar-se de forma diferente consoante o sítio onde o partilhou. lida.sh/launch?src=newsletter pode enviar os leitores da newsletter para um sítio especial:
linkdash links variants add launch --name newsletter \
--url https://example.com/pricing/newsletter \
--when param:src=newsletter
As regras de parâmetros suportam igual a (=), diferente de (!=), contém (~=), começa por (^=), termina em ($=), um de (=a|b), presente (param:ref?) e ausente (param:!ref). Se preferir que os parâmetros do visitante sejam passados para o destino, crie o link com --forward-params.
O painel tem os mesmos controlos, com um seletor de países que pesquisa pelo nome, para que não precise de se lembrar de que a Eslovénia é SI:

Ler as estatísticas de cliques no terminal
linkdash links stats launch --last 7d
O resultado inclui o total de visits, downloads e plays, o número de visitas no intervalo pedido (visitsInLast), os countries e referrers de onde vieram essas visitas, uma divisão por variants e uma lista visitors com a hora, o país, o dispositivo, o navegador e a origem de cada visita recente. --last aceita uma duração como 24h ou 30d e, por predefinição, é 24h.
O Linkdash não guarda os endereços IP dos visitantes. O endereço é usado para identificar o país do visitante e para obter um identificador anónimo que muda todos os dias; depois, é descartado.
Para reagir aos cliques à medida que acontecem, registe um webhook. O Linkdash envia eventos link.visit, link.download e link.play assinados para qualquer endpoint HTTPS:
linkdash webhooks create --url https://example.com/hooks
O segredo de assinatura só é mostrado uma vez, por isso guarde-o de imediato. Consulte a documentação sobre webhooks para verificar assinaturas.
Deixar os agentes de IA criar links curtos com MCP
Tudo o que está acima também está disponível para agentes de IA. O Linkdash tem um servidor MCP remoto em https://api.linkdash.dev/mcp, e as suas ferramentas espelham a CLI: links_create, links_update, links_stats, variants_add, domains_add e as restantes, que devolvem o mesmo JSON.
Crie uma chave de API no painel, em Chaves de API, e ligue o seu agente. No Claude Code:
claude mcp add --transport http linkdash https://api.linkdash.dev/mcp \
--header "Authorization: Bearer $LINKDASH_API_KEY"
No Cursor, adicione-o a .cursor/mcp.json:
{
"mcpServers": {
"linkdash": {
"url": "https://api.linkdash.dev/mcp",
"headers": { "Authorization": "Bearer ${env:LINKDASH_API_KEY}" }
}
}
}
No Codex, que lê a chave da variável de ambiente que indicar:
codex mcp add linkdash --url https://api.linkdash.dev/mcp \
--bearer-token-env-var LINKDASH_API_KEY
A partir daí, pode pedir links em linguagem natural, como “encurte https://example.com/pricing como pricing e dê-lhe a etiqueta launch” ou “que variante de launch teve mais visitantes esta semana?”, e o agente chama a ferramenta certa. A documentação do MCP também cobre o OpenCode.
Se o seu agente já trabalha num terminal, pode usar a CLI diretamente. Instale o skill de agente do Linkdash para que conheça os comandos e as flags:
npx skills add https://linkdash.dev/skills/linkdash/SKILL.md
Usar a API HTTP
No seu próprio código, as mesmas operações são uma API REST simples em https://api.linkdash.dev/v1, autenticada com a mesma chave 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" }'
A resposta tem a mesma estrutura que o resultado da CLI. A referência da API cobre todos os endpoints, incluindo o carregamento de ficheiros e as variantes.
Usar o seu próprio domínio
Por predefinição, os links curtos ficam em lida.sh. Para os servir a partir do seu próprio domínio, adicione-o e aponte o DNS para o Linkdash:
linkdash domains add go.example.com
linkdash domains verify go.example.com
Depois, crie links nele com --domain go.example.com. Cada domínio personalizado tem o seu próprio conjunto de slugs, por isso go.example.com/launch não colide com o launch de mais ninguém. O guia de domínios cobre a configuração de DNS, incluindo a configuração com um clique nos fornecedores que a suportam.
Preços
O plano Free não precisa de cartão de crédito e inclui 5000 eventos por mês, 1 GB de armazenamento de ficheiros, um mês de histórico de estatísticas e um domínio personalizado. Um evento é uma visita, transferência ou reprodução num dos seus links, ou uma escrita, como criar ou atualizar um link. As leituras, como listar links ou obter estatísticas, são gratuitas.
Os planos pagos aumentam esses limites: o Professional custa 18 $ por mês e o Growth 48 $ por mês. Consulte os preços para a comparação completa.
Perguntas frequentes
Existe um encurtador de URLs gratuito com CLI?
Sim. A CLI do Linkdash funciona no plano Free, que inclui 5000 eventos por mês, sem cartão de crédito.
Posso usar a CLI do Linkdash em CI?
Sim. Defina LINKDASH_TOKEN com um token de sessão e a CLI funciona sem navegador. Como todos os comandos devolvem JSON, pode criar e atualizar links a partir do GitHub Actions ou de qualquer outro pipeline e ler os resultados com jq.
Os agentes de IA podem criar links curtos?
Sim, de três formas: através do servidor MCP em https://api.linkdash.dev/mcp, através da CLI com o skill de agente do Linkdash instalado, ou através da API HTTP. As três expõem as mesmas operações e devolvem o mesmo JSON.
O Linkdash guarda os endereços IP dos visitantes?
Não. O Linkdash usa o endereço para identificar o país do visitante e para criar um identificador anónimo diário, e depois descarta-o. Os proprietários dos links nunca veem endereços IP.
Um único link curto pode enviar visitantes diferentes para páginas diferentes?
Sim. Dê a um link várias variantes e acrescente a cada uma condições como país, dispositivo, sistema operativo, idioma, origem ou parâmetro de query. Sem condições, as variantes dividem o tráfego por peso, que é como se faz um teste A/B.
Quer experimentar? Instale a CLI, execute linkdash auth create e encurte o seu primeiro link em menos de um minuto. O início rápido tem todos os passos.

