Dorabot – Vietnam address after 2025 merger

io.dorabotPublished by dorabot.ioOfficial publisherv1.1.0Updated Nov 8, 2026

Convert old Vietnamese addresses to the 2025 format and check new ones, per official resolutions.

VerifiedStreamable HTTPWeb executableLocation & LifestyleData & Analytics

Overview

AI-generated overview

Looks up and converts Vietnamese administrative addresses to the post-2025 two-level format, and validates new-format addresses.

What you can do
  • Look up which new commune/ward an old commune now belongs to, with the resolution clause
  • Convert one or many full old-style addresses to the new two-level format, with a confidence label
  • Check whether an address is already in the valid new format and flag old-style ones
  • List the new communes/wards of a province and the 34 provinces in effect from 1 July 2025
When to use it
Useful when a user asks what an old Vietnamese commune, district or province is called now, or when customer or form addresses must be migrated or validated against the 2025 administrative reorganisation.
Requirements
Remote streamable HTTP endpoint; no local runtime needed. Works without a key at a lower daily quota; an optional Authorization bearer API key raises the quota. Network access to the provider's endpoint.
Before you install
The optional Authorization header carries an API key; keep it private. Bulk conversion sends addresses to the provider's API, so avoid sending unnecessary personal data. Results flagged for checking should be verified, and the provider asks that its source be credited.

Installation

In SourceWeft

  1. Open Dorabot – Vietnam address after 2025 merger in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.dorabot%2Fdia-chi/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "dorabot-vietnam-address-after-2025-merge": {
      "type": "http",
      "url": "https://dorabot.io/dia-chi/mcp"
    }
  }
}

README

@dorabot-io/dia-chi

Địa chỉ hành chính Việt Nam sau sáp nhập 2025 cho JavaScript / TypeScript: 34 tỉnh, 3.321 xã/phường/đặc khu mới, bảng đổi 11.559 xã cũ sang mới theo đúng nghị quyết của Ủy ban Thường vụ Quốc hội (kèm số khoản), và form chọn địa chỉ 2 cấp cho React.

Từ 01/7/2025 địa chỉ ở Việt Nam chỉ còn 2 cấp: xã/phường/đặc khu → tỉnh/thành phố. Không còn quận/huyện. Form 3 cấp (tỉnh → huyện → xã) là kiểu cũ.

bash
npm i @dorabot-io/dia-chi

Chạy offline, không cần khoá, không gọi mạng (trừ doiDiaChi). Node ≥ 18, trình duyệt, Vite, Next.js, Bun, Deno, Cloudflare Workers.

Dùng nhanh

js
import { tinh, xa, timXaCu, kiemDiaChi, doiDiaChi } from '@dorabot-io/dia-chi';
tinh();                 // 34 tỉnh/thành: { slug, tenDayDu, gomTinhCu, nghiQuyet, soXa }xa('ha-noi');           // xã/phường mới của Hà Nội (nhận cả "Hà Nội", "Thái Bình" → Hưng Yên)
await timXaCu('Bách Khoa', { huyen: 'Hai Bà Trưng', tinh: 'Hà Nội' });// [{ xaCu: 'Phường Bách Khoa', huyenCu: 'Quận Hai Bà Trưng', den: [{ tenDayDu: 'Phường Bạch Mai', phan: 'toan_bo', khoan: 8 }],//    nghiQuyet: { so: '1656/NQ-UBTVQH15', hieu_luc: '2025-07-01', url: '…' } }]
await kiemDiaChi('12 Tạ Quang Bửu, phường Bách Khoa, quận Hai Bà Trưng, Hà Nội');// { trangThai: 'dia_chi_cu', lyDo: 'Còn cấp quận/huyện …' }   ← dùng ở bước kiểm form / nhập dữ liệuawait kiemDiaChi('12 Tạ Quang Bửu, Phường Bạch Mai, Thành phố Hà Nội');// { trangThai: 'hop_le', diaChiChuan: '12 Tạ Quang Bửu, Phường Bạch Mai, Thành phố Hà Nội' }
// Đổi địa chỉ đầy đủ, chuỗi lộn xộn/viết tắt (gọi API dorabot.io):await doiDiaChi('12 Tạ Quang Bửu, P. Bách Khoa, Q. Hai Bà Trưng, HN');// { thanh_cong: true, dia_chi_moi: '12 Tạ Quang Bửu, Phường Bạch Mai, Thành phố Hà Nội', tin_cay: { muc: 'cao' } }await doiDiaChi([...5000DiaChiKhachHang], { apiKey: process.env.DORABOT_API_KEY }); // tối đa 200/lần

