Référence des outils MCP
Le serveur MCP de Tube Search fournit 10 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. Pour les vidéos enrichies via notre pipeline de provenance Yandex.Video, la réponse inclut également un objet yandex imbriqué avec les clés internal_id, attribution, preview_url et scanned_at — voir la sous-section « Provenance de l'enrichissement Yandex » ci-dessous.
Provenance de l'enrichissement Yandex
Lorsque get_video renvoie un objet yandex imbriqué, le champ yandex.attribution prend l'une de trois valeurs de niveau de confiance. Utilisez le tableau ci-dessous pour décider si vous pouvez citer directement un fait concernant cette vidéo ou s'il faut chercher une deuxième source.
Niveau (valeur de yandex.attribution) | Action recommandée | Justification |
|---|---|---|
db_match | Citer directement | L'ID YouTube existait déjà dans notre base de données rattaché à cette chaîne ; Yandex a complété des métadonnées supplémentaires (title, duration, upload_date) via remplissage des champs NULL. Confiance maximale. |
yt_dlp_confirmed | Citer directement | L'ID YouTube a été découvert pour la première fois via Yandex ; yt-dlp a confirmé indépendamment l'attribution de la chaîne contre les métadonnées YouTube en direct. Corroboration par deux sources indépendantes. |
name_unique_anchor_passed | Corroborer d'abord | L'ID YouTube a été découvert pour la première fois via Yandex ; yt-dlp a échoué ou expiré ; l'attribution repose sur des heuristiques d'unicité de nom et de vérification par ancrage (au moins 2 sur K correspondances de titres de vidéos LIVE). Signal plus faible — confirmez avec une deuxième source avant de citer. |
Lorsque yandex.preview_url est non null, il pointe vers un court (~5 s) clip MP4 animé d'aperçu, miroir du snapshot Yandex — utile pour confirmer visuellement à quoi ressemblait la vidéo supprimée, mais pas équivalent au contenu original complet. Lorsque preview_url est null, les champs de métadonnées (title, duration, uploadDate) et attribution restent valides ; seul le miroir d'aperçu n'a pas abouti.
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.
generate_stenogram
Générer un sténogramme privé (dialogue mot à mot avec marquage des locuteurs) à partir du transcript d'une vidéo. Nécessite le niveau L3+ (offre MCP + API). Le résultat est stocké dans votre espace utilisateur et visible uniquement par vous.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
videoId | string | Oui | ID de la vidéo YouTube (11 caractères) |
language | enum | Non | auto (par défaut), en, ru, es, de, pt |
Renvoie : { stenogram, metadata: { llmModel, tokensUsed, promptVersion, generatedAt, language, generationTimeMs } }. Nécessite un transcript existant (sous-titres archivés ou IA). Émet notifications/progress si un progress token est fourni. Décompté de apiStenogramsPerDay (compteur partagé avec la route REST).
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.