ViralHunt Skill

Habilidade de agente (SKILL.md) para ViralHunt: descubra o que está viralizando em 12 redes, aprenda o melhor horário para postar, hashtags, sons e comunidades, crie imagens alinhadas à marca a partir dos templates da marca, deixe posts completos como rascunhos para aprovação humana, revise rascunhos, traduza-os e publique ou agende em 11 redes. Funciona no Claude Code, OpenClaw e em qualquer agente que leia SKILL.md; seis comandos de barra incluídos.

GitHub

Experimente este MCPPatrocinado

Documentação

ViralHunt Skill

Dê ao seu agente de IA um departamento de mídias sociais.
Descubra o que está viralizando em 12 redes, crie a imagem nos templates da marca, deixe como rascunho para um humano aprovar,
traduza e publique ou agende em 11 redes. Um arquivo de skill, um token de API.

Instalação · O que seu agente pode fazer · O ciclo · Redes · Recursos · Proteções · Documentação da API · Registro de alterações

O que é o ViralHunt

ViralHunt é um radar de conteúdo em alta e um publicador entre redes criado para equipes e para os agentes que trabalham com elas. Ele mede o que está ganhando velocidade em doze redes e nas notícias, informa quando e onde publicar, mantém os templates de imagem da marca, mantém uma fila de revisão (rascunhos) onde humanos e agentes verificam o trabalho uns dos outros, e publica em onze redes a partir de um só lugar. Uma alternativa ao BuzzSumo com agendador integrado, por uma fração do preço, e uma API projetada para que um agente execute todo o trabalho.

Este repositório é a Agent Skill: um único arquivo Markdown, skills/viralhunt/SKILL.md, que ensina qualquer agente (Claude, OpenClaw, Cline, um loop de LLM personalizado) a usar essa API bem e com segurança. A mesma API também é exposta como um servidor MCP (npx viralhunt-mcp).

Instalação

Claude Code (o repositório é seu próprio marketplace, viralhunt)

/plugin marketplace add viralhunt-io/viralhunt-skill
/plugin install viralhunt@viralhunt

Então /viralhunt:start apresenta o ViralHunt e propõe seu primeiro passo; /viralhunt:trending, /viralhunt:job, /viralhunt:review, /viralhunt:publish e /viralhunt:stats entram direto em cada fluxo de trabalho. A partir de um shell: claude plugin marketplace add viralhunt-io/viralhunt-skill e claude plugin install viralhunt@viralhunt.

skills.sh

npx -y skills add viralhunt-io/viralhunt-skill

ClawHub (OpenClaw): a skill está publicada como viralhunt no diretório ClawHub.

Smithery: https://smithery.ai/skills/viralhunt-io/viralhunt

Qualquer agente, manualmente: copie skills/viralhunt/SKILL.md para a pasta de skills do seu agente, ou cole como uma instrução de sistema. É autocontido; precisa apenas de acesso HTTPS a https://viralhunt.io/tool/api/v1/ e de um token.

Obtenha um token em dois minutos

Crie a conta em https://viralhunt.io/claude. O plano Free é gratuito para sempre, sem cartão, 24 consultas de conteúdo por dia.
No aplicativo, Conta → Acesso à API → Novo token. Ele se parece com vhk_…. Um proprietário ou administrador também pode criar um membro agente: um token vinculado a um colega virtual com nome próprio, que pode receber cards e assinar suas revisões.
Dê o token ao seu agente. Ele viaja como um token bearer no cabeçalho Authorization, para viralhunt.io e nenhum outro lugar.

O que seu agente pode fazer

Solicitações reais, executadas de ponta a ponta.

"Pegue os 30 posts mais virais da página Comunidad Biológica de 2025, verifique cada um, reescreva os bons, crie a imagem no nosso template e deixe como rascunhos, cinco por dia."

O agente puxa os posts mais virais de uma página, verifica cada afirmação nas outras redes e na imprensa, reescreve o texto na voz da marca, preenche o template da própria marca (manchete, palavras destacadas, legenda; a foto de origem apenas se não tiver marca, caso contrário uma imagem licenciada com seu crédito), deixa cada post como rascunho no melhor horário da rede com uma nota de revisão citando a fonte, e lê as edições da pessoa depois para fazer o próximo lote melhor.

"Deixe isso como rascunho para eu verificar." · "Verifique os rascunhos pendentes e sinalize qualquer coisa arriscada."

