Локальный API управления и MCP

Когда выбирать этот сервис

Выбирайте локальный API управления, когда программе на компьютере с SSApp нужен разрешённый доступ к приложению и источникам. Используйте встроенный адаптер MCP, чтобы совместимый ИИ-клиент получил эти команды как инструменты.

Это отдельная функция, не связанная с File > Enable Local Server, который запускает ретранслятор WebSocket для страниц Social Stream. См. Описание локальных серверов и сервисов если не уверены, какой сервис нужен.

1. Скачайте обычное настольное приложение

Установите актуальный выпуск Social Stream Ninja со страницы загрузки для Windows, macOS или Linux. Поддержка MCP встроена в скачанное приложение. Репозиторий исходного кода, Node, Python и отдельный пакет MCP не нужны.

2. Включите локальное управление через ИИ

Открыть File > Local AI / Automation.
Включить (Enable) Локальный API управления и дождитесь перезапуска приложения.
Вернитесь в то же меню и выберите Скопировать настройки MCP.
Вставьте скопированный JSON в настройки MCP вашего ИИ-инструмента и перезапустите его.

Скопированные настройки содержат точный путь установленного исполняемого файла, порт и аргументы для вашей платформы. Исполняемый файл Social Stream Ninja запускает собственный лёгкий адаптер MCP, когда ИИ-клиент вызывает его с --ssapp-mcp.

3. Дайте MCP обнаружить возможности

После подключения MCP-клиент автоматически запрашивает инструменты у Social Stream Ninja. Адаптер считывает текущие возможности работающего приложения и передаёт языковой модели схемы поддерживаемых инструментов, версии приложения и API и инструкции. Агенту следует сначала запросить возможности, затем состояние и использовать стабильные идентификаторы источников, возвращённые приложением.

Для обычного использования MCP не нужны сбор данных с сайта или установка навыка. Пользователь может просто попросить подключённого агента проверить Social Stream Ninja или управлять им.

Доступные локальные команды

Получать список источников, просматривать, добавлять, обновлять и удалять их.
Запускать, останавливать или перезагружать один источник либо отфильтрованный набор.
Менять видимость источника, отключение звука и режим подключения.
Читать и менять поддерживаемые общие настройки, перечисленные при обнаружении возможностей.
Читать состояние приложения, сеанса, источников, процессов, захвата и локальных медиа.
Следить за ограниченным потоком событий захваченных источников и возобновляемыми событиями операций или состояния.
Захватывать и безопасно просматривать поддерживаемые страницы источников и окна SSApp.
Выполнять разрешённые действия со страницами, окнами и диалогами с подтверждением.
Перезагружать или корректно закрывать приложение с явным подтверждением.

Ориентируйтесь на возможности работающего приложения. В старых версиях команд может быть меньше.

Прямой доступ по HTTP для локальных скриптов

Скрипты на том же компьютере могут использовать локальный API без MCP. Он принимает подключения только на 127.0.0.1 и не требует токена.

GET http://127.0.0.1:17777/api/v1/capabilities
GET http://127.0.0.1:17777/api/v1/status
GET http://127.0.0.1:17777/api/v1/events
POST http://127.0.0.1:17777/api/v1/command

Используйте объявленные возможности вместо предположения, что во всех версиях приложения команды одинаковы. Готовые к копированию примеры curl для добавления, перечисления, запуска, проверки и остановки источника приведены в пошаговое руководство по серверному HTTP API.

Локальный ИИ на VPS с Ubuntu

API также может обслуживать ИИ-инструмент на том же сервере Linux, где SSApp работает без интерфейса. Оставьте привязку к локальному интерфейсу и используйте скачанный AppImage как команду MCP.

Новый фолловер Запуск Social Stream Ninja без интерфейса по Xvfb, постоянным профилям, командам запуска, systemd и отдельному способу дистанционного управления. Там также есть Настройка MCP для AppImage в Linux для вставки в клиент, работающий на VPS.

Необязательный навык агента

Агенты с поддержкой устанавливаемых навыков могут скачать полный навык Control Social Stream. Также можно прочитать инструкции в интернете, с Справочник API и журнал версий. Навык добавляет рекомендации по работе, но не требуется для подключения MCP.

Машиночитаемые ссылки для обнаружения возможностей также перечислены в llms.txt.

Только локально

Этот интерфейс предназначен для ИИ и автоматизации на том же компьютере, что и SSApp. Не публикуйте его и не прокладывайте туннель для облачного дистанционного управления. Удалённые пользователи и Stream Deck должны использовать существующее подключение Social Stream через WebRTC или WebSocket. Локальный API не предоставляет произвольное выполнение JavaScript, cookie, секреты входа, неограниченные настройки или прямой доступ к файловой системе.

Полный список конечных точек, схем команд, определение версий и границы безопасности приведены в техническом справочнике автоматизации.