ViralHunt

Servidor MCP ViralHunt

Um servidor MCP para ViralHunt.io — a plataforma completa para descobrir o que está em alta, curar com sua equipe e publicar em qualquer lugar. Uma alternativa ao BuzzSumo com agendador integrado entre redes e uma API que agentes de IA podem conduzir de ponta a ponta.

Obtenha um token gratuito: https://viralhunt.io → Conta → Acesso à API (teste de 7 dias, sem cartão). Documentação completa da API: https://viralhunt.io/api.

O que um agente pode fazer por meio deste servidor MCP

Estas são as ferramentas que este servidor expõe (elas conduzem o ciclo completo de descobrir → cronometrar → publicar → verificar → corrigir). Cada número vem com seu tamanho de amostra e janela de tempo, para que um agente possa dizer o quanto confiar nele:

Ferramenta	O que faz
viralhunt_trending	Encontrar tópicos — o que está viralizando no TikTok, Instagram, X, Facebook, Pinterest, Bluesky, Douyin, Reddit, Mastodon, Tumblr, Hacker News e RSS de notícias, classificados por pontuação viral, cada post com growth_24h (o quanto mudou entre nossas duas leituras mais distantes)
viralhunt_best_time	Quando publicar — melhor dia da semana + hora por rede com base nos posts que viralizaram lá (amostra de 365 dias, taxa de sucesso, tamanho da amostra, seu fuso horário, palavra-chave de nicho opcional)
viralhunt_top_hashtags	Quais hashtags — principais tags por rede ou em todas, por engajamento, posts ou por post; detalhamento de uma tag por rede
viralhunt_trending_sounds	Qual som — áudio em alta no TikTok, Instagram Reels e Douyin, sons entre redes primeiro, com os posts que os usaram
viralhunt_best_communities	Onde publicar — melhores subreddits (pico por 1.000 membros, horário, principais posts, similares) e feeds personalizados do Bluesky para um tópico
viralhunt_targets	Liste suas marcas/projetos e as contas conectadas nas quais você pode publicar
viralhunt_schedule	Publique agora ou agende um post (texto + mídia) em suas contas conectadas
viralhunt_get_post	Verifique o status de um post + links permanentes por rede
viralhunt_update_post	Edite um post ainda agendado (corpo / mídia / redes / horário)
viralhunt_cancel_post	Cancele os alvos ainda não publicados de um post agendado
viralhunt_list_templates	Navegue pela biblioteca de modelos de conteúdo (layouts alinhados à marca que você preenche)
viralhunt_get_template	Obtenha a especificação completa de um modelo (html + css + manifesto de variáveis) para renderizar
viralhunt_upsert_template	Crie ou edite um modelo — editar um modelo curado o clona para sua cópia (proprietário/admin)
viralhunt_assign_template	Atribua um modelo a um projeto para que seus agentes possam usá-lo (proprietário/admin)
viralhunt_board_context	O Conselho Editorial da equipe em uma chamada: membros (com ids), colunas, categorias
viralhunt_create_card	Entregue um post a um colega — crie um cartão kanban (metadados de URL preenchidos automaticamente, responsável, prioridade, data de vencimento, categoria)
viralhunt_move_card	Mova um cartão para outra coluna (a coluna is_done o conclui)
viralhunt_my_cards	Os cartões atribuídos a você (quando o token pertence a um membro agente da equipe)
viralhunt_card_comments	Leia ou adicione comentários em um cartão (notifica o responsável, espelha no chat da equipe)

Proteções incorporadas: não publica na marca errada, só agenda no futuro e é instruído a não republicar notícias falsas / mídia com direitos autorais / spam.

O que a plataforma ViralHunt faz (além deste MCP)

ViralHunt é um produto completo; as ferramentas acima são a parte conduzível por agentes. O restante vive no aplicativo (e parte via API REST):

• Radar de Tendências — um feed ao vivo entre redes de conteúdo viral por nicho e janela de tempo.
• Publicação e agendamento entre redes — agende/publique em até 11 redes (Instagram, Facebook, TikTok, X, LinkedIn, YouTube, Pinterest, Threads, Bluesky, Telegram, Google Business), por marca.
• Conselho Editorial (equipe) — um kanban para curar antes de publicar: colunas, categorias, atribuições, comentários e chat da equipe, para que uma equipe gerencie o que sai. (Cartões/colunas/comentários estão na API REST.)
• Auto-DM (automação de comentário → DM) — quando alguém comenta sua palavra-chave no Instagram, o ViralHunt responde automaticamente e envia um DM — como o ManyChat, mas com preço fixo, contatos ilimitados e um limite mensal que é redefinido. Configurado no aplicativo (executa via webhooks); Facebook em seguida.
• Relatórios — o que cada marca/rede realmente fez: posts, alcance, DMs enviados, respostas, principais conteúdos.

Observação: Auto-DM e Relatórios são recursos do produto, não ferramentas que este MCP expõe hoje. O conselho editorial é exposto (contexto, cartões, movimentações, comentários) para que um agente possa entregar conteúdo a uma equipe em vez de publicá-lo diretamente.

Instalação (Claude Desktop / Cline)

{
  "mcpServers": {
    "viralhunt": {
      "command": "npx",
      "args": ["-y", "viralhunt-mcp"],
      "env": { "VIRALHUNT_API_KEY": "vhk_your_token_here" }
    }
  }
}

Configuração: VIRALHUNT_API_KEY (seu token vhk_…, obrigatório) e VIRALHUNT_BASE_URL (opcional, padrão para a API de produção). Execute localmente: VIRALHUNT_API_KEY=vhk_... npx viralhunt-mcp (Node ≥ 18).

Listado no Registro Oficial de MCP como io.github.rodvan/viralhunt-mcp. Licença: MIT.