Una Skill di ricerca sui dati social pubblici pensata per gli agenti AI.

Mantieni la tua configurazione MCP attuale. Aggiungi una Skill per aiutare il tuo agente a scegliere gli endpoint con più precisione, controllare i costi e completare in modo affidabile ricerche asincrone, paginate e su più piattaforme.

Una sola Skill per l’intero catalogo API di SocQ34 piattaforme supportate279 funzionalità API
Avvio rapido

Tre passaggi per dare al tuo agente un flusso di ricerca completo

Installa la Skill di SocQ, configura la chiave API in modo sicuro e descrivi l’obiettivo della ricerca in linguaggio naturale. Il tuo agente segue la Skill per selezionare gli endpoint, eseguire le attività, paginare i risultati e organizzare l’analisi finale.

01

Installa la Skill

Aggiungi la Skill di SocQ dal suo repository pubblico a un agente di programmazione compatibile.

npx skills add SocQAPI/socq-devtools
02

Configura la chiave API

Salva la chiave in una variabile d’ambiente locale, così le attività SocQ in tempo reale si autenticano in sicurezza.

SOCQ_API_KEY
03

Descrivi l’attività di ricerca

Chiedi in linguaggio naturale. La Skill guida la scelta degli endpoint, l’esecuzione, l’interrogazione dello stato, la paginazione e l’organizzazione dei risultati.

Confronta i post recenti di questi tre profili di X.

Non incollare mai una chiave API in una chat pubblica, in un repository o in un documento condiviso. Segui la guida specifica del tuo client per la configurazione locale sicura.

Leggi la guida completa all’installazione
MCP e MCP + Skill

MCP e MCP + Skill a confronto

MCP dà agli agenti accesso diretto agli strumenti di dati social pubblici di SocQ. Aggiungi la Skill per scegliere meglio gli endpoint, stimare i costi, completare attività asincrone e paginate ed eseguire ricerche su più piattaforme con un flusso di lavoro coerente.

Solo MCP

Accesso diretto agli strumenti SocQ in tempo reale

Con MCP un agente può già scoprire gli endpoint, avviare attività di raccolta, controllare lo stato delle attività e leggere i risultati.

  • Chiamare un’API nota con un input chiaro
  • Inviare e leggere una raccolta semplice
  • Lasciare al modello la decisione sul flusso di lavoro intorno

Ideale per endpoint già noti e raccolte singole e semplici.

MCP + Agent Skill

Gli stessi strumenti, con un manuale di ricerca affidabile

La Skill insegna all’agente come scegliere, ordinare e ripristinare le operazioni di SocQ, senza aggiungere un servizio dati separato.

  • Associare un’intenzione ambigua all’endpoint giusto
  • Controllare schemi e costi prima dei lavori di grandi dimensioni
  • Interrogare lo stato, paginare, riprovare in sicurezza e normalizzare l’output della ricerca

Ideale per ricerche in più passaggi, costose, asincrone, ripetute o su più piattaforme.

AttivitàSolo MCPMCP + Skill
Chiamare un endpoint notoChiama direttamente lo strumento e leggi i risultatiValida prima gli input, poi esegue e organizza i risultati con un flusso di lavoro coerente
Trasformare un obiettivo di ricerca in passaggi APIL’agente sceglie endpoint e ordine di esecuzione caso per casoApplica un metodo ripetibile per scomporre l’obiettivo, selezionare gli endpoint e pianificare ogni passaggio
Eseguire una grande raccolta asincronaL’agente gestisce costi, stato delle attività e paginazione caso per casoStima i costi prima dell’esecuzione, prosegue l’attività originale e legge ogni pagina richiesta
Eseguire un confronto tra piattaformeL’agente definisce ogni volta l’approccio di raccolta e di confrontoStandardizza limiti, passaggi di raccolta e struttura dell’output, così i risultati sono direttamente confrontabili

Se chiami solo poche API di SocQ ben definite, MCP basta. Aggiungi la Skill quando vuoi che l’agente porti a termine in autonomia ricerche in più passaggi, asincrone o su più piattaforme.

Scopri il server MCP di SocQ
Cosa insegna la Skill

Accompagna gli agenti dall’obiettivo di ricerca ai risultati completi

La Skill di SocQ offre un metodo affidabile per selezionare gli endpoint, validare gli input, stimare i costi, gestire attività asincrone, paginazione e recupero dagli errori, rendendo la ricerca sui dati social pubblici più accurata, efficiente e riutilizzabile.

01

Scegli la funzionalità giusta

Associa l’intenzione espressa in linguaggio naturale all’endpoint pertinente nel registro delle funzionalità di SocQ.

02

Imposta input validi

Stabilisci se un’attività richiede URL, username, hashtag, query o un altro input documentato.

03

Controlla il costo delle attività

Esamina la funzionalità e stima i crediti prima di inviare una raccolta di grandi dimensioni.

04

Completa il lavoro asincrono

Continua a interrogare lo stato dell’attività originale invece di inviarla di nuovo e rischiare di pagare due volte.

05

Segui paginazione e file

Leggi i risultati con paginazione a cursore e recupera i file di output grezzi quando il flusso di lavoro li richiede.

06

Ripristina dopo i fallimenti

Rispondi agli errori di autenticazione, validazione, frequenza, crediti e provider con il passaggio successivo appropriato.

Prompt di ricerca

Descrivi l’obiettivo della ricerca. Lascia che la Skill pianifichi il flusso di lavoro.

