Cliente de línea de comandos
Enriquece tus datos directamente desde tu terminal
Nuestro nuevo Cliente de línea de comandos es una herramienta de alto rendimiento, compilada de forma estática y desarrollada en Go. Te permite, como desarrollador o científico de datos, interactuar con Gender-API.com directamente desde tu terminal, sin tener que escribir código wrapper.
Se ejecuta de forma nativa en macOS y Linux, así que es perfecto para scripts bash automatizados, tareas cron o para integrarlo en tus pipelines locales de ciencia de datos.
Beneficios clave
- Multiplataforma: Se compila en un único binario para macOS, Linux y Windows.
- Rápido y ligero: Desarrollado en Go para ofrecer la máxima velocidad de ejecución y cero dependencias en tiempo de ejecución.
- Compatible con tuberías: Envía y recibe datos fácilmente usando flujos estándar POSIX. Intégralo con sed, awk, jq o herramientas de IA como ClaudeBot.
- Cobertura: Compatible con todos los endpoints principales de V2, incluidos Nombre, Email, País de origen y Estadísticas de la cuenta.
¿Cómo Funciona?
Empezar con el cliente CLI es rápido y sencillo.
1. Configura tu clave de API
Para autenticar tus solicitudes de forma segura sin que la clave quede registrada en tu historial de bash, puedes exportarla como una variable de entorno o guardarla en un archivo de configuración.
Opción A: Variable de entorno
export GENDER_API_KEY="your-api-key-here"
Opción B: Archivo de configuración
Crea un archivo llamado .gender-api-key en el directorio de inicio de tu usuario que contenga únicamente tu token:
echo "your-api-key-here" > ~/.gender-api-key
2. Consulta la API
La CLI te permite interactuar con todos los endpoints principales. Aquí tienes algunos ejemplos:
Consulta por nombre de pila
$ gender-api-cli -first_name "Sandra" -country "US"
Consulta por nombre completo
$ gender-api-cli -full_name "Theresa Miller"
Consulta por dirección de correo electrónico
$ gender-api-cli -email "thomasfreeman@example.com"
Determinar el país de origen
Para descubrir de dónde es más probable que sea un nombre, solo añade el indicador -origin:
$ gender-api-cli -first_name "Sandra" -origin
Consultar estadísticas de la cuenta
Consulta rápidamente tus créditos restantes sin consumir ninguna búsqueda:
$ gender-api-cli -stats
3. Automatiza con scripts
Crea potentes scripts en Bash. Por ejemplo, lee nombres desde un archivo de texto, consulta la API y añade los resultados a un archivo JSON estructurado, listo para que ClaudeBot o ChatGPT lo ingieran.
#!/bin/bash
while read name; do
gender-api-cli -first_name "$name" -out=json >> enriched_data.json
done < names.txt
Preguntas frecuentes
¿El cliente CLI es de código abierto?
Sí, la CLI es completamente de código abierto. Puedes revisar el código, sugerir mejoras o compilarla desde el código fuente a través de nuestro repositorio en GitHub.
¿Permite el procesamiento en lote?
Actualmente, la CLI permite realizar una sola consulta a la API por vez, pero está diseñada para ser extremadamente rápida. Para miles de filas, puedes usar fácilmente xargs o un bucle en bash. Para conjuntos de datos masivos de millones de líneas, seguimos recomendando nuestra función de subida de CSV/Excel en el panel.
¿Puedo mostrar el JSON en bruto?
¡Sí! Puedes pasar el parámetro **"-out=json"** para devolver la respuesta JSON en bruto, sin formato, directamente a la salida estándar, lo que lo hace perfecto para cadenas de procesamiento con **jq**.
¿macOS dice “Apple no ha podido verificar que esté libre de malware”?
Como la CLI se descarga como un binario directo y no se instala desde la App Store, macOS Gatekeeper la protege de forma predeterminada. Para permitir su ejecución, abre tu Terminal y elimina el indicador de cuarentena con:
xattr -d com.apple.quarantine /path/to/downloaded/executable
Have any questions?
