企業の顧客マスタや取引先台帳には、必ずといっていいほど「住所」のフィールドがあります。しかし実際には、市区町村合併による地名変更、郵便番号の統廃合、手入力の表記ゆれなどが蓄積し、住所データは時間とともに劣化していくのが現実です。

これまでの住所データ管理

多くの企業では、以下のような方法で住所データを管理してきました。

• Googleマップで都度検索 — 正確だが、数百件の顧客リストを一つずつ調べるのは非現実的
• KEN_ALL.CSVを手動ダウンロード — 日本郵便がCSV形式で公開している郵便番号データ。月次更新だが、ダウンロードとインポートは手作業
• zipcloudなどの非公式API — 便利だが、運営の継続性やデータ更新頻度に不安が残る

これからの住所データ管理

2025年5月、日本郵便が公式に「郵便番号・デジタルアドレスAPI」を無料公開しました。これにより、常に最新の住所データをAPI経由で自動取得できる環境が整いました。さらに2026年3月のver2.0では、法人名・電話番号・法人番号まで取得可能な「ビジネスデジタルアドレス」機能が追加されています。

郵便番号・デジタルアドレスAPIは、日本郵便株式会社が提供する住所検索のためのWeb APIです。利用料金は無料で、OAuth 2.0（＝安全にログイン情報を受け渡す認証の仕組み）による認証を使います。利用開始には「ゆうID」の登録が必要です。

機能1 — 郵便番号から住所を検索

もっとも基本的な機能です。7桁の郵便番号を送ると、対応する住所が漢字・カナ・ローマ字の3形式で返ってきます。既存の顧客データベースに郵便番号が入っていれば、正式な住所表記をすぐに取得・照合できます。

機能2 — デジタルアドレスから完全住所を検索

「デジタルアドレス」とは、日本郵便が建物・部屋番号レベルまで一意に割り当てた識別コードです。郵便番号では「丁目」までしか特定できませんが、デジタルアドレスを使えばマンション名・部屋番号まで含む完全な住所を取得できます。

機能3 — ビジネスデジタルアドレスから法人情報を検索（ver2.0新機能）

2026年3月のver2.0で追加された機能です。法人向けの「ビジネスデジタルアドレス」を指定すると、住所に加えて法人名・電話番号・法人番号・企業ホームページのURLまで取得できます。取引先の基本情報を一つのAPIで揃えられるため、法人顧客マスタの整備に特に有効です。

住所データの取得・管理方法は複数ありますが、それぞれにメリットとデメリットがあります。以下の比較表で整理します。

日本郵便公式APIの最大の強みは、「公式」「無料」「メンテ不要」「法人情報付き」の4点が同時に揃うところです。KEN_ALL.CSVは毎月ダウンロードしてインポートする手間がかかり、非公式APIは運営元の継続性に不安がありました。公式APIの登場で、これらの課題がまとめて解消されます。

最初に取り組みやすいのは、すでにkintoneやSalesforceに蓄積されている顧客マスタの住所クリーニングです。

よくある「住所データの劣化」パターン

• 市区町村合併による旧地名の残存 — 合併後も旧市町村名のままのデータが放置されている
• 手入力による表記ゆれ — 「1丁目2-3」「一丁目2番地3号」「1-2-3」が混在
• 郵便番号と住所の不一致 — 郵便番号の統廃合で、当時は正しかった組み合わせがずれている
• 旧字体・略称の混在 — 「ケ」「ヶ」「が」の違いなど

一括クリーニングの進め方

Claude Codeのようなコーディング支援AIを使えば、クリーニング処理の設計から実行まで効率的に進められます。具体的には次のような流れになります。

1. kintone（またはSalesforce）から顧客レコードの郵便番号フィールドを一覧取得
2. 各郵便番号を日本郵便APIに投げて、正式な住所を取得
3. 既存の住所フィールドとAPIのレスポンスを比較し、差分があるレコードをリストアップ
4. 差分レコードの内容を確認し、問題なければ正式住所で上書き更新

一括クリーニングは「いま溜まっている汚れ」を落とす作業ですが、放置すればまた汚れは溜まります。そこで、n8n（＝ノーコードで業務フローを自動化できるオープンソースツール）を使って、住所データの整合性チェックを定期的に自動実行する仕組みを組みます。

自動チェックフローの全体像

各ステップの役割

• ステップ1 スケジュールトリガーで毎週月曜の朝に自動起動。月次でもよいですが、データの鮮度を保つなら週次がおすすめです
• ステップ2 kintoneの顧客マスタアプリから、郵便番号と住所のフィールドを一括取得
• ステップ3 各レコードの郵便番号を日本郵便APIに投げて、正式住所を取得
• ステップ4 APIから返ってきた住所と既存データを比較。一致しないレコードだけを抽出
• ステップ5 差異のあるレコードをAPIの正式住所で更新
• ステップ6 「今週は3件の住所を最新化しました」のように、処理結果をSlackチャンネルに通知

既存データのクリーニングと定期チェックで「過去と現在」を整えたら、次は「未来」——新しく入ってくるデータを最初から正しい状態にする仕組みです。

フォーム入力時の住所自動補完

