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)
├── agent/                    # 汎用 AI エージェント
└── tests/                    # 横断テスト・フィクスチャ

利用方法

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

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

変数	説明
STADDRESS_API_KEY	API キー（取得方法は .env.example を参照）
STADDRESS_BASE_URL	ベース URL（既定: https://api.staddress.com）

curl サンプル（Mac／Linux 向け）

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

詳細は examples/curl/ を参照。

PowerShell サンプル（Windows 向け）

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

詳細は examples/powershell/ を参照。

Shell CLI（staddress）

ターミナル向けの 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

各言語 SDK（開発予定）

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

開発ロードマップ

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

フェーズ	内容	状態
1	curl サンプル	完了
2	PowerShell サンプル	完了
3	Shell CLI	完了
4	Node.js SDK	完了
5	Python SDK	未着手
6	Ruby SDK	未着手
7	その他言語（Go / PHP 等）	計画中
8	汎用 AI エージェント	未着手

ライセンス

MIT License © 2026 StaddressAI