CLI превращает каждое действие SocialGO в команду, которую можно передать по конвейеру, запланировать и поручить агенту. Ищите по каталогу, оформляйте заказы, отслеживайте их и проверяйте баланс, из терминала, CI-пайплайна или бота.
Установкаnpx @socialgo/cli
Команды5.000+
Что вы на этом строите
Один командный интерфейс. Скрипты, пайплайны и агенты.
Те же команды, на которых работает панель, открытые для кода. Встройте их в shell-скрипт, шаг CI или автономного агента. Каждая команда возвращает чистый код завершения и машиночитаемый JSON.
Скрипты
Объединяйте команды в shell-скрипте: найдите услугу, оформите заказ, опросите статус. Передайте --json и разберите вывод через jq.
Пайплайны
Встройте CLI в шаг CI или cron-задачу. Он возвращает 0 при успехе и ненулевой код при сбое, поэтому ваш пайплайн останавливается, когда останавливается заказ.
Агенты
Поручите команды ИИ-агенту. Он читает каталог, подтверждает ставку и количество, затем оформляет заказ, те же вызовы, что вы набрали бы вручную.
Траты явные. Поиск и список, только чтение; заказ происходит только когда вы запускаете order create с услугой, ссылкой и количеством, в скрипте или вручную. CLI никогда не тратит сам по себе.
Установка
Установите CLI глобально через npm или запускайте по требованию с помощью npx, без установки:
# install globally
npm i -g @socialgo/cli
# or run without installing
npx @socialgo/cli --help
После установки команда socialgo доступна в вашем PATH. Запустите socialgo --help, чтобы вывести список всех команд и флагов.
CLI считывает API-ключ из переменной окружения SOCIALGO_API_KEY. Сгенерируйте ключ в панели, затем экспортируйте его в своей оболочке или в секретах CI:
# macOS / Linux
export SOCIALGO_API_KEY="your_api_key_here"
# Windows (PowerShell)
$env:SOCIALGO_API_KEY="your_api_key_here"
Относитесь к ключу как к паролю. Не храните его в системе контроля версий, используйте секреты для каждого окружения или файл .env, который никогда не коммитится.
Команды
Поиск по каталогу
Находите услуги по ключевому слову. Используйте, чтобы получить id услуги перед оформлением заказа. Только чтение, никогда не тратит:
socialgo services search "instagram followers"
Список услуг
Вывести полный каталог доступных услуг:
socialgo services list
Оформить заказ
Закажите по id услуги, целевой ссылке и количеству. Это единственная команда, которая тратит, она выполняется только когда вы её вызываете:
Просмотрите детали кошелька и недавние транзакции:
socialgo wallet
Админ: синхронизация каталога
Для операторов панели, подтягивайте актуальные услуги и цены от подключённого провайдера в локальный каталог. Требуется админ-ключ:
socialgo admin sync-catalog
Цикл из трёх команд
Найдите услугу, оформите заказ, отследите его, цикл, который выполняет каждый скрипт и агент:
# 1. find the service id
socialgo services search "instagram followers"
# 2. place the order
socialgo order create --service 1423 --link https://instagram.com/yourhandle --quantity 1000
# 3. track it
socialgo order status 90871
Заскриптуйте от начала до конца
Передайте --json любой команде и направьте вывод в jq. Здесь скрипт выбирает самую дешёвую подходящую услугу, затем заказывает её, без кликов:
# pick the cheapest matching service, then order — with jq
id=$(socialgo services search "instagram followers" --json \
| jq -r 'sort_by(.rate) | .[0].id')
socialgo order create --service "$id" \
--link https://instagram.com/yourhandle --quantity 1000 --json
Коды завершения и JSON
Каждая команда возвращает 0 при успехе и ненулевой код при сбое, поэтому вы можете объединять вызовы в CI-пайплайнах и shell-скриптах. Передайте --json любой команде, чтобы получить машиночитаемый вывод для передачи в инструменты вроде jq, или напрямую обратно агенту.
