تصور کنید یک توسعهدهنده PropTech بخواهد بدون درگیر شدن با فایلهای پیچیده و قدیمی SOAP/XML، در چند ثانیه به دادههای ساختاریافتهٔ املاک اسپانیا دسترسی داشته باشد. طبق مستندات فنی Predio، اکنون این دسترسی از طریق یک پل ارتباطی اختصاصی به سامانه رسمی Sede Electrónica del Catastro (DGC) امکانپذیر شده است که دادههای نسخهبندی شده در قالب JSON را برای هر دو نوع املاک شهری و روستایی ارائه میدهد.
دسترسی به دادههای عمومی ثبت ملکی در اسپانیا تا پیش از این یک گلوگاه واقعی برای عاملهای هوش مصنوعی (AI Agents) — که شبیه دستیارهای هوشمندی هستند که میتوانند ابزارها را پیدا کرده و کارهای پیچیده را پیش ببرند — بود. به گزارش Predio، منابع رسمی بر طرحهای سنگین SOAP/XML و کدهای خطای ناسازگار HTTP تکیه داشتند که باعث شکست مداوم خطوط پردازش خودکار میشد. این اصطکاک فنی باعث میشد عاملها توکنها و زمان پردازش خود را صرف تلاش برای نرمالسازی دادههای بدون ساختار کنند، به جای اینکه روی ارزیابی ملک تمرکز کنند.
همانطور که در تحلیلهای پیشین ما دربارهی استانداردسازی دادهها برای مدلهای زبانی اشاره کردیم، کیفیت ورودی مستقیماً بر دقت خروجی اثر میگذارد. Predio بر اساس دادههای ژانویه ۲۰۲۶، مدیریت ۷۸.۹ میلیون دارایی ملکی را در قلمرو مشترک بر عهده دارد که به تفکیک شامل تقریباً ۴۰.۲ میلیون ملک شهری و ۳۸.۷ میلیون ملک روستایی است. این سرویس با نرمالسازی هر دو نوع داده در یک فرمت خروجی یکسان، اصطکاک معماری موجود در پایگاههای دادههای دولتی را حذف کرده است.
این پلتفرم برای حل این مشکل، سه روش ورودی اصلی ارائه میدهد که همگی خروجیهای نرمالشدهای شامل کلاس ملک، کاربرد، متراژ ساخته شده، سال ساخت و تجزیه جزئیات آدرس را برمیگردانند. توسعهدهندگان برای احراز هویت از یک هدر x-api-key استفاده میکنند:
- مرجع ثبتی (Cadastral Reference): استفاده از کد ۲۰ رقمی RC برای بازیابی یک ملک خاص.
- مختصات: استفاده از طول و عرض جغرافیایی (در سیستمهای WGS84 یا ETRS89) برای یافتن ملکی که شامل آن نقطه است.
- آدرس: استفاده از استان، شهرستان، نوع خیابان، نام و شماره برای املاک شهری.
برای تضمین پایداری و قابلیت اطمینان، این سرویس از مکانیزم «ارائه دادههای قدیمی» (Serve-stale) استفاده میکند؛ یعنی اگر منبع رسمی دولتی آفلاین شود، Predio آخرین مقدار ذخیرهشده در حافظه موقت (Cache) را که به عنوان «کهنه» (stale) علامتگذاری شده ارائه میدهد تا از متوقف شدن ادغامهای نرمافزاری جلوگیری شود. همچنین خطاهای مربوط به کسبوکار (مانند ۴۰۴ Not Found یا ۴۲۲ Invalid Input) بهصورت JSON پیشبینیپذیر بازگردانده میشوند و هیچ اعتباری از کاربر کسر نمیکنند.
این پلتفرم برای عصر عاملمحور (Agentic) از طریق دو رابط اصلی طراحی شده است:
- پروتکل زمینهٔ مدل (Model Context Protocol یا MCP): یک سرور بومی که به مدلهای زبانی بزرگ (LLMs) مانند Claude یا GPT اجازه میدهد ابزارها را بهطور خودکار از طریق JSON Schema شناسایی و فراخوانی کنند.
- رابط REST API (/v1): یک نقطه اتصال پایدار، نسخهبندی شده و دارای هسته مشابه برای اپلیکیشنهای سنتی با خطاهای JSON پیشبینیپذیر.
علاوه بر دادههای پایه، ابزار ParcelGuard به عنوان یک ابزار تخصصی برای بررسیهای لازم (Due Diligence) زمین ارائه شده است. این ابزار ریسکهای سیل (SNCZI)، مناطق محیطزیستی Red Natura 2000، سواحل و مسیرهای گلههای دام (vías pecuarias) را در یک گزارش JSON واحد جمعآوری میکند که برای هر لایه، منابع و تاریخهای مربوطه ذکر شده است. این قابلیت به توسعهدهندگان اجازه میدهد تا پیشارزیابی یک زمین را بدون نیاز به باز کردن پنج نمایشگر (Viewer) مجزا انجام دهند.
به باور تیم فنی Predio، این تغییر بارِ پاکسازی دادهها را از دوش پرامپت برداشته و به API منتقل میکند. با ارائه فایل llms.txt برای مدلها، مشخصات OpenAPI و یک فایل pricing.json ماشینخوان، Predio با عامل هوش مصنوعی به عنوان یک «شهروند درجهیک» رفتار میکند. این رویکرد «مالیات توکن» (Token Tax) مرتبط با پاکسازی XML را کاهش میدهد تا عاملها بتوانند بر استدلالهای سطح بالا و قیمتگذاری املاک تمرکز کنند.
در مورد هزینهها، طبق مدل قیمتگذاری prediohq.com، این سرویس بر اساس سیستم اعتباری عمل میکند که در آن هر پاسخ موفق برابر با یک اعتبار (Credit) است. خطاهای کسبوکار هزینهای ندارند؛ اما در مقابل، پاسخهای حاصل از حافظه موقت (Cache hits) و پاسخهای Serve-stale کسر اعتبار میشوند، زیرا کاربران در واقع برای ارزش دادهها پرداخت میکنند.
ساختار اشتراکها به شرح زیر است:
- رایگان: ۰ یورو برای ۲۵۰ اعتبار در ماه (بدون نیاز به کارت اعتباری) برای محیط Sandbox و تشخیص خطا.
- Mini: ۵ یورو برای ۲,۵۰۰ اعتبار (تقریباً ۰.۰۰۲ یورو برای هر فراخوانی).
- Starter: ۹ یورو برای ۵,۰۰۰ اعتبار (تقریباً ۰.۰۰۱۸ یورو برای هر فراخوانی).
- Scale: ۹۹ یورو برای ۱۵۰,۰۰۰ اعتبار (تقریباً ۰.۰۰۰۶۶ یورو برای هر فراخوانی).
در صورت اتمام موجودی، درگاه اعتباری با خطای ۴۰۲ (Payment Required) پاسخ میدهد و پاسخ را در میانه مسیر قطع نمیکند. کاربران میتوانند شارژ خودکار را فعال کرده یا بستههای پیشپرداخت را از طریق Stripe خریداری کنند.
شما اکنون میتوانید با بررسی مشخصات OpenAPI یا اتصال یک کلاینت MCP سازگار، کوئریهای خود را روی خاک اسپانیا اجرا کنید. توجه داشته باشید که پوشش این سرویس شامل باسک (Basque Country) و ناوارا (Navarra) نمیشود، زیرا این مناطق ثبت ملکی مستقل (Foral land registries) خود را دارند.
گام بعدی شما
- اگر توسعهدهنده ابزارهای تحلیل ملک هستید، مستندات OpenAPI را برای ادغام سریع بررسی کنید.
- برای کاهش مصرف توکن در عاملهای خود، پروتکل MCP را جایگزین متدهای سنتی انتقال داده کنید.
- قابلیتهای ParcelGuard را برای پیشارزیابی ریسکهای محیطزیستی در پروژههای لند-تک تست کنید.
اما تأثیر این استانداردسازی بر ارزشگذاری خودکار املاک حتی پیچیدهتر است — به تحلیل ما دربارهی مدلهای استدلالی در تحلیل بازار مراجعه کنید.
گفتگو