CDCStream/skills

Evaluación de creadores con transcripciones

Genera un informe de una página sobre un creador a partir de datos públicos: quién es en cada plataforma, con qué frecuencia publica, cómo rinden sus publicaciones recientes, con qué marcas ya trabaja y qué dice en cámara.

Lo que esto puede y no puede decirte

• Solo datos públicos, sin inicio de sesión. No están disponibles cuentas privadas, datos demográficos de la audiencia, puntuaciones de autenticidad de seguidores ni mensajes directos — indícalo; nunca los inventes.
• La tasa de engagement aquí es (me gusta + comentarios) / seguidores sobre las publicaciones extraídas. Es una señal aproximada de una muestra pequeña, no una métrica auditada.
• Algunos recuentos son redondeados por la plataforma (por ejemplo, "1,2M"); conserva los indicadores ...IsApproximate de la respuesta y muestra "≈" para ellos.
• Las transcripciones provienen del habla en el vídeo (TikTok, Instagram) o de los subtítulos publicados (YouTube). Una transcripción faltante significa que no hay habla o no hay subtítulos, no que el creador no dijo nada que valga la pena revisar.

Entradas que recopilar primero

1. Las URLs o handles del perfil del creador en TikTok, Instagram y/o YouTube. No adivines handles entre plataformas: pregunta o marca la plataforma como "no proporcionada".
2. Cuántas publicaciones recientes por plataforma (por defecto 10) y cuántas transcripciones (por defecto las 3 publicaciones más recientes por plataforma).
3. Qué le importa a la marca: competidores a buscar, temas a evitar.

Estimación de créditos — mostrar antes de ejecutar

Por creador, con valores predeterminados (10 publicaciones, 3 transcripciones por plataforma):

Plataforma	Llamadas	Créditos
TikTok	/v1/tiktok/channel-details 1 · /v1/tiktok/channel-posts 2 · 3 × /v1/tiktok/transcript 2	9
Instagram	/v1/instagram/channel-details 1 · /v1/instagram/channel-posts (0,3 por publicación, 10 publicaciones = 3) · 3 × /v1/instagram/transcript 2	10
YouTube	/v1/youtube/channel-details 1 · /v1/youtube/channel-videos 2 · 3 × /v1/youtube/transcript 1 · /v1/youtube/video-sponsors 0	6

Las tres plataformas: aproximadamente 25 créditos por creador; hasta ~35 con más publicaciones o transcripciones. Muestra el estimado para los creadores solicitados, consulta GET /v1/account/balance (gratis) y pide al usuario que confirme.

Cómo llamar a Captapi

• MCP: tiktok_channel_details, tiktok_channel_posts, tiktok_transcript, instagram_channel_details, instagram_channel_posts, instagram_transcript, youtube_channel_details, youtube_channel_videos, youtube_transcript, youtube_video_sponsors.
• REST: GET https://api.captapi.com<ruta>?url=<URL de perfil o vídeo> con el encabezado Authorization: Bearer $CAPTAPI_API_KEY.

Las llamadas fallidas cuestan 0 créditos. Un 403 como profile_restricted o un 404 es una respuesta definitiva para esa plataforma: regístralo y continúa.

Pasos

Para cada plataforma que el usuario haya proporcionado:

1. Perfil — channel-details con la URL del perfil. Conserva seguidores, seguidos, número de publicaciones, biografía, enlaces de la biografía, indicador de verificación, tipo de cuenta.
2. Publicaciones recientes — tiktok/channel-posts, instagram/channel-posts o youtube/channel-videos con limit=<N>. A partir de las filas calcula: publicaciones por semana en el período, mediana de vistas (cuando estén presentes), mediana de me gusta y comentarios, tasa de engagement, y la mejor y peor publicación.
3. Señales de patrocinio a partir de las mismas filas:
   • Las filas de Instagram llevan isPaidPartnership; enumera esas publicaciones y las marcas que mencionan.
   • TikTok y YouTube: escanea subtítulos/títulos en busca de #ad, #sponsored, "paid partnership", códigos de descuento y @menciones de marca.
   • YouTube: youtube/video-sponsors?url=<URL del vídeo> para cada vídeo transcrito devuelve segmentos de patrocinio enviados por la comunidad (gratis). Etiquétalos como reportados por la comunidad.
4. Transcripciones — para los vídeos más recientes, tiktok/transcript, instagram/transcript o youtube/transcript con la URL del vídeo. Léelas para buscar: productos y marcas mencionadas, menciones de competidores, afirmaciones que necesitarían respaldo (salud, finanzas) y lenguaje o temas que la marca indicó como prohibidos.

Formato del informe

1. Tabla resumen: una fila por plataforma: handle, seguidores, publicaciones/semana, mediana de vistas, tasa de engagement, verificado. Cada celda debe poder rastrearse hasta su endpoint.
2. Patrocinadores anteriores: marca, plataforma, fecha de publicación, enlace y cómo se detectó (isPaidPartnership, etiqueta de subtítulo, segmento comunitario).
3. Lo que dicen: 3 a 5 viñetas extraídas de las transcripciones, cada una con una cita breve y el enlace al vídeo.
4. Banderas [requiere revisión humana]: trabajo con competidores, afirmaciones arriesgadas, temas prohibidos, saltos repentinos de seguidores entre los datos del perfil y las publicaciones.
5. Brechas: plataformas no proporcionadas, restringidas o sin transcripciones.
6. Total de créditos de la ejecución.

Dónde un humano debe revisar

• Cada bandera — las transcripciones pueden malinterpretarse y el contexto importa.
• Si un "patrocinador" detectado fue pagado o fue solo una mención.
• Adecuación con la marca: el informe proporciona evidencia, no un veredicto de contratar o no contratar.