Tu hosting, desde el terminal.

Consulta tus sitios y VPS, automatiza tareas y accede al catálogo de herramientas autorizado para tu cuenta. Un fichero Python, sin dependencias externas.

Descargar hostbrid.py Guía completa del CLI

hostbrid · CLIPython 3

$ python3 ~/bin/hostbrid tools show hostbrid_get_plan

Plan contratado

Consulta el uso y los límites de sitios, bases de datos, dominios, buzones y disco de tu plan.

sitios:leer

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

Lecturas de ejemplo · sin crear recursos

Python 3 · biblioteca estándar · JSON

01 / Instalación

Instala una vez. Úsalo en tus scripts.

Necesitas Python 3. La descarga se guarda en tu equipo: puedes revisar el fichero antes de ejecutarlo. Los ejemplos usan la ruta completa; añade ~/bin a tu PATH si prefieres escribir hostbrid.

Guía completa del 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 / Recursos

Empieza por tus recursos

Los comandos directos cubren tareas habituales de sitios, DNS, correo y máquinas. Usa --help para consultar las opciones y --json para procesar la respuesta.

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

03 / Herramientas

Descubre antes de ejecutar

tools list consulta por MCP el catálogo que permite tu clave. tools show muestra el esquema de una herramienta; tools call la ejecuta con argumentos JSON. Los comandos directos y el catálogo MCP conviven en el mismo cliente. El catálogo público de planes se consulta sin clave con --public; es independiente del catálogo de tu cuenta.

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

JSON para tus pipelines

Guarda la respuesta, procésala con jq o pásala al siguiente paso de tu CI. En tools call puedes cargar argumentos desde @argumentos.json o desde la entrada estándar con @-. Comprueba el código de salida antes de continuar.

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

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

Autenticación

Una clave con los permisos que necesitas

Crea la clave en el panel y entrega HOSTBRID_TOKEN a tu proceso desde un gestor de secretos. No la escribas en repositorios, prompts ni logs. Las claves nuevas son de lectura; los permisos adicionales se conceden por separado. Revoca la clave en el panel cuando dejes de usarla o si se expone.

Gestionar claves API →

API · CLI · MCP

Las confirmaciones siguen vigentes

El CLI no amplía los permisos de tu clave ni evita las confirmaciones del servidor. Preparar una compra no la paga: revisa y confirma el pago en el panel. Los borrados y otras operaciones sensibles conservan sus vistas previas y controles de confirmación.