Klient pro příkazovou řádku
Obohaťte data přímo z vašeho 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 vašich 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ílejte data dovnitř i ven pomocí standardních POSIX streamů. Propojte 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. Nastavte si svůj API klíč
Abyste se mohli bezpečně autentizovat při odesílání požadavků, aniž by se vám klíče ukládaly do bash historie, můžete jej buď exportovat jako proměnnou prostředí, nebo si jej 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řte v domovském adresáři svého uživatele soubor .gender-api-key, který bude obsahovat pouze váš token:
echo "your-api-key-here" > ~/.gender-api-key
2. Dotaz na API
CLI vám umožní pracovat se všemi hlavními endpointy. Zde je několik 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"
Zjistěte zemi původu
Pokud chcete zjistit, odkud jméno s největší pravděpodobností pochází, jednoduše přidejte příznak -origin:
$ gender-api-cli -first_name "Sandra" -origin
Zkontrolujte statistiky účtu
Rychle si zkontrolujte zbývající kredity, aniž byste spotřebovali jakékoli vyhledávání:
$ gender-api-cli -stats
3. Automatizujte pomocí skriptů
Vytvářejte výkonné bash skripty. Třeba načtěte jména z textového souboru, dotazujte se na API a přidávejte 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
Je CLI klient open source?
Ano, CLI je kompletně open-source. Můžete si projít kód, navrhnout vylepšení nebo si ho zkompilovat ze zdrojového kódu přes náš GitHub repozitář.
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ůžete 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.
Můžu si nechat vypsat čistý JSON?
Ano! Můžete 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.
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. Abyste ho mohli spustit, otevřete Terminál a odstraňte příznak karantény pomocí:
xattr -d com.apple.quarantine /path/to/downloaded/executable
Máte nějaké otázky?
