Nouveau · v1.0 · open source

La CLI de domaines et le serveur MCP pensés pour les agents IA

dna est l'outil en ligne de commande et le serveur MCP officiels de Domain Name API. Copiez un prompt prêt à l'emploi dans Claude ou ChatGPT : votre assistant l'installe, le connecte et se met au travail sur vos domaines, vos DNS, vos certificats SSL et votre hébergement. Tout ce qui coûte de l'argent attend votre accord.

Installer dna dans Claude Code

Mets en place la CLI dna pour moi (https://github.com/domainreseller/cli).
1. Installe-la avec le script d'installation officiel pour mon système d'exploitation, puis lance `dna version` et `dna doctor`.
2. Installe le skill Claude Code avec `dna agent skill --install` et ajoute le serveur MCP avec `claude mcp add dna -- dna mcp serve --env ote`.
3. Ne me demande pas de coller ma clé API dans cette conversation. Dis-moi de lancer moi-même `dna auth login --env ote`, puis vérifie la connexion avec `dna --ote account get`.
Travaille uniquement dans l'environnement de test OTE et n'utilise jamais `--yes` sans mon accord.

Copiez un prompt, collez-le dans votre assistant IA et laissez-le faire le travail. Chaque prompt commence dans l'environnement de test OTE et s'arrête pour attendre votre accord avant toute opération payante.

  • 64opérations API
  • 65outils MCP
  • 4classes de sécurité
  • 6plateformes, un seul binaire
  • Apache-2.0licence open source
Avec vos propres mots

Prompts prêts à l'emploi pour Claude et ChatGPT

Remplacez les noms de domaine, collez un prompt dans votre assistant et regardez-le travailler. Chaque prompt précise où s'arrêter : rien de payant ne se fait sans vous.

Trouver et enregistrer un domaine

Avec dna, vérifie si brandname.com, brandname.net et brandname.io sont disponibles. Affiche les résultats avec les prix dans un tableau, puis prévisualise avec `--dry-run` l'enregistrement du moins cher des domaines disponibles. N'enregistre rien tant que je n'ai pas dit oui.
domain bulk-search · domain registerbillable

Renouvellements à venir

Avec dna, liste mes domaines qui expirent dans les 60 prochains jours avec leur prix de renouvellement, triés par date d'expiration. Ne renouvelle rien.
domain list · domain renew-checkread

Faire pointer un domaine vers un serveur

Avec dna, fais pointer example.com vers 203.0.113.10 : ajoute des enregistrements A pour `@` et `www`, puis montre-moi la zone DNS finale. Demande-moi avant de modifier ou de supprimer le moindre enregistrement existant.
dns add · dns listwrite

Transférer un domaine vers votre compte

Avec dna, vérifie si example.org peut être transféré vers mon compte, dis-moi ce qu'il me manque encore (code d'autorisation, déverrouillage) et prévisualise le transfert avec `--dry-run`.
domain transfer-check · domain transferbillable

Commander un certificat SSL

Avec dna, trouve le certificat DV SSL le moins cher pour example.com, crée un CSR et prévisualise la commande. Attends mon accord avant d'acheter.
product ssls · ssl generate-csr · ssl initializebillable

Dites ce dont vous avez besoin. Votre agent trouve la bonne commande.

Chaque opération de l'API est un outil doté d'une description claire et d'un schéma JSON : les assistants choisissent le bon appel et le remplissent correctement du premier coup. Vous parlez, dna exécute avec précision.

Garde-fou

Votre agent ne peut pas dépenser un centime sans vous

Chaque commande a une classe de sécurité, et c'est elle qui décide de ce qui se passe. La consultation et les modifications gratuites et réversibles s'exécutent tout de suite. Tout ce qui débite votre solde ou ne peut pas être annulé s'arrête et vous demande d'abord votre accord.

  • read

    Lecture

    Recherche, listes, infos sur les domaines, prix et règles des extensions.

    S'exécute immédiatement
  • write

    Écriture

    Enregistrements DNS, verrou de transfert, protection WHOIS et contacts. Gratuit et réversible.

    S'exécute immédiatement
  • destructive

    Destructif

    Supprimer un enregistrement, révoquer un certificat SSL, désactiver DNSSEC.

    Attend votre accord
  • billable

    Payant

    Enregistrement, renouvellement, transfert, restauration, commandes SSL et d'hébergement.

    Attend votre accord

Comment fonctionne la confirmation

Les outils soumis à confirmation acceptent un champ confirm en plus. La plupart des clients MCP vous demandent aussi votre avis avant chaque appel d'outil ; les annotations de sécurité les aident à signaler les plus risqués.

  1. L'agent demande d'abord

    Il appelle l'outil sans confirm. Rien n'est envoyé. Il reçoit en retour un aperçu de la requête exacte.

  2. Vous décidez

    L'agent vous montre le domaine, la durée et l'opération. Vous répondez oui ou non.

  3. Une seule exécution

    Ce n'est qu'après votre oui qu'il relance l'appel avec confirm=true. Un appel payant n'est jamais renvoyé après une erreur réseau.

