API và MCP đổi địa chỉ sau sáp nhập 2025

Đưa việc đổi địa chỉ cũ (có quận/huyện, 63 tỉnh) sang địa chỉ mới (34 tỉnh, xã/phường) vào phần mềm của bạn qua REST API, hoặc vào trợ lý AI (Claude, ChatGPT, Cursor, Claude Code) qua máy chủ MCP.

Mỗi dòng có nhãn tin cậy đối chiếu nghị quyết: xã cũ bị chia, trùng tên được đánh dấu để kiểm lại.

Khoá API của bạn

Đang tải…

Máy chủ MCP cho trợ lý AI

Địa chỉ: https://dorabot.io/dia-chi/mcp (Streamable HTTP, không cần đăng nhập để thử).

  1. Claude (claude.ai hoặc app): Settings → Connectors → Add custom connector → dán địa chỉ trên.
  2. ChatGPT: Settings → Connectors → Advanced, bật Developer mode → Create connector → dán địa chỉ trên (tuỳ gói ChatGPT).
  3. Claude Code:
    claude mcp add --transport http dorabot-dia-chi https://dorabot.io/dia-chi/mcp \
      --header "Authorization: Bearer dk_KHOA_CUA_BAN"
  4. Cursor / VS Code (mcp.json):
    {
      "mcpServers": {
        "dorabot-dia-chi": {
          "url": "https://dorabot.io/dia-chi/mcp",
          "headers": { "Authorization": "Bearer dk_KHOA_CUA_BAN" }
        }
      }
    }
Công cụLàm gìCần khoá?
tra_cuu_xa_cuXã/phường cũ nay là xã/phường nào, kèm khoản nghị quyếtKhông
doi_dia_chiĐổi 1–200 địa chỉ đầy đủ sang địa chỉ mới, có nhãn tin cậyKhông khoá 20/ngày, có khoá theo gói
danh_sach_xa_moiXã/phường mới của một tỉnh gồm những xã cũ nàoKhông
danh_sach_tinh34 tỉnh mới gồm tỉnh cũ nàoKhông

Thử hỏi trợ lý: "Phường Khâm Thiên, Đống Đa cũ nay là phường gì?" hoặc dán danh sách địa chỉ khách hàng và nhờ đổi sang địa chỉ mới.

REST API

Đổi địa chỉ — POST https://dorabot.io/dia-chi/api/v1/doi.php, tối đa 200 địa chỉ/lần.

curl -X POST https://dorabot.io/dia-chi/api/v1/doi.php \
  -H "Authorization: Bearer dk_KHOA_CUA_BAN" \
  -H "Content-Type: application/json" \
  -d '{"addresses": ["Số 12 ngõ 5, phường Khâm Thiên, quận Đống Đa, Hà Nội",
                    "45 Trần Phú, phường Hàng Bột, quận Đống Đa, Hà Nội"]}'

Trả về (rút gọn):

{"thanh_cong": true,
 "ket_qua": [
  {"dia_chi_cu": "Số 12 ngõ 5, phường Khâm Thiên, quận Đống Đa, Hà Nội", "thanh_cong": true,
   "dia_chi_moi": "Số 12 Ngõ 5, Phường Văn Miếu - Quốc Tử Giám, Thành phố Hà Nội",
   "tin_cay": {"muc": "cao", "ly_do": "nhap_nguyen"}},
  {"dia_chi_cu": "45 Trần Phú, phường Hàng Bột, quận Đống Đa, Hà Nội", "thanh_cong": true,
   "dia_chi_moi": "45 Trần Phú, Phường Văn Miếu - Quốc Tử Giám, Thành phố Hà Nội",
   "tin_cay": {"muc": "kiem_tra", "ly_do": "bi_chia",
               "lua_chon": ["Phường Văn Miếu - Quốc Tử Giám", "Phường Ô Chợ Dừa"]}}],
 "thong_ke": {"tong": 2, "thanh_cong": 2, "that_bai": 0, "can_kiem_tra": 1},
 "han_muc": {"goi": "Free", "ngay": 100, "con_lai": 98}}

Mã lỗi: 401 khoá sai/đã thu hồi, 413 quá số dòng, 429 hết hạn mức ngày (header X-Quota-Remaining). Dòng lỗi có loi: sai_dinh_dang, khong_tim_thay, chua_co_mapping.

Tra xã cũ (miễn phí, không khoá) — GET https://dorabot.io/dia-chi/sap-nhap/api/v1/tra-cuu?xa=Khâm Thiên&huyen=Đống Đa&tinh=Hà Nội. Mô tả OpenAPI: openapi.json. Tải cả bảng: dữ liệu mở CSV/JSON.

Hàm =DIACHIMOI() cho Google Sheets

  1. Mở bảng tính → Tiện ích mở rộng → Apps Script.
  2. Dán toàn bộ mã này → Lưu → tải lại bảng tính.
  3. Menu Dorabot địa chỉ → Đặt khoá API (khoá ở mục trên).
  4. Gõ =DIACHIMOI(A2:A200) để đổi cả cột, hoặc =DIACHIMOI(A2:A200; TRUE) để có thêm cột mức tin cậy và ghi chú.

Mỗi công thức tối đa 200 dòng, kết quả nhớ 6 giờ nên sửa bảng tính không tốn thêm lượt. Excel: dùng tab Chuyển đổi hàng loạt trên web (dán cột, tải CSV).

Hạn mức và giá

GóiGiáHạn mức đổiDùng được
Không khoá (thử)0đ20 địa chỉ/ngày/IPAPI, MCP
Miễn phí (đăng nhập Google)0đ100 địa chỉ/ngàyWeb, file Excel, API, MCP, 5 khoá
Cơ bản39.000đ / 15 ngày500 địa chỉ/ngàyNhư trên + lưu lịch sử, mẫu
Pro99.000đ / 30 ngày1.000 địa chỉ/ngàyNhư trên + hỗ trợ ưu tiên
Doanh nghiệpBáo giá theo số dòngTừ 10.000 địa chỉ/ngày, xử lý trọn fileHạn mức riêng, gửi file nhận kết quả, hỗ trợ đối chiếu dòng khó

Hạn mức tính chung cho web, file Excel, API và MCP, làm mới 00:00 mỗi ngày. Mua theo năm được tặng thêm 180 ngày. Thanh toán chuyển khoản, có email xác nhận.

Câu hỏi thường gặp

Có cần khoá API không?

Không bắt buộc: không có khoá vẫn gọi được 20 địa chỉ/ngày cho mỗi IP. Đăng nhập Google để tạo khoá miễn phí (100 địa chỉ/ngày), mua gói Cơ bản/Pro để có 500–1.000 địa chỉ/ngày.

Thêm vào Claude, ChatGPT thế nào?

Thêm "custom connector" (máy chủ MCP từ xa) với địa chỉ https://dorabot.io/dia-chi/mcp. Muốn hạn mức theo gói của bạn thì thêm header Authorization: Bearer <khoá>.

Kết quả đúng tới đâu?

Mỗi dòng có nhãn tin_cay. "cao" là xã cũ nhập nguyên vào một xã mới. "kiem_tra" là xã cũ bị chia cho nhiều xã mới hoặc trùng tên, cần xem số nhà thuộc phần nào (có link nghị quyết).

Dữ liệu có dùng lại được không?

Bảng xã cũ → xã mới đã đối chiếu nghị quyết được công khai theo giấy phép CC BY 4.0 (CSV, JSON) ở /dia-chi/sap-nhap/du-lieu/.