MCPSocial-Media-DatenAPI-Anleitung

SocQ-MCP-Anleitung: Social-Media-Daten in Cursor, Claude und Codex abrufen

Codex, Claude, Cursor und VS Code mit SocQ MCP verbinden, einen Tool-Umfang wählen und öffentliche Social-Media-Daten über asynchrone Aufgaben erfassen.

SocQAktualisiert am 10. September 202611 Min. Lesezeit

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.

SocQ MCP

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 über socq_search_endpoints → socq_describe_endpoint → socq_execute und 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.

UmfangAdresseSichtbare OberflächeGeeignet für
Kompakt/mcpTools für Erkundung, Ausführung, Aufgaben, Dateien und KontoErkundung, die über mehrere Plattformen wandern kann
Plattformen/mcp?platforms=youtube,tiktokTypisierte Tools zur Erfassung für bis zu fünf Plattformen sowie Tools für Aufgaben, Dateien und KontoAgenten, die bei einer bekannten Menge von Plattformen bleiben
Exakte Tools/mcp?tools=youtube_comments,x_searchBis zu dreißig typisierte Tools sowie Tools für Aufgaben, Dateien und KontoStabile 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:

  1. Wählen Sie Kompakt, Plattformen oder Exakte Tools.
  2. Wählen Sie Codex, Claude, Cursor oder VS Code.
  3. Kopieren Sie die erzeugte Konfiguration und verbinden Sie neu.

Dateien und Transporte der Clients:

ClientKonfigurationsdateiArt der Verbindung
Codex~/.codex/config.tomlRemote-HTTP zur gehosteten Streamable-HTTP-URL
Claudeclaude_desktop_config.jsonstdio-Bridge @socq/mcp, Node.js 20+
Cursor.cursor/mcp.jsonstdio-Bridge @socq/mcp
VS Codemcp.jsonstdio-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 input im Kompaktmodus muss zum Endpunktschema passen, das socq_describe_endpoint zurü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_limit als 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:

  • platform und resource passen zum ausgeführten Tool.
  • Mindestens eines von id oder url ist vorhanden.
  • Kennzahlen sind Zahlen oder null, niemals erzwungene Nullen.
  • collected_at ist vorhanden und nicht in created_at kopiert.
  • Die Antwort in Prosa lässt sich auf results.items zurü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.

ObjektSinnvolle GewohnheitGrund
Tool-UmfangNach jeder Änderung des Filters neu verbindenClients speichern tools/list zwischen
Erkundungsocq_search_endpoints wiederholen, wenn sich die Frage ändertDer Katalog ist live; der vorherige Treffer kann die falsche Ressource sein
Aufgabe zur ErfassungDieselbe ID abfragenErneutes Einreichen dupliziert Arbeit
Profilartige EntitätenWöchentlich oder monatlichIdentitätsfelder ändern sich langsam
Beiträge, Kommentare, Anzeigen, ProdukteStündlich bis täglich, solange aktivÖffentliche Kennzahlen und Anzeigen ändern sich schneller
Produktivserver mit exakten ToolsTools 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_execute als fertigen Datensatz zu behandeln.
  • platforms und tools in 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