Публичные данные соцсетей с разных платформчерез MCP для ИИ-агентов.
Подключите один раз — и ваш агент сам найдет и вызовет нужные API публичных данных соцсетей SocQ.
https://api.socq.ai/mcpКак агент обрабатывает запрос
Запрос на естественном языке
“Соберите последние 100 комментариев к этому видео на YouTube, дождитесь завершения задачи и верните текст комментария, автора, время публикации и число лайков.”
Поиск эндпоинта
socq_search_endpoints
socq_describe_endpointsocq_execute
POST /mcp
{ "endpoint": "…", "input": { … } }task_id
202 Accepted
{ "task_id": "…" }socq_get_task
GET /mcp
{ "task_id": "…" }results.items
200 OK
{ "items": [ … ],
"next_cursor": "…" }Эндпоинт облачного MCP
https://api.socq.ai/mcpTransport: Streamable HTTP
Способ настройки
Выберите, какую часть каталога API будет видеть агент, укажите клиент и скопируйте конфигурацию, сгенерированную по актуальному реестру платформ и эндпоинтов SocQ.
Храните API-ключ в переменной окружения и подключите Codex напрямую к облачному эндпоинту SocQ с транспортом Streamable HTTP.
Клиент
~/.codex/config.tomlКонфигурация[mcp_servers.socq]url = "https://api.socq.ai/mcp"bearer_token_env_var = "SOCQ_API_KEY"tool_timeout_sec = 45Что ваш агент может делать с SocQ MCP?
Формулируйте задачу на естественном языке. Агент выберет подходящую возможность, изучит требования к входным данным, отправит задачу на сбор и упорядочит нормализованные результаты, когда задача завершится.
Эндпоинт: youtube/commentsЭндпоинт: x/searchЭндпоинт: facebook-ad-library/searchЭндпоинт: linkedin/jobsЭндпоинт: tiktok-shop/searchЭндпоинт: instagram/postsКак ИИ-агент вызывает SocQ MCP?
Протокол берет на себя MCP-клиент. Вы описываете нужные данные, а агент находит или выбирает инструмент, отправляет задачу на сбор и читает ту же задачу, пока результаты не будут готовы.
Документация по работе с MCPЗапросите данные
Опишите задачу по публичным данным соцсетей на естественном языке: платформу, источник и нужный результат.
запрос пользователяПоиск или выбор инструмента
В компактном режиме агент ищет по реестру возможностей. В режимах «Платформы» и «Точные инструменты» можно сразу вызвать типизированный инструмент.
socq_search_endpoints → socq_describe_endpointОтправка задачи на сбор
SocQ проверяет входные данные, создает асинхронную задачу на сбор и возвращает ее идентификатор.
socq_execute → task_idЧтение и обработка результатов
Агент продолжает работу с той же задачей, читает страницы нормализованных результатов и представляет ответ в нужном формате.
socq_get_task → results.itemsДля ИИ-агентов, работающих с публичными данными разных соцсетей
Одно подключение MCP позволяет агентам находить и вызывать API разных платформ, контролировать, какие инструменты попадают в контекст, и доводить асинхронные задачи на сбор до нормализованных результатов — без отдельной интеграции с каждой платформой.
Одно подключение — весь каталог
Компактный поиск позволяет агенту искать и вызывать любые API из каталога SocQ без настройки отдельного MCP-сервера для каждой платформы.
/mcp → поиск → описание → запускКонтроль контекста инструментов
Переключайтесь между поиском, выбранными платформами и точными типизированными инструментами по мере того, как рабочий процесс становится предсказуемее.
compact | platforms≤5 | tools≤30Полноценный асинхронный процесс
Агенты продолжают исходную задачу, читают нормализованные результаты с курсорной пагинацией и получают файлы, не отправляя повторные задачи на сбор.
task_id → статус → results.items → next_cursorКак подключить ваш рабочий процесс к SocQ?
MCP, CLI и REST — способы выполнения запросов, а Agent Skill — слой инструкций для агента. У них общий каталог API и общая модель асинхронных задач, поэтому выбирайте интерфейс, который подходит вашему процессу.
ИИ-клиенты вызывают SocQ напрямую
Подключите один раз — и агенты сами находят инструменты по запросу на естественном языке, отправляют задачи на сбор и получают результаты асинхронных задач.
- Подходит для
- ИИ-клиенты и агенты для программирования
- Как это работает
- Естественный язык + вызовы инструментов MCP
- Следующий шаг
- Настроить SocQ MCP
Рекомендуемая связка · Инструкции для агента
Agent Skill
Добавьте инструкции по выбору эндпоинтов, контролю стоимости, пагинации и восстановлению задач. Лучше всего — в связке с MCP, но можно выполнять запросы и через CLI или REST.
Часто задаваемые вопросы
Что такое MCP-сервер SocQ?
Это облачный MCP-сервис, который подключает ИИ-клиентов к каталогу API SocQ. После подключения агент может находить возможности, отправлять задачи на сбор публичных данных соцсетей и читать результаты задач.
Как добавить SocQ в Codex, Claude, Cursor или VS Code?
Codex подключается напрямую к облачному эндпоинту Streamable HTTP. Claude Desktop, Cursor и VS Code могут запускать мост stdio @socq/mcp. Скопируйте подходящую конфигурацию выше, укажите SOCQ_API_KEY и переподключите клиент.
Один URL MCP — это только один API?
Нет. Эндпоинт по умолчанию находит и вызывает любые возможности из полного каталога SocQ по ID эндпоинта. В режимах платформ и точных инструментов выбранные возможности можно предоставить как типизированные инструменты.
Почему подключение по умолчанию не показывает каждый API отдельным инструментом?
Компактный режим ищет и описывает эндпоинт только тогда, когда он нужен. Так схемы всего каталога не попадают в контекст модели: расход контекста снижается, а выбор инструментов становится предсказуемее.
Можно ли пользоваться без API-ключа?
Поиск платформ, эндпоинтов и схем открыт для всех. Для сбора данных, операций с аккаунтом, результатов задач и файлов нужен действующий API-ключ SocQ.
Почему задача на сбор не возвращает все результаты сразу?
Сбор данных в SocQ асинхронный. При отправке возвращается ID задачи, и вызов может подождать до 30 секунд. Если задача еще выполняется, агент продолжает через socq_get_task, а не отправляет ее повторно.
Чем MCP отличается от REST API?
Оба используют одни и те же описания возможностей, входные данные, правила оплаты, лимиты и модель асинхронных задач. MCP добавляет поиск и структурированный вызов инструментов, поэтому ИИ-клиенту не нужна написанная вручную HTTP-интеграция.
Как оплачивается использование MCP?
MCP не меняет тарификацию эндпоинтов. Задачи на сбор подчиняются тем же правилам кредитов, лимитам API-ключа и правилам аккаунта, что и в REST. Инструменты поиска не создают задачи на сбор.
К каким данным агент может получить доступ?
Агент может вызывать только возможности по публичным данным соцсетей, доступные в каталоге API SocQ. На странице каждого API описаны поддерживаемые входные данные, объем публичных данных и нормализованные поля результатов.