Установите SocQ CLI
Добавьте опубликованный пакет @socq/cli, чтобы команда socq стала доступна в терминале.
Одна командная строка для всех публичных соцсетей: изучайте актуальный каталог API, отправляйте задачи на сбор, доводите до конца асинхронные задачи и передавайте нормализованные результаты в shell-скрипты, CI и процессы анализа данных.
Установите SocQ CLI, безопасно сохраните API-ключ и запустите эндпоинт — с тем же описанием, что используется в документации SocQ, MCP и REST.
Добавьте опубликованный пакет @socq/cli, чтобы команда socq стала доступна в терминале.
Сохраните ключ в системном хранилище ключей или в защищенной локальной конфигурации.
Запустите эндпоинт комментариев YouTube и получите нормализованный результат.
В CI передавайте SOCQ_API_KEY через менеджер секретов, чтобы учетные данные оставались защищенными при автоматических запусках.
Полное руководство по CLIИзучайте API, отправляйте задачи на сбор, проверяйте существующие задачи или выгружайте результаты. Каждая команда работает самостоятельно, и их можно комбинировать в локальном терминале, shell-скриптах и CI, когда этого требует процесс.
$ socq tools youtubeПосмотрите актуальные эндпоинты YouTube в реестре возможностей.
Эти шесть примеров используют актуальные ID эндпоинтов SocQ и допустимые входные данные. Каждую команду можно скопировать и адаптировать под свой процесс.
Эндпоинт: youtube/commentsСоберите публичные комментарии YouTube и дождитесь нормализованных результатов.
Эндпоинт: x/searchСоберите целевой датасет публичных постов X по поисковому запросу.
Эндпоинт: tiktok/searchНайдите публичные видео TikTok и выгрузите нормализованные записи.
Эндпоинт: instagram/commentsСоберите публичные комментарии по известному URL публикации Instagram.
Эндпоинт: facebook-ad-library/searchНайдите публичные креативы в Facebook Ad Library по ключевому слову.
Эндпоинт: linkedin/jobsПревратите публичную страницу вакансии LinkedIn в структурированные поля вакансии.
SocQ CLI отправляет каждую задачу на сбор как фоновую задачу и возвращает ID задачи. Дождитесь результата в текущей команде с --wait или сохраните ID задачи и возобновите работу позже, а затем читайте нормализованные результаты или получайте доступные файлы.
Выполните команду с платформой и ресурсом, чтобы создать фоновую задачу.
CLI возвращает уникальный идентификатор, по которому можно ждать, возобновлять задачу и читать результаты.
Используйте --wait сейчас или продолжите ту же задачу позже по ее ID.
Выгружайте нормализованные результаты и просматривайте доступные файлы после успешного завершения задачи.
01 / Отправка задачи на сбор
Выполните нужную команду с платформой и ресурсом. CLI отправит задачу на сбор как фоновую задачу.
task_id: TASK_IDПосле отправки CLI возвращает уникальный ID задачи.
SocQ CLI переносит в терминал актуальный каталог API, управление асинхронными задачами и нормализованные результаты. Проверьте команду локально, а затем используйте тот же процесс в shell-скриптах и автоматизированных пайплайнах — без отдельных парсеров для каждой платформы.
Платформы, эндпоинты, схемы входных данных и сведения о тарификации берутся из актуального реестра возможностей, поэтому вам не нужно поддерживать второй, фиксированный каталог команд.
АКТУАЛЬНЫЙ РЕЕСТР → АКТУАЛЬНЫЕ КОМАНДЫ
Вывод в JSON, JSONL, CSV и в виде таблицы, выгрузка в файл и осмысленные коды выхода делают одну и ту же модель команд надежной в shell-скриптах и автоматизированных пайплайнах.
JSON · JSONL · CSV · КОДЫ ВЫХОДА
Сохраните ID задачи, чтобы возобновить работу после тайм-аута или прерванного процесса, а затем пройти по страницам результатов и доступным файлам без повторной отправки задачи на сбор.
ОТПРАВКА → TASK_ID → ВОЗОБНОВЛЕНИЕ → РЕЗУЛЬТАТЫ
MCP, CLI и REST — способы выполнения запросов, а Agent Skill — слой инструкций для агента. У них общий каталог API и общая модель асинхронных задач, поэтому выбирайте интерфейс, который подходит вашему процессу.
Единая модель команд: находите API, отправляйте задачи на сбор, возобновляйте асинхронные задачи и выгружайте нормализованные результаты в файлы и автоматизацию.
Дополнительно · Agent Skill
Добавьте инструкции по выбору эндпоинтов, контролю стоимости, пагинации и восстановлению задач. Лучше всего — в связке с MCP, но можно выполнять запросы и через CLI или REST.
SocQ CLI — это инструмент командной строки SocQ. С его помощью можно находить и вызывать API SocQ, отправлять задачи на сбор публичных данных соцсетей, ждать завершения асинхронных задач или возобновлять их и выгружать нормализованные результаты в файлы, скрипты и автоматизированные пайплайны.
Используйте CLI для работы в терминале, shell-скриптов, автоматизированных пайплайнов, пакетного сбора и выгрузки в файлы. Используйте MCP, когда ИИ-клиент должен сам находить и вызывать инструменты, или REST API для долгосрочных интеграций в приложения.
Да. CLI получает актуальные платформы, эндпоинты, схемы входных данных и сведения о тарификации из актуального реестра возможностей, поэтому доступные команды соответствуют каталогу API SocQ. Чтобы посмотреть текущие возможности, используйте socq platforms, socq tools и socq describe.
Не обязательно. Для регулярной работы установите @socq/cli глобально, чтобы команда socq всегда была под рукой. Для разовых команд или первого знакомства с каталогом API используйте npx @socq/cli.
Просматривать публичный реестр возможностей можно без API-ключа. Для сбора данных, запросов по аккаунту и доступа к задачам и файлам он нужен. Для локальной работы используйте socq auth login, а в автоматизированных пайплайнах передавайте SOCQ_API_KEY через менеджер секретов.
Нет. Локальный тайм-аут ожидания не отменяет задачу на сервере. Сохраните ID задачи и снова выполните socq task get или socq task wait, чтобы продолжить ту же задачу без повторной отправки.
SocQ CLI поддерживает таблицу, JSON, JSONL и CSV. Небольшие результаты удобно читать прямо в терминале, а с --output нормализованные результаты записываются в файл для скриптов, таблиц или анализа данных.
Для SocQ CLI нужен Node.js 20 или новее; он работает в Windows, macOS и Linux.