Installer SocQ CLI
Ajoutez le package @socq/cli publié et rendez la commande socq disponible dans votre terminal.
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.
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.
Ajoutez le package @socq/cli publié et rendez la commande socq disponible dans votre terminal.
Stockez la clé dans le trousseau du système ou dans une configuration locale protégée.
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 CLIExplorez 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.
$ socq tools youtubeExplorez les endpoints YouTube actuels depuis le Capability Registry en direct.
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.
Endpoint: youtube/commentsCollectez les commentaires YouTube visibles publiquement et attendez les résultats normalisés.
Endpoint: x/searchConstituez un jeu de données ciblé de posts X publics à partir d’une requête de recherche.
Endpoint: tiktok/searchRecherchez des vidéos TikTok publiques et exportez des enregistrements normalisés.
Endpoint: instagram/commentsCollectez les commentaires publics à partir de l’URL d’une publication Instagram connue.
Endpoint: facebook-ad-library/searchRecherchez par mot-clé des créations publiques de la Facebook Ad Library.
Endpoint: linkedin/jobsNormalisez une page d’offre d’emploi LinkedIn publique en champs d’emploi structurés.
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.
Exécutez une commande plateforme et ressource pour créer une tâche en arrière-plan.
La CLI renvoie la référence unique servant à attendre, reprendre et lire les résultats.
Utilisez --wait tout de suite ou poursuivez la même tâche plus tard avec son ID de tâche.
Exportez les résultats normalisés et consultez les fichiers disponibles une fois la tâche réussie.
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_IDLa CLI renvoie l’ID de tâche unique après la soumission.
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 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
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
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
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.
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.
Complément facultatif · 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.
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.
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.
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.
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.
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.
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.
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.
SocQ CLI nécessite Node.js 20 ou version ultérieure et fonctionne sous Windows, macOS et Linux.