🌐 Social Media Research Skills para Agentes IA (ScrapeCreators)

RESUMEN EJECUTIVO

Social Media Research Skills (ScrapeCreators/social-media-research-skills) es una suite de habilidades de investigación de redes sociales diseñada para agentes de IA (Antigravity, Claude Code, Cursor, Codex, Copilot).

Respaldada por la infraestructura de ScrapeCreators, no se limita a exponer llamadas API crudas: implementa 13 flujos de investigación completos y orientados a resultados de negocio. Permite a los agentes detectar publicaciones virales atípicas (outliers), minar comentarios para extraer dolores de clientes (VOC), analizar transcripciones de vídeo, desarmar bibliotecas de anuncios (Meta, Google, LinkedIn) e investigar demanda de productos en más de 27 plataformas sociales.


📋 Ficha Técnica y Recursos

ParámetroDetalle
Repositorio OficialScrapeCreators/social-media-research-skills (GitHub)
Proveedor de DatosScrapeCreators (+110 endpoints REST)
LicenciaMIT License (Código abierto)
Estándar de HabilidadesCompatible con la especificación oficial de Agent Skills
Instalación CLInpx skills add ScrapeCreators/social-media-research-skills
AutenticaciónVariable de entorno SCRAPECREATORS_API_KEY
Plataformas Cubiertas (27+)TikTok, Instagram, YouTube (Videos & Shorts), Reddit, X/Twitter, LinkedIn, Facebook, Threads, Bluesky, Pinterest, Rumble, Twitch, Kick, Truth Social, TikTok Shop, Google y servicios Link-in-bio (Linktree, Komi, Pillar, etc.)
Herramientas CompatiblesAntigravity, Claude Code, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, Windsurf

🧠 ¿Qué es y cuál es el Concepto? (Workflow-First vs. API-Second)

La mayoría de integraciones de scraping simplemente ofrecen “endpoints sueltos” que obligan al usuario o al modelo a adivinar cómo encadenar llamadas.

Social Media Research Skills invierte este paradigma centrándose en el resultado de negocio:

graph TD
    User["Tú (Pides un objetivo de negocio)"] --> Agent["🤖 Agente IA (Antigravity / Claude Code / Cursor)"]
    
    subgraph "Capa de Habilidades de Flujo de Trabajo"
        Agent --> W1["📊 Outlier Post Finder<br>(Publicaciones que rompieron la media)"]
        Agent --> W2["💬 Comment Mining<br>(Objeciones, dudas y dolores VOC)"]
        Agent --> W3["🎙️ Transcript Intelligence<br>(Ganchos, afirmaciones y citas)"]
        Agent --> W4["📢 Ad Library Teardown<br>(Meta, Google y LinkedIn Ads)"]
        Agent --> W5["🛒 Product Demand Research<br>(Validación de ideas y mercado)"]
    end

    subgraph "Capa de Datos de Infraestructura"
        W1 --> API["🔍 scrapecreators-api (+110 Endpoints)"]
        W2 --> API
        W3 --> API
        W4 --> API
        W5 --> API
        API --> Platforms["🌐 27+ Redes Sociales (TikTok, YouTube, IG, Reddit, X...)"]
    end

    subgraph "Entregables Accionables (Artifacts)"
        W1 --> Out1["📋 Tabla comparativa con Baseline"]
        W2 --> Out2["📑 Reporte Voice-of-Customer (VOC)"]
        W3 --> Out3["🪝 Swipe File de Ganchos y Guiones"]
        W4 --> Out4["📊 Desglose Forense de Ofertas y CTAs"]
        W5 --> Out5["💡 Matriz de Dolores y Demanda Real"]
    end

🎯 Los 6 Principios de Diseño

  1. Flujo de trabajo primero, API después (Workflow-first): El agente resuelve un objetivo comercial (ej. auditar competidores), no solo buscar parámetros de URL.
  2. Exclusivamente datos públicos (Public-data only): No requiere cuentas iniciadas ni compromete credenciales privadas; extrae datos públicos auditables.
  3. Citas y fuentes obligatorias (Cited outputs): Cada conclusión incluye la URL directa del post, vídeo, comentario o anuncio original para verificarlo.
  4. Análisis consciente de la línea base (Baseline-aware): Un millón de visitas puede ser normal para un creador masivo y una anomalía brutal para uno pequeño. El sistema calcula la media habitual del creador para detectar verdaderos éxitos virales (outliers).
  5. Lenguaje exacto (Exact language matters): Mantiene verbatim el vocabulario, quejas y frases textuales de la audiencia para uso directo en copywriting.
  6. Entregables estructurados: Produce tablas Markdown, CSVs listos para importar, briefs estratégicos o archivos de inspiración (swipe files).

🗂️ Catálogo de las 13 Skills Especializadas

