TokensClean — Documentation

Version web

Convertit images, PDFs, DOCX et PPTX en Markdown pour réduire la consommation de tokens lors des échanges avec Claude.

Utilisation

Glisser-déposer — faites glisser votre fichier dans la zone gauche
Cmd+V — collez directement un screenshot depuis le presse-papier
Choisir un fichier — cliquez sur le bouton pour parcourir vos fichiers

Le Markdown est automatiquement copié dans le presse-papier après la conversion.

Formats supportés

Format	Moteur	Notes
PNG, JPG, GIF, WEBP	Mistral OCR	Compression automatique si > 1568px
PDF	Mistral OCR	Toutes les pages, avec images
DOCX	mammoth	Extraction texte brut
PPTX	jszip	Slides texte uniquement — les slides image-based nécessitent un export PDF

Modes

OCR — extrait le texte d'un document ou d'une image. Mode par défaut.
Vision — analyse une interface utilisateur et décrit les éléments cliquables avec leurs positions. Utile pour les screenshots d'apps.

Limite de taille

4,5 MB par fichier (limite Vercel Hobby). Les images sont automatiquement compressées côté client avant l'envoi.

Version MCP Claude Code

Un serveur MCP qui expose l'outil convert_to_markdown directement dans Claude Code. Idéal pour convertir des fichiers locaux sans quitter le terminal.

Prérequis

Node.js 18+
Claude Code CLI installé

Installation

git clone https://github.com/dabco/tokens-clean.git
cd tokens-clean/mcp
npm install

Configuration dans Claude Code

Ajoutez le serveur dans ~/.claude/settings.json :

{
  "mcpServers": {
    "tokensclean": {
      "command": "node",
      "args": ["/chemin/absolu/vers/tokens-clean/mcp/index.js"]
    }
  }
}

Remplacez /chemin/absolu/vers/tokens-clean par le chemin réel sur votre machine, ex. /Users/user/tokens-clean.

Exemples d'utilisation

# Convertir un PDF
"Convertis ~/Desktop/rapport.pdf en Markdown"

# Extraire le texte d'une image
"Extrais le texte de ~/Downloads/screenshot.png"

# Analyser une interface UI (mode vision)
"Analyse cette interface : ~/Desktop/app-ui.png"

Paramètres

Paramètre	Type	Description
`file_path`	string (requis)	Chemin absolu ou relatif vers le fichier
`mode`	ocr \| vision	Mode de conversion (défaut : ocr)

Formats supportés

PNG, JPG, GIF, WEBP, PDF, DOCX, PPTX — identiques à la version web.