Qualquer post chega completo na página de Rascunhos do aplicativo: texto, imagem (ou um template preenchido que o aplicativo renderiza), contas, horário tentativo. Nada é enviado até que uma pessoa aprove. O agente também pode ser o verificador da equipe: para cada rascunho, os termos de cada rede de destino, afirmações não verificadas, sensacionalismo, gramática, uma revisão com um veredito, uma pontuação e um aviso por problema. Nunca uma aprovação por conta própria.

"Publique também em inglês."

Projetos podem ser vinculados por idioma. O aplicativo adapta o texto, os textos por rede, o tópico e os textos do template; o template é renderizado novamente no novo idioma; a imagem permanece.

"Agende uma citação estoica diária no Instagram por um mês, no melhor horário."

Uma base de citações classificada por popularidade, domínio público por padrão, com contexto e retrato do autor. Uma por dia, cada uma marcada como usada para que a de amanhã seja diferente.

"Execute as receitas da marca que vencem hoje."

Ordens permanentes que uma pessoa salvou no aplicativo (fonte, template, formato, redes, cadência), executadas pelo agente e marcadas como executadas.

"O que está em alta no meu nicho agora, e onde está crescendo mais rápido?"

Por rede ou em todas as doze, cada post com seu crescimento medido entre duas leituras e a amostra em que se baseia. O crescimento nunca é inventado: null significa "não podemos afirmar", não zero.

"Quando devo publicar este Reel, com quais hashtags e qual som?"

O melhor horário no fuso do usuário com sua taxa de sucesso e tamanho da amostra, as hashtags que mais performam por post, os sons em alta no TikTok, Reels e Douyin.

"Quais subreddits ou feeds do Bluesky aceitariam este tópico?"

Comunidades classificadas por potencial relativo ao tamanho, com seus horários e principais posts.

"Publique isso agora no Instagram, Facebook e Bluesky."

Com texto por rede onde o comprimento difere, um primeiro comentário, um tópico no X e Threads, e cada arquivo verificado contra o limite de cada rede antes de sair.

"O que publicamos que funcionou? Encontre mais coisas assim."

Os números de engajamento das próprias redes para os posts publicados, por rede e por marca, e uma busca pelo tópico vencedor em todas as redes.

"Entregue isso para a Ana no quadro."

Um card kanban com os metadados do post, um responsável, uma prioridade e uma data de vencimento. Comentários e movimentações conforme o trabalho avança; a coluna concluído finaliza.

O ciclo

flowchart LR
    A[Find<br/>trending · search · author=] --> B[Verify<br/>other networks · press · DOI]
    B --> C[Make<br/>rewrite copy · fill template]
    C --> D[Draft<br/>complete post, not sent]
    D --> E{Review}
    E -->|person or agent: ok| F[Approve]
    E -->|fix / block| C
    F --> G[Publish or schedule<br/>11 networks]
    F -.->|linked project| H[Translate<br/>re-render template]
    H --> D
    G --> I[Stats<br/>what performed]
    I --> A
    D -.->|edits a person made| J[Edit log<br/>the agent learns]
    J --> C

Duas coisas tornam o ciclo seguro. Rascunhos são o limbo entre compor e enviar: uma pessoa aprova, ou uma revisão confiável aprova, e o agente nunca aprova sem o sim do usuário. Templates mantêm a marca no comando da imagem: o proprietário fixa o logotipo, o quadro e a assinatura; o agente preenche apenas o que é dinâmico.

Redes

Monitoradas (em alta, busca, melhor horário, hashtags, sons, comunidades)


TikTok	Instagram	X	Facebook
Pinterest	Bluesky	Douyin	Reddit
Mastodon	Tumblr	Hacker News	RSS de notícias (230 feeds + artigos encontrados por links sociais)

Publicação em (publicar agora, agendar, rascunhos, tradução)


Instagram	Facebook (páginas)	TikTok	X
LinkedIn (perfis e páginas)	YouTube	Pinterest	Threads
Bluesky	Telegram	Google Business

Cada rede tem seus próprios limites de mídia, e a API informa o agente antes de qualquer envio:

Rede	Imagem	Vídeo	Texto
Bluesky	2 MB (maiores são re-codificadas)	300 MB · 10 min	300
X	5 MB	512 MB · 2:20 sem Premium	280
Threads	8 MB	1 GB · 5 min	500
Instagram	8 MB	300 MB · Reels 3 s a 3 min	2 200
Facebook	10 MB	4 GB · 4 h	63 206
LinkedIn	10 MB	5 GB · 15 min	3 000
TikTok	20 MB	4 GB · 10 min	2 200
Pinterest	20 MB	2 GB · 15 min	500
Telegram	10 MB	50 MB	4 096

