Données sociales publiques multiplateformesvia un MCP pour agents IA.
Connectez-vous une seule fois et laissez votre agent découvrir et appeler les API de données sociales publiques de SocQ.
https://api.socq.ai/mcpFlux de signaux de l’agent
Requête en langage naturel
“Collectez les 100 derniers commentaires de cette vidéo YouTube, attendez la fin de la tâche, puis renvoyez le texte du commentaire, l’auteur, la date de publication et le nombre de mentions « J’aime ».”
Découverte de l’endpoint
socq_search_endpoints
socq_describe_endpointsocq_execute
POST /mcp
{ "endpoint": "…", "input": { … } }task_id
202 Accepted
{ "task_id": "…" }socq_get_task
GET /mcp
{ "task_id": "…" }results.items
200 OK
{ "items": [ … ],
"next_cursor": "…" }Endpoint MCP hébergé
https://api.socq.ai/mcpTransport: Streamable HTTP
Méthode de configuration
Choisissez la part du catalogue d’API que votre agent doit voir, sélectionnez votre client et copiez une configuration générée à partir de la liste actuelle des plateformes et des endpoints SocQ.
Conservez la clé API dans une variable d’environnement et connectez Codex directement à l’endpoint Streamable HTTP hébergé de SocQ.
Client
~/.codex/config.tomlConfiguration[mcp_servers.socq]url = "https://api.socq.ai/mcp"bearer_token_env_var = "SOCQ_API_KEY"tool_timeout_sec = 45Que peut faire votre agent avec SocQ MCP ?
Demandez en langage naturel. Votre agent choisit la fonctionnalité adaptée, lit les entrées requises, lance la collecte et organise les résultats normalisés une fois la tâche terminée.
Basé sur: youtube/commentsBasé sur: x/searchBasé sur: facebook-ad-library/searchBasé sur: linkedin/jobsBasé sur: tiktok-shop/searchBasé sur: instagram/postsComment un agent IA appelle-t-il SocQ MCP ?
Votre client MCP gère le protocole. Vous décrivez les données voulues ; l’agent découvre ou sélectionne un outil, soumet la collecte et continue de lire la même tâche jusqu’à ce que les résultats soient prêts.
Lire la documentation du workflow MCPDemander les données
Décrivez en langage naturel une tâche sur des données sociales publiques, en précisant la plateforme, la source et le résultat attendu.
prompt utilisateurDécouvrir ou sélectionner un outil
Le mode compact interroge le Capability Registry. Les modes Plateformes et Outils exacts peuvent appeler directement un outil typé.
socq_search_endpoints → socq_describe_endpointSoumettre la collecte
SocQ valide les données métier, crée une collecte asynchrone et renvoie son identifiant de tâche.
socq_execute → task_idLire et organiser les résultats
L’agent poursuit avec la même tâche, lit les pages de résultats normalisés et présente la réponse dans le format demandé.
socq_get_task → results.itemsConçu pour les agents IA qui traitent des données sociales publiques multiplateformes
Une seule connexion MCP permet aux agents de découvrir et d’appeler des API sur toutes les plateformes, de contrôler les outils qui entrent dans le contexte et de poursuivre des tâches de collecte asynchrones jusqu’aux résultats normalisés – sans intégrer chaque plateforme séparément.
Une connexion, le catalogue complet
La découverte compacte permet à un agent de rechercher et d’exécuter le catalogue d’API SocQ sans configurer un serveur MCP par plateforme.
/mcp → search → describe → executeMaîtriser le contexte des outils
Passez de la découverte aux plateformes sélectionnées, puis aux outils typés exacts, à mesure qu’un workflow devient plus prévisible.
compact | platforms≤5 | tools≤30Un vrai workflow asynchrone
Les agents peuvent poursuivre la tâche d’origine, lire des résultats normalisés paginés par curseur et récupérer des fichiers sans soumettre de collectes en double.
task_id → status → results.items → next_cursorOù 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.
Appel direct de SocQ par les clients IA
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.
- Idéal pour
- Clients IA et agents de code
- Fonctionnement
- Langage naturel + appels d’outils MCP
- Étape suivante
- Configurer le serveur MCP SocQ
Association recommandée · Couche de guidage pour agents
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.
Questions fréquentes
Qu’est-ce que le serveur MCP SocQ ?
Il s’agit d’un service MCP hébergé qui connecte les clients IA au catalogue d’API SocQ. Une fois connecté, un agent peut découvrir les fonctionnalités, soumettre des collectes de données sociales publiques et lire les résultats des tâches.
Comment ajouter SocQ à Codex, Claude, Cursor ou VS Code ?
Codex peut se connecter directement à l’endpoint Streamable HTTP hébergé. Claude Desktop, Cursor et VS Code peuvent exécuter le bridge stdio @socq/mcp. Copiez la configuration correspondante ci-dessus, renseignez SOCQ_API_KEY et reconnectez le client.
Une URL MCP correspond-elle à une seule API ?
Non. L’endpoint par défaut découvre et exécute tout le catalogue de fonctionnalités SocQ à partir de l’ID d’endpoint. Les modes Plateformes et Outils exacts peuvent à la place exposer certaines fonctionnalités sous forme d’outils typés.
Pourquoi la connexion par défaut n’expose-t-elle pas chaque API comme un outil distinct ?
Le mode compact recherche et décrit un endpoint uniquement quand c’est nécessaire. Le catalogue complet de schémas reste ainsi hors du contexte du modèle, ce qui réduit la consommation de contexte et rend le choix des outils plus prévisible.
Puis-je l’utiliser sans clé API ?
La découverte des plateformes, des endpoints et des schémas est publique. Les opérations de collecte, de compte, de résultats de tâche et de fichier nécessitent une clé API SocQ valide.
Pourquoi une collecte ne renvoie-t-elle pas tous les résultats immédiatement ?
Les collectes SocQ sont asynchrones. La soumission renvoie un ID de tâche et peut attendre jusqu’à 30 secondes. Si la tâche est toujours en cours, l’agent poursuit avec socq_get_task au lieu de la soumettre à nouveau.
En quoi MCP diffère-t-il de l’API REST ?
Les deux reposent sur les mêmes définitions de fonctionnalités, les mêmes données métier, les mêmes règles de facturation, les mêmes limites et le même modèle de tâche asynchrone. MCP ajoute la découverte et l’appel d’outils structuré, de sorte qu’un client IA n’a pas besoin d’une intégration HTTP écrite à la main.
Comment l’utilisation de MCP est-elle facturée ?
MCP ne modifie pas la facturation des endpoints. Les collectes suivent les mêmes crédits, les mêmes limites de clé API et les mêmes règles de compte que REST. Les outils de découverte ne soumettent aucune tâche de collecte.
À quelles données un agent peut-il accéder ?
Un agent peut uniquement appeler les fonctionnalités de données sociales publiques 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.