Communitygithub.com

benjaminb10/viewlify-mcp

Dados do TikTok para Claude e agentes de IA: servidor MCP (vídeos que superam as visualizações comuns do criador, tendências, hashtags, sons), plugin do Claude Code com 3 habilidades e a CLI viewlify.

O que é viewlify-mcp?

O Viewlify MCP é um servidor de protocolo MCP (Model Context Protocol) que fornece dados públicos do TikTok para agentes de IA como Claude, Cursor e outras ferramentas compatíveis. Ele se destaca ao comparar cada vídeo com as visualizações médias do criador, revelando o múltiplo de desempenho (outlier multiple) – um vídeo com 50 mil visualizações pode ser um fracasso para um criador que geralmente atinge 500 mil, mas um sucesso para outro que costuma ter 2 mil. O servidor oferece ferramentas para consultar tendências por nicho, hashtags, sons, criadores específicos e realizar buscas inteligentes com filtros como trending, outlier, visualizações e engajamento. A chave de API é opcional para uma prévia gratuita com 20 consultas por dia por IP, e planos pagos a partir de US$ 0,005 por chamada. Além do servidor MCP, o repositório inclui três habilidades especializadas para Claude Code (pesquisa de outliers, ideias de vídeo e resumo semanal de tendências), bem como a ferramenta de linha de comando viewlify publicada no npm.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/benjaminb10/viewlify-mcp/tree/main

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Viewlify MCP: Dados do TikTok para Claude e agentes de IA

Pergunte ao Claude quais vídeos do TikTok estão realmente se destacando em um nicho e por quê. O Viewlify rastreia vídeos públicos do TikTok e compara cada um com as visualizações habituais do criador: um vídeo com 50 mil visualizações é um fracasso para uma conta que normalmente atinge 500 mil e um sucesso para uma conta que costuma ter 2 mil. Essa proporção, o múltiplo, é o que este servidor retorna, junto com os vídeos, hashtags e sons que estão ganhando visualizações mais rapidamente por nicho.

Este repositório contém tudo que você precisa para usar o Viewlify no Claude Code, Claude, Cursor ou qualquer cliente MCP:

  • a configuração do servidor MCP remoto (https://viewlify.app/api/mcp),
  • um plugin do Claude Code com três habilidades construídas sobre ele,
  • o código-fonte da ferramenta de linha de comando viewlify publicada no npm.

O servidor é hospedado pelo Viewlify; não há nada para executar localmente.

Início rápido

Claude Code, como plugin (servidor MCP e as três habilidades):

/plugin marketplace add benjaminb10/viewlify-mcp
/plugin install viewlify@viewlify

Na instalação, o Claude Code solicitará sua chave de API do Viewlify. Ela é opcional (veja abaixo): deixe em branco para a prévia gratuita.

Claude Code, apenas o servidor MCP:

claude mcp add --transport http viewlify https://viewlify.app/api/mcp --header "Authorization: Bearer vf_live_YOUR_KEY"

Claude (claude.ai ou Desktop): Configurações > Conectores > Adicionar conector personalizado, URL https://viewlify.app/api/mcp.

Cursor e outros clientes: um servidor HTTP Streamable em https://viewlify.app/api/mcp, com o cabeçalho Authorization: Bearer vf_live_YOUR_KEY.

Terminal: npx viewlify login, depois npx viewlify search "skincare" --sort outlier --limit 5. npx viewlify mcp exibe o comando claude mcp add com sua chave.

Chave de API e preço

A chave é opcional. Sem ela, as ferramentas públicas respondem com uma prévia de 5 resultados (20 chamadas por dia por IP).

Com uma chave, você obtém resultados completos, o múltiplo de outlier, compartilhamentos por 1.000 visualizações, o histórico de visualizações registrado pelo Viewlify e busca em todos os vídeos da base. Qualquer conta do Viewlify pode criar uma chave em Configurações > API e MCP, plano gratuito incluso, com US$ 1 de crédito grátis. Depois disso, é US$ 0,005 por chamada com crédito pré-pago (recargas de 5 a 100 USD) ou incluído nos planos Pro e Agency. Preços: viewlify.app/tiktok-data-api.

Ferramentas

FerramentaChaveO que retorna
get_trendingopcionalVídeos, hashtags e sons que estão bombando agora, por nicho
get_outliersopcionalVídeos que superam as visualizações habituais do criador pela maior margem, por nicho ou busca
get_trending_hashtagsopcionalHashtags recorrentes entre o que está bombando, por nicho
get_creatoropcionalUm criador: seguidores, visualizações habituais, engajamento, melhor sucesso, melhor dia de postagem, principais hashtags e sons, e seus vídeos com o múltiplo
search_trending_videosobrigatóriaBuscar toda a base por palavra-chave, @criador ou #hashtag; ordenar por trending, outlier, visualizações, recente, engajamento ou compartilhamentos
get_balance, top_upobrigatóriaCrédito da API e um link de pagamento para adicionar mais
list_my_accounts, get_account_growth, get_account_videos, get_my_niche_watch, get_my_video_checksPro ou AgencySuas próprias contas rastreadas, seu crescimento e vídeos, seu monitoramento de nicho e verificações de vídeo por IA

Nichos: beleza, games, comida, fitness, moda, comédia, dança, pets, futebol, esportes, música, viagem, tecnologia, carros, dinheiro, aprendizado, casa, arte, motivação, anime. Somente leitura: o servidor nunca publica ou altera nada.

Habilidades

HabilidadeUse para
tiktok-outlier-researchEncontrar o que realmente explode em um nicho e os padrões por trás disso
tiktok-video-ideasObter 5 ideias de vídeo com aberturas, cada uma baseada em um sucesso real
tiktok-trend-watchUm resumo semanal em uma tela de formatos, hashtags e sons em ascensão

As habilidades também funcionam no claude.ai: baixe uma pasta de habilidade e adicione-a em Configurações > Capacidades > Habilidades.

Exemplos de prompts

  • "O que está bombando em fitness no TikTok neste mês, e o que esses vídeos têm em comum?"
  • "Me dê 5 ideias de vídeo para uma conta de culinária que grava em casa, baseadas no que funciona agora."
  • "Resumo semanal de tendências para beleza e moda."
  • "Pesquise no TikTok vídeos sobre barras de proteína ordenados por outlier, últimos 30 dias."

Dados

Apenas dados públicos do TikTok: vídeos, legendas, hashtags, sons e contadores públicos, atualizados diariamente. O Viewlify não é afiliado ao TikTok.

Estrutura do repositório

.claude-plugin/   manifesto do plugin e do marketplace para Claude Code
.mcp.json         o servidor MCP ao qual o plugin se conecta (chave de API solicitada na instalação, opcional)
server.json       entrada para o registro oficial de MCP
skills/           as três habilidades

Licença

MIT. Issues e pull requests são bem-vindos. Criado pela Viewlify.

Habilidades Relacionadas