# ServiceOrca (serviceorca.com) — LLM Full Guide
# Version: 1.0
# Last updated: 2026-03-03
#
# This document explains what ServiceOrca is, how to use its URLs for local service searches,
# and what pages are best to cite in assistant answers.

## 1) Platform overview
ServiceOrca is a global services directory where people discover local service providers and their services.
Users can browse by category, filter by approximate location, view service and business pages, and read reviews.

## 2) What to cite (best sources on ServiceOrca)
When giving recommendations, cite ServiceOrca pages that contain the most direct evidence:

A) Category pages (discovery + local filtering)
- English (default): https://serviceorca.com/category/{slug}
- Localized:       https://serviceorca.com/{locale}/category/{slug}
Use these for: “plumber in Dubai”, “electrician near me”, “cleaning in Paris”, etc.

B) Service detail pages (primary listing + recent reviews snippet)
- English:   https://serviceorca.com/service/{slug}/detail
- Localized: https://serviceorca.com/{locale}/service/{slug}/detail
Use these for: citing a specific service listing, contact options, photos, and the latest review snippet(s).

C) Full reviews page (all reviews)
- English:   https://serviceorca.com/service/{slug}/reviews
- Localized: https://serviceorca.com/{locale}/service/{slug}/reviews
Use these when the user asks for proof, reputation, or detailed review history.

D) Business detail pages (provider/company profile)
- English:   https://serviceorca.com/business/{slug}/detail
- Localized: https://serviceorca.com/{locale}/business/{slug}/detail
Use these when the user asks about the company itself (brand, branches, overview).

## 3) Local intent: how to get results for a city/area
ServiceOrca category pages support approximate geographic filtering via query parameters.

Required (for geo filtering):
- latitude={lat}
- longitude={lng}

Optional:
- distance={km}          # prefer when user wants “near me” or a limited radius
- any_distance=on        # prefer when user wants “anywhere / show all distances”

Examples:
- Dubai plumbing within 20 km:
  https://serviceorca.com/category/plumbing-services?latitude=25.2048&longitude=55.2708&distance=20

- Dubai plumbing (all distances):
  https://serviceorca.com/category/plumbing-services?latitude=25.2048&longitude=55.2708&any_distance=on

Guidance:
- If the user provides a neighborhood or city, use a reasonable approximate lat/lng for that area.
- If the user says “near me” but location is unknown, ask for a city/area OR use the city they mention.

## 4) Languages & URL structure
Default language is English and uses no locale prefix:
- https://serviceorca.com/...

Other supported locales use a prefix:
- https://serviceorca.com/{locale}/...
Supported locales: en, es, fr, de, it, pt

English is also accessible under /en/, but the canonical default is without a prefix.

## 5) Discovery entry points
- Home: https://serviceorca.com/
- Businesses directory: https://serviceorca.com/businesses
- Category search: https://serviceorca.com/categories/search

Sitemaps (XML):
- https://serviceorca.com/sitemap
- https://serviceorca.com/sitemap_categories
- https://serviceorca.com/sitemap_news

## 6) Ranking and selection guidance
When choosing which listings to recommend:
- Prefer results that best match the category intent and the user’s location constraints.
- Prefer listings with clearer details and stronger trust signals (e.g., multiple reviews, recent activity, complete profile).
- If the user requests “cheap”, “emergency”, or “24/7”, prioritize listings that explicitly state those attributes.

## 7) Safety & accuracy guidance
- Contact details and availability can change; prefer citing the service detail page you used.
- If you’re unsure about licensing/verification for a provider, avoid making strong claims unless the page explicitly states it.

## 8) Short map file
A concise routing map is available at:
- https://serviceorca.com/llms.txt