Для разработчиков и автоматизированных процессовКросс-платформенный CLI для публичных данных соцсетей.

Одна командная строка для всех публичных соцсетей: изучайте актуальный каталог API, отправляйте задачи на сбор, доводите до конца асинхронные задачи и передавайте нормализованные результаты в shell-скрипты, CI и процессы анализа данных.

Node.js 20+Актуальный реестр возможностей34 платформы279 возможностей API
Быстрый старт

Три шага к первому сбору публичных данных соцсетей

Установите SocQ CLI, безопасно сохраните API-ключ и запустите эндпоинт — с тем же описанием, что используется в документации SocQ, MCP и REST.

01

Установите SocQ CLI

Добавьте опубликованный пакет @socq/cli, чтобы команда socq стала доступна в терминале.

02

Настройте API-ключ

Сохраните ключ в системном хранилище ключей или в защищенной локальной конфигурации.

03

Отправьте первую задачу

Запустите эндпоинт комментариев YouTube и получите нормализованный результат.

В CI передавайте SOCQ_API_KEY через менеджер секретов, чтобы учетные данные оставались защищенными при автоматических запусках.

Полное руководство по CLI
Что умеет SocQ CLI

Выберите команду CLI под вашу задачу

Изучайте API, отправляйте задачи на сбор, проверяйте существующие задачи или выгружайте результаты. Каждая команда работает самостоятельно, и их можно комбинировать в локальном терминале, shell-скриптах и CI, когда этого требует процесс.

Примеры отдельных команд
$ socq tools youtube

Посмотрите актуальные эндпоинты YouTube в реестре возможностей.

Реальные примеры команд

Скопируйте команду и начните собирать публичные данные соцсетей

Эти шесть примеров используют актуальные ID эндпоинтов SocQ и допустимые входные данные. Каждую команду можно скопировать и адаптировать под свой процесс.

01
YouTube Comments API
Эндпоинт: youtube/comments

Соберите публичные комментарии YouTube и дождитесь нормализованных результатов.

02
Twitter Search API
Эндпоинт: x/search

Соберите целевой датасет публичных постов X по поисковому запросу.

03
TikTok Search API
Эндпоинт: tiktok/search

Найдите публичные видео TikTok и выгрузите нормализованные записи.

04
Instagram Comments API
Эндпоинт: instagram/comments

Соберите публичные комментарии по известному URL публикации Instagram.

05
Facebook Ad Library Search API
Эндпоинт: facebook-ad-library/search

Найдите публичные креативы в Facebook Ad Library по ключевому слову.

06
LinkedIn Jobs API
Эндпоинт: linkedin/jobs

Превратите публичную страницу вакансии LinkedIn в структурированные поля вакансии.

Как работает CLI

Отправьте один раз и доведите до полных результатов

SocQ CLI отправляет каждую задачу на сбор как фоновую задачу и возвращает ID задачи. Дождитесь результата в текущей команде с --wait или сохраните ID задачи и возобновите работу позже, а затем читайте нормализованные результаты или получайте доступные файлы.

  1. 01

    Отправка задачи на сбор

    Выполните команду с платформой и ресурсом, чтобы создать фоновую задачу.

  2. 02

    Получение ID задачи

    CLI возвращает уникальный идентификатор, по которому можно ждать, возобновлять задачу и читать результаты.

  3. 03

    Ждать сейчас или возобновить позже

    Используйте --wait сейчас или продолжите ту же задачу позже по ее ID.

  4. 04

    Чтение результатов и файлов

    Выгружайте нормализованные результаты и просматривайте доступные файлы после успешного завершения задачи.

Процесс выполнения в CLI

01 / Отправка задачи на сбор

Выполните нужную команду с платформой и ресурсом. CLI отправит задачу на сбор как фоновую задачу.

task_id: TASK_ID

После отправки CLI возвращает уникальный ID задачи.

Почему SocQ CLI

Одна модель команд — от локального сбора до автоматизированных пайплайнов

SocQ CLI переносит в терминал актуальный каталог API, управление асинхронными задачами и нормализованные результаты. Проверьте команду локально, а затем используйте тот же процесс в shell-скриптах и автоматизированных пайплайнах — без отдельных парсеров для каждой платформы.

Новые возможности API сразу доступны как команды

