read_post
Custa 20 créditos (2 se o post já foi lido nas últimas 6 horas).Lê qualquer post pelo link (TikTok, Instagram reel/carrossel/foto, YouTube, X, Threads, LinkedIn, Reddit) e devolve o conteúdo inteiro para você analisar: transcrição com tempos (da própria rede ou, se ela não legendou, transcrição automática do áudio), as imagens do carrossel (como imagens, para você ver) e o texto escrito em cada slide, comentários mais curtidos, métricas, resumo, pontos-chave, mapa mental e o Viral Score (quão fora da curva o post foi para o tamanho do autor). Use sempre que o usuário colar um link ou pedir para resumir, entender, estudar ou comparar um post. Grava no histórico do usuário.
| Parâmetro | Tipo | Descrição |
|---|---|---|
| urlobrigatóriostring | string | Link do post |
| nichestring | string | Tema/nicho de referência do usuário, para a nota de encaixe (fit) |
| include_imagesboolean | boolean | Devolver as imagens do carrossel (padrão true) |
bash
curl -s https://viralrecast.com/mcp \
-H "Authorization: Bearer $VIRALRECAST_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"read_post","arguments":{"url":"https://www.youtube.com/watch?v=KvLWuK2TU-w","include_images":false}}}' \
| jq '.result.structuredContent'Ver exemplo de resposta (structuredContent, encurtado)
json
{
"id": 73,
"platform": "youtube",
"format": "video",
"url": "https://www.youtube.com/watch?v=KvLWuK2TU-w",
"author": { "handle": "HTXStudio", "name": "HTX Studio", "followers": 2830000 },
"title": "We Built the Product Apple Gave Up On...",
"duration_s": 325,
"published_at": "2026-09-24T12:00:31Z",
"metrics": { "views": 5939233, "likes": 95213, "comments": 3400, "shares": 0, "saves": 0 },
"slides": [],
"transcript": [
{ "start": 0.2, "end": 4, "text": "For the past 2 months, I have been" },
{ "start": 2.1, "end": 6.3, "text": "building a desk. To understand what it" }
],
"transcript_text": "For the past 2 months, I have been building a desk...",
"transcript_source": "platform",
"top_comments": [{ "text": "2027 Apple Airdesk - Starting At $99,999", "likes": 8700, "author": "@..." }],
"analysis": {
"hook": "...", "summary": "...", "key_points": ["..."], "mind_map": "# ...",
"pattern": "história", "emotion": "admiração", "hook_score": 8,
"why_it_worked": "...", "how_to_adapt": ["..."]
},
"score": { "viral_index": 100, "tier": "fora_da_curva", "outlier": 31.31, "final_score": 21.92 },
"from_memory": true,
"credits_charged": 2,
"dashboard_url": "https://viralrecast.com/p/73"
}