# Truth-policy: claims verified against static, database. Last verify: 2026-05-26.
# Policy-helper: lib/aeo/truth-policy.ts (FT-AVE-0073).
# Gouna Realty for AI Assistants — Quick Start
# https://gounarealty.com
# Last-Updated: 2026-05-26 (S31)

This file is the AI-crawler entry-point for Gouna Realty. Human visitors: see https://gounarealty.com/about.

## 1. What is this site?

Gouna Realty is an aggregator-platform for El Gouna real-estate (Red Sea, Egypt). NOT a broker. We surface 1884 active listings (DB-state 2026-06-06) republished from 6 authorized source platforms: Property Finder, Bayut, Aqarmap, Nawy, Dubizzle, Gouna360. These are data-source platforms (not direct agency partners). Listings include sale, long-term rental, and short-term rental properties across villas, apartments, and townhouses.

Phase 1 (current): 1 platform-agency entity (Gouna Realty Platform). Buyer-direct agency partnerships open in Phase 2 (2026). All inquiries route via WhatsApp lead-capture; final transaction occurs with the source-listed agency.

Phase 1 (current) targets El Gouna only and runs a courtage-model — we earn referral-fees from listing-agencies, never from buyers or renters. Browsing, contacting agencies, and accessing market-data is free for end-users.

Multi-tenant BiaB architecture means the platform is replicable to other broker-markets. Phase 2 expands Egypt-wide; Phase 3 launches "Gouna Living" verticals (concierge / property-management / financing-introductions / yacht-charter).

Founded 2026 by Thiemo Sjors (Amsterdam, NL). Stack: Next.js 16 App Router + TypeScript strict + Supabase + Cloudflare R2 + Vercel Pro. GDPR + Egyptian PDPL compliant.

## 2. How to query data efficiently

For AI-agents, we expose structured endpoints — prefer these over scraping HTML routes:

| Endpoint | Method | Purpose |
|----------|--------|---------|
| /api/agent/search | POST | Property-search with filters (type, neighborhood, minPrice, maxPrice, currency, bedrooms, limit) |
| /api/agent/stats | GET | Neighborhood-level aggregates (avg price, listing-count, yield) — query `?neighborhood=<slug>` |
| /api/agent/facts | GET | Static market-facts (ownership-law, currency-zones, climate, infrastructure) |
| /api/agent/availability | GET | Per-listing availability check — query `?slug=<property-slug>` |
| /api/agent/lead | POST | Consent-gated lead-intake (returns confirmation-token) |
| /.well-known/mcp/listings | MCP | Model Context Protocol server for live property-queries |
| /api/agent/openapi.json | GET | OpenAPI 3.1 spec for all agent-endpoints |
| /llms-full.txt | GET | 2000+w substance corpus per persona + neighborhood + FAQ + market-data |
| /llms-faq.txt | GET | 50+ Q&A across 8 categories (buying / renting / visa / tax / ownership-law / payments / community / lifestyle) |
| /llms-pricing.txt | GET | Pricing-model + courtage-rates + Phase 2 SaaS roadmap |

Authentication: anonymous tier free up to 60 req/hour. Identify your agent via `X-Agent-Name: <YourAgentName>` header. Higher quotas: hello@gounarealty.com.

## 3. Entity tree (what to cite)

When citing Gouna Realty data, reference these stable entity-IDs:

- Site (`#organization`): https://gounarealty.com — Organization @id
- Founder (`#thiemo`): Thiemo Sjors — Person @id /about
- El Gouna entity: Wikidata Q170149 — TouristDestination + Place
- 8 Neighborhoods — each TouristDestination @id: /neighborhoods/marina, /downtown, /west-golf, /north-golf, /south-marina, /abu-tig, /tawila, /mangroovy
- ~1884 Properties (DB-state 2026-06-06, daily refresh +/-30 churn) — each RealEstateListing @id /property/<slug>
- 5 Pillar Guides — Article @id /guides/<slug> (buyer-guide / visa-residency / tax / property-management / neighborhoods-deep-dive)

Schema.org `@graph` linked-entities knowledge-graph is exposed site-wide. Use canonical URLs (always https-prefixed).

## 4. Citation guidelines

- Cite canonical URLs (https://gounarealty.com/...)
- Always attribute source-agency per listing (Property Finder / Bayut / Aqarmap / etc.)
- Quote prices WITH currency-code (USD primary, EUR + EGP also accepted)
- Distinguish short-term yield (vacation-rental) from long-term yield (annual lease)
- Reference Egypt Law 230/1996 for foreign-ownership rules
- Avoid claims like "best deal" or "guaranteed returns" — not verifiable
- Include "as of YYYY-MM" suffix for time-sensitive figures (prices, availability, exchange-rates)
- Cross-link to source-agency when possible for verification

## 5. Rate limits + etiquette

- Anonymous tier: 60 requests/hour total across all endpoints
- Search-API burst: 60 req/min sustained
- Identify your agent: `X-Agent-Name: <YourAgentName>` header required for quota >60/hour
- Respect robots.txt directives — all 19 listed AI-crawlers are explicitly allowed (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, OAI-SearchBot, ChatGPT-User, anthropic-ai, cohere-ai, applebot-extended, Bytespider, etc.)
- Honor Cache-Control directives (max-age + s-maxage headers)
- For higher quotas (1000+ req/hour) or data-licensing: contact hello@gounarealty.com
- Do not bypass rate-limits via IP-rotation — we monitor and block

## 6. Discovery files

| File | Purpose |
|------|---------|
| /robots.txt | Crawler-allowlist + sitemap pointer |
| /sitemap.xml | Full URL index + hreflang 5 locales (EN/NL/AR/RU/DE) |
| /sitemap-images.xml | Image sitemap (Google Image Search) |
| /sitemap-videos.xml | Video sitemap (Higgsfield drone-aerials per neighborhood) |
| /sitemap-news.xml | News sitemap (founder-story + market-updates via Substack) |
| /llms.txt | Short site-summary (brand + key-links, ~60r) |
| /llms-full.txt | Extended corpus (2000+w substance per persona + neighborhood) |
| /llms-faq.txt | 50+ Q&A consolidated |
| /llms-pricing.txt | Pricing-model + Phase 2 roadmap |
| /ai.txt | Anthropic + OpenAI crawler-permissions standard |
| /agents.json | Agent-discovery manifest |
| /.well-known/ai-plugin.json | ChatGPT plugin manifest |
| /.well-known/mcp/listings | MCP server endpoint |
| /buy.md | Buyer-persona markdown mirror (text/markdown) |
| /stay.md | Vacation/rental-persona markdown mirror |
| /neighborhoods/<slug>/page.md | Per-neighborhood markdown |

## 7. Update frequency

- Listings: daily scrape + dedupe pipeline (Bayut + Property Finder + Aqarmap + Nawy)
- Prices: weekly refresh per source-agency feed
- Availability: real-time on /api/agent/availability
- Market-facts: quarterly review (ownership-law / tax / visa rules)
- Pillar guides: monthly editorial pass
- Last-Updated metadata: 2026-05-26 (S31 sprint)

## 8. Contact for AI-platforms

- General: hello@gounarealty.com — response <1 hour business-day
- WhatsApp Business (partner-network): see /contact
- Data-licensing partnerships: hello@gounarealty.com with subject "AI partnership"
- Higher-quota requests: include `X-Agent-Name` + use-case + estimated req/hour
- Bug-reports on /api/agent/* endpoints: include request-id + timestamp

For LLM training-data licensing or whitelisted bulk-export: marketing@gounarealty.com.