Installa la Skill
Aggiungi la Skill di SocQ dal suo repository pubblico a un agente di programmazione compatibile.
npx skills add SocQAPI/socq-devtoolsMantieni 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.
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.
Aggiungi la Skill di SocQ dal suo repository pubblico a un agente di programmazione compatibile.
npx skills add SocQAPI/socq-devtoolsSalva la chiave in una variabile d’ambiente locale, così le attività SocQ in tempo reale si autenticano in sicurezza.
SOCQ_API_KEYChiedi 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’installazioneMCP 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
Con MCP un agente può già scoprire gli endpoint, avviare attività di raccolta, controllare lo stato delle attività e leggere i risultati.
Ideale per endpoint già noti e raccolte singole e semplici.
MCP + Agent Skill
La Skill insegna all’agente come scegliere, ordinare e ripristinare le operazioni di SocQ, senza aggiungere un servizio dati separato.
Ideale per ricerche in più passaggi, costose, asincrone, ripetute o su più piattaforme.
| Attività | Solo MCP | MCP + Skill |
|---|---|---|
| Chiamare un endpoint noto | Chiama direttamente lo strumento e leggi i risultati | Valida prima gli input, poi esegue e organizza i risultati con un flusso di lavoro coerente |
| Trasformare un obiettivo di ricerca in passaggi API | L’agente sceglie endpoint e ordine di esecuzione caso per caso | Applica un metodo ripetibile per scomporre l’obiettivo, selezionare gli endpoint e pianificare ogni passaggio |
| Eseguire una grande raccolta asincrona | L’agente gestisce costi, stato delle attività e paginazione caso per caso | Stima i costi prima dell’esecuzione, prosegue l’attività originale e legge ogni pagina richiesta |
| Eseguire un confronto tra piattaforme | L’agente definisce ogni volta l’approccio di raccolta e di confronto | Standardizza 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 SocQLa 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.
Associa l’intenzione espressa in linguaggio naturale all’endpoint pertinente nel registro delle funzionalità di SocQ.
Stabilisci se un’attività richiede URL, username, hashtag, query o un altro input documentato.
Esamina la funzionalità e stima i crediti prima di inviare una raccolta di grandi dimensioni.
Continua a interrogare lo stato dell’attività originale invece di inviarla di nuovo e rischiare di pagare due volte.
Leggi i risultati con paginazione a cursore e recupera i file di output grezzi quando il flusso di lavoro li richiede.
Rispondi agli errori di autenticazione, validazione, frequenza, crediti e provider con il passaggio successivo appropriato.
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.
Usa: instagram/postsUsa: tiktok/searchUsa: x/searchUsa: youtube/searchUsa: linkedin/profilesUsa: reddit/postsLa Skill aggiunge un livello decisionale intorno alle stesse funzionalità di SocQ disponibili tramite MCP, CLI e REST.
Leggi il flusso di lavoro completo della SkillIndividua entità, piattaforme, intervallo di tempo, volume dei risultati e output desiderato.
Associa l’attività alle voci attuali del registro delle funzionalità di SocQ.
Verifica schemi, vincoli e crediti stimati prima di un lavoro di grandi dimensioni.
Preferisci MCP e passa il marcatore di attribuzione della Skill al momento dell’invio.
Interroga lo stato con l’ID attività restituito invece di creare raccolte duplicate.
Segui la paginazione a cursore e recupera i file quando servono.
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.
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.
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 ↔ MCPL’agente sa quando inviare, quando attendere e come proseguire senza duplicare il lavoro.
submit → task_id → poll → resultsLe attività di grandi dimensioni possono essere verificate e pianificate prima di consumare crediti, con nuovi tentativi idempotenti quando serve.
schema → estimate → executeUsa limiti di raccolta e strutture di output coerenti quando le prove provengono da piattaforme diverse.
one goal → multiple platforms → comparable outputMCP, 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
Aggiungi indicazioni su selezione degli endpoint, controllo dei costi, paginazione e ripristino delle attività. Abbinala prima a MCP, oppure esegui tramite CLI o REST.
Percorso di esecuzione consigliato
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.
È 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 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.
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.
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 usa una sola Skill valida per tutte le piattaforme. L’agente seleziona la funzionalità adatta dall’intero catalogo SocQ in base all’attività.
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.
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.
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.