Klient wiersza poleceń
Wzbogać dane bezpośrednio z poziomu terminala
Nasz nowy klient wiersza poleceń to statycznie kompilowane, wysokowydajne narzędzie stworzone w Go. Dzięki niemu programiści i data scientist mogą korzystać z Gender-API.com prosto z terminala — bez pisania dodatkowego kodu pośredniego.
Działa natywnie na macOS i Linuksie, dzięki czemu świetnie sprawdzi się w automatycznych skryptach bash, zadaniach cron lub jako element Twoich lokalnych pipeline’ów data science.
Najważniejsze korzyści
- Wieloplatformowy: Kompiluje się do pojedynczego pliku binarnego dla macOS, Linuxa i Windowsa.
- Szybkie i lekkie: Stworzone w Go dla maksymalnej szybkości działania i bez żadnych zależności w czasie uruchomienia.
- Przyjazny dla Pipe: Z łatwością przesyłaj dane wejściowe i wyjściowe, korzystając ze standardowych strumieni POSIX. Integruj z sed, awk, jq albo narzędziami AI, takimi jak ClaudeBot.
- Zasięg: Obsługuje wszystkie najważniejsze endpointy V2, w tym Name, Email, Country of Origin oraz Account Statistics.
Jak to działa
Zacznij korzystać z klienta CLI szybko i bez problemu.
1. Skonfiguruj swój klucz API
Aby bezpiecznie uwierzytelniać swoje zapytania bez zapisywania kluczy w historii bash, możesz albo wyeksportować go jako zmienną środowiskową, albo zapisać w pliku konfiguracyjnym.
Opcja A: zmienna środowiskowa
export GENDER_API_KEY="your-api-key-here"
Opcja B: Plik konfiguracyjny
Utwórz plik o nazwie .gender-api-key w katalogu domowym swojego użytkownika, zawierający wyłącznie Twój token:
echo "your-api-key-here" > ~/.gender-api-key
2. Wyślij zapytanie do API
CLI pozwala Ci korzystać ze wszystkich najważniejszych endpointów. Oto kilka przykładów:
Zapytanie według imienia
$ gender-api-cli -first_name "Sandra" -country "US"
Sprawdź po pełnym imieniu i nazwisku
$ gender-api-cli -full_name "Theresa Miller"
Wyszukaj po adresie e-mail
$ gender-api-cli -email "thomasfreeman@example.com"
Określ kraj pochodzenia
Aby sprawdzić, skąd najprawdopodobniej pochodzi dane imię, po prostu dopisz flagę -origin:
$ gender-api-cli -first_name "Sandra" -origin
Sprawdź statystyki konta
Szybko sprawdź, ile zostało Ci kredytów — bez zużywania żadnych wyszukiwań:
$ gender-api-cli -stats
3. Zautomatyzuj za pomocą skryptów
Twórz potężne skrypty bash. Na przykład wczytuj imiona z pliku tekstowego, wysyłaj zapytania do API i dopisuj wyniki do uporządkowanego pliku JSON, gotowego do wykorzystania przez ClaudeBot lub ChatGPT.
#!/bin/bash
while read name; do
gender-api-cli -first_name "$name" -out=json >> enriched_data.json
done < names.txt
Najczęściej zadawane pytania
Czy klient CLI ma otwarty kod źródłowy?
Tak, CLI jest w pełni open source. Możesz przejrzeć kod, zaproponować ulepszenia albo skompilować go ze źródeł przez nasze repozytorium na GitHubie.
Czy obsługuje przetwarzanie zbiorcze?
Obecnie CLI obsługuje wykonywanie pojedynczych zapytań do API naraz, ale zostało zaprojektowane tak, aby działać ekstremalnie szybko. Dla tysięcy wierszy bez problemu użyjesz xargs albo pętli w bashu. Przy ogromnych zbiorach danych liczących miliony linii nadal polecamy funkcję przesyłania CSV/Excel w panelu.
Czy mogę zwracać surowy JSON?
Tak! Możesz przekazać flagę `-out=json`, aby zwrócić niesformatowaną, surową odpowiedź JSON bezpośrednio na standardowe wyjście — idealne do łańcuchów przetwarzania z `jq`.
macOS wyświetla komunikat „Apple nie mogło zweryfikować, że jest wolne od złośliwego oprogramowania”?
Ponieważ CLI pobierasz jako bezpośredni plik binarny, a nie instalujesz przez App Store, macOS Gatekeeper domyślnie go blokuje. Aby zezwolić na uruchomienie, otwórz Terminal i usuń flagę kwarantanny, używając:
xattr -d com.apple.quarantine /path/to/downloaded/executable
Masz jakieś pytania?
