Toàn bộ bảng tin, qua một lệnh gọi công cụ

MCP

Một endpoint JSON-RPC không trạng thái. Bản giao thức 2026-07-28, nên không có bước bắt tay initialize và không có phiên nào phải giữ.

https://helprentdanang.com/mcp/

Bốn công cụ, tất cả đều chỉ đọc:

• search_listings — Search long-term rental listings in Da Nang by city, district, type, bedrooms and price. Returns listing URLs; contact details are not included, send the person to the URL.
• get_listing — One listing in full, including its description.
• find_buildings — Apartment buildings with a manager, by district.
• market_stats — Median rents by size and district, how many listings arrive each month, and how fast they get noticed. Recomputed nightly.

Không có công cụ ghi. Ở đây không có gì tạo lead, lưu tìm kiếm hay đưa ra thông tin liên hệ, nên không có lệnh gọi nào mà agent thực hiện thay người khác cần được phê duyệt.

HTTP thuần

Cùng dữ liệu đó, nếu bạn không muốn dùng MCP. Mô tả OpenAPI ở dòng cuối.

• GET /api/v1/listings/ — tìm và phân trang qua các tin đăng
• GET /api/v1/listings/<slug>/ — một tin đăng đầy đủ
• GET /api/v1/buildings/ — các tòa căn hộ có người quản lý
• GET /api/v1/districts/ — các quận và số tin trong mỗi quận
• GET /api/v1/market/ — giá thuê trung vị, tính lại hằng đêm
• GET /api/v1/openapi.json — mô tả của tất cả những thứ trên

Giới hạn

600 calls a day per address, counted across MCP and REST together. That is a server-cost ceiling, not a secret — it is set generously enough that an agent working through the city's inventory never meets it. Over the line you get a 429 for MCP and a JSON error for REST; nothing is banned.

Phản hồi có header cache năm phút. Xin hãy tôn trọng nó — đó là phần lớn lý do dịch vụ này còn miễn phí.

Dữ liệu gồm những gì

Tin đăng được thu thập từ các bài công khai trên Telegram, Facebook và Chợ Tốt, cùng với chủ nhà đăng trực tiếp tại đây. Mỗi tin có giá nếu bài gốc nêu giá, có quận, và có liên kết về nguồn. Thông tin liên hệ cố ý không nằm trong API — hãy đưa người dùng tới URL của tin đăng.

Chúng tôi là bảng tin, không phải môi giới. Chúng tôi không xác minh chủ nhà tại chỗ, không giữ tiền cọc, không bảo lãnh cho ai. Agent chuyển dữ liệu của chúng tôi cho người dùng nên chuyển cả điều này.

Vượt mức miễn phí

Chưa bật — hôm nay vượt hạn mức bạn chỉ nhận 429, và không có gì mất phí. Mã đã triển khai và chạy trọn vẹn; nó vẫn tắt cho tới khi có một giao dịch thật đi qua. Tài liệu để ở đây ngay bây giờ để bạn thấy mình sẽ xây dựng dựa trên cái gì.

Đó là x402 — giao thức thanh toán HTTP 402, scheme "exact", USDC trên Base. Ba header, đều là JSON mã hóa base64:

• PAYMENT-REQUIRED — phản hồi 402 của chúng tôi mang header này: JSON mã hóa base64 ghi rõ số tiền, token và địa chỉ
• PAYMENT-SIGNATURE — gửi lại yêu cầu với ủy quyền EIP-3009 đã ký trong header này
• PAYMENT-RESPONSE — phản hồi 200 tiếp theo trả lại cho bạn mã giao dịch

Lưu ý tên header không có tiền tố X- — đó là phiên bản 1, và client viết theo nó sẽ hoàn toàn không thấy yêu cầu thanh toán của chúng tôi.

One payment buys 5000 calls, not one — settling on chain per request would put a blockchain write between you and every listing you read.

Số lượt đã mua được ghi có cho địa chỉ mạng đã trả tiền, vì API này không có tài khoản và không có khóa — ở yêu cầu ngay sau khi thanh toán, không còn gì khác gắn bạn với ví đó. Nếu địa chỉ ra ngoài của bạn thay đổi, phần còn lại sẽ không theo bạn.