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
viewlifypublié 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
| Outil | Clé | Ce qu'il renvoie |
|---|---|---|
get_trending | facultative | Vidéos, hashtags et sons qui percent en ce moment, par niche |
get_outliers | facultative | Vidéos dépassant les vues habituelles de leur créateur avec la plus grande marge, par niche ou recherche |
get_trending_hashtags | facultative | Hashtags récurrents sous ce qui perce, par niche |
get_creator | facultative | Un 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_videos | requise | Rechercher toute la base par mot-clé, @créateur ou #hashtag ; trier par tendance, outlier, vues, récent, engagement ou partages |
get_balance, top_up | requise | Cré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_checks | Pro ou Agence | Vos 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étence | Utilisez-la pour |
|---|---|
| recherche-outliers-tiktok | Trouver ce qui perce vraiment dans une niche et les schémas derrière |
| idees-videos-tiktok | Obtenir 5 idées vidéo avec accroches, chacune basée sur une percée réelle |
| veille-tendance-tiktok | Un 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.