Conçue pour les développeurs et les workflows automatisésUne CLI de données sociales publiques multiplateforme.

Une seule ligne de commande pour toutes les plateformes sociales publiques : découvrez le catalogue d’API en direct, soumettez des collectes, menez à bien les tâches asynchrones et livrez des résultats normalisés à vos scripts shell, à la CI et à vos workflows d’analyse de données.

Node.js 20+Capability Registry en direct34 plateformes279 endpoints d’API
Démarrage rapide

Trois étapes pour votre première collecte de données sociales publiques

Installez SocQ CLI, stockez votre clé API de façon sécurisée, puis exécutez un endpoint avec la même définition que dans la documentation SocQ, MCP et REST.

01

Installer SocQ CLI

Ajoutez le package @socq/cli publié et rendez la commande socq disponible dans votre terminal.

02

Configurer votre clé API

Stockez la clé dans le trousseau du système ou dans une configuration locale protégée.

03

Soumettre votre première tâche

Exécutez l’endpoint des commentaires YouTube et poursuivez avec le résultat normalisé.

En CI, fournissez SOCQ_API_KEY via votre gestionnaire de secrets afin que les identifiants restent protégés lors des exécutions automatisées.

Lire le guide complet de la CLI
Ce que SocQ CLI peut faire

Choisissez la commande CLI adaptée à votre tâche

Explorez les API, soumettez une collecte, vérifiez une tâche existante ou exportez des résultats. Chaque commande fonctionne indépendamment et peut être combinée dans des terminaux locaux, des scripts shell et la CI si votre workflow l’exige.

Exemples de commandes indépendantes
$ socq tools youtube

Explorez les endpoints YouTube actuels depuis le Capability Registry en direct.

Exemples de commandes réels

Copiez une commande et commencez à collecter des données sociales publiques

Ces six exemples utilisent des ID d’endpoint actuels et des entrées acceptées. Chaque commande est prête à être copiée et adaptée à votre workflow.

01
YouTube Comments API
Endpoint: youtube/comments

Collectez les commentaires YouTube visibles publiquement et attendez les résultats normalisés.

02
Twitter Search API
Endpoint: x/search

Constituez un jeu de données ciblé de posts X publics à partir d’une requête de recherche.

03
TikTok Search API
Endpoint: tiktok/search

Recherchez des vidéos TikTok publiques et exportez des enregistrements normalisés.

04
Instagram Comments API
Endpoint: instagram/comments

Collectez les commentaires publics à partir de l’URL d’une publication Instagram connue.

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

Recherchez par mot-clé des créations publiques de la Facebook Ad Library.

06
LinkedIn Jobs API
Endpoint: linkedin/jobs

Normalisez une page d’offre d’emploi LinkedIn publique en champs d’emploi structurés.

Fonctionnement de la CLI

Soumettre une fois, poursuivre jusqu’aux résultats complets

SocQ CLI soumet chaque collecte comme une tâche en arrière-plan et renvoie un ID de tâche. Attendez dans la commande en cours avec --wait, ou enregistrez l’ID de tâche et reprenez plus tard, puis lisez les résultats normalisés ou récupérez les fichiers disponibles.

  1. 01

    Soumettre une collecte

    Exécutez une commande plateforme et ressource pour créer une tâche en arrière-plan.

  2. 02

    Recevoir un ID de tâche

    La CLI renvoie la référence unique servant à attendre, reprendre et lire les résultats.

  3. 03

    Attendre maintenant ou reprendre plus tard

    Utilisez --wait tout de suite ou poursuivez la même tâche plus tard avec son ID de tâche.

  4. 04

    Lire les résultats ou récupérer les fichiers

    Exportez les résultats normalisés et consultez les fichiers disponibles une fois la tâche réussie.

Déroulement de l’exécution de la CLI

01 / Soumettre une collecte

Exécutez la commande plateforme et ressource appropriée. La CLI soumet la collecte comme tâche en arrière-plan.

task_id: TASK_ID

La CLI renvoie l’ID de tâche unique après la soumission.

Pourquoi SocQ CLI

Un seul modèle de commande, de la collecte locale aux pipelines automatisés

SocQ CLI apporte dans votre terminal le catalogue d’API en direct, le contrôle des tâches asynchrones et les résultats normalisés. Validez une commande en local, puis utilisez le même workflow dans des scripts shell et des pipelines automatisés, sans maintenir de collecteur distinct pour chaque plateforme.

Les nouvelles fonctionnalités d’API restent prêtes à l’emploi en commande

