Quand je donne une page web à lire à un assistant IA, il avale tout : le menu, le bandeau cookies, le pied de page, les scripts et les encarts publicitaires. Le texte qui m'intéresse ne pèse souvent qu'une petite fraction de l'ensemble. curl.md règle ce problème avec une idée toute simple : vous lui donnez une adresse, il vous rend le contenu de la page en Markdown, avec les titres, les liens et les tableaux, et rien d'autre. Je l'ai testé dans le navigateur, dans un terminal, avec Claude Code et dans un workflow n8n. Voici ce que j'en retiens, chiffres à jour, avec ses limites et les alternatives qui valent le coup d'œil.

curl.md, c'est quoi exactement ?

curl.md est un service en ligne développé par l'équipe wevm. Son principe tient en une phrase : il prend une URL et renvoie une version Markdown de la page, débarrassée de tout ce qui n'est pas du contenu. Pas de navigation, pas de fenêtre de consentement, pas de boutons de partage.

Pour ceux qui ne le connaissent pas, le Markdown est un format texte très léger. Un titre s'écrit avec un dièse, un lien avec des crochets et des parenthèses, une liste avec des tirets. Un humain le lit sans effort et les modèles de langage le comprennent parfaitement. C'est pour ça que la plupart des agents IA le préfèrent au HTML brut, qui est bavard et rempli de balises inutiles pour eux.

Le gain se joue sur deux tableaux. Pour vous, c'est une page propre, facile à relire ou à archiver. Pour votre agent IA, c'est beaucoup moins de tokens à ingérer, donc des réponses plus pertinentes et une facture plus légère si vous payez à l'usage. La page d'accueil affiche d'ailleurs un compteur en direct : au moment où je mets cet article à jour, il annonce plus de 5,7 milliards de tokens économisés et un peu plus de 17 000 dollars épargnés par les utilisateurs. Ce sont des estimations du service lui-même, mais l'ordre de grandeur montre que l'outil est réellement utilisé.

Tester curl.md sans rien installer

C'est ce qui m'a convaincu en premier : on l'essaie en dix secondes. Dans la barre d'adresse de votre navigateur, ajoutez curl.md/ devant l'adresse de la page qui vous intéresse. Par exemple :

curl.md/fr.wikipedia.org/wiki/Markdown

La page s'affiche alors en texte Markdown, directement à l'écran. Pas de compte, pas d'extension à installer.

Dans un terminal, ça marche de la même façon avec la commande curl, présente par défaut sous Linux, macOS et Windows 10/11 :

# Réponse en Markdown (type text/markdown)
curl curl.md/example.com

# Réponse en JSON
curl curl.md/example.com -H 'Accept: application/json'

# Enregistrer le résultat dans un fichier
curl curl.md/example.com -o page.md

La version JSON renvoie un objet avec un champ content qui contient le Markdown. Pratique quand on veut traiter le résultat dans un script ou un outil d'automatisation.

Un détail que j'ai découvert en lisant la documentation : chaque réponse transporte des en-têtes très parlants. x-tokens-count donne le nombre estimé de tokens de la réponse, x-tokens-saved les tokens économisés par rapport à la page d'origine, x-cache indique si la page venait du cache, et x-ratelimit-remaining vous dit combien de requêtes il vous reste. Avec des crédits, x-cost-mills et x-credits-remaining affichent le coût de la requête et votre solde. Ajoutez l'option -I ou -v à curl pour les voir.

Cibler l'information avec un objectif, des mots-clés et deux modes

Récupérer une page entière en Markdown, c'est déjà bien. Mais la fonction la plus intéressante de curl.md, c'est l'objectif. Vous décrivez en langage naturel ce que vous cherchez, et le service ne renvoie que le passage correspondant. Sur une documentation de quarante écrans, ça change la vie.

Quatre paramètres entrent en jeu :

objective (alias o ou q)
Décrit ce que vous voulez extraire de la page, par exemple « comment configurer le cache ».
keywords (alias k)
Une liste de mots-clés séparés par des virgules. Ils servent de pré-filtre avant l'extraction, ce qui rend le résultat plus précis sur les pages très longues.
mode (alias m)
Ne joue que si un objectif est défini. Deux valeurs : smart, le mode par défaut, qui fait une passe plus soignée, et rush, plus rapide mais un peu moins fin.
fresh (alias f)
Force une nouvelle récupération en ignorant le cache. Utile quand le contenu vient d'être mis à jour.

Tout passe en paramètres d'URL, donc même sans ligne de commande vous pouvez vous en servir depuis le navigateur :

curl.md/docs.joomla.org/J4.x:Caching?objective=activer+le+cache&keywords=cache,plugin&mode=rush