doiDiaChi không khoá: 20 địa chỉ/ngày/IP. Khoá miễn phí dk_… (100/ngày, đăng nhập Google): https://dorabot.io/dia-chi/nha-phat-trien/ — gói doanh nghiệp đổi hàng loạt: https://dorabot.io/dia-chi/doanh-nghiep/

Form chọn địa chỉ 2 cấp (React)

jsx
import { ChonDiaChi } from '@dorabot-io/dia-chi/react';
<ChonDiaChi  choDoiDiaChiCu            // thêm ô "dán địa chỉ cũ để đổi"  onChange={(v) => setForm({ ...form, tinh: v.tinh, xa: v.xa, diaChi: v.diaChi })}  selectClassName="border rounded px-2 py-1"/>

Không phụ thuộc thư viện UI (2 thẻ <select>). Lưu slug tỉnh + slug xã vào DB, hiển thị tenDayDu.

Lưu trong cơ sở dữ liệu

sql
-- địa chỉ mới: 2 cấpdia_chi_chi_tiet text,      -- số nhà, đường, thôn/xómxa_slug   text,             -- 'phuong-bach-mai'tinh_slug text              -- 'ha-noi'-- giữ cột địa chỉ cũ (nếu có) để đối chiếu, đừng xoá ngay

Còn có

  • MCP cho Claude / ChatGPT / Cursor: https://dorabot.io/dia-chi/mcp (công cụ tra_cuu_xa_cu, doi_dia_chi, kiem_dia_chi, danh_sach_xa_moi, danh_sach_tinh).
  • REST: POST https://dorabot.io/dia-chi/api/v1/doi.php {"addresses": [...]} — OpenAPI ở trang nhà phát triển.
  • Python: pip install dorabot-dia-chi.
  • Dữ liệu mở CSV/JSON: https://github.com/Dorabot-io/sap-nhap-2025
  • Tra tay, đổi file Excel: https://dorabot.io/dia-chi/

Giấy phép

Code MIT. Dữ liệu CC BY 4.0 — ghi nguồn "Dorabot (dorabot.io)" ở đâu đó trong app hoặc tài liệu (component React đã có dòng nhỏ, tắt bằng ghiNguon={false} nếu bạn ghi nguồn chỗ khác).

Dữ liệu chép từ nghị quyết UBTVQH 2025 về sắp xếp đơn vị hành chính cấp xã của từng tỉnh và Nghị quyết 202/2025/QH15. Thấy sai: [email protected] hoặc mở issue.

Dorabot (dorabot.io) là công cụ của Việt Nam, không liên quan tới công ty robot Dorabot ở Thâm Quyến (dorabot.com).

English. Vietnam administrative divisions after the 1 July 2025 merger (34 provinces, 2 levels: commune/ward → province, no districts). Offline list of provinces and 3,321 new communes, old→new commune mapping for 11,559 old communes with the official resolution clause, a validator for new-format addresses, a React 2-level address picker, and doiDiaChi() which calls the dorabot.io API to convert full free-text old addresses. Code MIT, data CC BY 4.0.

Trong repo này

  • js/ — gói npm @dorabot-io/dia-chi (+ /react)
  • python/ — PyPI dorabot-dia-chi
  • vi-du/ — ví dụ React/Vite, Node đổi file CSV, Python Excel, PHP/Laravel, Flutter
  • Dữ liệu CSV/JSON đầy đủ: https://github.com/Dorabot-io/sap-nhap-2025

