SocQ CLI installieren
Fügen Sie das veröffentlichte Paket @socq/cli hinzu und machen Sie den Befehl socq in Ihrem Terminal verfügbar.
Mit einer einzigen Befehlszeile entdecken Sie über öffentliche Social-Media-Plattformen hinweg den Live-API-Katalog, senden Erfassungen, schließen asynchrone Aufgaben ab und liefern normalisierte Ergebnisse an Shell-Skripte, CI und Datenanalyse-Workflows.
Installieren Sie die SocQ CLI, hinterlegen Sie Ihren API-Schlüssel sicher und führen Sie dann einen Endpunkt mit derselben Definition aus, die auch in der SocQ-Dokumentation, in MCP und in REST gilt.
Fügen Sie das veröffentlichte Paket @socq/cli hinzu und machen Sie den Befehl socq in Ihrem Terminal verfügbar.
Speichern Sie den Schlüssel im System-Schlüsselbund oder in einer geschützten lokalen Konfiguration.
Führen Sie den Endpunkt für YouTube-Kommentare aus und lesen Sie das normalisierte Ergebnis bis zum Ende.
Stellen Sie SOCQ_API_KEY in CI über Ihren Secret-Manager bereit, damit die Zugangsdaten bei automatisierten Läufen geschützt bleiben.
Vollständige CLI-Anleitung lesenErkunden Sie APIs, senden Sie eine Erfassung, prüfen Sie eine bestehende Aufgabe oder exportieren Sie Ergebnisse. Jeder Befehl funktioniert eigenständig und lässt sich bei Bedarf in lokalen Terminals, Shell-Skripten und CI kombinieren.
$ socq tools youtubeEntdecken Sie die aktuellen YouTube-Endpunkte aus der Live Capability Registry.
Diese sechs Beispiele verwenden aktuelle SocQ-Endpunkt-IDs und akzeptierte Eingaben. Jeder Befehl lässt sich kopieren und an Ihren Workflow anpassen.
Endpunkt: youtube/commentsÖffentlich sichtbare YouTube-Kommentare erfassen und auf normalisierte Ergebnisse warten.
Endpunkt: x/searchAus einer Suchanfrage einen gezielten Datensatz öffentlicher X-Posts erstellen.
Endpunkt: tiktok/searchÖffentliche TikTok-Videos suchen und normalisierte Datensätze exportieren.
Endpunkt: instagram/commentsÖffentliche Kommentare zu einer bekannten Instagram-Beitrags-URL erfassen.
Endpunkt: facebook-ad-library/searchÖffentliche Creatives der Facebook Ad Library per Keyword suchen.
Endpunkt: linkedin/jobsEine öffentliche LinkedIn-Jobseite in strukturierte Jobfelder normalisieren.
Die SocQ CLI sendet jede Erfassung als Hintergrundaufgabe und gibt eine Aufgaben-ID zurück. Warten Sie im aktuellen Befehl mit --wait oder speichern Sie die Aufgaben-ID und setzen Sie später fort. Anschließend lesen Sie normalisierte Ergebnisse oder rufen verfügbare Dateien ab.
Führen Sie einen Befehl mit Plattform und Ressource aus, um eine Hintergrundaufgabe zu erstellen.
Die CLI gibt die eindeutige Referenz zurück, mit der Sie warten, fortsetzen und Ergebnisse lesen.
Verwenden Sie --wait sofort oder setzen Sie dieselbe Aufgabe später mit ihrer Aufgaben-ID fort.
Exportieren Sie nach erfolgreicher Aufgabe die normalisierten Ergebnisse und prüfen Sie die verfügbaren Dateien.
01 / Erfassung senden
Führen Sie den passenden Befehl mit Plattform und Ressource aus. Die CLI sendet die Erfassung als Hintergrundaufgabe.
task_id: TASK_IDNach dem Senden gibt die CLI die eindeutige Aufgaben-ID zurück.
Die SocQ CLI bringt den Live-API-Katalog, die Steuerung asynchroner Aufgaben und normalisierte Ergebnisse in Ihr Terminal. Prüfen Sie einen Befehl lokal und nutzen Sie dann denselben Workflow in Shell-Skripten und automatisierten Pipelines, ohne für jede Plattform eigene Collector zu pflegen.
Plattformen, Endpunkte, Eingabeschemas und Hinweise zur Abrechnung stammen aus der Live Capability Registry, sodass Sie keinen zweiten, festen Befehlskatalog pflegen müssen.
LIVE REGISTRY → AKTUELLE BEFEHLE
Ausgabe als JSON, JSONL, CSV und Tabelle, Dateiexport und aussagekräftige Exit-Codes machen dasselbe Befehlsmodell in Shell-Skripten und automatisierten Pipelines verlässlich.
JSON · JSONL · CSV · EXIT-CODES
Behalten Sie die Aufgaben-ID, um nach einer Zeitüberschreitung oder einem abgebrochenen Prozess fortzufahren, und lesen Sie dann paginierte Ergebnisse und verfügbare Dateien, ohne die Erfassung erneut zu senden.
SENDEN → TASK_ID → FORTSETZEN → ERGEBNISSE
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.
Ein einheitliches Befehlsmodell zum Finden von APIs, Senden von Erfassungen, Fortsetzen asynchroner Aufgaben und Exportieren normalisierter Ergebnisse in Dateien und Automatisierungen.
Optionale Erweiterung · 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.
Die SocQ CLI ist das Befehlszeilen-Tool von SocQ. Damit entdecken und rufen Sie SocQ-APIs auf, senden Erfassungen öffentlicher Social-Media-Daten, warten auf asynchrone Aufgaben oder setzen sie fort und exportieren normalisierte Ergebnisse in Dateien, Skripte und automatisierte Pipelines.
Verwenden Sie die CLI für Terminalarbeit, Shell-Skripte, automatisierte Pipelines, Batch-Erfassungen und Dateiexporte. Nutzen Sie MCP, wenn ein KI-Client Tools direkt entdecken und aufrufen soll, oder die REST-API für langlebige Anwendungsintegrationen.
Ja. Die CLI liest aktuelle Plattformen, Endpunkte, Eingabeschemas und Hinweise zur Abrechnung aus der Live Capability Registry, sodass die verfügbaren Befehle dem SocQ-API-Katalog folgen. Mit socq platforms, socq tools und socq describe sehen Sie die aktuellen Funktionen ein.
Nicht unbedingt. Installieren Sie @socq/cli für die regelmäßige Nutzung global, damit der Befehl socq immer verfügbar ist. Verwenden Sie npx @socq/cli für gelegentliche Befehle oder um zuerst den API-Katalog zu erkunden.
Die öffentliche Capability Registry können Sie ohne API-Schlüssel durchsuchen. Erfassungen, Kontoabfragen sowie der Zugriff auf Aufgaben und Dateien erfordern einen. Verwenden Sie lokal socq auth login und stellen Sie SOCQ_API_KEY in automatisierten Pipelines über einen Secret-Manager bereit.
Nein. Eine lokale Zeitüberschreitung beim Warten bricht die serverseitige Aufgabe nicht ab. Behalten Sie die Aufgaben-ID und führen Sie socq task get oder socq task wait erneut aus, um dieselbe Aufgabe fortzusetzen, ohne die Erfassung erneut zu senden.
Die SocQ CLI unterstützt Tabelle, JSON, JSONL und CSV. Lesen Sie kleine Ergebnisse im Terminal oder schreiben Sie mit --output normalisierte Ergebnisse in eine Datei für Skripte, Tabellenkalkulationen oder Datenanalysen.
Die SocQ CLI erfordert Node.js 20 oder höher und läuft unter Windows, macOS und Linux.