Pensez juste à remplacer les espaces par des + dans l'objectif quand vous l'écrivez dans une URL. Un point à connaître : l'extraction par objectif est bien plus limitée que la conversion simple, surtout sans compte, et la documentation recommande de se connecter pour en profiter vraiment (j'y reviens plus bas).

Installer le client en ligne de commande

Si vous comptez l'utiliser souvent, le client officiel est plus confortable. Trois façons de l'installer :

# Avec npm
npm i -g curl.md

# Avec Bun
bun i -g curl.md

# Avec le script d'installation (Linux, macOS)
curl -fsSL https://curl.md/install.sh | bash

# Vérifier l'installation
curl.md --version

Pour la version npm, il vous faudra Node.js en version 22 ou supérieure. On peut aussi récupérer un binaire tout prêt sur la page des versions publiées sur GitHub. Une fois installé, le client répond à curl.md ou à son alias court md. Voici les commandes que j'utilise le plus :

# Récupérer une page
md example.com

# Avec un objectif
md zod.dev/error-formatting --objective "tree error formatting"

# Objectif + mots-clés + mode rapide
md developers.cloudflare.com/d1/get-started --objective "query D1 from a worker" --keywords D1,bindings --mode rush

# Ignorer le cache
md example.com --fresh

# Se connecter pour débloquer des limites plus hautes
curl.md auth login

# Mettre à jour le client
curl.md update

Le client gère aussi les jetons d'API (curl.md token create mon-app), les crédits prépayés (curl.md credits status et curl.md credits add), l'historique de vos requêtes (curl.md request list, avec une recherche par URL) et des organisations pour travailler en équipe, avec invitations et rôles. Il sait même générer l'autocomplétion pour bash, zsh, fish ou nushell avec curl.md completions. Pour un usage dans un script ou sur un serveur, il lit la variable d'environnement CURLMD_API_KEY.

curl.md et les agents IA : plugins, serveur MCP, skills et SDK

C'est clairement le public visé. L'idée : votre agent va chercher lui-même les pages dont il a besoin, en Markdown optimisé, sans que vous ayez à copier-coller quoi que ce soit.

Des intégrations officielles existent pour quatre agents de code : Claude, Amp, OpenCode et Pi. Pour Claude Code, l'installation tient en deux lignes :

claude plugin marketplace add wevm/curl.md
claude plugin install curl-md@curl-md

Votre outil n'est pas dans la liste ? Plusieurs solutions de repli existent :

Voici à quoi ressemble un appel avec le SDK :

import { createClient } from 'curl.md'

const client = createClient()
const res = await client.fetch('docs.github.com/en/webhooks/webhook-events-and-payloads', {
  objective: 'pull request webhook payload',
  keywords: ['pull_request'],
})
const json = await res.json()

Le SDK renvoie des erreurs typées selon le code HTTP : validation_error pour une requête mal formée, fetch_failed ou ai_failed quand la récupération ou l'extraction échoue. On peut donc gérer proprement les cas d'échec dans son code.

Mes cas d'usage concrets

Donner de la documentation à mon agent de code

C'est mon usage principal. Quand je travaille sur un site Joomla avec Claude Code et que je bloque sur une API, je ne colle plus des pages entières de documentation dans le prompt. L'agent récupère la page avec un objectif précis et ne reçoit que les trois paragraphes utiles. Le contexte reste léger, et les réponses sont plus justes parce que l'agent n'est pas noyé sous le bruit.

Automatiser ma veille dans n8n

J'utilise n8n pour pas mal d'automatisations, et curl.md s'y branche sans connecteur spécial. Un nœud HTTP Request qui appelle https://curl.md/ suivi de l'adresse à surveiller suffit, avec le jeton dans l'en-tête Authorization: Bearer si vous avez un compte. Je m'en sers pour suivre les notes de version de Joomla et de YOOtheme Pro : le workflow récupère la page, un objectif du type « nouveautés et correctifs de sécurité » isole la partie qui compte, puis un nœud IA me prépare un résumé. Je reçois l'essentiel sans ouvrir dix onglets. Petit conseil au passage : lisez l'en-tête x-ratelimit-remaining dans le workflow pour éviter de taper dans le plafond.

Versionner une documentation dans un dépôt

Autre usage que je trouve malin : aspirer la documentation d'une bibliothèque dans un fichier .md rangé dans le dépôt Git du projet. C'est bien plus lisible qu'un PDF oublié dans un dossier, et l'agent de code peut la consulter hors ligne.

Côté perso : lecture, archivage et chatbots

En dehors du travail, curl.md me sert à récupérer un article pour le relire tranquillement dans Obsidian, à archiver une recette ou un mode d'emploi avant qu'il disparaisse du web, ou à envoyer une page à ChatGPT ou Claude sans lui faire avaler la moitié du site autour.

