Entwickelt für Entwickler und automatisierte WorkflowsEine plattformübergreifende CLI für öffentliche Social-Media-Daten.

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.

Node.js 20+Live Capability Registry34 Plattformen279 API-Endpunkte
Schnellstart

Drei Schritte bis zur ersten Erfassung öffentlicher Social-Media-Daten

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.

01

SocQ CLI installieren

Fügen Sie das veröffentlichte Paket @socq/cli hinzu und machen Sie den Befehl socq in Ihrem Terminal verfügbar.

02

API-Schlüssel konfigurieren

Speichern Sie den Schlüssel im System-Schlüsselbund oder in einer geschützten lokalen Konfiguration.

03

Erste Aufgabe senden

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 lesen
Was die SocQ CLI kann

Wählen Sie den CLI-Befehl, den Ihre Aufgabe braucht

Erkunden 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.

Beispiele für eigenständige Befehle
$ socq tools youtube

Entdecken Sie die aktuellen YouTube-Endpunkte aus der Live Capability Registry.

Echte Befehlsbeispiele

Befehl kopieren und öffentliche Social-Media-Daten erfassen

Diese sechs Beispiele verwenden aktuelle SocQ-Endpunkt-IDs und akzeptierte Eingaben. Jeder Befehl lässt sich kopieren und an Ihren Workflow anpassen.

01
YouTube Comments API
Endpunkt: youtube/comments

Öffentlich sichtbare YouTube-Kommentare erfassen und auf normalisierte Ergebnisse warten.

02
Twitter Search API
Endpunkt: x/search

Aus einer Suchanfrage einen gezielten Datensatz öffentlicher X-Posts erstellen.

03
TikTok Search API
Endpunkt: tiktok/search

Öffentliche TikTok-Videos suchen und normalisierte Datensätze exportieren.

04
Instagram Comments API
Endpunkt: instagram/comments

Öffentliche Kommentare zu einer bekannten Instagram-Beitrags-URL erfassen.

05
Facebook Ad Library Search API
Endpunkt: facebook-ad-library/search

Öffentliche Creatives der Facebook Ad Library per Keyword suchen.

06
LinkedIn Jobs API
Endpunkt: linkedin/jobs

Eine öffentliche LinkedIn-Jobseite in strukturierte Jobfelder normalisieren.

So funktioniert die CLI

Einmal senden, bis zum vollständigen Ergebnis weitermachen

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.

  1. 01

    Erfassung senden

    Führen Sie einen Befehl mit Plattform und Ressource aus, um eine Hintergrundaufgabe zu erstellen.

  2. 02

    Aufgaben-ID erhalten

    Die CLI gibt die eindeutige Referenz zurück, mit der Sie warten, fortsetzen und Ergebnisse lesen.

  3. 03

    Jetzt warten oder später fortsetzen

    Verwenden Sie --wait sofort oder setzen Sie dieselbe Aufgabe später mit ihrer Aufgaben-ID fort.

  4. 04

    Ergebnisse lesen oder Dateien abrufen

    Exportieren Sie nach erfolgreicher Aufgabe die normalisierten Ergebnisse und prüfen Sie die verfügbaren Dateien.

Ablauf in der CLI

01 / Erfassung senden

Führen Sie den passenden Befehl mit Plattform und Ressource aus. Die CLI sendet die Erfassung als Hintergrundaufgabe.

task_id: TASK_ID

Nach dem Senden gibt die CLI die eindeutige Aufgaben-ID zurück.

Warum SocQ CLI

Ein Befehlsmodell, von der lokalen Erfassung bis zu automatisierten Pipelines

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.

Neue API-Funktionen sind sofort als Befehle nutzbar

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

Von der lokalen Prüfung zur Automatisierung

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

Lang laufende Aufgaben ohne Neustart fortsetzen

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

Integration wählen

Wo 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.

SocQ in Terminals und automatisierte Pipelines bringen

Ein einheitliches Befehlsmodell zum Finden von APIs, Senden von Erfassungen, Fortsetzen asynchroner Aufgaben und Exportieren normalisierter Ergebnisse in Dateien und Automatisierungen.

Am besten für
Entwickler, Shell-Skripte und automatisierte Pipelines
So funktioniert es
socq-Befehle + strukturierte Ausgabe
Nächster Schritt
SocQ CLI installieren und ausführen
CLI verwenden

Optionale Erweiterung · Agent Skill

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.

Agent Skill entdecken
CLI FAQ

Häufig gestellte Fragen

Was ist die SocQ CLI?

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.

Wann sollte ich die SocQ CLI verwenden?

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.

Deckt die SocQ CLI den kompletten SocQ-API-Katalog ab?

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.

Muss ich die SocQ CLI global installieren?

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.

Brauche ich einen API-Schlüssel für die SocQ CLI?

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.

Wird meine Erfassung abgebrochen, wenn das Warten eine Zeitüberschreitung erreicht?

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.

Welche Ausgabeformate unterstützt die SocQ CLI?

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.

Welche Systeme und Laufzeitumgebungen unterstützt die SocQ CLI?

Die SocQ CLI erfordert Node.js 20 oder höher und läuft unter Windows, macOS und Linux.

Erfassen Sie öffentliche Social-Media-Daten mit einem einzigen Befehl

API-Schlüssel erstellen