Dati social pubblici su più piattaformetramite un MCP per gli agenti AI.
Collega una volta sola e lascia che il tuo agente scopra e chiami le API di dati social pubblici di SocQ.
https://api.socq.ai/mcpFlusso dei segnali dell’agente
Richiesta in linguaggio naturale
“Raccogli gli ultimi 100 commenti di questo video di YouTube, attendi il completamento dell’attività, poi restituisci il testo del commento, l’autore, la data di pubblicazione e il numero di Mi piace.”
Scoperta dell’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 ospitato
https://api.socq.ai/mcpTransport: Streamable HTTP
Metodo di configurazione
Scegli quanta parte del catalogo API deve vedere il tuo agente, seleziona il client e copia una configurazione generata dal registro attuale di piattaforme ed endpoint di SocQ.
Tieni la chiave API in una variabile d’ambiente e collega Codex direttamente all’endpoint Streamable HTTP ospitato di SocQ.
Client
~/.codex/config.tomlConfigurazione[mcp_servers.socq]url = "https://api.socq.ai/mcp"bearer_token_env_var = "SOCQ_API_KEY"tool_timeout_sec = 45Cosa può fare il tuo agente con il server MCP di SocQ?
Chiedi in linguaggio naturale. Il tuo agente sceglie la funzionalità adatta, legge i requisiti di input, avvia la raccolta e organizza i risultati normalizzati al termine dell’attività.
Basato su: youtube/commentsBasato su: x/searchBasato su: facebook-ad-library/searchBasato su: linkedin/jobsBasato su: tiktok-shop/searchBasato su: instagram/postsCome chiama un agente AI il server MCP di SocQ?
Il tuo client MCP gestisce il protocollo. Tu descrivi i dati che ti servono; l’agente scopre o seleziona uno strumento, avvia la raccolta e continua a leggere la stessa attività finché i risultati non sono pronti.
Leggi la documentazione sul flusso MCPChiedi i dati
Descrivi in linguaggio naturale un’attività sui dati social pubblici, indicando piattaforma, fonte e risultato desiderato.
user promptScopri o seleziona uno strumento
La modalità compatta cerca nel registro delle funzionalità. Le modalità Piattaforme e Strumenti specifici possono chiamare direttamente uno strumento tipizzato.
socq_search_endpoints → socq_describe_endpointAvvia la raccolta
SocQ valida l’input di business, crea una raccolta asincrona e restituisce il suo identificatore di attività.
socq_execute → task_idLeggi e organizza i risultati
L’agente prosegue con la stessa attività, legge le pagine di risultati normalizzati e presenta la risposta nel formato richiesto.
socq_get_task → results.itemsPensato per gli agenti AI che gestiscono dati social pubblici su più piattaforme
Una sola connessione MCP permette agli agenti di scoprire e chiamare API su più piattaforme, controllare quali strumenti entrano nel contesto e proseguire le attività di raccolta asincrone con risultati normalizzati, senza integrare ogni piattaforma separatamente.
Una connessione, catalogo completo
La scoperta compatta permette a un agente di cercare ed eseguire il catalogo API di SocQ senza configurare un server MCP per ogni piattaforma.
/mcp → search → describe → executeControlla il contesto degli strumenti
Passa dalla scoperta alle piattaforme selezionate e agli strumenti tipizzati specifici man mano che il flusso di lavoro diventa più prevedibile.
compact | platforms≤5 | tools≤30Un vero flusso di lavoro asincrono
Gli agenti possono proseguire l’attività originale, leggere risultati normalizzati con paginazione a cursore e recuperare i file senza avviare raccolte duplicate.
task_id → status → results.items → next_cursorDove deve collegarsi a SocQ il tuo flusso di lavoro?
MCP, CLI e REST sono percorsi di esecuzione. Agent Skill è un livello di guida. Condividono lo stesso catalogo API e lo stesso modello di attività asincrone, quindi puoi scegliere l’interfaccia più adatta al tuo flusso di lavoro.
Lascia che i client AI chiamino SocQ direttamente
Collega una volta sola, poi lascia che gli agenti scoprano gli strumenti in linguaggio naturale, avviino le raccolte e proseguano con i risultati delle attività asincrone.
- Ideale per
- Client AI e agenti di programmazione
- Come funziona
- Linguaggio naturale + chiamate agli strumenti MCP
- Passo successivo
- Configura il server MCP di SocQ
Abbinamento consigliato · Livello di guida per gli agenti
Agent Skill
Aggiungi indicazioni su selezione degli endpoint, controllo dei costi, paginazione e ripristino delle attività. Abbinala prima a MCP, oppure esegui tramite CLI o REST.
Domande frequenti
Che cos’è il server MCP di SocQ?
È un servizio MCP ospitato che collega i client AI al catalogo API di SocQ. Una volta collegato, un agente può scoprire le funzionalità, avviare raccolte di dati social pubblici e leggere i risultati delle attività.
Come aggiungo SocQ a Codex, Claude, Cursor o VS Code?
Codex può collegarsi direttamente all’endpoint Streamable HTTP ospitato. Claude Desktop, Cursor e VS Code possono eseguire il bridge stdio @socq/mcp. Copia la configurazione corrispondente qui sopra, fornisci SOCQ_API_KEY e ricollega il client.
Un URL MCP rappresenta una sola API?
No. L’endpoint predefinito scopre ed esegue l’intero catalogo di funzionalità di SocQ tramite l’ID endpoint. Le modalità Piattaforme e Strumenti specifici possono invece esporre funzionalità selezionate come strumenti tipizzati.
Perché la connessione predefinita non espone ogni API come strumento separato?
La modalità compatta cerca e descrive un endpoint solo quando serve. Così gli schemi dell’intero catalogo restano fuori dal contesto del modello, riducendone l’uso e rendendo più prevedibile la scelta degli strumenti.
Posso usarlo senza chiave API?
La scoperta di piattaforme, endpoint e schemi è pubblica. Le operazioni di raccolta, account, risultati delle attività e file richiedono una chiave API di SocQ valida.
Perché una raccolta non restituisce subito tutti i risultati?
Le raccolte di SocQ sono asincrone. L’invio restituisce un ID attività e può attendere fino a 30 secondi. Se l’attività è ancora in corso, l’agente prosegue con socq_get_task invece di inviarla di nuovo.
In cosa MCP è diverso dalla REST API?
Entrambe usano le stesse definizioni delle funzionalità, gli stessi input di business, le stesse regole di fatturazione, gli stessi limiti e lo stesso modello di attività asincrone. MCP aggiunge la scoperta e la chiamata strutturata degli strumenti, quindi un client AI non ha bisogno di un’integrazione HTTP scritta a mano.
Come viene fatturato l’utilizzo di MCP?
MCP non modifica la fatturazione degli endpoint. Le raccolte seguono gli stessi crediti, gli stessi limiti della chiave API e le stesse regole dell’account della REST API. Gli strumenti di scoperta non avviano raccolte.
A quali dati può accedere un agente?
Un agente può chiamare solo le funzionalità sui dati social pubblici disponibili nel catalogo API di SocQ. Ogni pagina API documenta gli input supportati, l’ambito dei dati pubblici e i campi dei risultati normalizzati.