Creada para desarrolladores y flujos de trabajo automatizadosUna CLI de datos públicos de redes sociales para todas las plataformas.

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.

Node.js 20+Capability Registry en vivo34 plataformas279 endpoints de API
Inicio rápido

Tres pasos para su primera recolección de datos públicos de redes sociales

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.

01

Instale la CLI de SocQ

Agregue el paquete publicado @socq/cli y deje disponible el comando socq en su terminal.

02

Configure su clave de API

Guarde la clave en el llavero del sistema o en una configuración local protegida.

03

Envíe su primera tarea

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 CLI
Qué puede hacer la CLI de SocQ

Elija el comando de la CLI que necesita su tarea

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

Ejemplos de comandos independientes
$ socq tools youtube

Explore los endpoints actuales de YouTube desde el Capability Registry en vivo.

Ejemplos reales de comandos

Copie un comando y comience a recolectar datos públicos de redes sociales

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.

01
YouTube Comments API
Endpoint: youtube/comments

Recolecte los comentarios de YouTube visibles públicamente y espere los resultados normalizados.

02
Twitter Search API
Endpoint: x/search

Cree un conjunto de datos específico de posts públicos de X a partir de una consulta de búsqueda.

03
TikTok Search API
Endpoint: tiktok/search

Busque videos públicos de TikTok y exporte registros normalizados.

04
Instagram Comments API
Endpoint: instagram/comments

Recolecte los comentarios públicos de la URL de una publicación de Instagram conocida.

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

Busque por palabra clave los creativos públicos de la Facebook Ad Library.

06
LinkedIn Jobs API
Endpoint: linkedin/jobs

Normalice una página pública de empleo de LinkedIn en campos estructurados de la oferta.

Cómo funciona la CLI

Envíe una vez y siga hasta completar los resultados

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.

  1. 01

    Enviar una recolección

    Ejecute un comando de plataforma y recurso para crear una tarea en segundo plano.

  2. 02

    Recibir un ID de tarea

    La CLI devuelve la referencia única que sirve para esperar, retomar y leer los resultados.

  3. 03

    Esperar ahora o retomar después

    Use --wait de inmediato o continúe la misma tarea más tarde con su ID de tarea.

  4. 04

    Leer resultados u obtener archivos

    Exporte los resultados normalizados y revise los archivos disponibles cuando la tarea termine con éxito.

Flujo de ejecución de la CLI

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_ID

La CLI devuelve el ID de tarea único después del envío.

Por qué la CLI de SocQ

Un solo modelo de comandos, desde la recolección local hasta los pipelines automatizados

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 nuevas funcionalidades de API quedan listas como comandos

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

Pase de la validación local a la automatización

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

Retome tareas de larga duración sin empezar de nuevo

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

Elegir una integración

¿Dónde debe conectarse su flujo de trabajo con SocQ?

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.

Lleve SocQ a terminales y pipelines automatizados

Use un solo modelo de comandos para descubrir API, enviar recopilaciones, reanudar tareas asíncronas y exportar resultados normalizados a archivos y automatizaciones.

Ideal para
Desarrolladores, scripts de shell y pipelines automatizados
Cómo funciona
Comandos socq + salida estructurada
Siguiente paso
Instalar y ejecutar SocQ CLI
Usar CLI

Mejora opcional · Agent Skill

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.

Explorar Agent Skill
FAQ de la CLI

Preguntas frecuentes

¿Qué es la CLI de SocQ?

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.

¿Cuándo debo usar la CLI de SocQ?

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.

¿La CLI de SocQ cubre todo el catálogo de API de SocQ?

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.

¿Debo instalar la CLI de SocQ de forma global?

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.

¿Necesito una clave de API para usar la CLI de SocQ?

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.

¿Se cancela mi recolección si se agota el tiempo de espera?

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.

¿Qué formatos de salida admite la CLI de SocQ?

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.

¿Qué sistemas y entornos de ejecución admite la CLI de SocQ?

La CLI de SocQ requiere Node.js 20 o posterior y funciona en Windows, macOS y Linux.

Comience a recolectar datos públicos de redes sociales con un solo comando

Crear clave de API