SkillPropósito PrincipalEntregable / Artefacto que produce
outlier-post-finderEncuentra publicaciones, reels, shorts o tweets que superaron significativamente la media habitual de la cuenta.Tabla de outliers, patrones repetibles de formato y lista de ganchos (hooks) a modelar.
transcript-intelligenceAnaliza transcripciones completas de vídeos (TikTok, YouTube, Reels, Rumble, Facebook…).Resumen ejecutivo, despiece de ganchos iniciales, afirmaciones polémicas, citas textuales y átomos de contenido.
comment-miningMina comentarios en busca de preguntas frecuentes, quejas, objeciones de compra, ideas de producto y lenguaje real.Reporte Voice-of-Customer (VOC), temáticas recurrentes, citas literales e ideas de contenido.
competitor-social-researchCompara la estrategia de múltiples competidores en redes para descubrir qué les funciona.Brief competitivo, pilares temáticos de cada competidor, brechas desatendidas y recomendaciones.
ad-library-teardownAnaliza anuncios activos en la biblioteca de anuncios de Meta, Google y LinkedIn.Ángulos de mensajería, propuestas de valor, ofertas, llamadas a la acción (CTAs) e hipótesis de prueba.
trend-discoveryDetecta temas emergentes, hashtags en alza, audios/música viral y formatos en tendencia en un nicho.Brief de tendencias, tabla de evidencia y ángulos sugeridos de contenido.
influencer-prospectingConstruye listas de prospección de creadores o influencers basadas en métricas reales.Tabla/CSV de prospectos calificados, puntuación de afinidad (fit score) y notas personalizadas para outreach.
audience-researchEvalúa la afinidad de audiencia a partir de biografía, demografía y señales de interacción.Reporte de encaje de audiencia, notas de mercado por país y etiquetas de confianza.
social-listening-briefInvestiga qué dice el público sobre una marca, producto, categoría o nicho en varias redes.Brief multicanal, temas dominantes, ejemplos citados y matices de sentimiento.
product-demand-researchValida ideas de producto y detecta dolores latentes en Reddit, foros y comentarios de redes.Señales de demanda real, objeciones de compra, frustraciones y oportunidades de mercado.
creator-profile-teardownAnálisis forense de por qué funciona el perfil de un creador o marca de éxito.Desglose de posicionamiento, pilares de contenido, mejores publicaciones y playbook a replicar.
content-repurposingRecicla vídeos, transcripciones y publicaciones en múltiples formatos derivados.Hilos para X (Twitter), publicaciones de LinkedIn, guiones de vídeo corto y esquemas para newsletters.
scrapecreators-apiCapa base para enrutar consultas directas a los más de 110 endpoints de ScrapeCreators.Respuestas JSON estructuradas, paginación con cursores y parámetros validados.

⚡ Prompts de Ejemplo para Probar con tu Agente

Una vez instaladas las skills en tu agente (Antigravity o Claude Code), puedes pedir tareas complejas con lenguaje natural:

1. Detección de Contenido Outlier

"Encuentra las publicaciones outlier de @starterstory en YouTube Shorts analizando los últimos 20 vídeos. Quiero saber cuáles rompieron su baseline y qué patrones de gancho repiten."

2. Minería Forense de Comentarios (Voice-of-Customer)

"Mina los comentarios de este reel de Instagram [URL]. Extrae objeciones de compra, dudas principales sobre el precio y el vocabulario textual que usa la audiencia para describir su frustración."

3. Despiece de Anuncios de la Competencia

"Haz un teardown de los anuncios activos de Facebook y LinkedIn de [Marca Competidora]. Desglosa los ángulos de copywriting, las ofertas que usan, los CTAs y qué variaciones creativas están testeando."

4. Inteligencia de Transcripciones

"Analiza las transcripciones de estos 10 TikToks virales en el nicho de SaaS. Extrae los primeros 3 segundos de gancho de cada uno y crea un swipe file de ganchos que pueda reutilizar."

🚀 Instalación y Configuración Paso a Paso

Paso 1: Obtener la Clave de API

  1. Regístrate en scrapecreators.com.
  2. Obtén tu API key en el panel de control.
  3. Exporta la variable de entorno en tu terminal (o agrégala a tu ~/.zshrc o ~/.bashrc):
    export SCRAPECREATORS_API_KEY="sk_tu_clave_aqui"

Paso 2: Instalación de las Habilidades

Opción A: Vía CLI Universal de Agent Skills (Recomendada)

npx skills add ScrapeCreators/social-media-research-skills

Este comando detecta automáticamente si estás usando Antigravity, Claude Code, Cursor, Codex o Gemini CLI e instala las carpetas correspondientes en tu entorno de desarrollo.

Opción B: Instalación Manual en Antigravity CLI (agy)

En Antigravity, cada habilidad reside en su propia carpeta dentro de ~/.gemini/config/skills/:

# Clonar temporalmente el repositorio
git clone https://github.com/ScrapeCreators/social-media-research-skills.git /tmp/sm-skills
 
# Copiar las habilidades al directorio de skills de Antigravity
cp -r /tmp/sm-skills/skills/* ~/.gemini/config/skills/
 
# Limpiar
rm -rf /tmp/sm-skills

🔗 Referencias y Conexiones en Ryukami Labs