namegen

namegen

各地域で一般的なランダムな名前を生成する、AI エージェント向けツールです。 依存関係はありません（Python ≥ 3.9、標準ライブラリのみ）。

地域： AR、BR、CN、DE、ES、FR、GB、IN、IT、JP、MX、NG、US（ARG、UK、USA などの別名も使用できます）。

3 つの利用方法

インターフェース	コマンド	対象
HTTP API	python -m namegen.server --port 8080 --base-url https://tu-dominio.com	Web アクセスが可能な任意のエージェント
MCP（stdio）	python -m namegen.mcp_server	Claude、Cursor、その他の MCP クライアント
CLI	python -m namegen.cli -r AR -n 5	スクリプトやシェルを使うエージェント

AI 向けの発見機能

サーバーは、人の介入なしにエージェントがサーバーを見つけて使用するために必要な情報をすべて公開します。

• /llms.txt：LLM 向けのプレーンテキストガイド
• /openapi.json：operationId: generate_names を含む OpenAPI 3.1（直接のツール呼び出しに対応）
• /.well-known/agent.json：機能、インターフェース、料金、利用ポリシーを記載した情報
• /.well-known/ai-plugin.json：プラグイン形式のマニフェスト（互換性用）
• 各レスポンスの Link ヘッダーで OpenAPI と llms.txt を参照
• 安定した code（REGION_UNSUPPORTED、COUNT_OUT_OF_RANGE など）と、修正方法を示す hint を含む JSON エラー

API

GET /v1/names?region=AR&count=3&gender=female&seed=abc
GET /v1/regions

{
  "schema": "namegen.v1", "region": "AR", "count": 1, "seed": null, "synthetic": true,
  "results": [{"id": "…", "full_name": "Martina Acosta", "given_name": "Martina",
               "family_names": ["Acosta"], "gender": "female", "region": "AR", "locale": "es-AR"}]
}

地域ごとの慣習に従います。MX／ES／BR では姓を 2 つ、JP／CN では姓を先にします。

暗号資産での決済（x402 + USDC）

決済を受け取るウォレットを設定すると有効になります。

export NAMEGEN_PAY_TO=0xTuWallet
export NAMEGEN_PRICE_USDC=0.001        # por solicitud
export NAMEGEN_NETWORK=base-sepolia    # testnet; usar "base" en producción
python -m namegen.server --base-url https://tu-dominio.com

フロー：エージェントがリクエストを送信 → 支払い額と支払先を示す 402 を受信 → x402 クライアントで USDC の支払いに署名 → X-PAYMENT ヘッダーを付けて再試行 → サーバーが facilitator を通じて検証・決済し、200 を返します。 無効なリクエストは、課金前に 400 で拒否されます。/v1/regions と発見用ファイルは無料です。

mainnet（base）では、NAMEGEN_FACILITATOR_URL に mainnet で動作する facilitator（例：Coinbase CDP のもの）を指定する必要があります。デフォルトの x402.org/facilitator は testnet 用です。

MCP への接続

{"mcpServers": {"namegen": {"command": "python", "args": ["-m", "namegen.mcp_server"],
                             "cwd": "/ruta/a/namegen"}}}

利用ポリシー

名前はランダムな組み合わせであり、実在の人物や個人のアイデンティティではありません。各レスポンスには "synthetic": true が含まれます。想定される用途：フィクション、ゲーム、プレースホルダー、モックアップ、テストデータ。 人物になりすましたり、架空の人物としてアカウントを作成したり、本人確認を通過したりする目的では使用しないでください。