Installa la CLI di SocQ
Aggiungi il pacchetto @socq/cli pubblicato e rendi disponibile il comando socq nel tuo terminale.
Usa un’unica riga di comando su tutte le piattaforme social pubbliche per scoprire il catalogo API in tempo reale, avviare raccolte, completare attività asincrone e consegnare risultati normalizzati a script di shell, CI e flussi di analisi dei dati.
Installa la CLI di SocQ, salva la chiave API in modo sicuro, poi esegui un endpoint con la stessa definizione usata nella documentazione di SocQ, in MCP e in REST.
Aggiungi il pacchetto @socq/cli pubblicato e rendi disponibile il comando socq nel tuo terminale.
Salva la chiave nel portachiavi di sistema o in una configurazione locale protetta.
Esegui l’endpoint dei commenti di YouTube e prosegui con il risultato normalizzato.
Per la CI, fornisci SOCQ_API_KEY tramite il tuo gestore dei segreti, così le credenziali restano protette nelle esecuzioni automatizzate.
Leggi la guida completa alla CLIEsplora le API, invia una raccolta, controlla un’attività esistente o esporta i risultati. Ogni comando funziona in modo indipendente e, se il tuo flusso di lavoro lo richiede, si può combinare con gli altri nei terminali locali, negli script di shell e nella CI.
$ socq tools youtubeEsplora gli endpoint YouTube attuali dal registro delle funzionalità in tempo reale.
Questi sei esempi usano gli ID endpoint attuali di SocQ e input accettati. Ogni comando è pronto da copiare e adattare al tuo flusso di lavoro.
Endpoint: youtube/commentsRaccogli i commenti di YouTube visibili pubblicamente e attendi i risultati normalizzati.
Endpoint: x/searchCrea un dataset mirato di post pubblici di X a partire da una query di ricerca.
Endpoint: tiktok/searchCerca video pubblici di TikTok ed esporta i record normalizzati.
Endpoint: instagram/commentsRaccogli i commenti pubblici dall’URL di un post di Instagram noto.
Endpoint: facebook-ad-library/searchCerca per parola chiave le creatività pubbliche nella Facebook Ad Library.
Endpoint: linkedin/jobsNormalizza una pagina pubblica di offerta di lavoro di LinkedIn in campi strutturati.
La CLI di SocQ invia ogni raccolta come attività in background e restituisce un ID attività. Attendi nel comando corrente con --wait oppure salva l’ID attività e riprendi più tardi, poi leggi i risultati normalizzati o recupera i file disponibili.
Esegui un comando di piattaforma e risorsa per creare un’attività in background.
La CLI restituisce il riferimento univoco usato per attendere, riprendere e leggere i risultati.
Usa --wait subito oppure prosegui la stessa attività più tardi con il suo ID attività.
Esporta i risultati normalizzati e consulta i file disponibili dopo il completamento dell’attività.
01 / Invia una raccolta
Esegui il comando di piattaforma e risorsa pertinente. La CLI invia la raccolta come attività in background.
task_id: TASK_IDDopo l’invio, la CLI restituisce l’ID attività univoco.
La CLI di SocQ porta nel tuo terminale il catalogo API in tempo reale, il controllo delle attività asincrone e i risultati normalizzati. Valida un comando in locale, poi usa lo stesso flusso di lavoro negli script di shell e nelle pipeline automatizzate, senza mantenere collector separati per ogni piattaforma.
Piattaforme, endpoint, schemi di input e indicazioni di fatturazione arrivano dal registro delle funzionalità in tempo reale, quindi non devi mantenere un secondo catalogo di comandi fisso.
LIVE REGISTRY → CURRENT COMMANDS
Output JSON, JSONL, CSV e in tabella, esportazione su file e codici di uscita significativi rendono affidabile lo stesso modello di comandi negli script di shell e nelle pipeline automatizzate.
JSON · JSONL · CSV · EXIT CODES
Conserva l’ID attività per riprendere dopo un timeout o un processo interrotto, poi prosegui con i risultati paginati e i file disponibili senza inviare di nuovo la raccolta.
SUBMIT → TASK_ID → RESUME → RESULTS
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.
Usa un unico modello di comandi per scoprire le API, avviare le raccolte, riprendere le attività asincrone ed esportare i risultati normalizzati in file e automazioni.
Estensione facoltativa · 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.
La CLI di SocQ è lo strumento da riga di comando di SocQ. Usala per scoprire e chiamare le API di SocQ, avviare raccolte di dati social pubblici, attendere o riprendere attività asincrone ed esportare i risultati normalizzati in file, script e pipeline automatizzate.
Usa la CLI per il lavoro da terminale, gli script di shell, le pipeline automatizzate, le raccolte in batch e le esportazioni su file. Usa MCP quando un client AI deve scoprire e chiamare direttamente gli strumenti, oppure la REST API per le integrazioni di applicazioni di lunga durata.
Sì. La CLI legge piattaforme, endpoint, schemi di input e indicazioni di fatturazione attuali dal registro delle funzionalità in tempo reale, quindi i comandi disponibili seguono il catalogo API di SocQ. Usa socq platforms, socq tools e socq describe per consultare le funzionalità attuali.
Non necessariamente. Installa @socq/cli a livello globale per l’uso regolare, così il comando socq è sempre disponibile. Usa npx @socq/cli per comandi occasionali o per esplorare prima il catalogo API.
Puoi consultare il registro pubblico delle funzionalità senza chiave API. Raccolte, interrogazioni dell’account e accesso ad attività o file ne richiedono una. Usa socq auth login per il lavoro in locale e fornisci SOCQ_API_KEY tramite un gestore dei segreti nelle pipeline automatizzate.
No. Il timeout di un’attesa locale non annulla l’attività lato server. Conserva l’ID attività ed esegui di nuovo socq task get o socq task wait per proseguire la stessa attività senza inviare di nuovo la raccolta.
La CLI di SocQ supporta tabella, JSON, JSONL e CSV. Leggi i risultati piccoli nel terminale, oppure usa --output per scrivere i risultati normalizzati in un file da usare con script, fogli di calcolo o analisi dei dati.
La CLI di SocQ richiede Node.js 20 o successivo e funziona su Windows, macOS e Linux.