MCPданные соцсетейруководство по API

Руководство по SocQ MCP: данные соцсетей в Cursor, Claude и Codex

Как подключить Codex, Claude, Cursor и VS Code к SocQ MCP, выбрать набор инструментов и собирать публичные данные соцсетей через асинхронные задачи.

SocQОбновлено 10 сентября 2026 г.10 мин чтения

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

В этом руководстве показано, как подключить Codex, Claude, Cursor и VS Code, выбрать набор инструментов, отправить сбор данных и продолжать опрашивать ту же задачу. Подробности настройки — на странице MCP. Копируйте сгенерированную конфигурацию оттуда, а не придумывайте поля.

SocQ MCP

Коротко: подключитесь к облачному эндпоинту Streamable HTTP https://api.socq.ai/mcp. Поиск по каталогу работает без ключа. Для сбора данных нужен API-ключ SocQ. В компактном режиме цепочка выглядит так: socq_search_endpoints → socq_describe_endpoint → socq_execute, после чего вы продолжаете возвращенную задачу. Не воспринимайте вызов execute как синхронную выгрузку всех строк.

Официальные API платформ или публичный MCP?

Официальные продукты Instagram, X, YouTube и подобных платформ остаются правильным путем, когда пользователь авторизует публикацию, обмен сообщениями, рекламу или закрытую статистику. MCP таких разрешений не добавляет.

SocQ MCP — путь к публичным данным. Агент может вызывать только возможности, которые уже есть в каталоге API. Он не может публиковать, не может читать закрытые аккаунты и не может придумать эндпоинт, которого нет в реестре. REST, MCP и CLI выполняют одни и те же задачи. Agent Skill помогает агенту выбирать эндпоинты и оценивать расход кредитов; это не второй сервис данных. Если продукт уже работает по HTTP, оставайтесь на REST. Если оператор живет в терминале или в задаче CI, используйте CLI. Если оператор — агент в IDE, используйте MCP.

Выбирайте набор инструментов, а не угадывайте эндпоинт

MCP-клиент видит только инструменты, которые открыты в текущем подключении. Выберите набор на странице /mcp, затем скопируйте соответствующий адрес.

НаборАдресЧто видно клиентуЛучше всего для
Компактный/mcpИнструменты поиска, выполнения, задач, файлов и аккаунтаИсследования, которые могут переходить между платформами
Платформы/mcp?platforms=youtube,tiktokТипизированные инструменты сбора для пяти платформ максимум, плюс инструменты задач, файлов и аккаунтаАгенты, которые работают с известным набором платформ
Точные инструменты/mcp?tools=youtube_comments,x_searchДо тридцати типизированных инструментов, плюс инструменты задач, файлов и аккаунтаСтабильные сценарии с контролируемым списком инструментов

platforms и tools взаимоисключающие. После изменения фильтра переподключите клиент, чтобы он обновил tools/list. Компактное подключение, которое ни разу не переподключалось, продолжит отдавать прежний список инструментов.

Внутри набора вы всё равно выбираете конкретную возможность каталога. Компактный режим ищет по реестру. Режимы платформ и точных инструментов вызывают типизированный инструмент, схема входных данных которого совпадает с телом REST-запроса для этого ресурса.

Разумный вариант по умолчанию:

  • Начинайте с компактного режима, когда вопрос может перескочить с комментариев YouTube на поиск в X и затем на запрос по Shop.
  • Переходите на платформы, когда агент работает только с двумя-тремя сетями.
  • Переходите на точные инструменты, когда продакшен-оценка должна видеть зафиксированный список инструментов.

Не оставляйте подключение на пять платформ, чтобы потом просить модель «заодно попробовать Amazon». Переподключитесь с Amazon в фильтре или вернитесь к компактному режиму.

Подключите клиент и не храните ключ в Git

Настройка состоит из трех шагов, как и на странице MCP:

  1. Выберите компактный режим, платформы или точные инструменты.
  2. Выберите Codex, Claude, Cursor или VS Code.
  3. Скопируйте сгенерированную конфигурацию и переподключитесь.

Файлы клиентов и способы подключения:

КлиентФайл конфигурацииКак подключается
Codex~/.codex/config.tomlУдаленный HTTP к облачному URL Streamable HTTP
Claudeclaude_desktop_config.jsonstdio-мост @socq/mcp, Node.js 20+
Cursor.cursor/mcp.jsonstdio-мост @socq/mcp
VS Codemcp.jsonstdio-мост, ключ передается как вводимое значение (prompt input)

