Ein KI-Client kann über Social-Media-Daten sprechen, ohne zu wissen, welchen Endpunkt er aufrufen soll. Das ist ein Routing-Problem, kein zweiter Katalog. SocQ MCP stellt dieselben APIs für öffentliche Daten bereit wie REST: eine gehostete Adresse, drei Tool-Umfänge und dasselbe asynchrone Aufgabenmodell.
Diese Anleitung zeigt, wie Sie Codex, Claude, Cursor und VS Code verbinden, einen Umfang wählen, eine Erfassung einreichen und dieselbe Aufgabe weiter abfragen. Die Einzelheiten zur Einrichtung stehen auf der MCP-Seite. Kopieren Sie die erzeugte Konfiguration von dort, statt Felder zu erfinden.

Kurze Antwort: Verbinden Sie sich mit dem gehosteten Streamable-HTTP-Endpunkt
https://api.socq.ai/mcp. Die Erkundung funktioniert ohne Schlüssel. Für die Erfassung brauchen Sie einen SocQ-API-Schlüssel. Der Kompaktmodus geht übersocq_search_endpoints→socq_describe_endpoint→socq_executeund führt dann die zurückgegebene Aufgabe fort. Behandeln Sie diesen Execute-Aufruf nicht als synchrone Ausgabe aller Zeilen.
Offizielle Plattform-APIs oder ein öffentlicher MCP-Server?
Die offiziellen Produkte von Instagram, X, YouTube und ähnlichen Plattformen bleiben der richtige Zugang, wenn ein Nutzer Veröffentlichung, Nachrichten, Werbung oder private Insights autorisiert. MCP fügt diese Berechtigungen nicht hinzu.
SocQ MCP ist ein Zugang für öffentliche Daten. Ein Agent kann nur Funktionen aufrufen, die bereits im API-Katalog existieren. Er kann nichts veröffentlichen, keine privaten Konten lesen und keinen Endpunkt erfinden, der nicht im Register steht. REST, MCP und die CLI führen dieselben Aufträge aus. Der Agent Skill hilft einem Agenten, Endpunkte zu wählen und Credits zu schätzen; er ist kein zweiter Datendienst. Spricht das Produkt bereits HTTP, bleiben Sie bei REST. Arbeitet der Bediener im Terminal oder in einem CI-Job, nutzen Sie die CLI. Ist der Bediener ein Agent in einer IDE, nutzen Sie MCP.
Einen Tool-Umfang wählen, keinen geratenen Endpunkt
Ein MCP-Client sieht nur die Tools, die die aktuelle Verbindung bereitstellt. Wählen Sie den Umfang auf /mcp und kopieren Sie dann die passende Adresse.
| Umfang | Adresse | Sichtbare Oberfläche | Geeignet für |
|---|---|---|---|
| Kompakt | /mcp | Tools für Erkundung, Ausführung, Aufgaben, Dateien und Konto | Erkundung, die über mehrere Plattformen wandern kann |
| Plattformen | /mcp?platforms=youtube,tiktok | Typisierte Tools zur Erfassung für bis zu fünf Plattformen sowie Tools für Aufgaben, Dateien und Konto | Agenten, die bei einer bekannten Menge von Plattformen bleiben |
| Exakte Tools | /mcp?tools=youtube_comments,x_search | Bis zu dreißig typisierte Tools sowie Tools für Aufgaben, Dateien und Konto | Stabile Workflows mit kontrollierter Tool-Liste |
platforms und tools schließen sich gegenseitig aus. Nachdem Sie einen Filter geändert haben, verbinden Sie den Client neu, damit er tools/list aktualisiert. Eine Kompaktverbindung, die nie neu verbunden wird, liefert weiter die vorherige Tool-Liste.
Innerhalb dieses Umfangs wählen Sie weiterhin eine konkrete Funktion des Katalogs. Der Kompaktmodus durchsucht das Register. Die Modi Plattformen und Exakte Tools rufen ein typisiertes Tool auf, dessen Eingabeschema zum REST-Body dieser Ressource passt.
Eine brauchbare Faustregel:
- Beginnen Sie kompakt, wenn die Frage von YouTube-Kommentaren über die Suche auf X bis zu einer Abfrage zu Shop springen kann.
- Wechseln Sie zu Plattformen, wenn der Agent immer nur mit zwei oder drei Netzwerken arbeitet.
- Wechseln Sie zu Exakten Tools, wenn eine Evaluierung im Produktivbetrieb eine eingefrorene Tool-Liste sehen muss.
Behalten Sie keine Verbindung mit fünf Plattformen, um das Modell dann zu bitten: „Versuch es auch mit Amazon.“ Verbinden Sie neu mit Amazon im Filter oder kehren Sie zum Kompaktmodus zurück.
Einen Client verbinden und den Schlüssel aus Git heraushalten
Die Einrichtung erfolgt in drei Schritten, auf derselben Ebene wie die MCP-Seite:
- Wählen Sie Kompakt, Plattformen oder Exakte Tools.
- Wählen Sie Codex, Claude, Cursor oder VS Code.
- Kopieren Sie die erzeugte Konfiguration und verbinden Sie neu.
Dateien und Transporte der Clients:
| Client | Konfigurationsdatei | Art der Verbindung |
|---|---|---|
| Codex | ~/.codex/config.toml | Remote-HTTP zur gehosteten Streamable-HTTP-URL |
| Claude | claude_desktop_config.json | stdio-Bridge @socq/mcp, Node.js 20+ |
| Cursor | .cursor/mcp.json | stdio-Bridge @socq/mcp |
| VS Code | mcp.json | stdio-Bridge, der Schlüssel als Eingabe per Prompt |
Die Erkundung von Plattformen, Endpunkten und Schemas erfordert keinen Schlüssel. Erfassung, Konto, Aufgabenergebnisse und Dateien erfordern einen. Legen Sie SOCQ_API_KEY in der Umgebung oder in der geschützten Prompt-Eingabe des Clients ab. Committen Sie den Schlüssel nicht.
Eine allgemeine Skizze für Streamable HTTP sieht so aus. Bevorzugen Sie die Datei, die die MCP-Seite für Ihren Client ausgibt; fügen Sie keine undokumentierten Felder hinzu.
{
"mcpServers": {
"socq": {
"url": "https://api.socq.ai/mcp",
"headers": {
"Authorization": "Bearer ${SOCQ_API_KEY}"
}
}
}
}
Codex spricht diese gehostete URL direkt an. Claude, Cursor und VS Code erreichen sie üblicherweise über die veröffentlichte Bridge @socq/mcp. Starten Sie nach dem Speichern den SocQ-Server im Client neu oder verbinden Sie ihn neu.
REST und MCP teilen sich eine Funktion
Jede Erfassung hat einen REST-Pfad, eine Endpunkt-ID und einen Namen für das typisierte Tool. Der Kompaktmodus legt die fachlichen Felder in input. Typisierte Tools stellen dieses Schema direkt bereit.
POST /v1/tiktok/profiles
= endpoint id tiktok-profiles
= typed tool tiktok_profiles
Abrechnung, Limits und der Rahmen der Aufgabe ändern sich nicht, wenn Sie den Zugang wechseln. Tools zur Erkundung erzeugen keine Aufträge zur Erfassung. Lehnt REST eine Liste von Benutzernamen ab, lehnt MCP sie ebenfalls ab.
Eine Erfassung einreichen und dann dieselbe Aufgabe abfragen
Der Kompaktmodus ist ein Weg über drei Tools plus Fortführung der Aufgabe:
natural-language request
→ socq_search_endpoints
→ socq_describe_endpoint
→ socq_execute(endpoint, input)
→ task_id
→ socq_get_task
→ results.items
socq_execute validiert die fachliche Eingabe und erzeugt eine asynchrone Erfassung. Es kann kurz warten und gibt dann den aktuellen Status zurück. Ist die Aufgabe noch queued oder running, fahren Sie mit derselben task_id fort. Eine Zeitüberschreitung des Clients bricht die Erfassung nicht ab.
Ist die Aufgabe erfolgreich, lesen Sie results.items. Solange has_more wahr ist, übergeben Sie next_cursor unverändert. Reichen Sie dasselbe Instagram-Profil oder denselben TikTok-Benutzernamen nicht erneut ein, nur weil die erste Seite kurz war.
Die Modi Plattformen und Exakte Tools überspringen die Suche, wenn das typisierte Tool bereits im Kontext ist. Der Vertrag der Aufgabe ändert sich nicht: einmal erzeugen, die ID speichern, abfragen, paginieren.
Beispiel für eine Absicht im Kompaktmodus, kein Screenshot eines Chats:
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.
Der Agent sollte mit einer Aufgaben-ID und normalisierten Einträgen zurückkommen, nicht mit der Behauptung, „das Profil sei in einem synchronen Tool-Ergebnis angekommen“.
Speichern Sie dieselbe operative Zeile, die Sie auch für REST speichern würden:
- Gewählte Endpunkt-ID oder Name des typisierten Tools.
- Kanonische fachliche Eingabe.
- Aufgaben-ID.
- Zuerst beobachteter Status und Endstatus.
- Zuletzt verbrauchter
next_cursor.
Stirbt der Prozess des Agenten, setzen Sie diese Aufgabe fort. Lassen Sie keine Schleife mit Wiederholungen fünf identische TikTok-Profil-Jobs öffnen.
Sauberkeit der Eingaben bleibt Ihre Aufgabe
MCP lockert die Validierung von REST nicht.
- Die
inputim Kompaktmodus muss zum Endpunktschema passen, dassocq_describe_endpointzurückgibt. - Typisierte Tools stellen dieselben Pflichtfelder bereit wie
POST /v1/{platform}/{resource}. - Entfernen Sie
@oder behalten Sie es durchgängig bei. Wandeln Sie Profil-URLs im Prompt oder in einem Vorschritt in Benutzernamen um. - Senden Sie keine Video-URL an ein Feld für Benutzernamen und keinen Benutzernamen an ein Feld für Status-URLs.
- Behandeln Sie
results_limitals Obergrenze. Der Katalog verspricht keine Vollständigkeit. - Fehlt die Plattform im Umfang, verbinden Sie neu mit einem Filter für Plattformen oder Tools, der sie enthält. Bitten Sie das Modell nicht, „TikTok trotzdem einfach aufzurufen“.
Schreiben Sie die gewählte Endpunkt-ID, die Eingaben und die Aufgaben-ID in Ihr eigenes Log. Agenten vergessen; Ihre Job-Tabelle sollte es nicht.
Normalisierte Felder lesen, nicht Prosa aus dem Chat
Erfolgreiche Einträge nutzen denselben Rahmen wie REST: id, platform, resource, type, url, author, metrics, created_at, collected_at und, falls vorhanden, extra.
Bitten Sie den Agenten, Nullwerte beizubehalten. Eine verborgene Follower-Zahl ist nicht null. Ein fehlendes Transkript bedeutet nicht „keine Sprache“. URLs von Medien sind Quellenverweise.
Brauchen Sie Dateien, rufen Sie diese mit dem Datei-Tool für diese Aufgabe ab. Brauchen Sie eine weitere Seite, behalten Sie den Cursor. Brauchen Sie eine andere Ressource, beschreiben und führen Sie diese Ressource aus; formen Sie die erste Nutzlast nicht zu einem erfundenen zweiten Schema um.
Mindestprüfungen, bevor Sie einer vom Agenten zusammengefassten Zeile vertrauen:
platformundresourcepassen zum ausgeführten Tool.- Mindestens eines von
idoderurlist vorhanden. - Kennzahlen sind Zahlen oder null, niemals erzwungene Nullen.
collected_atist vorhanden und nicht increated_atkopiert.- Die Antwort in Prosa lässt sich auf
results.itemszurückführen, nicht auf das Gedächtnis des Modells.
Bitten Sie den Agenten, Felder zu zitieren, und nicht, fehlende Werte „aufzuräumen“.
Aktualisierungsrhythmus für Agenten
MCP-Verbindungen und Aufträge zur Erfassung laufen nach unterschiedlichen Uhren.
| Objekt | Sinnvolle Gewohnheit | Grund |
|---|---|---|
| Tool-Umfang | Nach jeder Änderung des Filters neu verbinden | Clients speichern tools/list zwischen |
| Erkundung | socq_search_endpoints wiederholen, wenn sich die Frage ändert | Der Katalog ist live; der vorherige Treffer kann die falsche Ressource sein |
| Aufgabe zur Erfassung | Dieselbe ID abfragen | Erneutes Einreichen dupliziert Arbeit |
| Profilartige Entitäten | Wöchentlich oder monatlich | Identitätsfelder ändern sich langsam |
| Beiträge, Kommentare, Anzeigen, Produkte | Stündlich bis täglich, solange aktiv | Öffentliche Kennzahlen und Anzeigen ändern sich schneller |
| Produktivserver mit exakten Tools | Tools nur bei einem geplanten Release ändern | Überraschende Tool-Listen brechen Evaluierungen |
Aktualisieren Sie eine abgeschlossene Aufgabe nicht, um sie „synchron zu machen“. Starten Sie nur dann eine neue Aufgabe, wenn sich die Eingaben oder das Zeitfenster tatsächlich geändert haben.
Häufige Fehlerbilder
Der Agent sagt, die Plattform fehle
Die aktuelle Verbindung kennt den Kompaktmodus womöglich nicht, ist auf andere Plattformen beschränkt oder hält noch ein altes tools/list. Öffnen Sie /mcp, legen Sie den Umfang fest, kopieren Sie die Konfiguration und verbinden Sie neu.
Die Erfassung wird abgelehnt, ohne dass ein nützliches Profil vorliegt
Die Erkundung braucht keinen Schlüssel. Die Ausführung schon. Prüfen Sie SOCQ_API_KEY in der Umgebung oder in der Prompt-Eingabe von VS Code.
Der erste Aufruf des Tools war „fertig“, aber ohne Zeilen
Der Job ist asynchron. Lesen Sie den Status der Aufgabe. Setzen Sie socq_get_task fort, bevor Sie einen Fehler annehmen oder erneut einreichen.
Der Agent erfindet ein Tool zum Veröffentlichen oder für private Daten
Diese Funktion steht nicht im Katalog. Brechen Sie ab. Nutzen Sie für Schreibzugriffe und private Insights ein offizielles OAuth-Produkt.
Die Paginierung endete zu früh
has_more und next_cursor sind Teil des Ergebnisses, keine optionale Dekoration. Arbeiten Sie den Cursor ab oder halten Sie fest, dass Sie absichtlich aufgehört haben.
Die Änderung des Filters bewirkte nichts
platforms und tools lassen sich nicht kombinieren. Verbinden Sie nach dem Wechsel neu.
Verantwortungsvolle Nutzung
Erfassen Sie nur öffentliche Daten, die für einen legitimen Zweck nötig sind. Bitten Sie einen Agenten nicht, private Konten, Logins oder Zugriffskontrollen zu umgehen. Halten Sie Schlüssel aus Prompts heraus, die Sie in Tickets einfügen. Prüfen Sie die Bedingungen der Plattformen und Ihre eigenen Regeln zur Aufbewahrung.
Bitten Sie den Agenten nicht:
- Etwas zu veröffentlichen, zu antworten oder eine DM zu senden.
- Eine private Ansicht oder eine Ansicht mit Login zu öffnen.
socq_executeals fertigen Datensatz zu behandeln.platformsundtoolsin einer URL zu kombinieren.- Einen aktiven API-Schlüssel fest in eine committete Konfigurationsdatei zu schreiben.
SocQ MCP ist eine technische Verbindung. Es gewährt keine zusätzlichen Rechte an Inhalten und macht aus einem inoffiziellen Scrape keine offizielle Integration.
Behalten Sie dieselbe Regel zur Datensparsamkeit bei, die Sie in einem REST-Worker anwenden würden: Erfassen Sie die öffentlichen Felder, die das Ticket braucht, und hören Sie dann auf. Ein Agent mit Kompaktzugriff auf den gesamten Katalog entdeckt gern weiter Endpunkte, nach denen Sie nicht gefragt haben. Eingeschränkte Umfänge gibt es aus diesem Grund.
Häufig gestellte Fragen (FAQ)
Ist SocQ MCP eine zweite Social-Media-API?
Nein. Es ist ein weiterer Zugang zum selben Katalog, den auch REST und die CLI nutzen.
Kann ich es ohne API-Schlüssel nutzen?
Sie können Plattformen, Endpunkte und Schemas erkunden. Erfassung, Konto, Aufgabenergebnisse und Dateien brauchen einen Schlüssel.
Warum führt der Kompaktmodus nicht jede API als eigenes Tool auf?
Der Kompaktmodus durchsucht und beschreibt einen Endpunkt bei Bedarf. Dadurch bleibt die vollständige Menge der Schemas aus dem Kontext des Modells heraus.
Liefert Execute sofort alle Zeilen?
Nein. Es liefert eine Aufgabe. Setzen Sie diese Aufgabe fort und blättern Sie durch results.items.
Kann der Agent auf X posten oder ein privates Instagram-Konto lesen?
Nein. Er kann nur öffentliche Funktionen des Katalogs aufrufen.
Wann sollte ich den Skill hinzufügen?
Wenn der Agent bei einem mehrstufigen Job Endpunkte wählen und Credits schätzen muss. Ausgeführt wird weiterhin über MCP. Einzelheiten stehen auf /skill.
Wo kopiere ich die echte Konfiguration des Clients?
Von /mcp: Umfang wählen, Client wählen, kopieren, neu verbinden.
MULTI-PLATTFORM API
Workflow mit einer öffentlichen Multi-Plattform-URL testen
Senden Sie öffentliche Eingaben und erhalten Sie normalisierte Datensätze mit nachvollziehbarem Quellkontext.
Multi-Plattform-APIs ansehen