# Visit-Iraq - AI Crawler Documentation

## Site Overview
Visit-Iraq is a multilingual travel platform connecting travelers with Iraqi guides
and providing SEO-optimized content about Iraqi destinations, food, culture, and adventures.

**Domain:** https://visit-iraq.com

## Supported Languages
The site supports 4 languages with content available in multiple languages:
- English (en)
- Arabic (ar) - العربية
- French (fr) - Français
- German (de) - Deutsch

## URL Structure
All content uses language-prefixed URLs:
https://visit-iraq.com/{language}/{section}/{item}

**Important:** Not all content is available in all languages. URLs are only generated
for languages where translations exist.

### Examples
- https://visit-iraq.com/en/blog/traveling-baghdad
- https://visit-iraq.com/ar/places/babylon
- https://visit-iraq.com/fr/food/masgouf
- https://visit-iraq.com/de/adventures/ziggurat-of-ur

## Main Content Sections

### 1. Blog (/blog)
Travel tips, cultural insights, history articles, safety guides, and itineraries about Iraq.

**Categories:**
- travel_tips - Practical advice for travelers
- culture - Iraqi cultural insights and traditions
- history - Historical context and heritage
- safety - Safety tips and guidelines
- itinerary - Suggested travel routes
- news - Latest travel news

**Example:** https://visit-iraq.com/en/blog

### 2. Places (/places)
Iraqi destinations including ancient sites, natural wonders, cities, and religious locations.

**Categories:**
- ancient - Ancient archaeological sites
- natural - Natural wonders and landscapes
- city - Modern cities and urban destinations
- religious - Religious and spiritual sites

**Example:** https://visit-iraq.com/en/places/babylon

### 3. Food (/food)
Iraqi culinary guide featuring traditional dishes, street food, desserts, and beverages.

**Categories:**
- traditional_dishes - Classic Iraqi cuisine
- street_food - Popular street food
- desserts - Iraqi sweets and desserts
- beverages - Traditional drinks

**Example:** https://visit-iraq.com/en/food/masgouf

### 4. Adventures (/adventures)
Adventure activities and experiences available in Iraq.

**Categories:**
- historical_sites - Historical adventure locations
- natural_wonders - Natural exploration opportunities
- cultural_experiences - Immersive cultural activities
- archaeological_sites - Archaeological exploration
- religious_sites - Religious site visits

**Example:** https://visit-iraq.com/en/adventures/shiladze-waterfall

### 5. Guides (/guides)
Local Iraqi tour guide profiles with expertise, languages spoken, and regions served.

**Features:**
- Guide profiles with bio and qualifications
- Languages spoken
- Regions and specializations
- Tour offerings

**Example:** https://visit-iraq.com/en/guides

### 6. Tours (/tours)
Tour packages and experiences offered by local guides.

**Features:**
- Detailed itineraries
- Duration and pricing
- Included services
- Booking information

**Example:** https://visit-iraq.com/en/tours

### 7. Travel Listings (/travel-listings)
Public travel buddy finder where visitors can find travel companions.

**Features:**
- Travel dates and destinations
- Group size preferences
- Interests and activities
- Contact options

**Example:** https://visit-iraq.com/en/travel-listings

### 8. Best of Iraq (/best-of-iraq)
Immersive landing page showcasing Iraq's highlights:
- Ancient Heritage
- Natural Wonders
- Culture & Traditions
- Culinary Delights
- Cities & Towns
- Must-Do Experiences

**Example:** https://visit-iraq.com/en/best-of-iraq

## Pages to Exclude from Indexing

The following pages are private and should NOT be indexed:
- /*/admin/* - Admin dashboard and management
- /*/auth/* - Authentication pages
- /*/profile/* - User profile pages
- /*/guide/dashboard* - Guide dashboard
- /*/messages/* - Private messaging
- /*/edit - Edit pages
- /api/* - API endpoints

See robots.txt for complete exclusion list.

## API Endpoints (Not for Crawling)
All API endpoints are at /api/* and return JSON data. These should not be crawled
as they are for application functionality only.

## Sitemaps

### Main Sitemap
https://visit-iraq.com/sitemap.xml

### Sub-Sitemaps
Organized by content type for better performance:
- https://visit-iraq.com/sitemap-static.xml - Static pages (home, list pages)
- https://visit-iraq.com/sitemap-blog.xml - Blog posts
- https://visit-iraq.com/sitemap-places.xml - Places
- https://visit-iraq.com/sitemap-food.xml - Food items
- https://visit-iraq.com/sitemap-adventures.xml - Adventures
- https://visit-iraq.com/sitemap-guides.xml - Guide profiles
- https://visit-iraq.com/sitemap-tours.xml - Tours
- https://visit-iraq.com/sitemap-listings.xml - Travel listings

## Content Focus & Topics

**Geographic Focus:**
Iraq, Iraqi Kurdistan, Mesopotamia

**Main Topics:**
- Iraqi travel destinations and tourism
- Ancient Mesopotamian history and archaeology
- Iraqi culture, traditions, and heritage
- Iraqi cuisine and culinary traditions
- Natural wonders and landscapes of Iraq
- Travel safety and practical tips
- Local guide services and tours
- Cultural experiences and activities

**Target Audience:**
International travelers, history enthusiasts, cultural tourists, adventure seekers,
food lovers, researchers, and anyone interested in Iraqi culture and heritage.

## Technical Information

**Framework:** Next.js 16 (App Router)
**Database:** Supabase PostgreSQL
**Hosting:** Vercel
**CDN:** Vercel Edge Network

## Multilingual Implementation

Content translations are stored in the database. Each piece of content (blog post,
place, food item, adventure) has translations for available languages.

**Important for AI indexing:**
- A blog post may exist in English and Arabic but not French or German
- Sitemaps only include URLs for languages where translations exist
- This prevents 404 errors and ensures accurate indexing

## Contact & Support

For questions about this site structure or content, visit:
https://visit-iraq.com/en

## Robots.txt

See https://visit-iraq.com/robots.txt for crawler access rules.

---

**Last Updated:** 2026-01-02
**Version:** 1.0
**Purpose:** Help AI crawlers understand Visit-Iraq's structure and content for better indexing and context understanding.