Fixez jusqu'où il peut aller

--env ote
Environnement de test : la vraie API, sans argent réel
--read-only
Regarder sans toucher. Toute modification est bloquée.
--no-billable
Tout sauf les achats
--groups domain,dns
Seulement les groupes de commandes que vous indiquez
--dry-run
Affiche la requête HTTP exacte, clé API masquée
Premiers pas

Du prompt au premier domaine en quatre étapes, sans quitter l'environnement de test

OTE est notre environnement de test : la même API, avec sa propre clé API et son propre solde. Entraînez-vous dans OTE, puis passez en production avec une seule option.

  1. Copiez un prompt

    Choisissez Claude Code, ChatGPT Codex ou le chat classique en haut de cette page, puis copiez le prompt.

  2. Collez-le dans votre assistant

    Il installe dna, ajoute le serveur MCP et lance dna doctor pour vérifier l'installation.

    dna doctor
  3. Connectez-vous vous-même à OTE

    Lancez la commande de connexion dans votre propre terminal et saisissez-y votre identifiant revendeur et votre clé API OTE, jamais dans la conversation.

    dna auth login --env ote
  4. Demandez avec vos mots

    Recherchez, prévisualisez avec --dry-run, enregistrez. Tout ce qui débite le solde de test attend votre accord.

    --dry-run
Installation manuelle

Vous préférez le terminal ? Connecté en deux commandes

Installez le binaire, puis ajoutez dna mcp serve à votre client MCP. Chaque opération de l'API devient un outil pour Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex CLI ou Gemini CLI.

$ curl -fsSL https://raw.githubusercontent.com/domainreseller/cli/main/scripts/install.sh | sh

Un seul binaire, sans aucune dépendance. Chaque version est publiée avec ses sommes de contrôle SHA-256.

  • Un outil par opération de l'API, chacun avec un schéma JSON généré à partir de la spécification de l'API
  • dna_context indique au modèle s'il est en production ou dans l'environnement de test avant qu'il ne touche à quoi que ce soit
  • N'exposez que le nécessaire avec --groups ou --read-only. Une liste d'outils plus courte économise aussi des tokens de contexte.
  • Les agents qui n'ont qu'un shell reçoivent une skill Claude Code et un guide d'utilisation en un seul appel
# connectez-vous d'abord à l'environnement de test
$ claude mcp add dna -- dna mcp serve --env ote

# lecture seule, partagé avec votre équipe via .mcp.json
$ claude mcp add dna --scope project -- dna mcp serve --env ote --read-only

Lancez dna mcp config pour afficher un extrait prêt à l'emploi pour chaque client.

Couverture

Les 64 opérations de l'API, regroupées comme vous les pensez

Si l'API revendeur sait le faire, dna aussi. Le --help de chaque commande indique sa classe de sécurité, sa route API et des exemples.

  • dna domain

    Recherche simple et groupée, enregistrement, renouvellement, transfert et restauration. Verrou de transfert, protection WHOIS, code de transfert (auth), serveurs de noms, hôtes enfants et redirection.

  • dna dns · dna dnssec

    Enregistrements de zone sur les serveurs de noms de la plateforme, et enregistrements DS auprès du registre.

  • dna ssl

    Générer un CSR, acheter, configurer, suivre le statut, télécharger, réémettre et révoquer des certificats.

  • dna hosting

    Offres et forfaits d'hébergement, nouvelles commandes et leur statut.

  • dna contact

    Fiches contact réutilisables, avec vérification de l'e-mail et du téléphone.

  • dna account · product · order

    Solde et transactions, catalogue des extensions avec leurs prix, et statut des commandes.

  • dna api

    Une requête brute authentifiée vers n'importe quel point de terminaison, avec les mêmes règles de sécurité.

  • dna schema · enums · agent

    Des descriptions lisibles par machine de chaque opération, entrée et valeur codée, pour les agents et les créateurs d'outils.

Voir la référence complète des commandes

Scripts et CI

Conçu pour les pipes, les tâches cron et les pipelines

Dans un terminal, vous obtenez des tableaux lisibles. Dans un pipe, du JSON. Les erreurs aussi sont en JSON, avec des codes de sortie dont le sens ne change jamais : un script sait toujours ce qui s'est mal passé.

  • JSON quand la sortie passe dans un pipe, JSON Lines pour les flux et un --jq intégré pour garder une sortie légère
  • Identifiants lus dans DNA_RESELLER_ID et DNA_API_KEY en CI, ou dans un profil sur votre propre machine
  • Aucune question cachée hors d'un terminal : une commande soumise à confirmation se termine avec le code 9 et n'envoie rien
  • Les entrées sont vérifiées avant tout envoi, et les requêtes freinées par la limite de débit sont relancées pour vous