顧客登録フォームで郵便番号を入力した瞬間に、APIで正式住所を取得して自動入力する仕組みです。ユーザーは番地以降だけを手入力すれば済むので、入力ミスが大幅に減ります。多くのWebサイトで見かけるこの機能を、日本郵便の公式データで実現できるようになりました。

バックエンドでの住所検証

フォームの自動補完だけでは、ユーザーが手動で上書きしたり、別の経路（メール・電話・紙伝票）で入ってきた住所データは検証できません。そこで、顧客情報がデータベースに登録されるタイミングで、バックエンド側でもAPIによる住所検証を入れます。郵便番号と住所が一致しないレコードにはフラグを立てて、後日確認できるようにする運用が効果的です。

ビジネスデジタルアドレスで法人情報を自動取得

BtoB企業にとって特に価値が大きいのが、ver2.0のビジネスデジタルアドレス機能です。取引先のビジネスデジタルアドレスがわかれば、法人名・電話番号・法人番号・企業ホームページを一括で取得できます。これまで手動で国税庁の法人番号公表サイトやコーポレートサイトを調べていた作業が、API一発で完了します。

はてなベースでは、kintone・Salesforce・freeeなどのクラウドサービスの導入支援から、n8nやClaude Codeを活用した業務フローの自動化まで、企業のDX推進を幅広くサポートしています。その立場から、日本郵便のAPIがなぜ重要だと考えているのかを率直にお伝えします。

「都度Googleマップで調べに行く」作業の撲滅

住所の確認は、1回あたりの作業時間は短いものの、頻度が高い作業です。営業担当が訪問先の住所を確認する、経理が請求書の宛先を照合する、総務が社員の住所変更を処理する——こうした「ちょっとした確認」が積み重なると、年間で相当な時間になります。APIに置き換えることで、この「塵も積もれば」型の工数を削減できます。

AIエージェントの精度を支える「データの整備」

はてなベースが企業のAI活用を支援するなかで、繰り返しお伝えしているのが「AIの精度はデータの品質で決まる」という原則です。たとえば、AIエージェントに「A社への提案書を作って」と指示したとき、顧客マスタの住所が古ければ、提案書に誤った住所が載ります。帳票の自動生成、ダイレクトメールの送付先リスト、配送ルートの最適化——いずれもデータの正確性が前提です。

住所データの整備は地味な作業ですが、AIエージェント時代においては「AIが正しく仕事をするための土台」になります。

Claude CodeのSkillsやn8nフローへの組み込み

はてなベースでは、Claude Codeのカスタムスキルやn8nのワークフローに日本郵便APIを組み込むことで、住所関連の処理を「頼めばやってくれる」状態にすることを推奨しています。たとえば、Claude Codeに「このkintoneアプリの住所データをチェックして」と指示するだけで、API照合から差分レポートの作成まで一貫して実行できます。

無料で高機能なAPIですが、導入前に押さえておくべきポイントがいくつかあります。

ゆうIDの法人登録が必要

APIを利用するには、日本郵便の「ゆうID」を法人として登録する必要があります。個人のゆうIDでは一部機能に制限がかかる場合があるため、企業として本格利用する際は法人登録をおすすめします。

利用規約の確認

特に重要なのは、第三者へのAPI提供が禁止されている点です。自社の業務システムに組み込んで利用する分には問題ありませんが、APIを使ったサービスを外部に提供する場合は特約が必要になります。自社利用に限定しているか、事前に確認しましょう。

郵便番号のフォーマット

APIに郵便番号を送るときは、ハイフンを入れずに7桁の数字だけで送る必要があります。「100-0001」ではなく「1000001」です。kintoneやSalesforceの郵便番号フィールドにハイフン付きで保存されている場合は、API呼び出し前にハイフンを除去する処理が必要です。

レート制限への対応

大量のレコードを一括処理する場合は、適切な間隔を空けてAPIを呼び出す必要があります。1秒間に何十件もリクエストを投げると制限がかかる可能性があるため、1件ずつ適切な間隔（たとえば0.5秒〜1秒）を空けて処理するのが安全です。n8nのフローでも、ループ処理の間にウェイトを入れる設定が可能です。

OAuthトークンの有効期限管理

認証にはOAuth 2.0を使用しており、アクセストークンには有効期限があります。定期実行のフローを組む場合は、トークンの自動更新（リフレッシュ）の仕組みを入れておく必要があります。n8nやMakeには、OAuthトークンの自動更新機能が組み込まれているため、初回設定さえ済めば通常は意識する必要はありません。

住所データの整備やAI活用に関連する記事もあわせてご覧ください。

日本郵便の「郵便番号・デジタルアドレスAPI」は、住所データの管理方法を根本から変えるポテンシャルを持つサービスです。改めてポイントを整理します。

• 公式 × 無料 × 常に最新 — CSVダウンロードや非公式APIに頼る必要がなくなった
• 3つの検索機能 — 郵便番号検索、デジタルアドレス検索、ビジネスデジタルアドレス検索（法人情報付き）
• 既存データのクリーニング — kintone・Salesforceの顧客マスタを一括で正式住所に補正
• n8nによる定期チェック — 住所データの劣化を自動で検知・修正する仕組み
• 新規登録フローへの組み込み — 最初から正しいデータだけが入る仕組みをつくる
• AI活用の前提条件 — マスタデータの品質がAIエージェントの精度を左右する