Instale la CLI de SocQ
Agregue el paquete publicado @socq/cli y deje disponible el comando socq en su terminal.
Use una sola línea de comandos en todas las plataformas sociales públicas para descubrir el catálogo de API en vivo, enviar recolecciones, completar tareas asíncronas y entregar resultados normalizados a scripts de shell, CI y flujos de análisis de datos.
Instale la CLI de SocQ, guarde su clave de API de forma segura y ejecute un endpoint con la misma definición que se usa en la documentación de SocQ, MCP y REST.
Agregue el paquete publicado @socq/cli y deje disponible el comando socq en su terminal.
Guarde la clave en el llavero del sistema o en una configuración local protegida.
Ejecute el endpoint de comentarios de YouTube y continúe con el resultado normalizado.
En CI, proporcione SOCQ_API_KEY mediante su gestor de secretos para que las credenciales permanezcan protegidas en las ejecuciones automatizadas.
Leer la guía completa de la CLIExplore las APIs, envíe una recolección, consulte una tarea existente o exporte resultados. Cada comando funciona de forma independiente y se puede combinar en terminales locales, scripts de shell y CI cuando su flujo de trabajo lo requiera.
$ socq tools youtubeExplore los endpoints actuales de YouTube desde el Capability Registry en vivo.
Estos seis ejemplos usan los ID de endpoint vigentes de SocQ y entradas aceptadas. Cada comando está listo para copiarse y adaptarse a su flujo de trabajo.
Endpoint: youtube/commentsRecolecte los comentarios de YouTube visibles públicamente y espere los resultados normalizados.
Endpoint: x/searchCree un conjunto de datos específico de posts públicos de X a partir de una consulta de búsqueda.
Endpoint: tiktok/searchBusque videos públicos de TikTok y exporte registros normalizados.
Endpoint: instagram/commentsRecolecte los comentarios públicos de la URL de una publicación de Instagram conocida.
Endpoint: facebook-ad-library/searchBusque por palabra clave los creativos públicos de la Facebook Ad Library.
Endpoint: linkedin/jobsNormalice una página pública de empleo de LinkedIn en campos estructurados de la oferta.
La CLI de SocQ envía cada recolección como una tarea en segundo plano y devuelve un ID de tarea. Espere en el mismo comando con --wait o guarde el ID de tarea y retómela más tarde; después lea los resultados normalizados u obtenga los archivos disponibles.
Ejecute un comando de plataforma y recurso para crear una tarea en segundo plano.
La CLI devuelve la referencia única que sirve para esperar, retomar y leer los resultados.
Use --wait de inmediato o continúe la misma tarea más tarde con su ID de tarea.
Exporte los resultados normalizados y revise los archivos disponibles cuando la tarea termine con éxito.
01 / Enviar una recolección
Ejecute el comando de la plataforma y el recurso correspondientes. La CLI envía la recolección como una tarea en segundo plano.
task_id: TASK_IDLa CLI devuelve el ID de tarea único después del envío.
La CLI de SocQ lleva a su terminal el catálogo de API en vivo, el control de tareas asíncronas y los resultados normalizados. Valide un comando de forma local y use después el mismo flujo de trabajo en scripts de shell y pipelines automatizados, sin mantener recolectores distintos para cada plataforma.
Las plataformas, los endpoints, los esquemas de entrada y la información de facturación provienen del Capability Registry en vivo, por lo que no necesita mantener un segundo catálogo fijo de comandos.
REGISTRO EN VIVO → COMANDOS ACTUALES
La salida en JSON, JSONL, CSV y tabla, la exportación a archivos y los códigos de salida significativos hacen que el mismo modelo de comandos sea confiable en scripts de shell y pipelines automatizados.
JSON · JSONL · CSV · CÓDIGOS DE SALIDA
Conserve el ID de tarea para retomarla después de un tiempo de espera agotado o de un proceso interrumpido, y continúe con los resultados paginados y los archivos disponibles sin volver a enviar la recolección.
ENVIAR → TASK_ID → RETOMAR → RESULTADOS
MCP, CLI y REST son vías de ejecución. Agent Skill es una capa de orientación. Comparten un mismo catálogo de API y el mismo modelo de tareas asíncronas, de modo que puede elegir la interfaz que mejor se adapte a su flujo de trabajo.
Use un solo modelo de comandos para descubrir API, enviar recopilaciones, reanudar tareas asíncronas y exportar resultados normalizados a archivos y automatizaciones.
Mejora opcional · Agent Skill
Agregue orientación sobre selección de endpoints, control de costos, paginación y recuperación de tareas. Combínela primero con MCP, o ejecute mediante CLI o REST.
La CLI de SocQ es la herramienta de línea de comandos de SocQ. Sirve para descubrir y llamar APIs de SocQ, enviar recolecciones de datos públicos de redes sociales, esperar o retomar tareas asíncronas y exportar resultados normalizados a archivos, scripts y pipelines automatizados.
Use la CLI para trabajar en la terminal, en scripts de shell, pipelines automatizados, recolecciones por lotes y exportaciones de archivos. Use MCP cuando un cliente de IA deba descubrir y llamar herramientas directamente, o la API REST para integraciones de aplicaciones de larga duración.
Sí. La CLI lee las plataformas, los endpoints, los esquemas de entrada y la información de facturación vigentes desde el Capability Registry en vivo, por lo que los comandos disponibles siguen el catálogo de API de SocQ. Use socq platforms, socq tools y socq describe para revisar las funcionalidades actuales.
No necesariamente. Instale @socq/cli de forma global para el uso habitual, de modo que el comando socq esté siempre disponible. Use npx @socq/cli para comandos ocasionales o para explorar primero el catálogo de API.
Puede explorar el Capability Registry público sin clave de API. Las recolecciones, las consultas de cuenta y el acceso a tareas o archivos sí la requieren. Use socq auth login para el trabajo local y proporcione SOCQ_API_KEY mediante un gestor de secretos en los pipelines automatizados.
No. Un tiempo de espera local agotado no cancela la tarea en el servidor. Conserve el ID de tarea y vuelva a ejecutar socq task get o socq task wait para continuar la misma tarea sin volver a enviar la recolección.
La CLI de SocQ admite tabla, JSON, JSONL y CSV. Lea los resultados pequeños en la terminal o use --output para escribir los resultados normalizados en un archivo para scripts, hojas de cálculo o análisis de datos.
La CLI de SocQ requiere Node.js 20 o posterior y funciona en Windows, macOS y Linux.