Référence des outils MCP
Le serveur MCP de Tube Search fournit 9 outils pour rechercher, lire et analyser les données YouTube archivées.
search_channel
Trouver toutes les vidéos connues d'une chaîne YouTube en interrogeant les archives web.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
query | string | Oui | URL de la chaîne, @handle ou Channel ID (ex. UC...) |
Renvoie un tableau de métadonnées de vidéos incluant le statut (LIVE, DELETED, CHECKING).
search_videos
Recherche plein texte dans les titres et descriptions des vidéos archivées.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
query | string | Oui | Requête de recherche (supporte le langage naturel) |
limit | number | Non | Nombre max. de résultats (par défaut : 20, max : 100) |
status | string | Non | Filtrer par statut : live, deleted, all |
sort | string | Non | relevance (par défaut) ou date-desc |
hasSubtitles | boolean | Non | Uniquement les vidéos avec sous-titres |
hasSummary | boolean | Non | Uniquement les vidéos avec résumé IA |
get_video
Obtenir les métadonnées d'une vidéo spécifique.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
videoId | string | Oui | ID de la vidéo YouTube (11 caractères) |
Renvoie : title, description, channelId, channelTitle, duration, uploadDate, viewCount, status, thumbnailUrl, subtitleStatus, hasSummary.
get_subtitles
Obtenir la transcription complète d'une vidéo en texte lisible.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
videoId | string | Oui | ID de la vidéo YouTube |
Renvoie la transcription sans horodatages, formatée en paragraphes lisibles. Fonctionne pour les vidéos actives et supprimées ayant des sous-titres archivés.
get_summary
Obtenir le résumé généré par IA d'une vidéo.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
videoId | string | Oui | ID de la vidéo YouTube |
Renvoie : tldr, keyPoints (avec horodatages), detailedSummary, tags, language. Renvoie une erreur si aucun résumé n'existe — utilisez generate_summary pour en créer un.
generate_summary
Générer un résumé IA pour une vidéo ayant des sous-titres.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
videoId | string | Oui | ID de la vidéo YouTube |
Lance la génération et attend la fin (jusqu'à 60 s). Renvoie le résumé si la vidéo en possède déjà un. Décompté de votre limite quotidienne de génération de résumés.
browse_summaries
Parcourir les résumés IA existants avec des filtres optionnels.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
tag | string | Non | Filtrer par tag (ex. "music", "education") |
channelId | string | Non | Filtrer par chaîne |
language | string | Non | Filtrer par langue (ex. "en", "fr") |
page | number | Non | Numéro de page (par défaut : 1) |
limit | number | Non | Résultats par page (par défaut : 20) |
get_video_status_history
Voir l'historique des changements de statut d'une vidéo.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
videoId | string | Oui | ID de la vidéo YouTube |
Renvoie un tableau de transitions de statut : [{ status, previousStatus, changedAt, source }], les plus récentes en premier.
get_usage
Vérifier vos compteurs d'utilisation API actuels et les limites restantes.
Aucun paramètre. Renvoie les compteurs actuels et les limites pour les recherches, requêtes FTS, téléchargements de sous-titres et générations de résumés.