Installer le Skill
Ajoutez le Skill SocQ depuis son dépôt public à un agent de programmation compatible.
npx skills add SocQAPI/socq-devtoolsGardez votre configuration MCP existante. Ajoutez un seul Skill pour aider votre agent à choisir plus précisément les endpoints, à maîtriser les coûts et à mener à bien, de façon fiable, des recherches asynchrones, paginées et multiplateformes.
Installez le Skill SocQ, configurez votre clé API de façon sécurisée et décrivez l’objectif de recherche en langage naturel. Votre agent suit le Skill pour sélectionner les endpoints, exécuter les tâches, paginer les résultats et organiser l’analyse finale.
Ajoutez le Skill SocQ depuis son dépôt public à un agent de programmation compatible.
npx skills add SocQAPI/socq-devtoolsStockez la clé dans une variable d’environnement locale pour que les tâches SocQ en direct s’authentifient en toute sécurité.
SOCQ_API_KEYDemandez en langage naturel. Le Skill guide le choix des endpoints, l’exécution, l’interrogation, la pagination et l’organisation des résultats.
Comparez les posts récents de ces trois profils X.Ne collez jamais de clé API dans un chat public, un dépôt ou un document partagé. Suivez le guide propre à votre client pour une configuration locale sécurisée.
Lire le guide d’installation completMCP donne aux agents un accès direct aux outils de données sociales publiques de SocQ. Ajoutez le Skill pour améliorer le choix des endpoints, estimer les coûts, mener à bien les tâches asynchrones et paginées, et conduire des recherches multiplateformes avec un workflow cohérent.
MCP seul
MCP permet déjà à un agent de découvrir les endpoints, de soumettre des tâches de collecte, de consulter leur état et de lire les résultats.
Idéal pour des endpoints connus et des collectes ponctuelles simples.
MCP + Agent Skill
Le Skill apprend à l’agent à choisir, enchaîner et reprendre les opérations SocQ sans ajouter de service de données distinct.
Idéal pour les recherches en plusieurs étapes, coûteuses, asynchrones, répétées ou multiplateformes.
| Tâche | MCP seul | MCP + Skill |
|---|---|---|
| Appeler un endpoint connu | Appeler directement l’outil et lire les résultats | Valider d’abord les entrées, puis exécuter et organiser les résultats avec un workflow cohérent |
| Transformer un objectif de recherche en étapes d’API | L’agent choisit les endpoints et l’ordre d’exécution au cas par cas | Appliquer une méthode reproductible pour décomposer l’objectif, sélectionner les endpoints et planifier chaque étape |
| Lancer une grande collecte asynchrone | L’agent gère le coût, l’état de la tâche et la pagination au cas par cas | Estimer le coût avant l’exécution, poursuivre la tâche d’origine et lire chaque page demandée |
| Mener une comparaison multiplateforme | L’agent définit à chaque fois la collecte et la méthode de comparaison | Uniformiser les limites, les étapes de collecte et la structure de sortie pour que les résultats soient directement comparables |
Si vous n’appelez que quelques API SocQ bien définies, MCP suffit. Ajoutez le Skill lorsque vous voulez que l’agent mène seul à bien des recherches en plusieurs étapes, asynchrones ou multiplateformes.
Découvrir SocQ MCPLe Skill SocQ fournit une méthode fiable pour le choix des endpoints, la validation des entrées, l’estimation des coûts, les tâches asynchrones, la pagination et la reprise après erreur – pour des recherches sur les données sociales publiques plus précises, plus efficaces et réutilisables.
Associer une intention en langage naturel à l’endpoint approprié du Capability Registry de SocQ.
Déterminer si une tâche requiert des URL, des noms d’utilisateur, des hashtags, des requêtes ou une autre entrée documentée.
Examiner la fonctionnalité et estimer les crédits avant de soumettre une grande collecte.
Continuer d’interroger la tâche d’origine plutôt que de la soumettre à nouveau et de risquer de payer deux fois.
Lire les résultats paginés par curseur et récupérer les fichiers de sortie bruts lorsque le workflow l’exige.
Réagir aux erreurs d’authentification, de validation, de limite de débit, de crédits et de fournisseur par l’étape suivante appropriée.
Chaque exemple part d’un résultat attendu côté métier. Le Skill sélectionne les endpoints, valide les entrées, maîtrise les coûts, mène à bien les tâches asynchrones et la pagination, puis organise les résultats en une analyse prête à l’emploi.
Utilise: instagram/postsUtilise: tiktok/searchUtilise: x/searchUtilise: youtube/searchUtilise: linkedin/profilesUtilise: reddit/postsLe Skill ajoute une couche de décision autour des mêmes fonctionnalités SocQ disponibles via MCP, CLI et REST.
Lire le workflow complet du SkillIdentifier les entités, les plateformes, la période, le volume de résultats et la sortie souhaitée.
Associer la tâche aux entrées actuelles du Capability Registry de SocQ.
Vérifier les schémas, les contraintes et les crédits estimés avant un gros traitement.
Privilégier MCP et transmettre le marqueur d’attribution du Skill lors de la soumission.
Interroger l’ID de tâche renvoyé plutôt que de créer des collectes en double.
Suivre la pagination par curseur et récupérer les fichiers si nécessaire.
Renvoyer des tableaux comparables, des synthèses, des preuves ou une sortie structurée plutôt que du jargon d’endpoint brut.
Ordre d’exécution préféré
Serveur MCP hébergé → bridge stdio SocQ → CLI ou REST en solution de repli si MCP n’est pas disponible.
Le SocQ Agent Skill reste aligné sur le Capability Registry en direct. Il aide les agents à choisir précisément les endpoints, à mener à bien les tâches asynchrones, à planifier les coûts et à comparer les plateformes avec une méthodologie cohérente.
Le choix des endpoints et les conseils sur les entrées s’appuient sur la même source de fonctionnalités que MCP et le catalogue d’API.
Skill ↔ Capability Registry ↔ MCPL’agent sait quand soumettre, quand attendre et comment poursuivre sans dupliquer le travail.
soumission → task_id → interrogation → résultatsLes grosses tâches peuvent être vérifiées et planifiées avant de consommer des crédits, avec des nouvelles tentatives idempotentes le cas échéant.
schéma → estimation → exécutionAppliquez des limites de collecte et des structures de sortie cohérentes lorsque les éléments proviennent de plateformes différentes.
un objectif → plusieurs plateformes → sortie comparableMCP, 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.
Page actuelle · 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.
Voie d’exécution privilégiée
Connectez-vous une fois, puis laissez les agents découvrir les outils en langage naturel, lancer des collectes et poursuivre avec les résultats des tâches asynchrones.
Il s’agit d’un ensemble d’instructions réutilisable qui apprend à un agent IA à sélectionner les endpoints SocQ, formuler les entrées, maîtriser les coûts, mener à bien des collectes asynchrones et organiser les résultats de recherche.
MCP donne aux agents accès aux outils SocQ en direct ; le Skill leur donne une méthode fiable pour mener une recherche de bout en bout. Avec le Skill, les agents traduisent les objectifs en étapes, sélectionnent les endpoints, valident les entrées, estiment les coûts, poursuivent les tâches asynchrones et la pagination, et organisent les résultats multiplateformes selon des critères cohérents. Pour les recherches en plusieurs étapes, de longue durée ou répétables, cela réduit les décisions improvisées et les exécutions en double, tout en produisant des résultats plus fiables, plus complets et plus comparables.
Non. Le Skill n’ajoute aucun service de données distinct et ne débloque aucune fonctionnalité privée. Il apprend à l’agent à utiliser plus fiablement le même catalogue d’API SocQ.
Non. Le Skill privilégie MCP hébergé ou stdio, mais il peut guider l’agent vers la CLI SocQ ou l’API REST lorsque MCP n’est pas disponible.
SocQ utilise un seul Skill multiplateforme. L’agent sélectionne la fonctionnalité appropriée dans tout le catalogue SocQ selon la tâche.
Les collectes de données en direct nécessitent une clé API SocQ valide. Le Skill lui-même ne doit jamais contenir ni stocker d’identifiants ; configurez la clé de façon sécurisée dans l’environnement local du client.
Oui. Il guide l’agent pour qu’il continue d’interroger la tâche d’origine, suive les curseurs de résultats et récupère les fichiers bruts lorsque le workflow demandé l’exige.
Il peut utiliser les fonctionnalités de données sociales publiques actuellement disponibles dans le catalogue d’API SocQ. Chaque page d’API documente les entrées prises en charge, le périmètre des données publiques et les champs de résultat normalisés.