登録不要 · 無料 · 無制限 · MIT

日本の郵便番号を、
CDN から配るデータセット。

個人開発者と OSS のための日本郵便番号データセット。Cloudflare Pages から配信される 120,677 件の正規化済みデータを、各言語の薄い SDK 経由でオフラインまで持っていける。

$ npm i jpzip
120,677
Zipcodes
948
3桁 Prefix
10 files
1-digit groups
¥0
Forever
Playground

7 桁、入れてみる。
本物の CDN が、返事を返す。

下のフォームはブラウザから直接 jpzip.nadai.dev を叩いています。CORS が通れば本物のデータ、通らなければデモ用フォールバックが返ります。

QUERY
EXAMPLES
endpoint: https://jpzip.nadai.dev/p/{prefix}.json
cache: L1 memory · 24h CDN
待機中GET /p/—.json
左に郵便番号を入れて
「引く」を押してみよう
SDK

3 行で読める SDK。
同じシグネチャ、どの言語でも。

プロトコル仕様を固定してあるから、SDK の中身は数十行。各言語で同じシグネチャを揃えています。

~30 LoC
import { lookup, preload } from "jpzip"

// 単発検索 — /p/231.json を fetch して結果を抽出
const entry = await lookup("2310017")
// → { prefecture: "神奈川県", city: "横浜市中区",
//     towns: [{ town: "本町", kana: "ホンチョウ" }], ... }

// オフライン化 — 全件を SDK 内にキャッシュ
await preload({ scope: "all" })

// 以降の lookup() はネットワーク不要
const e2 = await lookup("1500001")
{ "prefecture": "神奈川県", "city": "横浜市中区", "towns": [{ "town": "本町" }] }
Why jpzip

構造的に、無料。
壊れにくい設計。

Worker・R2・KV を一切使わない設計。アクセスが何億あっても課金軸が存在しません。

¥

永続的に無料

Cloudflare Pages の無料枠のみで成立。約 1,000 ファイル × 25 MiB 未満、課金軸そのものが存在しない構造。

オフライン対応

preload({ scope: "all" }) で全件を SDK にキャッシュ。以降はネットワーク不要で動作。

A

登録・認証なし

API キー不要。CORS は全オリジン許可。ブラウザから直接 fetch して使えます。

月次自動更新

毎月 1 日と 15 日に GitHub Actions が日本郵便の最新データを取り込み、CDN へデプロイ。

漢字・カナ・ローマ字

KEN_ALL と KEN_ALL_ROME を結合済み。city_code (総務省コード) も付与。

MIT & Public Domain

SDK は MIT。データは元データが Public Domain 相当のため、商用利用も再配布も自由。

3 行で、郵便番号が引ける。

登録不要、API キー不要、課金リスクなし。今すぐ npm でインストールして、ブラウザでもサーバでも動かしてみてください。