コマンドラインクライアント

開発者ツール

現在のバージョン: v1.0.4

macOS（Intel） macOS（Apple Silicon） Linux（amd64） Windows

GitHubでソースコードを見る

ターミナルから直接データをエンリッチする

新しい コマンドラインクライアント は、Go で開発された静的コンパイルの高性能ツールです。開発者やデータサイエンティストは、ラッパーコードを書かずに、ターミナルからそのまま Gender-API.com を操作できます。

macOS と Linux でネイティブに動作するため、自動化した bash スクリプトや cron ジョブ、ローカルのデータサイエンス用パイプラインへの組み込みに最適です。

主なメリット

クロスプラットフォーム: macOS、Linux、Windows向けに、単一のバイナリとしてコンパイルできます。
高速＆軽量: 最大限の実行速度と実行時依存ゼロを実現するために、Goで開発されています。
パイプ対応: 標準の POSIX ストリームを使って、データを簡単に入出力できます。sed、awk、jq、または ClaudeBot のような AI ツールともスムーズに連携できます。
カバレッジ: 名前、メールアドレス、出身国、アカウント統計など、主要なV2エンドポイントにすべて対応しています。

仕組み

CLIクライアントの使い始めは、すばやく簡単にできます。

1. API キーを設定する

bash の履歴にキーを残さずリクエストを安全に認証するには、環境変数として export するか、設定ファイルに保存します。

オプションA：環境変数

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

オプションB：設定ファイル

ユーザーのホームディレクトリに、トークンだけを含む .gender-api-key という名前のファイルを作成してください

echo "your-api-key-here" > ~/.gender-api-key

APIキーを取得する

2. APIに問い合わせる

CLI を使えば、主要なエンドポイントすべてとやり取りできます。以下に例を示します:

ファーストネームで照会

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

フルネームで照会

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

メールアドレスで照会

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

出身国を判定する

名前がどの地域に由来する可能性が高いかを調べるには、-origin フラグを末尾に付けるだけ:

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

アカウント統計を確認する

照会を消費せずに、残りのクレジットをすばやく確認できます:

$ gender-api-cli -stats

3. スクリプトで自動化

強力な Bash スクリプトを作成できます。たとえば、テキストファイルから名前を読み込み、API に照会して、結果を ClaudeBot や ChatGPT が取り込みやすい構造化 JSON ファイルに追記できます。

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

よくある質問

CLI クライアントはオープンソースですか？

はい、この CLI は完全にオープンソースです。GitHub リポジトリでコードを確認したり、改善案を提案したり、ソースからコンパイルしたりできます。

一括処理に対応していますか？

現時点では、この CLI は API クエリを1件ずつ実行する形に対応していますが、動作は非常に高速です。数千行程度であれば、xargs や bash のループを使って簡単に処理できます。何百万行もの大規模データセットの場合は、ダッシュボードの CSV/Excel アップロード機能をおすすめします。

生の JSON をそのまま出力できますか？

はい。「-out=json」フラグを渡すと、整形されていない生の JSON レスポンスをそのまま標準出力に返せます。jq の処理チェーンにそのままつなげられます。

macOS で「Apple はマルウェアに感染していないことを確認できませんでした」と表示される場合は？

CLI は App Store からインストールするアプリではなく、実行ファイルを直接ダウンロードする形式のため、macOS の Gatekeeper によりデフォルトで保護されます。実行できるようにするには、ターミナルを開き、次のコマンドで quarantine フラグを解除してください：

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