# domaines qui expirent dans les 30 prochains jours, en CSV
$ dna domain list --all \
    --jq '.items[] | select(.remainingDay <= 30) | [.domainName, .expirationDate] | @csv'

# vérifier plusieurs noms d'un coup
$ dna domain bulk-search brand.com brand.net brand.io \
    --jq '.infos[] | "\(.domainName)\t\(.status)\t\(.price)"'

# dans un script, un achat sans --yes s'arrête ici
$ dna domain renew example.com --period 1
exit 9  confirmation required · nothing sent
Codes de sortie
0succès6limite de débit atteinte
2entrée invalide, rien n'est envoyé7erreur serveur
3authentification8réseau
4introuvable9confirmation requise
5rejeté par l'API10mode lecture seule
Choisir un outil

CLI, SDK, REST API ou module prêt à l'emploi ?

Tous parlent à la même API revendeur, avec les mêmes identifiants. Choisissez celui qui correspond à l'endroit où le travail se fait.

Questions fréquentes

Ce qu'on nous demande avant de brancher un agent

Des réponses courtes et directes. Le README sur GitHub couvre tous les détails.

Lire la documentation complète
Qu'est-ce que la CLI Domain Name API ?

dna est le client en ligne de commande et le serveur MCP officiels de la plateforme revendeur Domain Name API. Il couvre les 64 opérations de la REST API revendeur, de la recherche, l'enregistrement, le renouvellement et le transfert de domaines jusqu'au DNS, au DNSSEC, aux contacts, au SSL et à l'hébergement, dans un seul binaire open source pour macOS, Linux et Windows, sous licence Apache-2.0.

Est-il sûr de laisser un agent IA enregistrer des domaines ?

Oui, car l'agent ne peut rien acheter de lui-même. Les opérations payantes et destructives renvoient un aperçu au lieu de s'exécuter. Elles ne s'exécutent qu'une fois que vous avez donné votre accord et que l'appel contient confirm=true, ou --yes dans la CLI. Démarrez les agents sur l'environnement de test OTE et restreignez-les davantage avec --read-only ou --no-billable.

Puis-je l'essayer sans dépenser d'argent ?

Oui. Avec --env ote, dna communique avec OTE, notre environnement de test. Il a sa propre clé API et son propre solde, et rien de ce que vous y faites ne touche aux domaines en production ni à votre vrai compte.

Quels assistants IA fonctionnent avec dna ?

Tous les clients MCP : Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, OpenAI Codex CLI, Gemini CLI et d'autres. Les agents qui n'ont qu'un shell peuvent appeler directement la CLI ; dna agent guide et la skill Claude Code leur apprennent à s'en servir.

Faut-il un compte Domain Name API ?

Oui. dna fonctionne avec un compte revendeur et ses identifiants API : votre identifiant revendeur et une clé API, tous deux dans la section Paramètres API du panneau revendeur. La production et OTE ont des clés différentes, et l'e-mail et le mot de passe de votre panneau ne fonctionnent pas ici.

dna est-il gratuit ?

Oui. L'outil est gratuit et open source, sous licence Apache-2.0. Vous ne payez que ce que vous achetez avec lui, comme des domaines, des renouvellements, des certificats SSL ou de l'hébergement, à vos prix revendeur et depuis le solde de votre compte.

Où mes identifiants sont-ils stockés ?

dna auth login les enregistre dans un fichier de profil, dans le dossier de configuration de votre utilisateur, lisible par vous seul sous Linux et macOS ; dna config path indique son emplacement. Les variables d'environnement sont toujours prioritaires, et la clé API est masquée dans toutes les sorties, --dry-run compris.

Puis-je utiliser dna dans des scripts et en CI ?

Oui. La sortie est en JSON quand elle passe dans un pipe, les erreurs sont en JSON avec des codes de sortie stables, et rien n'est demandé hors d'un terminal interactif. Passez les identifiants via DNA_RESELLER_ID et DNA_API_KEY. Une commande payante sans --yes se termine avec le code 9 et n'envoie rien.

Dois-je utiliser la CLI ou un SDK ?

Utilisez dna quand c'est une personne, un script ou un agent IA qui fait le travail. Utilisez un SDK pour PHP, Node.js, Python, Ruby ou Go, ou directement la REST API, quand vous intégrez des fonctions de domaine à votre propre application. Tous utilisent la même API et les mêmes identifiants.

Faut-il forcément passer par le terminal ?

Non. Collez un prompt prêt à l'emploi dans Claude Code, qui tourne aussi dans l'application de bureau Claude, ou dans ChatGPT Codex, et l'assistant installe et connecte dna pour vous. La seule commande que vous tapez vous-même est dna auth login : votre clé API ne passe ainsi jamais par la conversation. Sans aucun terminal, le prompt pour le chat vous guide à chaque étape.