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 tu ejecución, abre tu Terminal y elimina el indicador de cuarentena con:
xattr -d com.apple.quarantine /path/to/downloaded/executable
¿Tienes alguna pregunta?