Для поиска платформ, эндпоинтов и схем ключ не нужен. Для сбора данных, аккаунта, результатов задач и файлов — нужен. Храните SOCQ_API_KEY в переменной окружения или в защищенном поле ввода клиента. Не коммитьте ключ.

Общий набросок для Streamable HTTP выглядит так. Лучше используйте файл, который страница MCP генерирует для вашего клиента; не добавляйте недокументированные поля.

{
  "mcpServers": {
    "socq": {
      "url": "https://api.socq.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${SOCQ_API_KEY}"
      }
    }
  }
}

Codex обращается к облачному URL напрямую. Claude, Cursor и VS Code обычно подключаются к нему через опубликованный мост @socq/mcp. После сохранения перезапустите клиент или переподключите в нем сервер SocQ.

REST и MCP — одна и та же возможность

У каждого сбора данных есть путь REST, ID эндпоинта и имя типизированного инструмента. В компактном режиме бизнес-поля передаются внутри input. Типизированные инструменты открывают эту схему напрямую.

POST /v1/tiktok/profiles
  = endpoint id tiktok-profiles
  = typed tool tiktok_profiles

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

Отправьте сбор, затем опрашивайте ту же задачу

Компактный режим — это переход через три инструмента плюс продолжение задачи:

natural-language request
  → socq_search_endpoints
  → socq_describe_endpoint
  → socq_execute(endpoint, input)
  → task_id
  → socq_get_task
  → results.items

socq_execute проверяет бизнес-входные данные и создает асинхронную задачу сбора. Он может недолго подождать, а затем вернуть текущий статус. Если задача все еще в статусе queued или running, продолжайте с тем же task_id. Тайм-аут клиента не отменяет сбор.

Когда задача успешно завершится, читайте results.items. Пока has_more равно true, передавайте next_cursor без изменений. Не отправляйте тот же профиль Instagram или имя пользователя TikTok повторно только потому, что первая страница оказалась короткой.

Режимы платформ и точных инструментов пропускают поиск, если типизированный инструмент уже есть в контексте. Контракт задачи не меняется: создать один раз, сохранить ID, опрашивать, листать страницы.

Пример намерения для компактного режима (не скриншот чата):

Collect the public TikTok profile for @tiktok.
Describe the tiktok/profiles input first.
Execute, wait for the task, then return username, name, visible metrics, and collected_at.

Агент должен вернуть ID задачи и нормализованные элементы, а не утверждение, что «профиль пришел в одном синхронном результате инструмента».

Сохраняйте ту же служебную запись, что и для REST:

  • Выбранный ID эндпоинта или имя типизированного инструмента.
  • Канонические бизнес-входные данные.
  • ID задачи.
  • Первый увиденный статус и итоговый статус.
  • Последний использованный next_cursor.

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

Чистота входных данных остается на вас

MCP не ослабляет проверки REST.

  • Компактный input должен соответствовать схеме эндпоинта, которую возвращает socq_describe_endpoint.
  • Типизированные инструменты открывают те же обязательные поля, что и POST /v1/{platform}/{resource}.
  • Убирайте @ или последовательно оставляйте его. Преобразуйте URL профилей в имена пользователей в промпте или на предварительном шаге.
  • Не отправляйте URL видео в поле имени пользователя, а имя пользователя — в поле URL статуса.
  • Используйте results_limit как верхнюю границу. Каталог не обещает полноты.
  • Если в наборе нет нужной платформы, переподключитесь с фильтром platforms или tools, который ее включает. Не просите модель «всё равно вызвать TikTok».

Записывайте выбранный ID эндпоинта, входные данные и ID задачи в собственный журнал. Агенты забывают; ваша таблица задач не должна.

Читайте нормализованные поля, а не текст чата

Успешные элементы используют ту же обертку, что и REST: id, platform, resource, type, url, author, metrics, created_at, collected_at и extra, если оно есть.

Попросите агента сохранять null. Скрытое число подписчиков — не ноль. Отсутствующая расшифровка — не «речи нет». URL медиа — это ссылки на источник.

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

Минимальные проверки, прежде чем доверять строке, которую пересказал агент:

  • platform и resource соответствуют выполненному инструменту.
  • Есть хотя бы одно из полей id или url.
  • Метрики — числа или null, а не принудительно подставленные нули.
  • collected_at присутствует и не скопирован в created_at.
  • Текстовый ответ можно проследить до results.items, а не до памяти модели.

