# madeira.fun

> AI-powered tourism assistant for Madeira Island, Portugal

## About

madeira.fun helps visitors discover events, plan itineraries, book hiking permits, find restaurants, and explore activities on Madeira Island. The site supports 18 languages and provides personalized recommendations through an AI chat interface.

## Markdown Access

Append `.md` to any content URL to get a clean Markdown version optimized for AI agents:

- **Events**: `/e/{slug}-{shortId}.md` → e.g. `/e/summer-festival-abc12.md`
- **Activities**: `/a/{slug}-{shortId}.md` → e.g. `/a/pico-do-arieiro-hike-xyz89.md`
- **Restaurants**: `/eats/{slug}-{shortId}.md` → e.g. `/eats/seafood-restaurant-def45.md`

These return `text/markdown` with full structured content, no HTML to parse.

## Content Types

### Events (/e/*)
Live events, concerts, festivals, and activities in Madeira.
- URL pattern: `/e/{slug}-{shortId}`
- Structured data: Schema.org/Event with offers, pricing tiers, duration, categories
- Fields: date, time, duration, venue, city, pricing (free/paid/tiered), ticketing, categories, booking URL, contact

### Things to Do (/a/*)
Tourist attractions, hiking trails, viewpoints, beaches, and activities.
- URL pattern: `/a/{slug}-{shortId}`
- Structured data: Schema.org/TouristAttraction with geo, images, cost
- Fields: location, category, difficulty, duration, distance, elevation (min/max/gain/loss), start/end points, passage places, trail features (waterfall, coastal views, levada, family-friendly, mountain views)

### Restaurants (/eats/*)
Restaurants, cafes, and food establishments across Madeira.
- URL pattern: `/eats/{slug}-{shortId}`
- Structured data: Schema.org/Restaurant with menu, reservations, opening hours
- Fields: cuisine types, price range, rating, meals served, dietary options (vegetarian/vegan), opening hours, phone, website, reservations, special designations (Editor's Pick, Poncha Bar, Exceptional Views)
- Menu available at: `/eats/menu/{shortId}`

### SEO Guides (/s/*)
In-depth travel guides for Madeira topics.
- URL pattern: `/s/{slug}`
- Structured data: Schema.org/FAQPage or WebPage

### Event Groups (/group/*)
Recurring events and event series.
- URL pattern: `/group/{slug}-{shortId}`
- Structured data: Schema.org/CollectionPage

## Key Information

- **Location**: Madeira Island, Portugal (Atlantic Ocean)
- **Capital**: Funchal
- **Coordinates**: 32.6669° N, 16.9241° W
- **Languages**: Portuguese (official), English widely spoken
- **Currency**: Euro (EUR)
- **Timezone**: Atlantic/Madeira (WET/WEST)
- **Supported UI Languages**: en, pt, es, de, fr, it, ru, pl, nl, cs, da, sv, no, fi, lv, ro, hu, tr

## Data Freshness

- Events: Updated daily, include future events only
- Activities: Updated weekly
- Restaurants: Updated weekly, menus refreshed on change
- Hiking permits: Availability cached every 30 minutes from government API

## Structured Data

All content pages include JSON-LD structured data:
- `Event` with `Offer`, `Place`, `BreadcrumbList`
- `TouristAttraction` with `GeoCoordinates`, `BreadcrumbList`
- `Restaurant` with `Menu`, `OpeningHoursSpecification`, `AggregateRating`, `BreadcrumbList`
- `CollectionPage`, `FAQPage`, `WebPage`

## Machine-Readable Endpoints

- **Sitemap**: /sitemap.xml
- **LLM Info**: /llms.txt (this file)
- **LLM Full**: /llms-full.txt (extended version)
- **Markdown**: Append `.md` to any /e/, /a/, or /eats/ URL

## Contact

Website: https://madeira.fun