Öffentliche Social-Media-Daten plattformübergreifendüber MCP für KI-Agenten.
Einmal verbinden, und Ihr Agent findet und nutzt die APIs von SocQ für öffentliche Social-Media-Daten.
https://api.socq.ai/mcpSignalfluss des Agenten
Anfrage in natürlicher Sprache
“Rufen Sie die neuesten 100 Kommentare zu diesem YouTube-Video ab, warten Sie auf die Aufgabe und geben Sie dann Kommentartext, Autor, Veröffentlichungszeit und Anzahl der „Gefällt mir“-Angaben zurück.”
Endpunkt finden
socq_search_endpoints
socq_describe_endpointsocq_execute
POST /mcp
{ "endpoint": "…", "input": { … } }task_id
202 Accepted
{ "task_id": "…" }socq_get_task
GET /mcp
{ "task_id": "…" }results.items
200 OK
{ "items": [ … ],
"next_cursor": "…" }Gehosteter MCP-Endpunkt
https://api.socq.ai/mcpTransport: Streamable HTTP
Konfiguration
Legen Sie fest, wie viel vom API-Katalog Ihr Agent sehen soll, wählen Sie Ihren Client und kopieren Sie eine Konfiguration, die aus der aktuellen Plattform- und Endpunktregistrierung von SocQ erzeugt wird.
Halten Sie den API-Schlüssel in einer Umgebungsvariablen und verbinden Sie Codex direkt mit dem gehosteten Streamable-HTTP-Endpunkt von SocQ.
Client
~/.codex/config.tomlKonfiguration[mcp_servers.socq]url = "https://api.socq.ai/mcp"bearer_token_env_var = "SOCQ_API_KEY"tool_timeout_sec = 45Was kann Ihr Agent mit SocQ MCP tun?
Fragen Sie in natürlicher Sprache. Ihr Agent wählt die passende Funktion, liest deren Eingabeanforderungen, sendet die Erfassung und ordnet die normalisierten Ergebnisse, sobald die Aufgabe abgeschlossen ist.
Basiert auf: youtube/commentsBasiert auf: x/searchBasiert auf: facebook-ad-library/searchBasiert auf: linkedin/jobsBasiert auf: tiktok-shop/searchBasiert auf: instagram/postsWie ruft ein KI-Agent SocQ MCP auf?
Ihr MCP-Client übernimmt das Protokoll. Sie beschreiben die benötigten Daten; der Agent findet oder wählt ein Tool, sendet die Erfassung und fragt dieselbe Aufgabe weiter ab, bis die Ergebnisse bereit sind.
Dokumentation zum MCP-Workflow lesenDaten anfordern
Beschreiben Sie eine Aufgabe mit öffentlichen Social-Media-Daten in natürlicher Sprache, einschließlich Plattform, Quelle und gewünschtem Ergebnis.
user promptTool finden oder auswählen
Der Kompaktmodus durchsucht die Funktionsregistrierung. Die Modi Plattform und Exakt können ein typisiertes Tool direkt aufrufen.
socq_search_endpoints → socq_describe_endpointErfassung senden
SocQ validiert die fachliche Eingabe, legt eine asynchrone Erfassung an und gibt deren Aufgaben-ID zurück.
socq_execute → task_idErgebnisse lesen und aufbereiten
Der Agent macht mit derselben Aufgabe weiter, liest normalisierte Ergebnisseiten und liefert die Antwort im gewünschten Format.
socq_get_task → results.itemsEntwickelt für KI-Agenten, die plattformübergreifende öffentliche Social-Media-Daten verarbeiten
Mit einer MCP-Verbindung finden und rufen Agenten APIs plattformübergreifend auf, steuern, welche Tools in den Kontext gelangen, und setzen asynchrone Erfassungsaufgaben bis zu normalisierten Ergebnissen fort – ohne jede Plattform einzeln anzubinden.
Eine Verbindung, vollständiger Katalog
Die kompakte Erkennung lässt einen Agenten den SocQ-API-Katalog durchsuchen und ausführen, ohne pro Plattform einen eigenen MCP-Server zu konfigurieren.
/mcp → search → describe → executeKontrolle über den Tool-Kontext
Wechseln Sie zwischen Erkennung, ausgewählten Plattformen und exakten typisierten Tools, sobald ein Workflow vorhersehbarer wird.
compact | platforms≤5 | tools≤30Ein echter asynchroner Workflow
Agenten können die ursprüngliche Aufgabe fortsetzen, normalisierte Ergebnisse per Cursor-Paginierung lesen und Dateien abrufen, ohne doppelte Erfassungen zu senden.
task_id → status → results.items → next_cursorWo soll sich Ihr Workflow mit SocQ verbinden?
MCP, CLI und REST sind Ausführungswege. Agent Skill ist eine Anleitungsebene. Alle nutzen denselben API-Katalog und dasselbe asynchrone Aufgabenmodell, sodass Sie die Schnittstelle wählen können, die zu Ihrem Workflow passt.
KI-Clients SocQ direkt aufrufen lassen
Einmal verbinden, dann Agenten per natürlicher Sprache Tools finden, Erfassungen senden und asynchrone Aufgabenergebnisse weiterverfolgen lassen.
- Am besten für
- KI-Clients und Coding-Agenten
- So funktioniert es
- Natürliche Sprache + MCP-Tool-Aufrufe
- Nächster Schritt
- SocQ MCP konfigurieren
Empfohlene Kombination · Anleitungsebene für Agenten
Agent Skill
Ergänzt Anleitungen zu Endpunktauswahl, Kostenkontrolle, Paginierung und Aufgabenwiederaufnahme. Kombinieren Sie ihn zuerst mit MCP oder führen Sie über CLI oder REST aus.
Häufig gestellte Fragen
Was ist der SocQ-MCP-Server?
Ein gehosteter MCP-Dienst, der KI-Clients mit dem SocQ-API-Katalog verbindet. Nach der Verbindung kann ein Agent Funktionen finden, Erfassungen öffentlicher Social-Media-Daten senden und Aufgabenergebnisse lesen.
Wie füge ich SocQ zu Codex, Claude, Cursor oder VS Code hinzu?
Codex kann sich direkt mit dem gehosteten Streamable-HTTP-Endpunkt verbinden. Claude Desktop, Cursor und VS Code können die stdio-Bridge @socq/mcp ausführen. Kopieren Sie oben die passende Konfiguration, geben Sie SOCQ_API_KEY an und verbinden Sie den Client neu.
Steht eine MCP-URL nur für eine einzige API?
Nein. Der Standard-Endpunkt findet und führt den gesamten SocQ-Funktionskatalog über die Endpunkt-ID aus. Die Modi Plattform und Exakte Tools können ausgewählte Funktionen stattdessen als typisierte Tools bereitstellen.
Warum stellt die Standardverbindung nicht jede API als eigenes Tool bereit?
Der Kompaktmodus durchsucht und beschreibt einen Endpunkt erst, wenn er gebraucht wird. So bleibt der vollständige Schema-Katalog aus dem Modellkontext heraus, der Kontextverbrauch sinkt und die Tool-Auswahl wird berechenbarer.
Kann ich es ohne API-Schlüssel nutzen?
Die Erkennung von Plattformen, Endpunkten und Schemas ist öffentlich. Erfassungen sowie Konto-, Aufgabenergebnis- und Dateivorgänge erfordern einen gültigen SocQ-API-Schlüssel.
Warum liefert eine Erfassung nicht sofort alle Ergebnisse?
SocQ-Erfassungen sind asynchron. Das Senden gibt eine Aufgaben-ID zurück und kann bis zu 30 Sekunden warten. Läuft die Aufgabe noch, macht der Agent mit socq_get_task weiter, statt sie erneut zu senden.
Worin unterscheidet sich MCP von der REST-API?
Beide nutzen dieselben Funktionsdefinitionen, fachlichen Eingaben, Abrechnungsregeln und Limits sowie dasselbe asynchrone Aufgabenmodell. MCP ergänzt Erkennung und strukturierte Tool-Aufrufe, sodass ein KI-Client keine handgeschriebene HTTP-Integration braucht.
Wie wird die MCP-Nutzung abgerechnet?
MCP ändert die Abrechnung der Endpunkte nicht. Erfassungen folgen denselben Credits, API-Schlüssel-Limits und Kontoregeln wie bei REST. Erkennungs-Tools senden keine Erfassungsaufträge.
Auf welche Daten kann ein Agent zugreifen?
Ein Agent kann nur die Funktionen für öffentliche Social-Media-Daten aufrufen, die im SocQ-API-Katalog verfügbar sind. Jede API-Seite dokumentiert die unterstützten Eingaben, den Umfang der öffentlichen Daten und die normalisierten Ergebnisfelder.