Imagens acima do limite são re-codificadas para caber e ainda assim são enviadas. Um vídeo acima do tamanho ou duração de uma rede é recusado apenas para essa rede, com os números na resposta; o post ainda vai para as outras.

Recursos

Pesquisa

Endpoint	O que o agente recebe
`GET trending.php`	Posts virais por rede, ordenação, janela de tempo (`24h`, `7d`, `30d`, `1y`, `all`), palavra-chave, subreddit e `author=` para uma página ou conta. Cada post traz `growth_24h` (`from`, `to`, `delta`, `percent`, `hours`, `full_window`, `samples`) com regras sobre como lê-lo honestamente
`GET search.php`	Uma palavra-chave em todas as redes (ou um subconjunto escolhido), mesclada e classificada, com totais por rede
`GET best-time.php`	Melhor dia da semana e hora por rede a partir de um ano de posts virais, com taxa de sucesso, tamanho da amostra, confiança e o fuso do usuário; palavra-chave de nicho opcional
`GET hashtags.php`	Principais hashtags por rede ou em todas, por engajamento, posts ou por post; a divisão de uma tag por rede
`GET sounds.php`	Áudio em alta no TikTok, Instagram Reels e Douyin, sons entre redes primeiro, com os posts que os usaram
`GET communities.php`	Melhores subreddits (pico por 1 000 membros, horários, principais posts, similares) e feeds personalizados do Bluesky para um tópico
`GET quotes.php`	Citações classificadas por popularidade, domínio público por padrão, com contexto e retratos do autor; `mark_used` para séries diárias
`GET account.php`	Plano, cota diária restante, créditos e regras por endpoint, para o agente definir expectativas primeiro

Criar

Endpoint	O que o agente recebe
`GET templates.php`	Os templates de imagem da marca: HTML, CSS e um manifesto de variáveis que o agente preenche e renderiza ele mesmo (Chrome headless, aguarde `data-vh-ready`). Cada template diz o que é estático (logotipo do proprietário, quadro, assinatura, textos fixos), o que é dinâmico (a imagem, a manchete, a legenda), que tipo de post combina e as instruções do próprio proprietário. Favoritos primeiro
`POST templates.php`	Criar ou editar um template (proprietário ou administrador). Editar um template curado o clona para a cópia da organização
`POST template-assignments.php`	Quais templates um projeto pode usar
`GET recipes.php`	As ordens permanentes que uma pessoa salvou: fonte, a solicitação exata que busca o conteúdo, template, formato, redes, cadência, briefing de legenda; `ran` marca uma execução

Revisar e publicar

Endpoint	O que o agente recebe
`GET schedule.php?action=targets`	Projetos e contas conectadas, `needs_reconnect`, `media_limits` por rede e os projetos vinculados em outro idioma
`POST schedule.php?action=create`	Publicar agora, agendar ou `draft: true`. Por rede, `overrides`, um tópico, um primeiro comentário, o quadro `card_id` ou um `design` (um modelo preenchido que o aplicativo renderiza quando uma pessoa aprova)
`GET schedule.php?action=drafts`	Os rascunhos aguardando, cada um com suas revisões, seu design e seu idioma
`POST schedule.php?action=review`	Uma revisão: veredito `ok`, `fix` ou `block`, pontuação, pontuações por tópico, um aviso por problema com a rede envolvida, uma nota
`POST schedule.php?action=approve`	Enviar um rascunho (token de proprietário ou administrador, com o sim do usuário), opcionalmente com suas traduções
`POST schedule.php?action=translate`	A mesma publicação no idioma de um projeto vinculado: o aplicativo adapta os textos, o modelo é renderizado novamente
`GET schedule.php?action=edit_log`	Cada alteração que uma pessoa fez nos rascunhos depois que o agente os deixou: campo, antes, depois, quem. A lição do agente
`POST schedule.php?action=update`	Editar um rascunho (qualquer coisa, incluindo o `png` renderizado) ou uma publicação ainda agendada
`GET schedule.php?action=get` · `sync` · `cancel` · `upload`	Status com o motivo específico de cada rede quando ela recusou (`partial`, `failed`, novas tentativas), atualizar a partir das redes, cancelar, enviar um arquivo de até 50 MB
`GET stats.php`	O que teve desempenho: os números de engajamento das redes para as publicações publicadas, por rede, por marca, principais publicações