Source: README.md at commit 54b561f

Tools

5

tra_cuu_xa_cu

Tra xã/phường cũ nay là gì

Tra một xã, phường, thị trấn CŨ (trước 01/7/2025) nay thuộc xã/phường MỚI nào sau sắp xếp đơn vị hành chính 2025 ở Việt Nam, theo đúng nghị quyết của Ủy ban Thường vụ Quốc hội (kèm số khoản, cho biết đơn vị bị chia). Miễn phí, không cần khoá. Hiện có các tỉnh: Hà Nội, Hồ Chí Minh, Hải Phòng, Đà Nẵng, Hưng Yên, Bắc Ninh, Ninh Bình, Thanh Hóa, An Giang, Cà Mau, Cao Bằng, Lai Châu, Lạng Sơn, Huế, Quảng Trị, Quảng Ngãi, Khánh Hòa, Gia Lai, Lâm Đồng, Đắk Lắk, Đồng Nai, Tây Ninh, Đồng Tháp, Điện Biên, Sơn La, Quảng Ninh, Nghệ An, Hà Tĩnh, Tuyên Quang, Lào Cai, Thái Nguyên, Phú Thọ, Cần Thơ, Vĩnh Long. Tỉnh khác: dùng doi_dia_chi.

Parametersxarequiredtinhhuyen

doi_dia_chi

Đổi địa chỉ cũ sang địa chỉ mới (hàng loạt)

Đổi một hoặc nhiều địa chỉ đầy đủ kiểu CŨ (số nhà/đường, phường/xã, quận/huyện, tỉnh) sang địa chỉ MỚI sau sáp nhập 2025 (bỏ cấp huyện, tỉnh và xã mới) cho cả 63 tỉnh cũ. Mỗi dòng có nhãn tin_cay: "cao" hoặc "kiem_tra" (xã cũ bị chia/trùng tên). Không khoá: 20 địa chỉ/ngày. Có khoá API (miễn phí 100/ngày, gói trả phí cao hơn): tối đa 200 địa chỉ/lần. Lấy khoá: https://dorabot.io/dia-chi/nha-phat-trien/

Parametersdia_chiaddresses

kiem_dia_chi

Kiểm địa chỉ đã đúng kiểu mới chưa

Kiểm một hoặc nhiều địa chỉ ở Việt Nam đã đúng kiểu MỚI sau 01/7/2025 chưa (2 cấp: xã/phường/đặc khu + tỉnh/thành, không còn quận/huyện; xã có thật trong tỉnh). Dùng ở bước kiểm form địa chỉ, nhập dữ liệu khách hàng. Trả về trang_thai: "hop_le", "dia_chi_cu" (còn quận/huyện, tỉnh cũ hoặc xã cũ: gọi doi_dia_chi), "khong_thay_xa", "khong_thay_tinh". Miễn phí, không cần khoá, tối đa 200 địa chỉ/lần.

Parametersdia_chiaddresses

danh_sach_xa_moi

Danh sách xã/phường mới của một tỉnh

Liệt kê các xã, phường, đặc khu mới của một tỉnh/thành sau sáp nhập 2025, mỗi đơn vị gồm những xã cũ nào. Miễn phí.

Parameterstimtinhrequired

danh_sach_tinh

34 tỉnh, thành sau sáp nhập

34 tỉnh, thành phố từ 01/7/2025, mỗi tỉnh gồm những tỉnh cũ nào (Nghị quyết 202/2025/QH15), và tỉnh nào đã có dữ liệu xã chi tiết.

Takes no parameters.

Version history

1
  1. v1.1.0LatestNov 8, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Dorabot integrations

Dorabot – Vietnam public holidays & business days

io.dorabotOfficial publisher

Vietnam public holiday and business-day calculator for 2026–2040, letting an assistant check days off, count working days and add business days.

Streamable HTTPWeb executable
Productivity & Workflow4 toolsNov 8, 2026