Платформы, эндпоинты, схемы входных данных и сведения о тарификации берутся из актуального реестра возможностей, поэтому вам не нужно поддерживать второй, фиксированный каталог команд.

АКТУАЛЬНЫЙ РЕЕСТР → АКТУАЛЬНЫЕ КОМАНДЫ

От локальной проверки к автоматизации

Вывод в JSON, JSONL, CSV и в виде таблицы, выгрузка в файл и осмысленные коды выхода делают одну и ту же модель команд надежной в shell-скриптах и автоматизированных пайплайнах.

JSON · JSONL · CSV · КОДЫ ВЫХОДА

Длительные задачи возобновляются без перезапуска

Сохраните ID задачи, чтобы возобновить работу после тайм-аута или прерванного процесса, а затем пройти по страницам результатов и доступным файлам без повторной отправки задачи на сбор.

ОТПРАВКА → TASK_ID → ВОЗОБНОВЛЕНИЕ → РЕЗУЛЬТАТЫ

Выберите интеграцию

Как подключить ваш рабочий процесс к SocQ?

MCP, CLI и REST — способы выполнения запросов, а Agent Skill — слой инструкций для агента. У них общий каталог API и общая модель асинхронных задач, поэтому выбирайте интерфейс, который подходит вашему процессу.

SocQ в терминале и автоматизированных пайплайнах

Единая модель команд: находите API, отправляйте задачи на сбор, возобновляйте асинхронные задачи и выгружайте нормализованные результаты в файлы и автоматизацию.

Подходит для
Разработчики, shell-скрипты и автоматизированные пайплайны
Как это работает
Команды socq + структурированный вывод
Следующий шаг
Установить и запустить SocQ CLI
Использовать CLI

Дополнительно · Agent Skill

Agent Skill

Добавьте инструкции по выбору эндпоинтов, контролю стоимости, пагинации и восстановлению задач. Лучше всего — в связке с MCP, но можно выполнять запросы и через CLI или REST.

Подробнее об Agent Skill
FAQ по CLI

Часто задаваемые вопросы

Что такое SocQ CLI?

SocQ CLI — это инструмент командной строки SocQ. С его помощью можно находить и вызывать API SocQ, отправлять задачи на сбор публичных данных соцсетей, ждать завершения асинхронных задач или возобновлять их и выгружать нормализованные результаты в файлы, скрипты и автоматизированные пайплайны.

Когда стоит использовать SocQ CLI?

Используйте CLI для работы в терминале, shell-скриптов, автоматизированных пайплайнов, пакетного сбора и выгрузки в файлы. Используйте MCP, когда ИИ-клиент должен сам находить и вызывать инструменты, или REST API для долгосрочных интеграций в приложения.

Охватывает ли SocQ CLI весь каталог API SocQ?

Да. CLI получает актуальные платформы, эндпоинты, схемы входных данных и сведения о тарификации из актуального реестра возможностей, поэтому доступные команды соответствуют каталогу API SocQ. Чтобы посмотреть текущие возможности, используйте socq platforms, socq tools и socq describe.

Нужно ли устанавливать SocQ CLI глобально?

Не обязательно. Для регулярной работы установите @socq/cli глобально, чтобы команда socq всегда была под рукой. Для разовых команд или первого знакомства с каталогом API используйте npx @socq/cli.

Нужен ли API-ключ для работы с SocQ CLI?

Просматривать публичный реестр возможностей можно без API-ключа. Для сбора данных, запросов по аккаунту и доступа к задачам и файлам он нужен. Для локальной работы используйте socq auth login, а в автоматизированных пайплайнах передавайте SOCQ_API_KEY через менеджер секретов.

Отменяется ли сбор, если истекло время ожидания?

Нет. Локальный тайм-аут ожидания не отменяет задачу на сервере. Сохраните ID задачи и снова выполните socq task get или socq task wait, чтобы продолжить ту же задачу без повторной отправки.

Какие форматы вывода поддерживает SocQ CLI?

SocQ CLI поддерживает таблицу, JSON, JSONL и CSV. Небольшие результаты удобно читать прямо в терминале, а с --output нормализованные результаты записываются в файл для скриптов, таблиц или анализа данных.

Какие системы и среды выполнения поддерживает SocQ CLI?

Для SocQ CLI нужен Node.js 20 или новее; он работает в Windows, macOS и Linux.

Начните собирать публичные данные соцсетей одной командой

Создать API-ключ