CLI

Клиент командной строки для платформы S.EE, который позволяет создавать и управлять короткими ссылками, текстовыми фрагментами и файлами прямо из терминала.

sdotee/cli

Возможности

Управление короткими URL: создание, обновление и удаление сокращенных ссылок с пользовательскими короткими кодами, доменами и сроком действия
Текстовые фрагменты: публикация кода и заметок через stdin или из файлов
Загрузка файлов: отправка файлов напрямую или через stdin
Управление доменами и метками: просмотр доступных доменов и управление метками
Защита паролем: защита контента паролями
Вывод JSON: машиночитаемый вывод для скриптов

Установка

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
# или готовый бинарный пакет
yay -S see-cli-bin

Сборка из исходного кода

go install github.com/sdotee/cli@latest

Скачайте предварительно собранные бинарники и пакеты на GitHub Releases.

Настройка

Укажите API-ключ через переменную окружения или флаг:

# Переменная окружения (рекомендуется)
export SEE_API_KEY="your-api-key"

# Или используйте флаг
see --api-key "your-api-key" <command>

Параметры конфигурации

Параметр	Переменная окружения	Описание
`--api-key`	`SEE_API_KEY`	Ваш API-ключ S.EE (обязательно)
`--base-url`	`SEE_BASE_URL`	Пользовательский базовый URL API
`--timeout`	`SEE_TIMEOUT`	Таймаут запроса
`--json`	-	Включает JSON-вывод

Команды

Домены и метки

# Показать доступные домены для коротких URL
see domains

# Показать доступные домены для загрузки файлов
see file domains

# Показать ваши метки
see tags

Короткие URL

# Создать короткий URL
see url create https://example.com

# Создать с дополнительными параметрами
see url create https://example.com \
  --slug my-link \
  --domain s.ee \
  --title "My Link" \
  --password secret \
  --expires 2024-12-31

# Обновить короткий URL
see url update --domain s.ee --slug my-link --title "New Title"

# Удалить короткий URL
see url delete --domain s.ee --slug my-link

Текстовые фрагменты

# Создать текст из stdin
echo "Hello World" | see text create --title "greeting"

# Создать текст из файла
see text create --file ./snippet.txt --title "Code Snippet"

# Создать с параметрами
cat script.sh | see text create \
  --title "Shell Script" \
  --domain fs.to \
  --password secret \
  --expires 2024-12-31

# Обновить текст
see text update --domain fs.to --slug abc123 --title "Updated Title"

# Удалить текст
see text delete --domain fs.to --slug abc123

Загрузка файлов

# Загрузить файл
see file upload ./image.png

# Загрузить с пользовательским доменом
see file upload ./document.pdf --domain fs.to

# Загрузить из stdin
cat image.png | see file upload --stdin --filename image.png

# Удалить файл
see file delete <delete-hash>

JSON-вывод

Используйте флаг --json, чтобы получить машиночитаемый вывод для скриптов:

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

Примеры

Создать короткую ссылку и скопировать ее в буфер обмена (macOS)

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

Загрузить скриншот и получить URL (Linux)

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

Массовое создание коротких ссылок

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

На этой странице