Communitygithub.com

benjaminb10/viewlify-mcp

Données TikTok pour Claude et les agents IA : serveur MCP (vidéos qui dépassent les vues habituelles de leur créateur, tendances, hashtags, sons), plugin Claude Code avec 3 compétences, et l'outil en ligne de commande viewlify.

Qu'est-ce que viewlify-mcp ?

Viewlify MCP est un serveur MCP (Model Context Protocol) qui offre aux agents IA comme Claude, Claude Code, Cursor et autres clients compatibles un accès aux données publiques de TikTok. Sa particularité est de calculer pour chaque vidéo un **multiple** : le ratio entre ses vues et les vues habituelles de son créateur. Une vidéo à 50 000 vues est un échec pour un compte qui en fait habituellement 500 000, mais un succès retentissant pour un compte qui en fait 2 000. Le serveur expose plusieurs outils : `get_trending` pour les tendances par niche, `get_outliers` pour les vidéos qui surperforment le plus, `get_trending_hashtags`, `get_creator` pour analyser un créateur en détail, et `search_trending_videos` pour rechercher dans toute la base. Il inclut également trois compétences Claude Code : recherche d'outliers, génération d'idées vidéo et veille hebdomadaire. L'API est gratuite avec un aperçu limité à 20 appels par jour par IP, ou payante à partir de 1 $ de crédit. Aucune installation locale nécessaire car le serveur est hébergé par Viewlify.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Viewlify MCP : Données TikTok pour Claude et les agents IA

Demandez à Claude quelles vidéos TikTok sont vraiment en train de percer dans une niche, et pourquoi. Viewlify suit les vidéos TikTok publiques et compare chacune d'elles aux vues habituelles de son créateur : une vidéo à 50 000 vues est un échec pour un compte qui en obtient habituellement 500 000 et une percée pour un compte qui en obtient habituellement 2 000. Ce ratio, le multiple, est ce que ce serveur renvoie, ainsi que les vidéos, hashtags et sons qui gagnent le plus de vues par niche.

Ce dépôt contient tout ce dont vous avez besoin pour utiliser Viewlify depuis Claude Code, Claude, Cursor ou tout client MCP :

  • la configuration du serveur MCP distant (https://viewlify.app/api/mcp),
  • un plugin Claude Code avec trois compétences construites dessus,
  • le code source de l'outil en ligne de commande viewlify publié sur npm.

Le serveur lui-même est hébergé par Viewlify ; rien à exécuter localement.

Démarrage rapide

Claude Code, en tant que plugin (serveur MCP et les trois compétences) :

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

Lors de l'installation, Claude Code demande votre clé API Viewlify. Elle est facultative (voir ci-dessous) : laissez-la vide pour l'aperçu gratuit.

Claude Code, serveur MCP uniquement :

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

Claude (claude.ai ou Desktop) : Paramètres > Connecteurs > Ajouter un connecteur personnalisé, URL https://viewlify.app/api/mcp.

Cursor et autres clients : un serveur HTTP streamable à https://viewlify.app/api/mcp, avec l'en-tête Authorization: Bearer vf_live_YOUR_KEY.

Terminal : npx viewlify login, puis npx viewlify search "skincare" --sort outlier --limit 5. npx viewlify mcp affiche la commande claude mcp add avec votre clé.

Clé API et prix

La clé est facultative. Sans elle, les outils publics répondent avec un aperçu de 5 résultats (20 appels par jour par IP).

Avec une clé, vous obtenez les résultats complets, le multiple d'outlier, les partages pour 1 000 vues, l'historique des vues enregistré par Viewlify, et la recherche dans toutes les vidéos de la base. Tout compte Viewlify peut créer une clé dans Paramètres > API & MCP, plan gratuit inclus, avec 1 $ de crédit gratuit. Ensuite, le coût est de 0,005 $ par appel depuis un crédit prépayé (recharges de 5 à 100 USD), ou inclus dans les plans Pro et Agence. Tarifs : viewlify.app/tiktok-data-api.

Outils

OutilCléCe qu'il renvoie
get_trendingfacultativeVidéos, hashtags et sons qui percent en ce moment, par niche
get_outliersfacultativeVidéos dépassant les vues habituelles de leur créateur avec la plus grande marge, par niche ou recherche
get_trending_hashtagsfacultativeHashtags récurrents sous ce qui perce, par niche
get_creatorfacultativeUn créateur : abonnés, vues habituelles, engagement, meilleure percée, meilleur jour de publication, principaux hashtags et sons, et ses vidéos avec le multiple
search_trending_videosrequiseRechercher toute la base par mot-clé, @créateur ou #hashtag ; trier par tendance, outlier, vues, récent, engagement ou partages
get_balance, top_uprequiseCrédit API, et un lien de paiement pour en ajouter
list_my_accounts, get_account_growth, get_account_videos, get_my_niche_watch, get_my_video_checksPro ou AgenceVos propres comptes suivis, leur croissance et leurs vidéos, votre veille de niche et les analyses vidéo IA

Niches : beauté, gaming, cuisine, fitness, mode, comédie, danse, animaux de compagnie, football, sports, musique, voyage, technologie, voitures, argent, apprentissage, maison, art, motivation, anime. Lecture seule : le serveur ne publie ni ne modifie jamais rien.

Compétences

CompétenceUtilisez-la pour
recherche-outliers-tiktokTrouver ce qui perce vraiment dans une niche et les schémas derrière
idees-videos-tiktokObtenir 5 idées vidéo avec accroches, chacune basée sur une percée réelle
veille-tendance-tiktokUn résumé hebdomadaire sur un écran des formats, hashtags et sons montants

Les compétences fonctionnent aussi sur claude.ai : téléchargez un dossier de compétence et ajoutez-le dans Paramètres > Capacités > Compétences.

Exemples de prompts

  • "Qu'est-ce qui perce dans la fitness sur TikTok ce mois-ci, et qu'est-ce que ces vidéos ont en commun ?"
  • "Donne-moi 5 idées vidéo pour un compte de cuisine qui filme à la maison, basées sur ce qui marche en ce moment."
  • "Brief de tendances hebdomadaire pour la beauté et la mode."
  • "Recherche des vidéos TikTok sur les barres protéinées triées par outlier, ces 30 derniers jours."

Données

Données TikTok publiques uniquement : vidéos, légendes, hashtags, sons et compteurs publics, actualisés quotidiennement. Viewlify n'est pas affilié à TikTok.

Structure du dépôt

.claude-plugin/   manifestes du plugin et de la marketplace pour Claude Code
.mcp.json         le serveur MCP auquel le plugin se connecte (clé API demandée à l'installation, facultative)
server.json       entrée pour le registre MCP officiel
skills/           les trois compétences

Licence

MIT. Les problèmes et les demandes de fusion sont les bienvenus. Construit par Viewlify.

Skills associés