Les plateformes, les endpoints, les schémas d’entrée et les indications de facturation proviennent du Capability Registry en direct : vous n’avez pas à maintenir un second catalogue de commandes figé.

REGISTRY EN DIRECT → COMMANDES ACTUELLES

De la validation locale à l’automatisation

Les sorties JSON, JSONL, CSV et tableau, l’export de fichiers et des codes de sortie explicites rendent le même modèle de commande fiable dans les scripts shell et les pipelines automatisés.

JSON · JSONL · CSV · CODES DE SORTIE

Reprendre les tâches longues sans repartir de zéro

Conservez l’ID de tâche pour reprendre après un délai d’expiration ou un processus interrompu, puis poursuivez avec les résultats paginés et les fichiers disponibles sans soumettre à nouveau la collecte.

SOUMETTRE → TASK_ID → REPRENDRE → RÉSULTATS

Choisir une intégration

Où votre workflow doit-il se connecter à SocQ ?

MCP, CLI et REST sont des voies d’exécution. Agent Skill est une couche de guidage. Ils partagent un même catalogue d’API et un même modèle de tâches asynchrones : vous choisissez l’interface qui convient à votre workflow.

SocQ dans vos terminaux et vos pipelines automatisés

Un seul modèle de commandes pour découvrir les API, lancer des collectes, reprendre des tâches asynchrones et exporter des résultats normalisés vers des fichiers et des outils d’automatisation.

Idéal pour
Développeurs, scripts shell et pipelines automatisés
Fonctionnement
Commandes socq + sortie structurée
Étape suivante
Installer et exécuter SocQ CLI
Utiliser CLI

Complément facultatif · Agent Skill

Agent Skill

Ajoute des consignes de sélection des endpoints, de maîtrise des coûts, de pagination et de reprise des tâches. À associer d’abord à MCP, ou à exécuter via CLI ou REST.

Découvrir Agent Skill
FAQ CLI

Questions fréquentes

Qu’est-ce que SocQ CLI ?

SocQ CLI est l’outil en ligne de commande de SocQ. Il permet de découvrir et d’appeler les API SocQ, de soumettre des collectes de données sociales publiques, d’attendre ou de reprendre des tâches asynchrones et d’exporter des résultats normalisés vers des fichiers, des scripts et des pipelines automatisés.

Quand utiliser SocQ CLI ?

Utilisez la CLI pour le travail en terminal, les scripts shell, les pipelines automatisés, les collectes par lots et les exports de fichiers. Utilisez MCP lorsqu’un client IA doit découvrir et appeler directement des outils, ou l’API REST pour des intégrations applicatives durables.

SocQ CLI couvre-t-il tout le catalogue d’API SocQ ?

Oui. La CLI lit les plateformes, endpoints, schémas d’entrée et indications de facturation actuels depuis le Capability Registry en direct : les commandes disponibles suivent donc le catalogue d’API SocQ. Utilisez socq platforms, socq tools et socq describe pour consulter les fonctionnalités actuelles.

Dois-je installer SocQ CLI globalement ?

Pas nécessairement. Installez @socq/cli globalement pour un usage régulier afin que la commande socq soit toujours disponible. Utilisez npx @socq/cli pour des commandes occasionnelles ou pour explorer d’abord le catalogue d’API.

Ai-je besoin d’une clé API pour utiliser SocQ CLI ?

Vous pouvez parcourir le Capability Registry public sans clé API. Les collectes, les requêtes de compte et l’accès aux tâches ou aux fichiers en exigent une. Utilisez socq auth login en local et fournissez SOCQ_API_KEY via un gestionnaire de secrets dans les pipelines automatisés.

Ma collecte est-elle annulée si l’attente expire ?

Non. Un délai d’expiration de l’attente en local n’annule pas la tâche côté serveur. Conservez l’ID de tâche et exécutez de nouveau socq task get ou socq task wait pour poursuivre la même tâche sans soumettre à nouveau la collecte.

Quels formats de sortie SocQ CLI prend-il en charge ?

SocQ CLI prend en charge table, JSON, JSONL et CSV. Lisez les petits résultats dans le terminal, ou utilisez --output pour écrire les résultats normalisés dans un fichier destiné à des scripts, des tableurs ou de l’analyse de données.

Quels systèmes et environnements d’exécution SocQ CLI prend-il en charge ?

SocQ CLI nécessite Node.js 20 ou version ultérieure et fonctionne sous Windows, macOS et Linux.

Commencez à collecter des données sociales publiques avec une seule commande

Créer une clé API