Votre hébergement, depuis le terminal.

Consultez vos sites et VPS, automatisez vos tâches et accédez au catalogue d’outils autorisé pour votre compte. Un fichier Python, sans dépendances externes.

Télécharger hostbrid.py Guide complet du CLI

hostbrid · CLIPython 3

$ python3 ~/bin/hostbrid tools show hostbrid_get_plan

Offre actuelle

Consultez l’utilisation et les limites de votre offre : sites, bases de données, domaines, boîtes e-mail et espace disque.

sitios:leer

{
  "type": "object",
  "properties": {}
}

Exemples en lecture seule · aucune ressource créée

Python 3 · bibliothèque standard · JSON

01 / Installation

Installez une fois. Utilisez-le dans vos scripts.

Python 3 est nécessaire. Le fichier est enregistré sur votre ordinateur : vous pouvez le vérifier avant de l’exécuter. Les exemples utilisent le chemin complet ; ajoutez ~/bin au PATH pour saisir hostbrid directement.

Guide complet du CLI →

mkdir -p ~/bin
curl --fail --show-error --location \
  https://my.hostbrid.com/cli/hostbrid.py \
  --output ~/bin/hostbrid
chmod 700 ~/bin/hostbrid
python3 ~/bin/hostbrid --help

02 / Ressources

Commencez par vos ressources

Les commandes directes couvrent les tâches courantes des sites, DNS, e-mails et machines. Utilisez --help pour consulter les options et --json pour traiter la réponse.

python3 ~/bin/hostbrid sites list
python3 ~/bin/hostbrid maquinas list
python3 ~/bin/hostbrid sites list --json

03 / Outils

Découvrez avant d’exécuter

tools list interroge par MCP le catalogue autorisé par votre clé. tools show affiche le schéma d’un outil ; tools call l’exécute avec des arguments JSON. Commandes directes et catalogue MCP partagent le même client. Consultez le catalogue public des offres sans clé avec --public ; il est distinct du catalogue de votre compte.

MCP →

python3 ~/bin/hostbrid tools list
python3 ~/bin/hostbrid tools list --filter plan
python3 ~/bin/hostbrid tools show hostbrid_get_plan
python3 ~/bin/hostbrid tools call hostbrid_get_plan --arguments '{}'

python3 ~/bin/hostbrid tools call hostbrid_listar_planes_publicos \
  --arguments '{"tipo_recurso":"vps","limite":3}' --public

04 / JSON

Du JSON pour vos pipelines

Enregistrez une réponse, traitez-la avec jq ou transmettez-la à l’étape CI suivante. Dans tools call, chargez les arguments depuis @arguments.json ou depuis l’entrée standard avec @-. Vérifiez le code de sortie avant de poursuivre.

python3 ~/bin/hostbrid sites list --json > sites.json
jq . sites.json

printf '%s' '{}' | python3 ~/bin/hostbrid tools call hostbrid_get_plan --arguments @-

Authentification

Une clé avec les permissions nécessaires

Créez une clé dans le panneau et fournissez HOSTBRID_TOKEN au processus depuis un gestionnaire de secrets. Ne la placez jamais dans un dépôt, un prompt ou un journal. Les nouvelles clés sont en lecture seule ; les permissions supplémentaires sont accordées séparément. Révoquez la clé dans le panneau après utilisation ou en cas d’exposition.

Gérer les clés API →

API · CLI · MCP

Les confirmations restent obligatoires

Le CLI n’élargit pas les permissions de votre clé et ne contourne pas les confirmations du serveur. Préparer un achat ne le paie pas : vérifiez et confirmez le paiement dans le panneau. Les suppressions et autres opérations sensibles conservent leurs aperçus et leurs contrôles de confirmation.