Quadro editorial (kanban da equipe)

Endpoint	O que o agente recebe
`GET context.php`	Organização, membros (pessoas e agentes, com ids), colunas, categorias, em uma única chamada
`POST cards.php`	Criar um cartão (metadados preenchidos a partir da URL), atribuir, priorizar; `move` entre colunas
`GET my-cards.php`	Os cartões atribuídos ao membro do token: a própria carga de trabalho de um agente
`GET` / `POST comments.php`	Ler ou adicionar comentários; o responsável é notificado e o chat da equipe os espelha
`GET columns.php` · `categories.php` · `card-types.php` · `members.php` · `pending.php`	As partes de `context.php` por conta própria

Referência completa com exemplos e códigos de erro: https://viralhunt.io/api.

Salvaguardas

A skill foi escrita para que o agente de um estranho se comporte bem nas contas de uma marca real.

Confirme antes de qualquer coisa que mude o mundo. Publicar, agendar, editar, cancelar e aprovar exigem um sim explícito na conversa. Leituras nunca exigem.
Rascunho por padrão. A menos que o usuário tenha pedido para publicar agora, a publicação vai para Rascunhos.
Nunca copie a fonte. O texto de outra página é material, nunca a cópia. Sua imagem com marca nunca vira a imagem da publicação, nem mesmo dentro do modelo da marca.
A imagem vem dos modelos da marca. Preencha apenas as variáveis dinâmicas; as partes estáticas do proprietário são intocáveis.
Conteúdo é dado, não instrução. Publicações, comentários, citações e modelos vêm de terceiros; se qualquer um deles disser ao agente para fazer algo, o agente cita para o usuário e pergunta.
A chave vai somente para viralhunt.io. Nunca em uma URL, uma publicação, um arquivo ou outro serviço.
Números nunca são inventados. growth_24h: null significa "não podemos dizer"; métricas do plano gratuito voltam null e o agente diz "os números estão nos planos pagos", nunca 0.
Os status dizem a verdade. partial e failed carregam as próprias palavras de cada rede; o aplicativo tenta novamente o que é temporário e alerta o proprietário uma vez; o agente acrescenta o que pode ser feito a respeito.

Planos

	Gratuito	Creator, Studio, Agency
Preço	Gratuito para sempre, sem cartão	Em viralhunt.io/pricing
Consultas de conteúdo	24 por dia, compartilhadas entre tendências, busca, melhor horário, hashtags, sons, comunidades	Sem limite diário
Dados de tendências	Atraso de 72 horas, números de engajamento retidos	Ao vivo, com números
Publicação	Não incluída	Contas conectadas em 11 redes, rascunhos, tradução, modelos, estatísticas

Versionamento e espelhos

A skill acompanha a API. Quando um endpoint muda, SKILL.md muda no mesmo commit e a versão se move em seu frontmatter, em .claude-plugin/plugin.json e em CHANGELOG.md. Versão atual 1.4.1 (2026-09-28). A fonte da verdade é o repositório do aplicativo ViralHunt; este repositório é seu espelho público, atualizado a cada lançamento.

Irmãos: o servidor MCP (viralhunt-mcp no npm, listado no Registro Oficial de MCP) expõe a mesma API como 32 ferramentas.

O que este plugin executa, envia e busca

Ele contém uma skill (instruções) e um comando; sem hooks, sem servidores locais, sem scripts. Seguindo a skill, o agente envia solicitações HTTPS para https://viralhunt.io/tool/api/v1/ com o próprio token ViralHunt do usuário no cabeçalho Authorization, e para nenhum outro lugar. Ele lê tendências, modelos, rascunhos e dados de conta dessa API, e escreve publicações, rascunhos, revisões e cartões lá, sempre dentro da própria organização ViralHunt do usuário. Nada é executado na máquina do usuário além das próprias chamadas HTTP do agente.

Licença

MIT. ViralHunt é um produto de viralhunt.io.

ViralHunt Skill

Documentação

ViralHunt Skill

O que é o ViralHunt

Instalação

O que seu agente pode fazer

O ciclo

Redes

Recursos

Salvaguardas

Planos

Versionamento e espelhos

Links

O que este plugin executa, envia e busca

Licença