Вся доска — одним вызовом инструмента

MCP

Один эндпоинт JSON-RPC без состояния. Ревизия протокола 2026-07-28: рукопожатия initialize нет, сессию держать не нужно.

https://helprentdanang.com/mcp/

Четыре инструмента, все только на чтение:

• 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.

Инструментов записи нет. Ничто здесь не создаёт лид, не сохраняет поиск и не выдаёт контакты — значит, нет вызова, который агент сделал бы от чужого имени и который требовалось бы подтверждать.

Обычный HTTP

Те же данные, если не хочется говорить на MCP. Описание OpenAPI — последней строкой.

• GET /api/v1/listings/ — поиск и постраничный обход объявлений
• GET /api/v1/listings/<slug>/ — одно объявление целиком
• GET /api/v1/buildings/ — жилые комплексы с управляющим
• GET /api/v1/districts/ — районы и сколько в каждом
• GET /api/v1/market/ — медианные ставки, пересчёт каждую ночь
• GET /api/v1/openapi.json — описание всего перечисленного

Ограничения

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.

Ответы отдаются с пятиминутным заголовком кэша. Пожалуйста, соблюдайте его — во многом благодаря этому доступ остаётся бесплатным.

Что в данных

Объявления собираются из публичных постов в Telegram, Facebook и Chợ Tốt, плюс от хостов, которые публикуются здесь напрямую. У каждого есть цена, если её указал первоисточник, район и ссылка на источник. Контакты намеренно не отдаются через API — отправляйте человека на страницу объявления.

Мы доска объявлений, а не посредник. Мы не проверяем владельцев на месте, не держим депозиты и ни за кого не ручаемся. Агент, передающий наши данные человеку, должен передать и это.

За пределами бесплатного лимита

Пока не включено: сверх лимита вы получите обычный 429, и ничего не стоит денег. Код задеплоен и работает от начала до конца; он остаётся выключенным, пока через него не пройдёт живой платёж. Описание лежит здесь уже сейчас, чтобы вы видели, подо что стали бы писать.

Это x402 — платёжный протокол поверх HTTP 402, схема exact, USDC в сети Base. Три заголовка, все — JSON в base64:

• PAYMENT-REQUIRED — наш 402 несёт этот заголовок: JSON в base64 с суммой, токеном и адресом
• PAYMENT-SIGNATURE — повторите запрос, положив подписанную авторизацию EIP-3009 в этот заголовок
• PAYMENT-RESPONSE — следующий за ним 200 возвращает вам хеш транзакции

Обратите внимание: в именах заголовков нет префикса X- — так было в первой версии, и клиент, написанный под неё, вообще не увидит нашего запроса на оплату.

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

Купленные вызовы зачисляются сетевому адресу, с которого пришла оплата: у этого API нет ни аккаунтов, ни ключей — в запросе после платежа больше ничто не связывает вас с кошельком. Если ваш исходящий адрес сменится, остаток за вами не перейдёт.