Instale la Skill
Agregue la Skill de SocQ desde su repositorio público a un agente de programación compatible.
npx skills add SocQAPI/socq-devtoolsConserve su configuración MCP actual. Agregue una Skill para que su agente elija los endpoints con más precisión, controle el costo y complete de forma confiable investigaciones asíncronas, paginadas y entre plataformas.
Instale la Skill de SocQ, configure su clave de API de forma segura y describa el objetivo de la investigación en lenguaje natural. Su agente sigue la Skill para seleccionar endpoints, ejecutar tareas, paginar resultados y organizar el análisis final.
Agregue la Skill de SocQ desde su repositorio público a un agente de programación compatible.
npx skills add SocQAPI/socq-devtoolsGuarde la clave en una variable de entorno local para que las tareas de SocQ en vivo se autentiquen de forma segura.
SOCQ_API_KEYPida lo que necesita en lenguaje natural. La Skill guía la elección del endpoint, la ejecución, la consulta, la paginación y la organización de los resultados.
Compare las publicaciones recientes de estos tres perfiles de X.Nunca pegue una clave de API en un chat público, un repositorio o un documento compartido. Siga la guía específica de su cliente para una configuración local segura.
Leer la guía de instalación completaMCP da a los agentes acceso directo a las herramientas de datos públicos de redes sociales de SocQ. Agregue la Skill para mejorar la elección de endpoints, estimar el costo, completar tareas asíncronas y paginadas, y realizar investigaciones entre plataformas con un flujo de trabajo coherente.
Solo MCP
MCP ya permite a un agente descubrir endpoints, enviar tareas de recolección, consultar el estado de las tareas y leer los resultados.
Ideal para endpoints conocidos y recolecciones puntuales sencillas.
MCP + Agent Skill
La Skill enseña al agente a elegir, ordenar y recuperar las operaciones de SocQ sin agregar un servicio de datos aparte.
Ideal para investigaciones de varios pasos, costosas, asíncronas, repetidas o entre plataformas.
| Tarea | Solo MCP | MCP + Skill |
|---|---|---|
| Llamar a un endpoint conocido | Llamar directamente a la herramienta y leer los resultados | Validar primero las entradas y luego ejecutar y organizar los resultados con un flujo de trabajo coherente |
| Convertir un objetivo de investigación en pasos de API | El agente elige los endpoints y el orden de ejecución caso por caso | Aplicar un método repetible para desglosar el objetivo, seleccionar endpoints y planificar cada paso |
| Ejecutar una recolección asíncrona grande | El agente gestiona el costo, el estado de la tarea y la paginación caso por caso | Estimar el costo antes de ejecutar, continuar la tarea original y leer todas las páginas solicitadas |
| Realizar una comparación entre plataformas | El agente define cada vez cómo recolectar y comparar | Estandarizar los límites, los pasos de recolección y la estructura de salida para que los resultados sean directamente comparables |
Si solo llama a unas pocas APIs de SocQ bien definidas, MCP es suficiente. Agregue la Skill cuando quiera que el agente complete por sí solo investigaciones de varios pasos, asíncronas o entre plataformas.
Explorar el MCP de SocQLa Skill de SocQ ofrece un método confiable para elegir endpoints, validar entradas, estimar costos, manejar tareas asíncronas, paginar y recuperarse de errores, de modo que la investigación de datos públicos de redes sociales sea más precisa, eficiente y reutilizable.
Asocia la intención en lenguaje natural con el endpoint correspondiente del SocQ Capability Registry.
Determina si una tarea necesita URLs, nombres de usuario, hashtags, consultas u otra entrada documentada.
Revisa la funcionalidad y estima los créditos antes de enviar una recolección grande.
Sigue consultando la tarea original en lugar de volver a enviarla y pagar dos veces.
Lee los resultados con paginación por cursor y obtiene los archivos de salida sin procesar cuando el flujo de trabajo lo necesita.
Responde con el siguiente paso adecuado a los errores de autenticación, validación, límite de solicitudes, créditos y del proveedor.
Cada ejemplo parte de un resultado de negocio. La Skill selecciona los endpoints, valida las entradas, controla el costo, completa las tareas asíncronas y la paginación, y organiza los resultados en un análisis listo para usar.
Usa: instagram/postsUsa: tiktok/searchUsa: x/searchUsa: youtube/searchUsa: linkedin/profilesUsa: reddit/postsLa Skill agrega una capa de decisión alrededor de las mismas funcionalidades de SocQ disponibles mediante MCP, CLI y REST.
Leer el flujo de trabajo completo de la SkillIdentifica las entidades, las plataformas, el rango de tiempo, el volumen de resultados y la salida deseada.
Asocia la tarea con las entradas vigentes del SocQ Capability Registry.
Comprueba los esquemas, las restricciones y los créditos estimados antes de un trabajo grande.
Prefiere MCP y pasa el marcador de atribución de la Skill al enviar.
Consulta el ID de tarea devuelto en lugar de crear recolecciones duplicadas.
Sigue la paginación por cursor y obtiene los archivos cuando hace falta.
Devuelve tablas comparables, resúmenes, evidencias o salida estructurada en lugar de jerga de endpoints sin procesar.
Preferencia de ejecución
MCP alojado → puente stdio de SocQ → CLI o REST como alternativa de respaldo cuando MCP no está disponible.
La Agent Skill de SocQ se mantiene alineada con el Capability Registry en vivo y ayuda a los agentes a elegir endpoints con precisión, completar tareas asíncronas, planificar el costo y comparar plataformas con una metodología coherente.
La elección de endpoints y la guía de entradas consultan la misma fuente de funcionalidades que usan MCP y el catálogo de API.
Skill ↔ Capability Registry ↔ MCPEl agente sabe cuándo enviar, cuándo esperar y cómo continuar sin duplicar trabajo.
enviar → task_id → consultar → resultadosLas tareas grandes pueden revisarse y planificarse antes de consumir créditos, con reintentos idempotentes cuando corresponde.
esquema → estimación → ejecuciónUse límites de recolección y estructuras de salida coherentes cuando las evidencias provienen de distintas plataformas.
un objetivo → varias plataformas → salida comparableMCP, 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.
Página actual · 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.
Vía de ejecución preferida
Conecte una sola vez y deje que los agentes descubran herramientas en lenguaje natural, envíen recopilaciones y continúen con los resultados de tareas asíncronas.
Es un conjunto reutilizable de instrucciones que enseña a un agente de IA a seleccionar endpoints de SocQ, preparar las entradas, controlar el costo, completar recolecciones asíncronas y organizar los resultados de la investigación.
MCP da a los agentes acceso a las herramientas de SocQ en vivo; la Skill les da un método confiable para completar la investigación de principio a fin. Con la Skill, los agentes convierten los objetivos en pasos, seleccionan endpoints, validan entradas, estiman el costo, continúan las tareas asíncronas y la paginación, y organizan los resultados entre plataformas con criterios coherentes. En investigaciones de varios pasos, de larga duración o repetibles, esto reduce las decisiones improvisadas y las ejecuciones duplicadas, y produce resultados más confiables, completos y comparables.
No. La Skill no agrega un servicio de datos aparte ni desbloquea funcionalidades privadas. Enseña al agente a usar con más confiabilidad el mismo catálogo de API de SocQ.
No. La Skill prefiere MCP alojado o stdio, pero puede guiar al agente para que use la CLI o la API REST de SocQ cuando MCP no está disponible.
SocQ usa una sola Skill para todas las plataformas. El agente selecciona la funcionalidad adecuada del catálogo completo de SocQ según la tarea.
Las recolecciones de datos en vivo requieren una clave de API de SocQ válida. La Skill en sí nunca debe contener ni almacenar credenciales; configure la clave de forma segura en el entorno local del cliente.
Sí. Guía al agente para seguir consultando la tarea original, recorrer los cursores de resultados y obtener los archivos sin procesar cuando el flujo de trabajo solicitado lo requiere.
Puede usar las funcionalidades de datos públicos de redes sociales disponibles actualmente en el catálogo de API de SocQ. Cada página de API documenta las entradas admitidas, el alcance de los datos públicos y los campos de resultados normalizados.