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/mcp
TransportStreamable HTTP

Clients pris en charge

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.

02 / Configuration

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 = 45
Ouvrir le guide de configuration

Ce que les agents peuvent faire

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

01
YouTube Comments APIBasé sur: youtube/comments
02
Twitter Search APIBasé sur: x/search
03
Facebook Ad Library Search APIBasé sur: facebook-ad-library/search
04
LinkedIn Jobs APIBasé sur: linkedin/jobs
05
TikTok Shop Search APIBasé sur: tiktok-shop/search
06
Instagram Posts APIBasé sur: instagram/posts
Du prompt aux résultats

Comment 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 MCP
01

Demander 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 utilisateur
02

Dé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_endpoint
03

Soumettre la collecte

SocQ valide les données métier, crée une collecte asynchrone et renvoie son identifiant de tâche.

socq_execute → task_id
04

Lire 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.items
Trace type en mode compact
Requête en langage naturelDécouverte de l’endpointSoumission de la tâchetask_idLecture des résultats
Pourquoi SocQ MCP

Conç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.

01

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 → execute
02

Maî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≤30
03

Un 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_cursor
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.

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
Configurer MCP

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.

Découvrir Agent Skill
FAQ MCP

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.

Connectez votre agent IA aux données sociales publiques de toutes les plateformes

Créer une clé API