S.EE Docs
Desarrolladores

CLI

Cliente de línea de comandos para la plataforma S.EE

Un cliente de línea de comandos para la plataforma S.EE que le permite crear y gestionar URL cortas, fragmentos de texto y archivos directamente desde su terminal.

Funciones

  • Gestión de URL cortas: cree, actualice y elimine enlaces acortados con slugs personalizados, dominios y vencimiento
  • Fragmentos de texto: comparta fragmentos de código y notas desde stdin o archivos
  • Subida de archivos: suba archivos directamente o mediante stdin
  • Gestión de dominios y etiquetas: liste dominios disponibles y gestione etiquetas
  • Protección con contraseña: proteja su contenido con contraseñas
  • Salida JSON: salida legible por máquina para scripts

Instalación

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

Desde el código fuente

go install github.com/sdotee/cli@latest

Descargue binarios y paquetes precompilados desde GitHub Releases.

Configuración

Defina su clave API mediante una variable de entorno o un flag:

# Variable de entorno (recomendada)
export SEE_API_KEY="your-api-key"

# O use el flag
see --api-key "your-api-key" <command>

Opciones de configuración

OpciónVariable de entornoDescripción
--api-keySEE_API_KEYSu clave API de S.EE (obligatoria)
--base-urlSEE_BASE_URLURL base personalizada de la API
--timeoutSEE_TIMEOUTTiempo de espera de la solicitud
--json-Activa el formato de salida JSON

Comandos

Dominios y etiquetas

# Listar dominios disponibles para URL cortas
see domains

# Listar dominios disponibles para subidas de archivos
see file domains

# Listar sus etiquetas
see tags

URL cortas

# Crear una URL corta
see url create https://example.com

# Crear con opciones personalizadas
see url create https://example.com \
  --slug my-link \
  --domain s.ee \
  --title "My Link" \
  --password secret \
  --expires 2024-12-31

# Actualizar una URL corta
see url update --domain s.ee --slug my-link --title "New Title"

# Eliminar una URL corta
see url delete --domain s.ee --slug my-link

Fragmentos de texto

# Crear texto desde stdin
echo "Hello World" | see text create --title "greeting"

# Crear texto desde un archivo
see text create --file ./snippet.txt --title "Code Snippet"

# Crear con opciones
cat script.sh | see text create \
  --title "Shell Script" \
  --domain fs.to \
  --password secret \
  --expires 2024-12-31

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

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

Subida de archivos

# Subir un archivo
see file upload ./image.png

# Subir con dominio personalizado
see file upload ./document.pdf --domain fs.to

# Subir desde stdin
cat image.png | see file upload --stdin --filename image.png

# Eliminar un archivo
see file delete <delete-hash>

Salida JSON

Use el flag --json para obtener una salida legible por máquina, útil para scripts:

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

Ejemplos

Crear una URL corta y copiarla al portapapeles (macOS)

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

Subir una captura de pantalla y obtener la URL (Linux)

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

Crear URL cortas por lotes

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

En esta página