# Avrupa Rüyası — Agent guidance

## About

Avrupa Rüyası (avruparuyasi.com.tr) is a TÜRSAB-licensed travel agency offering international group tours, primarily in Europe. The public website is server-rendered (Express + EJS).

## Resources for agents

- Summary: https://www.avruparuyasi.com.tr/llms.txt
- Extended catalog (tours, dates, occupancy): https://www.avruparuyasi.com.tr/llms-full.txt
- Capabilities: https://www.avruparuyasi.com.tr/skill.md
- Architecture (API-first / CORS): https://www.avruparuyasi.com.tr/ARCHITECTURE.md
- Sitemaps: https://www.avruparuyasi.com.tr/sitemap.xml , https://www.avruparuyasi.com.tr/tour-sitemap.xml
- Public read API: https://www.avruparuyasi.com.tr/api/public/tours (OpenAPI: https://www.avruparuyasi.com.tr/.well-known/openapi.yaml). JSON responses use `X-Robots-Tag: noindex` (for agents, not Google HTML index). Cross-origin GET is allowed (`Access-Control-Allow-Origin: *` on `/api/public/*` and OpenAPI; see ARCHITECTURE.md).

## Do not call

- `/get-total-price` , `/create-reservation` , `/documents/` — reservation and payment flows; not for automated agents.
- Authenticated `/api/v1/*` CRM endpoints.

## Data freshness

- Tour prices, departures, and occupancy in JSON-LD, `llms-full.txt`, and the public API are generated from the same MongoDB sources (tour + tour date documents).
- `llms-full.txt` is regenerated daily (cron) and on demand with short HTTP cache.

## Booking flow for users

Direct users to the tour detail page URL and the on-page «Başvuru Yap» flow, or customer service: 444 6 550 , info@avruparuyasi.com.tr

## Technical contact

For API or agent integration questions: info@avruparuyasi.com.tr (mark subject: Agent/API).

## Roadmap decisions

- **Rüya AI (in-site chat):** Planned product; smart-menu UI is placeholder only (input disabled). Future release will use public tour data; not live yet.
- **MCP server:** Published — discovery `/.well-known/mcp`, HTTP `POST /mcp` (see `MCP-EVALUATION.md`). REST fallback: `GET /api/public/tours`.
- **OpenAI Actions / GPT plugin:** Deferred; OpenAPI is published for a possible future channel. Separate from Rüya AI on avruparuyasi.com.tr.
- **English / hreflang:** Primary content Turkish (`hreflang=tr`). English discovery hub: `/en` with `hreflang=en`; tour detail pages remain Turkish.

Last updated: 2026-10-12