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
viewlifypublicada 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
| Ferramenta | Chave | O que retorna |
|---|---|---|
get_trending | opcional | Vídeos, hashtags e sons que estão bombando agora, por nicho |
get_outliers | opcional | Vídeos que superam as visualizações habituais do criador pela maior margem, por nicho ou busca |
get_trending_hashtags | opcional | Hashtags recorrentes entre o que está bombando, por nicho |
get_creator | opcional | Um 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_videos | obrigatória | Buscar toda a base por palavra-chave, @criador ou #hashtag; ordenar por trending, outlier, visualizações, recente, engajamento ou compartilhamentos |
get_balance, top_up | obrigatória | Cré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_checks | Pro ou Agency | Suas 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
| Habilidade | Use para |
|---|---|
| tiktok-outlier-research | Encontrar o que realmente explode em um nicho e os padrões por trás disso |
| tiktok-video-ideas | Obter 5 ideias de vídeo com aberturas, cada uma baseada em um sucesso real |
| tiktok-trend-watch | Um 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.