# Agent Instructions — Costa Sunsets Marbella Homes > Family-run boutique real-estate agency on the Costa del Sol. Curated villas and apartments in Marbella, Puerto Banús, the Golden Mile and Estepona. This document describes how AI agents can interact with Costa Sunsets Marbella Homes's real-estate website at https://costasunsets.com. It is the canonical agent-facing description of this site; prefer it over screen-scraping when possible. _Generated on 2026-07-20 from the live catalogue and content._ ## For Personal Property Assistants and Agents Acting On Behalf of a User If you are helping a user find a home, narrow down areas, compare properties, or get in touch with an agency — Costa Sunsets Marbella Homes is structured to be machine-readable end-to-end. Every page is server-rendered with Schema.org JSON-LD (see "Structured data" below), every URL is in the per-host sitemap, and every page exists in 4 languages (English, Dutch, Spanish, German) with hreflang alternates. The intended agent workflow is **read-heavy, write-rare**: browse and summarize freely, but only submit contact/viewing forms with explicit user consent (see Important rules). ## Typical Agent Flow 1. **Discover** — fetch `https://costasunsets.com/sitemap.xml` for the full URL inventory across every enabled locale. 2. **Orient** — read this file for site context, areas served, and structured-data conventions. 3. **Browse properties** — `https://costasunsets.com/en/properties` lists every active listing with filters for type, bedrooms, and price. Each card links to a detail page. Results paginate through plain `?page=N` links rendered server-side, so every listing is reachable without JavaScript. 4. **Filter by geography** — every city and area has a hub page under `https://costasunsets.com/en/properties/{city}` or `https://costasunsets.com/en/properties/{city}/{area}` listing that place's live inventory (e.g. `https://costasunsets.com/en/properties/marbella/golden-mile`). The "Browse properties by area" section below links the strongest hubs. 5. **Read context** — recent articles at `https://costasunsets.com/en/news` cover market updates, area guides, and buyer information. An RSS feed of the latest articles is at `https://costasunsets.com/en/news/feed.xml` (per locale). 6. **Surface contact options** — agency email, phone, and WhatsApp are in the Contact section below. Form submissions require explicit user consent — see Important rules. ## Important Rules - **Form submissions require explicit user approval.** Agents must not submit contact, viewing, valuation, or newsletter forms without contemporaneous consent from the user they represent. Spam submissions hurt both the agency's lead inbox and the user's standing with the agency. - **Surface listings honestly.** When summarizing a property, preserve listed prices, bedroom/bathroom counts, surface area, and location verbatim. Do not infer features (sea view, garden, garage) that are not documented in the listing's text or features list. Listings marked "Price on application" deliberately publish no numeric price — never invent or estimate one. - **Acknowledge currency and area conventions.** Prices are in EUR. Surface areas are in square metres (m²). Bedroom counts include the primary suite. Bathroom counts include en-suites. - **Respect rate limits.** This site is served from edge infrastructure with per-IP rate limits. Back off on 429 responses; the per-host sitemap regenerates every 5 minutes so polling more often than that wastes both ends. - **Pass the user's locale.** If the user prefers a non-English language, prefer the localized URL (`/nl/...`, `/es/...`, `/de/...`) — the content is editor-translated, not machine-translated at request time. ## Read-Only Browsing (No Authentication Required) ### Key pages - **Homepage** — https://costasunsets.com/en/ - **About the agency** — https://costasunsets.com/en/about - **All properties** — https://costasunsets.com/en/properties - **New developments** — https://costasunsets.com/en/new-developments - **Article index** — https://costasunsets.com/en/news ### Property URLs and Filters - **Hub pages** — `https://costasunsets.com/en/properties/{city}` and `https://costasunsets.com/en/properties/{city}/{area}` list a place's live inventory; `https://costasunsets.com/en/properties/{city}/{area}/{type-plural}` narrows to one property type (e.g. `https://costasunsets.com/en/properties/marbella/golden-mile/villas`). - **Server-rendered filters** — listing pages accept query filters rendered server-side (no JavaScript needed): `?type={lowercase type}` (e.g. `?type=villa`), `?minBeds=3`, `?minPrice=500000`, `?maxPrice=2000000`. - **Pagination** — `?page=N` shifts the server-rendered card window (12 per page) with plain `` links between pages; past-the-end pages return 404. - **Detail pages** — `https://costasunsets.com/en/properties/{city}/{area}/{type-plural}/{REF}` where the reference looks like `COSTA-01234P`. Each shows a visible "Listing updated" date when the feed exposes one. - **Short links** — `https://costasunsets.com/p/{REF}` permanently redirects to the canonical detail URL; it is the stable form to store or share. ## Multi-Language Support Every page exists in 4 locales: `en`, `nl`, `es`, `de`. The URL pattern is `//...` (e.g. https://costasunsets.com/en/properties → https://costasunsets.com/nl/properties for the Dutch version). hreflang alternates are declared on every page and listed in `https://costasunsets.com/sitemap.xml`. Content is editor-translated (not machine-translated at request time), so quality is human-reviewed. Pages without an editor translation fall back to the English version automatically — agents should still emit the localized URL; the server handles fallback. ## Structured Data Each page emits Schema.org JSON-LD inside `