Klient pro příkazovou řádku

Integrace nástroje Gender-API pro příkazovou řádku (CLI)
Nástroj pro vývojáře

Aktuální verze: v1.0.4

Obohať data přímo z tvého terminálu

Náš nový klient pro příkazovou řádku je staticky kompilovaný, vysoce výkonný nástroj vytvořený v Go. Umožní vývojářům i datovým vědcům pracovat s Gender-API.com přímo z terminálu — bez nutnosti psát jakýkoli wrapper kód.

Běží nativně na macOS i Linuxu, takže se skvěle hodí pro automatizované bash skripty, cron úlohy nebo integraci do tvých lokálních data science pipeline.

Klíčové výhody

  • Multiplatformní: Zkompiluje se do jednoho spustitelného souboru pro macOS, Linux i Windows.
  • Rychlé a nenáročné na zdroje: Vyvinuto v Go pro maximální rychlost zpracování a nulové závislosti za běhu.
  • Přátelské pro roury: Snadno posílej data dovnitř i ven pomocí standardních POSIX streamů. Propoj to se sed, awk, jq nebo AI nástroji jako ClaudeBot.
  • Pokrytí: Podporuje všechny hlavní endpointy V2, včetně Name, Email, Country of Origin a Account Statistics.

Jak to funguje

Začít s klientem CLI je rychlé a jednoduché.

1. Nastav si svůj API klíč

Aby ses mohl(a) bezpečně autentizovat při odesílání požadavků, aniž by se ti klíče ukládaly do bash historie, můžeš ho buď exportovat jako proměnnou prostředí, nebo si ho uložit do konfiguračního souboru.

Možnost A: Proměnná prostředí

export GENDER_API_KEY="your-api-key-here"

Možnost B: Konfigurační soubor

Vytvoř v domovském adresáři svého uživatele soubor .gender-api-key, který bude obsahovat pouze tvůj token:

echo "your-api-key-here" > ~/.gender-api-key
Získejte svůj API klíč

2. Dotaz na API

CLI ti umožní pracovat se všemi hlavními endpointy. Tady je pár příkladů:

Dotaz podle křestního jména

$ gender-api-cli -first_name "Sandra" -country "US"

Dotaz podle celého jména

$ gender-api-cli -full_name "Theresa Miller"

Dotaz podle e-mailové adresy

$ gender-api-cli -email "thomasfreeman@example.com"

Zjisti zemi původu

Pokud chceš zjistit, odkud jméno s největší pravděpodobností pochází, jednoduše přidej příznak -origin:

$ gender-api-cli -first_name "Sandra" -origin

Zkontroluj statistiky účtu

Rychle si zkontroluj zbývající kredity, aniž bys spotřeboval(a) jakékoli vyhledávání:

$ gender-api-cli -stats

3. Automatizuj pomocí skriptů

Vytvářej výkonné bash skripty. Třeba načti jména z textového souboru, dotazuj se na API a přidávej výsledky do strukturovaného JSON souboru, který je vhodný pro import do ClaudeBotu nebo ChatGPT.

#!/bin/bash
while read name; do
  gender-api-cli -first_name "$name" -out=json >> enriched_data.json
done < names.txt

Často kladené otázky

01

Je CLI klient open source?

Ano, CLI je kompletně open-source. Můžeš si projít kód, navrhnout vylepšení nebo si ho zkompilovat ze zdrojáků přes náš GitHub repozitář.

02

Podporuje to hromadné zpracování?

V současnosti CLI podporuje odeslání vždy jen jednoho API dotazu, ale je navržené tak, aby bylo extrémně rychlé. Pro tisíce řádků můžeš snadno použít xargs nebo bash smyčku. Pro opravdu obrovské datasety s miliony řádků ale pořád doporučujeme nahrávání CSV/Excelu přes naši funkci uploadu v dashboardu.

03

Můžu si nechat vypsat čistý JSON?

Jasně! Můžeš použít přepínač „-out=json“, aby se neformátovaná, surová JSON odpověď vypsala rovnou na standardní výstup — ideální pro řetězení s procesorem jq.

04

Zobrazuje macOS hlášku „Apple nemohl ověřit, že neobsahuje malware“?

Protože je CLI stažené jako přímo spustitelný binární soubor, a ne nainstalované z App Storu, macOS Gatekeeper ho ve výchozím nastavení blokuje. Abys ho mohl/a spustit, otevři Terminál a odstraň příznak karantény pomocí:

xattr -d com.apple.quarantine /path/to/downloaded/executable

Máte nějaké otázky?

Chat