Si c'est la consommation de tokens de vos agents qui vous préoccupe, RTK (Rust Token Killer) suit la même logique, mais pour les commandes du terminal. Ce proxy compresse la sortie de commandes comme git status, ls ou grep avant qu'elle n'arrive dans le contexte de l'agent. Les deux outils se complètent bien.

Limites et tarifs de la version hébergée

La version en ligne est gratuite, mais avec des plafonds. Voici les limites affichées dans la documentation officielle, que j'ai revérifiées pour cette mise à jour :

Limites de débit de curl.md
Type de requête Anonyme Compte gratuit Crédits prépayés
Récupération standard 100 par heure 1 000 par heure Pas de limite de débit
Requête avec objectif 3 par heure 10 par heure Pas de limite de débit
Crédits rechargeables par tranches de 5, 10, 20 ou 50 dollars. Au-delà du plafond gratuit, le service renvoie une erreur 429 avec un en-tête retry-after.

Pour de simples conversions, 1 000 requêtes par heure avec un compte gratuit, c'est large. Le vrai point faible concerne les requêtes avec objectif, qui font justement l'intérêt de l'outil : dix par heure, c'est de quoi tester, pas de quoi travailler au quotidien avec un agent qui en enchaîne plusieurs par tâche. Il faudra alors passer aux crédits, ou regarder du côté de l'auto-hébergement. Bonne nouvelle quand même : avec des crédits, l'en-tête x-cost-mills indique le coût exact de chaque requête, ce qui permet de surveiller sa dépense sans surprise.

Gardez en tête que chaque URL transite par les serveurs de curl.md. Je ne l'utilise donc jamais pour des pages internes, des intranets clients ou des adresses qui contiennent un jeton d'accès dans leurs paramètres. Et les pages protégées par une connexion ne sont de toute façon pas accessibles.

Auto-héberger curl.md : ce qu'il faut savoir

Le code source complet est public sur GitHub, sous licence MIT. Vous pouvez donc l'utiliser, le modifier et le faire tourner chez vous gratuitement. Par contre, soyons honnêtes : ce n'est pas un conteneur à lancer en deux clics sur un NAS.

Le projet est conçu pour tourner sur Cloudflare Workers. En production, il s'appuie sur plusieurs briques : Cloudflare pour les Workers, le rendu de pages (Browser Rendering), Workers AI, les files d'attente et le stockage clé-valeur, une base Postgres (PlanetScale chez eux), plus GitHub OAuth pour l'authentification et Stripe pour les crédits. Leur guide de déploiement est surtout écrit pour l'équipe, mais il donne les bases pour reproduire l'infrastructure sur votre propre compte Cloudflare.

Pour un usage local ou des tests, le guide de contribution décrit un environnement de développement basé sur Docker Compose :

git clone https://github.com/wevm/curl.md.git
cd curl.md
cp .env.example .env   # à compléter avec vos propres clés
docker compose up -d

Une fois votre instance en place, le client en ligne de commande peut pointer dessus grâce à la variable CURLMD_BASE_URL, qui vaut https://curl.md par défaut. Si vous avez déjà un compte Cloudflare et l'habitude de Docker, c'est jouable. Si vous cherchez juste un outil local sans dépendance à un cloud, Defuddle (voir plus bas) sera bien plus simple.

Les alternatives à curl.md

curl.md n'est pas seul sur ce créneau. Voici comment il se situe face aux outils que je croise le plus souvent :

curl.md face à Jina Reader, Defuddle et Firecrawl
Outil Utilisation Extraction ciblée Gratuit Code source
curl.md Préfixe d'URL, curl, CLI, MCP, plugins d'agents, SDK Oui (objectif, mots-clés, modes smart et rush) 100 req/h anonyme, 1 000 avec compte MIT, basé sur Cloudflare
Jina Reader Préfixe r.jina.ai/, API, serveur MCP Partielle (sélecteurs CSS) 20 req/min sans clé, 500 avec clé gratuite (10 millions de tokens offerts) Service open source, modèles ReaderLM sous licence non commerciale
Defuddle CLI npm en local, bibliothèque JavaScript Non Oui, sans limite (tourne sur votre machine) MIT
Firecrawl API avec clé, SDK, crawl de sites entiers Oui (extraction structurée par IA) 1 000 crédits par mois, 10 req/min, 2 requêtes simultanées AGPL-3.0, auto-hébergeable
Pour un usage ponctuel : préfixe curl.md ou Jina. Pour tout garder en local : Defuddle. Pour crawler un site complet : Firecrawl. Les quotas gratuits de ces services changent souvent, vérifiez-les avant de bâtir un workflow dessus.