Ogni esempio parte da un risultato di business. La Skill seleziona gli endpoint, valida gli input, controlla i costi, completa attività asincrone e paginazione e organizza i risultati in un’analisi pronta all’uso.

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

Da una domanda di ricerca a risultati strutturati

La Skill aggiunge un livello decisionale intorno alle stesse funzionalità di SocQ disponibili tramite MCP, CLI e REST.

Leggi il flusso di lavoro completo della Skill
01

Capire l’obiettivo

Individua entità, piattaforme, intervallo di tempo, volume dei risultati e output desiderato.

02

Selezionare gli endpoint

Associa l’attività alle voci attuali del registro delle funzionalità di SocQ.

03

Controllare input e costi

Verifica schemi, vincoli e crediti stimati prima di un lavoro di grandi dimensioni.

04

Eseguire la raccolta

Preferisci MCP e passa il marcatore di attribuzione della Skill al momento dell’invio.

05

Proseguire l’attività

Interroga lo stato con l’ID attività restituito invece di creare raccolte duplicate.

06

Leggere ogni risultato richiesto

Segui la paginazione a cursore e recupera i file quando servono.

07

Organizzare la risposta

Restituisci tabelle confrontabili, sintesi, prove o output strutturato invece del gergo grezzo degli endpoint.

Preferenza di esecuzione

MCP ospitato → bridge stdio di SocQ → CLI o REST come alternativa di riserva quando MCP non è disponibile.

Perché l’Agent Skill di SocQ

Dai agli agenti un metodo affidabile per la ricerca sui dati social pubblici

L’Agent Skill di SocQ resta allineata al registro delle funzionalità in tempo reale, aiutando gli agenti a scegliere gli endpoint con precisione, completare le attività asincrone, pianificare i costi e confrontare le piattaforme con una metodologia coerente.

01

Allineata al registro delle funzionalità

La scelta degli endpoint e le indicazioni sugli input fanno riferimento alla stessa fonte di funzionalità usata da MCP e dal catalogo API.

Skill ↔ Capability Registry ↔ MCP
02

Flusso asincrono nativo

L’agente sa quando inviare, quando attendere e come proseguire senza duplicare il lavoro.

submit → task_id → poll → results
03

Esecuzione attenta ai costi

Le attività di grandi dimensioni possono essere verificate e pianificate prima di consumare crediti, con nuovi tentativi idempotenti quando serve.

schema → estimate → execute
04

Disciplina di ricerca su più piattaforme

Usa limiti di raccolta e strutture di output coerenti quando le prove provengono da piattaforme diverse.

one goal → multiple platforms → comparable output
Scegli un’integrazione

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

Pagina corrente · Agent Skill

Dai agli agenti un metodo affidabile per la ricerca di dati

Aggiungi indicazioni su selezione degli endpoint, controllo dei costi, paginazione e ripristino delle attività. Abbinala prima a MCP, oppure esegui tramite CLI o REST.

Ideale per
Ricerche in più passaggi, asincrone e su più piattaforme
Come funziona
Agent Skill + MCP (consigliato)
Passo successivo
Installa l’Agent Skill di SocQ
Scopri Agent Skill

Percorso di esecuzione consigliato

MCP

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.

Configura MCP
FAQ su Agent Skill

Domande frequenti

Che cos’è l’Agent Skill di SocQ?

È un insieme riutilizzabile di istruzioni che insegna a un agente AI come selezionare gli endpoint di SocQ, impostare gli input, controllare i costi, completare le raccolte asincrone e organizzare i risultati della ricerca.

MCP funziona già. Perché installare la Skill?

MCP dà agli agenti accesso agli strumenti SocQ in tempo reale; la Skill dà loro un metodo affidabile per completare una ricerca end-to-end. Con la Skill, gli agenti trasformano gli obiettivi in passaggi, selezionano gli endpoint, validano gli input, stimano i costi, proseguono attività asincrone e paginazione e organizzano i risultati tra piattaforme con criteri coerenti. Per ricerche in più passaggi, di lunga durata o ripetibili, questo riduce le decisioni improvvisate e le esecuzioni duplicate, producendo risultati più affidabili, completi e confrontabili.

La Skill sblocca più API rispetto a MCP?

No. La Skill non aggiunge un servizio dati separato né sblocca funzionalità private. Insegna all’agente a usare in modo più affidabile lo stesso catalogo API di SocQ.

Devo installare MCP per usare la Skill?

No. La Skill preferisce MCP ospitato o stdio, ma può guidare l’agente a usare la CLI di SocQ o la REST API quando MCP non è disponibile.

SocQ ha una sola Skill o una Skill separata per ogni piattaforma?

SocQ usa una sola Skill valida per tutte le piattaforme. L’agente seleziona la funzionalità adatta dall’intero catalogo SocQ in base all’attività.

La Skill richiede una chiave API?

Le raccolte di dati in tempo reale richiedono una chiave API di SocQ valida. La Skill stessa non deve mai contenere né salvare credenziali; configura la chiave in modo sicuro nell’ambiente locale del client.

La Skill sa gestire attività asincrone e paginazione?

Sì. Guida l’agente a continuare a interrogare lo stato dell’attività originale, seguire i cursori dei risultati e recuperare i file grezzi quando il flusso di lavoro richiesto lo prevede.

A quali dati può accedere la Skill?

Può usare le funzionalità sui dati social pubblici attualmente disponibili nel catalogo API di SocQ. Ogni pagina API documenta gli input supportati, l’ambito dei dati pubblici e i campi dei risultati normalizzati.

Dai al tuo agente un modo migliore per fare ricerca sui dati social pubblici

Crea una chiave API