Просите агента цитировать поля, а не «приводить в порядок» отсутствующие значения.

Частота обновления для агентов

У MCP-подключений и задач сбора разные часы.

ОбъектРазумная практикаПричина
Набор инструментовПереподключаться после каждого изменения фильтраКлиенты кешируют tools/list
Поиск по каталогуПовторять socq_search_endpoints, когда меняется вопросКаталог живой; прежнее совпадение может оказаться не тем ресурсом
Задача сбораОпрашивать тот же IDПовторная отправка дублирует работу
Сущности вроде профилейРаз в неделю или в месяцИдентификационные поля меняются медленно
Публикации, комментарии, реклама, товарыОт раза в час до раза в день, пока активныПубличные метрики и объявления меняются быстрее
Продакшен-серверы с точными инструментамиМенять инструменты только в плановом релизеНеожиданные списки инструментов ломают оценки

Не обновляйте завершенную задачу, чтобы «сделать ее синхронной». Запускайте новую задачу, только когда действительно изменились входные данные или временное окно.

Типичные сбои

Агент сообщает, что платформы нет

Текущее подключение может не поддерживать компактный режим, быть ограничено другими платформами или по-прежнему держать старый tools/list. Откройте /mcp, задайте набор, скопируйте конфигурацию и переподключитесь.

Сбор отклонен без понятного описания

Поиску по каталогу ключ не нужен. Выполнению — нужен. Проверьте SOCQ_API_KEY в переменной окружения или в поле ввода VS Code.

Первый вызов инструмента «завершился» без строк

Задача асинхронная. Прочитайте статус задачи. Продолжайте вызывать socq_get_task, прежде чем считать ее неудачной или отправлять повторно.

Агент придумывает инструмент публикации или доступа к закрытым данным

Такой возможности нет в каталоге. Остановитесь. Для записи и закрытой статистики используйте официальный продукт с OAuth.

Пагинация остановилась раньше времени

has_more и next_cursor — часть результата, а не необязательное украшение. Пройдите курсор до конца или зафиксируйте, что остановились намеренно.

Изменение фильтра ничего не дало

platforms и tools нельзя комбинировать. После переключения переподключитесь.

Ответственное использование

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

Не просите агента:

  • Публиковать, отвечать или отправлять личные сообщения.
  • Открывать закрытое представление или представление после входа в аккаунт.
  • Считать socq_execute готовым датасетом.
  • Комбинировать platforms и tools в одном URL.
  • Прописывать действующий API-ключ в закоммиченный файл конфигурации.

SocQ MCP — это техническое подключение. Оно не дает дополнительных прав на контент и не превращает неофициальный парсинг в официальную интеграцию.

Соблюдайте то же правило минимизации данных, что и в REST-воркере: соберите публичные поля, нужные для задачи, и остановитесь. Агент с компактным доступом ко всему каталогу охотно продолжит находить эндпоинты, о которых вы не просили. Ограниченные наборы инструментов существуют именно поэтому.

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

SocQ MCP — это второй API соцсетей?

Нет. Это еще один путь к тому же каталогу, который используют REST и CLI.

Можно ли пользоваться им без API-ключа?

Можно искать платформы, эндпоинты и схемы. Для сбора данных, аккаунта, результатов задач и файлов нужен ключ.

Почему компактный режим не показывает каждый API отдельным инструментом?

Компактный режим ищет и описывает эндпоинт по мере необходимости, поэтому полный набор схем не попадает в контекст модели.

Возвращает ли execute все строки сразу?

Нет. Он возвращает задачу. Продолжайте эту задачу и листайте страницы results.items.

Может ли агент публиковать в X или читать закрытый аккаунт Instagram?

Нет. Он может вызывать только публичные возможности каталога.

Когда стоит добавить Skill?

Когда агенту нужно выбирать эндпоинты и оценивать расход кредитов в многошаговой задаче. Выполнение по-прежнему идет через MCP. Подробности — на странице /skill.

Где скопировать настоящую конфигурацию клиента?

На странице /mcp: выберите набор, выберите клиент, скопируйте конфигурацию и переподключитесь.

MULTI-PLATFORM API

Проверить сценарий на публичном URL Multi-platform

Отправляйте публичные входные данные и получайте нормализованные записи с отслеживаемым источником.

API для Multi-platform