Un Skill de recherche sur les données sociales publiques conçu pour les agents IA.

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

Un seul Skill pour tout le catalogue d’API SocQ34 plateformes prises en charge279 fonctionnalités d’API
Démarrage rapide

Trois étapes pour donner à votre agent un workflow de recherche complet

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.

01

Installer le Skill

Ajoutez le Skill SocQ depuis son dépôt public à un agent de programmation compatible.

npx skills add SocQAPI/socq-devtools
02

Configurer votre clé API

Stockez la clé dans une variable d’environnement locale pour que les tâches SocQ en direct s’authentifient en toute sécurité.

SOCQ_API_KEY
03

Décrire la tâche de recherche

Demandez 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 complet
MCP et MCP + Skill

MCP ou MCP + Skill

MCP 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

Accès direct aux outils SocQ en direct

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.

  • Appeler une API connue avec une entrée claire
  • Soumettre et lire une collecte simple
  • Laisser le modèle décider du workflow environnant

Idéal pour des endpoints connus et des collectes ponctuelles simples.

MCP + Agent Skill

Les mêmes outils, avec un guide de recherche fiable

Le Skill apprend à l’agent à choisir, enchaîner et reprendre les opérations SocQ sans ajouter de service de données distinct.

  • Associer une intention ambiguë au bon endpoint
  • Vérifier les schémas et le coût avant les gros traitements
  • Interroger, paginer, réessayer en toute sécurité et normaliser la sortie de la recherche

Idéal pour les recherches en plusieurs étapes, coûteuses, asynchrones, répétées ou multiplateformes.

TâcheMCP seulMCP + Skill
Appeler un endpoint connuAppeler directement l’outil et lire les résultatsValider 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’APIL’agent choisit les endpoints et l’ordre d’exécution au cas par casAppliquer une méthode reproductible pour décomposer l’objectif, sélectionner les endpoints et planifier chaque étape
Lancer une grande collecte asynchroneL’agent gère le coût, l’état de la tâche et la pagination au cas par casEstimer le coût avant l’exécution, poursuivre la tâche d’origine et lire chaque page demandée
Mener une comparaison multiplateformeL’agent définit à chaque fois la collecte et la méthode de comparaisonUniformiser 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 MCP
Ce qu’apprend le Skill

Guider les agents d’un objectif de recherche jusqu’à des résultats complets

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

01

Choisir la bonne fonctionnalité

Associer une intention en langage naturel à l’endpoint approprié du Capability Registry de SocQ.

02

Formuler des entrées valides

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.

03

Maîtriser le coût des tâches

Examiner la fonctionnalité et estimer les crédits avant de soumettre une grande collecte.

04

Mener à bien le travail asynchrone

Continuer d’interroger la tâche d’origine plutôt que de la soumettre à nouveau et de risquer de payer deux fois.

05

Gérer la pagination et les fichiers

Lire les résultats paginés par curseur et récupérer les fichiers de sortie bruts lorsque le workflow l’exige.

06

Reprendre après un échec

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.

Prompts de recherche

Décrivez l’objectif de recherche. Le Skill planifie le workflow.

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.

01
Instagram Posts APIUtilise: instagram/posts
02
TikTok Search APIUtilise: tiktok/search
03
Twitter Search APIUtilise: x/search
04
YouTube Search APIUtilise: youtube/search
05
LinkedIn Profiles APIUtilise: linkedin/profiles
06
Reddit Posts APIUtilise: reddit/posts
Fonctionnement

D’une question de recherche à des résultats structurés

Le 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 Skill
01

Comprendre l’objectif

Identifier les entités, les plateformes, la période, le volume de résultats et la sortie souhaitée.

02

Sélectionner les endpoints

Associer la tâche aux entrées actuelles du Capability Registry de SocQ.

03

Examiner les entrées et le coût

Vérifier les schémas, les contraintes et les crédits estimés avant un gros traitement.

04

Exécuter la collecte

Privilégier MCP et transmettre le marqueur d’attribution du Skill lors de la soumission.

05

Poursuivre la tâche

Interroger l’ID de tâche renvoyé plutôt que de créer des collectes en double.

06

Lire chaque résultat demandé

Suivre la pagination par curseur et récupérer les fichiers si nécessaire.

07

Organiser la réponse

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.

Pourquoi le SocQ Agent Skill

Donnez aux agents une méthode fiable pour la recherche sur les données sociales publiques

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.

01

Aligné sur le Capability Registry

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 ↔ MCP
02

Workflow asynchrone natif

L’agent sait quand soumettre, quand attendre et comment poursuivre sans dupliquer le travail.

soumission → task_id → interrogation → résultats
03

Exécution attentive aux coûts

Les 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écution
04

Rigueur en recherche multiplateforme

Appliquez 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 comparable
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.

Page actuelle · Agent Skill

Une méthode fiable de recherche de données pour vos agents

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.

Idéal pour
Recherches en plusieurs étapes, asynchrones et multiplateformes
Fonctionnement
Agent Skill + MCP (recommandé)
Étape suivante
Installer SocQ Agent Skill
Découvrir Agent Skill

Voie d’exécution privilégiée

MCP

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.

Configurer MCP
FAQ Agent Skill

Questions fréquentes

Qu’est-ce que le SocQ Agent Skill ?

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 fonctionne déjà. Pourquoi installer le Skill ?

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.

Le Skill débloque-t-il plus d’API que MCP ?

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.

Dois-je installer MCP pour utiliser le Skill ?

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 propose-t-il un seul Skill ou un Skill par plateforme ?

SocQ utilise un seul Skill multiplateforme. L’agent sélectionne la fonctionnalité appropriée dans tout le catalogue SocQ selon la tâche.

Le Skill nécessite-t-il une clé API ?

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.

Le Skill gère-t-il les tâches asynchrones et la pagination ?

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.

À quelles données le Skill peut-il accéder ?

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.

Offrez à votre agent une meilleure façon de rechercher des données sociales publiques

Créer une clé API