S.EE Docs
Desenvolvedores

CLI

Cliente de linha de comando para a plataforma S.EE

Um cliente de linha de comando para a plataforma S.EE que permite criar e gerenciar URLs curtas, trechos de texto e arquivos diretamente pelo terminal.

Recursos

  • Gerenciamento de URLs curtas: criar, atualizar e excluir links encurtados com slugs personalizados, domínios e expiração
  • Trechos de texto: compartilhar trechos de código e notas via stdin ou arquivos
  • Envio de arquivos: enviar arquivos diretamente ou via stdin
  • Gerenciamento de domínios e tags: listar domínios disponíveis e gerenciar tags
  • Proteção por senha: proteger seu conteúdo com senhas
  • Saída JSON: saída legível por máquina para scripts

Instalação

macOS

brew tap sdotee/homebrew-tap
brew install see

Debian / Ubuntu

dpkg -i see-cli_<version>_<arch>.deb

RHEL / Fedora

rpm -i see-cli_<version>_linux_<arch>.rpm

Arch Linux

yay -S see-cli
# or pre-built binary
yay -S see-cli-bin

A partir do código-fonte

go install github.com/sdotee/cli@latest

Baixe binários e pacotes pré-compilados em GitHub Releases.

Configuração

Defina sua chave de API por variável de ambiente ou flag:

# Variável de ambiente (recomendada)
export SEE_API_KEY="your-api-key"

# Ou use a flag
see --api-key "your-api-key" <command>

Opções de configuração

OpçãoVariável de ambienteDescrição
--api-keySEE_API_KEYSua chave de API S.EE (obrigatória)
--base-urlSEE_BASE_URLURL base personalizada da API
--timeoutSEE_TIMEOUTTempo limite da requisição
--json-Ativa o formato de saída JSON

Comandos

Domínios e tags

# Listar domínios disponíveis para URLs curtas
see domains

# Listar domínios disponíveis para envios de arquivos
see file domains

# Listar suas tags
see tags

URLs curtas

# Criar uma URL curta
see url create https://example.com

# Criar com opções personalizadas
see url create https://example.com \
  --slug my-link \
  --domain s.ee \
  --title "My Link" \
  --password secret \
  --expires 2024-12-31

# Atualizar uma URL curta
see url update --domain s.ee --slug my-link --title "New Title"

# Excluir uma URL curta
see url delete --domain s.ee --slug my-link

Trechos de texto

# Criar texto a partir de stdin
echo "Hello World" | see text create --title "greeting"

# Criar texto a partir de arquivo
see text create --file ./snippet.txt --title "Code Snippet"

# Criar com opções
cat script.sh | see text create \
  --title "Shell Script" \
  --domain fs.to \
  --password secret \
  --expires 2024-12-31

# Atualizar texto
see text update --domain fs.to --slug abc123 --title "Título atualizado"

# Excluir texto
see text delete --domain fs.to --slug abc123

Envio de arquivos

# Enviar um arquivo
see file upload ./image.png

# Enviar com domínio personalizado
see file upload ./document.pdf --domain fs.to

# Enviar a partir de stdin
cat image.png | see file upload --stdin --filename image.png

# Excluir um arquivo
see file delete <delete-hash>

Saída JSON

Use a flag --json para obter uma saída legível por máquina, útil para scripts:

see url create https://example.com --json | jq '.short_url'

Exemplos

Criar uma URL curta e copiá-la para a área de transferência (macOS)

see url create https://example.com --json | jq -r '.short_url' | pbcopy

Enviar uma captura de tela e obter a URL (Linux)

see file upload ~/screenshot.png --json | jq -r '.url'

Criar URLs curtas em lote

while read url; do
  see url create "$url" --json
done < urls.txt

Nesta página