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ử).
- Claude (claude.ai hoặc app): Settings → Connectors → Add custom connector → dán địa chỉ trên.
- ChatGPT: Settings → Connectors → Advanced, bật Developer mode → Create connector → dán địa chỉ trên (tuỳ gói ChatGPT).
- Claude Code:
claude mcp add --transport http dorabot-dia-chi https://dorabot.io/dia-chi/mcp \ --header "Authorization: Bearer dk_KHOA_CUA_BAN"
- 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_cu | Xã/phường cũ nay là xã/phường nào, kèm khoản nghị quyết | Không |
doi_dia_chi | Đổi 1–200 địa chỉ đầy đủ sang địa chỉ mới, có nhãn tin cậy | Không khoá 20/ngày, có khoá theo gói |
danh_sach_xa_moi | Xã/phường mới của một tỉnh gồm những xã cũ nào | Không |
danh_sach_tinh | 34 tỉnh mới gồm tỉnh cũ nào | Khô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
- Mở bảng tính → Tiện ích mở rộng → Apps Script.
- Dán toàn bộ mã này → Lưu → tải lại bảng tính.
- Menu Dorabot địa chỉ → Đặt khoá API (khoá ở mục trên).
- 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ói | Giá | Hạn mức đổi | Dùng được |
|---|---|---|---|
| Không khoá (thử) | 0đ | 20 địa chỉ/ngày/IP | API, MCP |
| Miễn phí (đăng nhập Google) | 0đ | 100 địa chỉ/ngày | Web, file Excel, API, MCP, 5 khoá |
| Cơ bản | 39.000đ / 15 ngày | 500 địa chỉ/ngày | Như trên + lưu lịch sử, mẫu |
| Pro | 99.000đ / 30 ngày | 1.000 địa chỉ/ngày | Như trên + hỗ trợ ưu tiên |
| Doanh nghiệp | Báo giá theo số dòng | Từ 10.000 địa chỉ/ngày, xử lý trọn file | Hạ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/.