Lokale Steuerungs-API und MCP

Wann du diesen Dienst wählst

Verwende die lokale Steuerungs-API, wenn Software auf dem SSApp-Computer genehmigte App- und Quellensteuerung benötigt. Verwende den mitgelieferten MCP-Adapter, wenn ein kompatibler KI-Client diese Steuerungen als Werkzeuge erhalten soll.

Dies ist getrennt von File > Enable Local Server, das ein WebSocket-Relay für Social-Stream-Seiten startet. Siehe Lokale Server und Dienste erklärt wenn du nicht sicher bist, welchen Dienst du brauchst.

1. Die normale Desktop-App herunterladen

Installiere das aktuelle Social Stream Ninja Release von der Downloads für Windows, macOS oder Linux. MCP-Unterstützung ist in der heruntergeladenen App enthalten. Du benötigst weder Quellrepository noch Node, Python oder ein separates MCP-Paket.

2. Lokale KI-Steuerung aktivieren

1. Öffnen Datei > Lokale KI / Automatisierung (File > Local AI / Automation).
2. Aktivieren Lokale Steuerungs-API und lass die App neu starten.
3. Kehre zum selben Menü zurück und wähle MCP-Einrichtung kopieren (Copy MCP Setup).
4. Füge das kopierte JSON in die MCP-Einstellungen deines KI-Werkzeugs ein und starte das Werkzeug neu.

Die kopierte Einrichtung enthält den genauen installierten Programmpfad, Port und plattformspezifische Argumente. Die heruntergeladene Social Stream Ninja Programmdatei startet ihren eigenen schlanken MCP-Adapter, wenn der KI-Client sie mit --ssapp-mcp.

3. MCP die Funktionen erkennen lassen

Nach dem Verbinden fragt der MCP-Client automatisch die Werkzeuge von Social Stream Ninja ab. Der Adapter liest die aktuellen Fähigkeiten der laufenden App und liefert dem LLM unterstützte Werkzeugschemas, App-/API-Versionen und Bedienungsanweisungen. Der Agent sollte zuerst capabilities und dann status aufrufen und die von der App zurückgegebenen stabilen Quell-IDs verwenden.

Für die normale MCP-Nutzung sind weder Website-Scraping noch Skill-Installation nötig. Der Benutzer kann den verbundenen Agenten einfach bitten, Social Stream Ninja zu prüfen oder zu steuern.

Verfügbare lokale Steuerelemente

• Quellen auflisten, prüfen, hinzufügen, aktualisieren und entfernen.
• Eine Quelle oder eine gefilterte Auswahl starten, stoppen oder neu laden.
• Sichtbarkeit, Stummschaltung und Verbindungsmodus von Quellen ändern.
• Unterstützte globale Einstellungen lesen und aktualisieren, die die Fähigkeitenerkennung zurückgibt.
• App-, Sitzungs-, Quellen-, Prozess-, Erfassungs- und lokalen Medienstatus lesen.
• Begrenzte Ereignisse erfasster Quellen und fortsetzbare Vorgangs- oder Statusereignisse verfolgen.
• Unterstützte Quellseiten und SSApp-eigene Fenster erfassen und sicher prüfen.
• Genehmigte Interaktionen mit Seiten, Fenstern und Dialogen nach Bestätigung durchführen.
• App mit ausdrücklicher Bestätigung neu laden oder geordnet beenden.

Die Fähigkeiten der laufenden App sind maßgeblich. Ältere Versionen bieten möglicherweise weniger Steuerelemente.

Direkter HTTP-Zugriff für lokale Skripte

Skripte auf demselben Computer können die Loopback-API ohne MCP nutzen. Sie lauscht nur auf 127.0.0.1 und benötigt kein Token.

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

Verwende die gemeldeten Fähigkeiten, statt dieselben Steuerelemente in jeder App-Version vorauszusetzen. Für kopierfertige curl Beispiele zum Hinzufügen, Auflisten, Starten, Prüfen und Stoppen einer Quelle siehe die Anleitung zur Server-HTTP-API.

Lokale KI auf einem Ubuntu-VPS

Die API kann auch einem KI-Werkzeug dienen, das auf demselben Linux-Server wie eine Headless-SSApp-Instanz läuft. Lass sie an Loopback gebunden und verwende die heruntergeladene AppImage als MCP-Befehl.

Follow Social Stream Ninja ohne sichtbare Oberfläche ausführen zu Xvfb, dauerhaften Profilen, Startbefehlen, systemd und dem separaten Fernsteuerungsweg. Er enthält außerdem eine MCP-Konfiguration für Linux-AppImage die du in einen Client auf dem VPS einfügen kannst.

Optionaler Agent-Skill

Agenten, die installierbare Skills unterstützen, können den vollständigen Control Social Stream Skill herunterladen. Du kannst auch seine Anweisungen online lesen, mit der API-Referenz und Versionsprotokoll. Der Skill ergänzt Ablaufanweisungen, ist für die MCP-Verbindung aber nicht erforderlich.

Maschinenlesbare Erkennungslinks stehen auch in llms.txt.

Nur lokal

Diese Schnittstelle ist für KI und Automatisierung auf demselben Computer wie SSApp. Veröffentliche oder tunnele sie nicht als Cloud-Fernsteuerungs-API. Entfernte Benutzer und Stream Deck sollten Social Streams bestehende WebRTC- oder WebSocket-Verbindung nutzen. Die lokale API bietet weder beliebige JavaScript-Ausführung noch Cookies, Anmeldegeheimnisse, uneingeschränkte Einstellungen oder direkten Dateisystemzugriff.

Für vollständige Endpunkte, Befehlsschemas, Versionserkennung und Sicherheitsgrenzen siehe die technische Automatisierungsreferenz.