Mon avis rapide sur chacun. Jina Reader fonctionne sur le même principe de préfixe et reste une valeur sûre. Son débit gratuit s'est nettement amélioré avec une clé (500 requêtes par minute contre 200 il y a quelque temps), et il lit aussi les PDF. Le contexte a changé : Jina AI appartient désormais à Elastic. Le code du service reste ouvert, mais les modèles utilisés par Reader, comme ReaderLM-v2, sont publiés sous licence CC-BY-NC 4.0. Concrètement, leur usage commercial en production demande une licence, vendue séparément par Elastic depuis le 10 août 2026. Si vous l'intégrez dans un produit client, ça mérite une vérification.

Defuddle, créé par Steph Ango (le CEO d'Obsidian), tourne entièrement en local avec defuddle parse <url> --md : rien ne sort de votre machine, mais il n'y a pas de filtrage intelligent. Firecrawl vise plutôt le crawl de sites complets et l'extraction de données structurées, avec une API plus lourde. Son offre gratuite donne aujourd'hui 1 000 crédits renouvelés chaque mois sans carte bancaire, soit environ 1 000 pages, puis l'abonnement Hobby démarre à 16 dollars par mois en paiement annuel. Je reste prudent sur ces chiffres : Firecrawl a revu sa grille tarifaire début septembre 2026 et peut encore la faire évoluer. curl.md, lui, se distingue par son objectif en langage naturel et par ses intégrations natives avec les agents de code.

Mon avis sur curl.md

J'aime beaucoup l'idée, et surtout la façon dont elle est pensée. On peut commencer sans rien installer, puis monter en puissance avec le client, les plugins ou le serveur MCP, sans changer d'outil. Le filtrage par objectif est vraiment efficace sur les documentations longues, et les en-têtes qui affichent les tokens économisés et le coût par requête permettent de mesurer le gain concret.

Côté faiblesses, les requêtes avec objectif restent trop limitées en gratuit pour un usage professionnel régulier, et l'auto-hébergement demande une vraie infrastructure Cloudflare. Le projet est aussi jeune : quelques mois après mes premiers tests, le paquet npm en est toujours à une version 0.1.x (0.1.3 à l'heure où j'écris), et une partie de l'API publique est encore marquée comme expérimentale. Je m'attends donc toujours à des changements, ce qui invite à ne pas bâtir un workflow critique dessus sans plan B.

Mon conseil : testez-le d'abord avec le préfixe dans le navigateur, puis créez un compte gratuit si vous voulez l'utiliser avec un agent. Vous verrez vite si les 10 requêtes à objectif par heure vous suffisent ou s'il faut passer aux crédits.

Essayer curl.md

Questions fréquentes

curl.md est-il gratuit ?
Oui, dans la limite de 100 requêtes par heure sans compte et 1 000 avec un compte gratuit. Les requêtes avec objectif sont limitées à 3 par heure en anonyme et 10 avec un compte. Au-delà, il faut acheter des crédits prépayés ou héberger votre propre instance.
Faut-il savoir programmer pour l'utiliser ?
Non. Il suffit d'ajouter curl.md/ devant une adresse dans la barre de votre navigateur. La ligne de commande, le SDK et le serveur MCP sont là pour ceux qui veulent aller plus loin.
Quels sont les prérequis pour installer le client ?
Avec npm, il faut Node.js 22 ou plus récent. Sinon, Bun, le script d'installation pour Linux et macOS ou un binaire téléchargé depuis GitHub font l'affaire.
Est-ce que curl.md fonctionne avec ChatGPT ou Claude ?
Vous pouvez copier le Markdown obtenu dans n'importe quel chatbot. Pour les agents de code, des plugins officiels existent pour Claude, Amp, OpenCode et Pi, et le mode serveur MCP ou les skills couvrent la plupart des autres outils, comme Cursor ou Codex.
Peut-on convertir une page protégée par un mot de passe ?
Non. curl.md récupère les pages publiques. Les contenus derrière une connexion, un paywall ou un intranet ne sont pas accessibles, et je déconseille de toute façon de faire transiter des adresses privées par un service tiers.
Quelle différence entre les modes smart et rush ?
Ils ne s'appliquent qu'aux requêtes avec objectif. Smart, le mode par défaut, fait une extraction plus soignée, adaptée à la plupart des recherches dans une documentation. Rush est plus rapide, au prix d'une précision un peu moindre.
Comment connaître le coût d'une requête payante ?
Regardez les en-têtes de la réponse : x-cost-mills donne le coût de la requête et x-credits-remaining le solde de crédits restant. La commande curl.md credits status affiche aussi votre solde.
Peut-on installer curl.md sur son propre serveur ?
Oui, le code est sous licence MIT. Mais le projet repose sur Cloudflare Workers et plusieurs services associés. Un environnement Docker Compose existe pour le développement local, et le client peut ensuite pointer vers votre instance avec la variable CURLMD_BASE_URL.

Source