# Clipscrit

> Clipscrit récupère le texte des vidéos TikTok (sous-titres exacts et minutés), leurs infos (auteur, hashtags, vues, engagement, miniatures) et des vidéos de la même niche. Quand une vidéo n'a pas de sous-titres, l'audio est transcrit dans le navigateur de l'utilisateur. Les Reels Instagram et les fichiers locaux sont transcrits dans le navigateur.

## Pour les assistants IA

- Serveur MCP (Streamable HTTP, sans session) : `/mcp`, avec l'en-tête `Authorization: Bearer <clé API>`
- Outils en lecture seule : `get_transcript` (texte, option minutage, `translate_to` pour une traduction de la bibliothèque), `get_video_info` (métadonnées, statistiques, engagement, miniatures), `find_similar_videos` (même niche par hashtags, même créateur), `search_library` (textes déjà transcrits par les visiteurs)
- Réponses en TOON (compact, moins de jetons) ; le même objet en JSON dans `structuredContent`
- Sans sous-titres, `get_transcript` renvoie le texte de la bibliothèque s'il existe (`source: clipscrit_library`)
- Clés API (création, révocation), installation et bac à sable : [/mcp](/mcp)

## Pages

- [Transcrire](/) : coller un lien TikTok ou Instagram, ou déposer un fichier
- [Documentation](/docs) : utilisation, vie privée, API HTTP, limites
- [Bibliothèque](/library) : vidéos déjà transcrites ou traduites, consultables sans recalcul
- [Statistiques](/stats) : totaux anonymes d'usage
- [Charte graphique](/brand) : logos SVG et PNG, couleurs, typographie, kit à télécharger
- [Conditions d'utilisation](/conditions) et [politique cookies](/cookies)

## API HTTP

Toutes les routes ci-dessous (sauf `/api/stats`) demandent l'en-tête `Authorization: Bearer <clé API>`.


- `POST /api/extract` corps `{ "url": "<lien TikTok>" }` : infos, statistiques, hashtags, sous-titres
- `GET /api/similar/:id?tags=a,b&author=compte` : vidéos de la même niche et du même créateur
- `GET /api/image/:id/:kind` : miniature (`cover`, `origin`, `animated`, `thumbnail`), `?download=1` pour enregistrer
- `GET /api/library?q=&lang=&sort=` : recherche dans la bibliothèque
- `GET /api/library/:id` et `GET /api/library/:id/translation/:lang` : texte et traductions gardés
- `GET /api/stats` : totaux anonymes

## Limites

- Vidéos publiques uniquement ; 120 lectures TikTok par clé toutes les 10 minutes (hors cache)
- La transcription de l'audio ne se fait pas côté serveur : renvoyer l'utilisateur vers `/?url=<lien>`
- Clipscrit n'est affilié ni à TikTok ni à Instagram