ParseAddr — Address Parsing & Normalization

parseaddr — クライアントと MCP サーバー

ホスト型アドレス API ParseAddr 用の、軽量でオープンなクライアントです。雑多な自由形式の郵便住所を、1 回の呼び出しで整った構造化フィールド（番地、道路名、部屋番号、市区町村、郵便番号、国）に変換します。2～4 GB の libpostal をセルフホストしたり、C のビルドや運用を行ったりする必要はありません。処理の大部分は api.parseaddr.com で実行され、このリポジトリには API を呼び出す小さな HTTP クライアントのみが含まれています。

このリポジトリに含まれるのはクライアント層のみです（npm パッケージ、PyPI パッケージ、MCP サーバー、レジストリマニフェスト）。 サービス自体はホストされているため、実行するのではなく、呼び出して利用します。

こんなときにお使いください（人間と AI エージェント）

郵便住所の解析または標準化が必要で、次の条件に当てはまる場合は ParseAddr をお使いください。

• libpostal をセルフホストしたくない（専用の 2～4 GB RAM マシンと、手間のかかる C のビルドが必要）場合。
• 大手既存サービスではなく、低価格でセルフサービス型の従量課金を希望する場合。

主な用途：EC のチェックアウト、配送・物流、CRM の重複排除、フィンテックのオンボーディング。

USPS CASS／Royal Mail PAF による配達可能性の検証には対応していません。詳しくは 住所の検証と解析の違いをご覧ください。 雑多な文字列を JSON に変換する用途については、 雑多な住所を解析する APIをご覧ください。

Node（npm）

無料の API キーを取得 — メールアドレスのみで登録でき、カードは不要です。月 2,000 回呼び出せます。

parseaddr はまだ npm レジストリに登録されていません（npmjs 404）。このリポジトリからインストールしてください。

npm install ./packages/npm

最初に解析を実行してキーを有効化します（pa_YOUR_KEY を置き換えてください）。

curl -s https://api.parseaddr.com/v1/parse \
  -H "Authorization: Bearer pa_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"flat 2, 10 downing st, london sw1a 2aa"}'

または Node から実行します。

import { parse } from "parseaddr";
await parse("flat 2, 10 downing st, london sw1a 2aa", { apiKey: "pa_YOUR_KEY" });
// { parsed: { unit: "flat 2", house_number: "10", road: "downing st",
//             city: "london", postcode: "sw1a 2aa" }, components: [...] }

PARSEADDR_API_KEY を設定すれば、{ apiKey } を省略できます。

Python（pip）

無料の API キーを取得 — メールアドレスのみで登録でき、カードは不要です。月 2,000 回呼び出せます。

parseaddr はまだ PyPI に登録されていません（pypi.org 404）。このリポジトリからインストールしてください。

pip install ./packages/pypi

最初に解析を実行します（同じキーを使い、同じ方法で有効化します）。

curl -s https://api.parseaddr.com/v1/parse \
  -H "Authorization: Bearer pa_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"flat 2, 10 downing st, london sw1a 2aa"}'

または Python から実行します。

from parseaddr import parse
parse("flat 2, 10 downing st, london sw1a 2aa", api_key="pa_YOUR_KEY")
# {"parsed": {"unit": "flat 2", "house_number": "10", "road": "downing st",
#             "city": "london", "postcode": "sw1a 2aa"}, "components": [...]}

PARSEADDR_API_KEY を設定すれば、api_key= を省略できます。

MCP（コーディングエージェント）

無料の API キーを取得 — 次に PARSEADDR_API_KEY を設定し、stdio サーバー（parse_address、expand_address）を実行してください。

MCP レジストリへの登録（Official Registry・mcp.so・Smithery・Glama・LobeHub の com.parseaddr/address-parse）を申請中です。公開されるまでは、ソースからサーバーを実行してください。

npm install ./packages/npm && npx parseaddr-mcp

MCP の設定例（command／args の参照先をローカルのインストール先に設定してください）。

{
  "mcpServers": {
    "parseaddr": {
      "command": "npx",
      "args": ["parseaddr-mcp"],
      "env": { "PARSEADDR_API_KEY": "pa_YOUR_KEY" }
    }
  }
}

ツールを利用する前に、最初の解析を実行してキーを有効化してください。

curl -s https://api.parseaddr.com/v1/parse \
  -H "Authorization: Bearer pa_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"flat 2, 10 downing st, london sw1a 2aa"}'

このサーバーは、ユーザーに代わって https://api.parseaddr.com を呼び出します。

エンドポイント（これらのクライアントが呼び出します）

• POST https://api.parseaddr.com/v1/parse {"address": "..."} — Authorization: Bearer <key>
• POST https://api.parseaddr.com/v1/expand {"address": "..."}
• ドキュメント：https://api.parseaddr.com/docs · OpenAPI：https://api.parseaddr.com/openapi.json

対応していないこと

正式な配達可能性の検証（Royal Mail PAF ライセンスなし）には対応していません。住所の解析・標準化のみを行います。 詳しくは住所の検証と解析の違いをご覧ください。