staddress-tools

Staddress AI（ストアドレス）住所解析サービス向けの クライアントツール群 および 汎用 AI エージェント の開発リポジトリ。

• 公式 API 仕様: https://staddress.com/api

Staddress AI（住所解析サービス）の解析精度を確認するだけであれば、GUI で手軽に行えます。まずは 公式サイト からお試しください。

コードで動作検証や開発を行う場合に、本リポジトリが役立ちます。さまざまなプログラミング言語から Staddress AI API を利用できるよう、サンプルコードおよび**各言語に対応した SDK（ライブラリ）**を提供します。

staddress-tools/
├── README.md                 # 本ファイル
├── .env.example              # 環境変数テンプレート
├── docs/                     # 設計・計画・仕様書
├── examples/
│   ├── curl/                 # curl サンプル
│   └── powershell/           # PowerShell サンプル
├── openapi/                  # Staddress API OpenAPI 定義
├── packages/
│   ├── cli/                  # staddress シェルコマンド
│   ├── node/                 # Node.js SDK (@staddress/client)
│   ├── python/               # Python SDK (staddress)
│   ├── ruby/                 # Ruby Gem (staddress)
│   └── mcp/                  # MCP サーバー (@staddress/mcp)
├── agent/                    # 汎用 AI エージェント
└── tests/                    # 横断テスト・フィクスチャ

事前に、リポジトリルートで環境変数を設定します。

cp .env.example .env
# STADDRESS_API_KEY と STADDRESS_BASE_URL を設定

source .env
./examples/curl/staddress.sh -s "六本木ヒルズ 森タワー 52F"

詳細は examples/curl/ を参照。

.\examples\powershell\staddress.ps1 -Single "六本木ヒルズ 森タワー 52F"

詳細は examples/powershell/ を参照。

ターミナル向けの staddress コマンドを提供しています（詳細: packages/cli/）。

cd packages/cli && ./install.sh
staddress config set api-key <あなたのキー>

staddress parse "東京都渋谷区道玄坂1-2 マンション桜 101号"
staddress usage
staddress batch --file addresses.json

Node.js / Python / Ruby などの SDK を順次提供予定です（開発ロードマップ を参照）。

詳細は docs/plan-tools.md を参照。

リポジトリ直下の plugin.json と mcp.json は Agent Plugins（Open Plugins）標準 のマニフェストです。Cursor Directory などのレジストリがこれを自動検出し、MCP サーバー @staddress/mcp をプラグインとして掲載します（削除しないでください）。

• plugin.json: プラグイン名・メタデータ（$schema は Agent Plugins 1.0.0）。訴求力のある日本語／英語併記の description と、レジストリ表示用アイコン logo（assets/staddress-icon.png）を設定済み。
• mcp.json: MCP サーバー定義（stdio、npx -y @staddress/mcp）。API キーは各クライアントの環境変数 STADDRESS_API_KEY で指定します。

MIT License © 2026 StaddressAI