Pensata per chi sviluppa e per i flussi di lavoro automatizzatiUna CLI per i dati social pubblici su più piattaforme.

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.

Node.js 20+Registro delle funzionalità in tempo reale34 piattaforme279 endpoint API
Avvio rapido

Tre passaggi per la tua prima raccolta di dati social pubblici

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.

01

Installa la CLI di SocQ

Aggiungi il pacchetto @socq/cli pubblicato e rendi disponibile il comando socq nel tuo terminale.

02

Configura la chiave API

Salva la chiave nel portachiavi di sistema o in una configurazione locale protetta.

03

Invia la tua prima attività

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 CLI
Cosa può fare la CLI di SocQ

Scegli il comando della CLI di cui ha bisogno la tua attività

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

Esempi di comandi indipendenti
$ socq tools youtube

Esplora gli endpoint YouTube attuali dal registro delle funzionalità in tempo reale.

Esempi di comandi reali

Copia un comando e inizia a raccogliere dati social pubblici

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.

01
YouTube Comments API
Endpoint: youtube/comments

Raccogli i commenti di YouTube visibili pubblicamente e attendi i risultati normalizzati.

02
Twitter Search API
Endpoint: x/search

Crea un dataset mirato di post pubblici di X a partire da una query di ricerca.

03
TikTok Search API
Endpoint: tiktok/search

Cerca video pubblici di TikTok ed esporta i record normalizzati.

04
Instagram Comments API
Endpoint: instagram/comments

Raccogli i commenti pubblici dall’URL di un post di Instagram noto.

05
Facebook Ad Library Search API
Endpoint: facebook-ad-library/search

Cerca per parola chiave le creatività pubbliche nella Facebook Ad Library.

06
LinkedIn Jobs API
Endpoint: linkedin/jobs

Normalizza una pagina pubblica di offerta di lavoro di LinkedIn in campi strutturati.

Come funziona la CLI

Invia una volta, prosegui fino ai risultati completi

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.

  1. 01

    Invia una raccolta

    Esegui un comando di piattaforma e risorsa per creare un’attività in background.

  2. 02

    Ricevi un ID attività

    La CLI restituisce il riferimento univoco usato per attendere, riprendere e leggere i risultati.

  3. 03

    Attendi ora o riprendi più tardi

    Usa --wait subito oppure prosegui la stessa attività più tardi con il suo ID attività.

  4. 04

    Leggi i risultati o recupera i file

    Esporta i risultati normalizzati e consulta i file disponibili dopo il completamento dell’attività.

Flusso di esecuzione della CLI

01 / Invia una raccolta

Esegui il comando di piattaforma e risorsa pertinente. La CLI invia la raccolta come attività in background.

task_id: TASK_ID

Dopo l’invio, la CLI restituisce l’ID attività univoco.

Perché la CLI di SocQ

Un unico modello di comandi, dalla raccolta locale alle pipeline automatizzate

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.

Le nuove funzionalità API sono subito disponibili come comandi

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

Dalla validazione locale all’automazione

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

Riprendi le attività lunghe senza ricominciare da capo

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

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.

Porta SocQ nei terminali e nelle pipeline automatizzate

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.

Ideale per
Sviluppatori, script di shell e pipeline automatizzate
Come funziona
Comandi socq + output strutturato
Passo successivo
Installa ed esegui la CLI di SocQ
Usa la CLI

Estensione facoltativa · Agent Skill

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.

Scopri Agent Skill
FAQ sulla CLI

Domande frequenti

Che cos’è la CLI di SocQ?

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.

Quando conviene usare la CLI di SocQ?

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.

La CLI di SocQ copre l’intero catalogo API di SocQ?

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.

Devo installare la CLI di SocQ a livello globale?

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.

Mi serve una chiave API per usare la CLI di SocQ?

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.

La raccolta viene annullata se l’attesa scade?

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.

Quali formati di output supporta la CLI di SocQ?

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.

Quali sistemi e runtime supporta la CLI di SocQ?

La CLI di SocQ richiede Node.js 20 o successivo e funziona su Windows, macOS e Linux.

Inizia a raccogliere dati social pubblici con un solo comando

Crea una chiave API