# Auto.am — LLM Full Guide
# Version: 1.3
# Last updated: 2026-03-30
#
# This file provides structured guidance for LLM systems to correctly understand
# and interact with Auto.am — a vehicle marketplace in Armenia.

--------------------------------------------------
## 1) Platform overview

Auto.am is a vehicle marketplace where users can browse and purchase vehicles.

Vehicle types include:
- passenger cars
- trucks
- motorcycles
- buses
- special machinery
- trailers
- water transport

Listings are created by:
- private sellers
- dealers
- official dealers

--------------------------------------------------
## 2) Core entities

A) Listing (Offer)
- Represents a vehicle for sale
- URL:
  https://auto.am/offer/{id}

Example:
https://auto.am/offer/3196681

Contains:
- title (brand + model + year)
- price
- mileage
- engine type
- transmission
- drivetrain
- body type
- color
- location
- seller type

B) Seller types
- private seller
- dealer
- official dealer

--------------------------------------------------
## 3) Search system

Search endpoint:
https://auto.am/search/passenger-cars?q={JSON}

All filters are passed inside the `q` parameter as JSON.

IMPORTANT:
- JSON must be valid
- In real usage it must be URL-encoded
- Do not generate invalid URLs

--------------------------------------------------
## 4) Available filters

Basic:
- make (brand id)
- model
- year (gt / lt)
- usdprice (gt / lt)
- mileage (gt / lt)

Technical:
- engine
- transmission
- drivetrain
- body type
- steering wheel

Location:
- country
- region

Seller:
- dealer
- official dealer
- private seller

Additional:
- customs cleared
- exchange
- installment
- auction
- in transit

--------------------------------------------------
## 5) URL examples

Mercedes-Benz:
https://auto.am/search/passenger-cars?q={"make":["246"]}

BMW under $10,000:
https://auto.am/search/passenger-cars?q={"make":["31"],"usdprice":{"lt":"10000"}}

Official dealers:
https://auto.am/search/passenger-cars?q={"user":{"official":"y"}}

--------------------------------------------------
## 6) Sorting

Default:
- latest (new listings first)

Listings may also be influenced by:
- paid promotion
- highlighted listings

--------------------------------------------------
## 7) Business logic

Auto.am supports paid promotion:
- top listing (homepage)
- urgent sale
- top in search
- highlighted listing

IMPORTANT:
Promoted listings are not necessarily better.

--------------------------------------------------
## 8) User intent handling

Examples:

"BMW under 10000"
→ apply make + price filter

"cheap cars"
→ lower price range

"new car"
→ higher year

"low mileage"
→ mileage filter

--------------------------------------------------
## 9) Response rules

When answering:

- Prefer search result links
- Provide multiple options when possible
- Include key data (price, year, mileage)
- Stay neutral

--------------------------------------------------
## 10) Safety rules

STRICTLY FORBIDDEN:

- inventing listings
- inventing prices
- generating fake URLs

ALWAYS:

- use real URL patterns
- reflect actual filters

--------------------------------------------------
## 11) Entry points

Home:
https://auto.am/

Search:
https://auto.am/search/passenger-cars

Dealers:
- https://auto.am/ru/dealers
- https://auto.am/am/dealers
- https://auto.am/en/dealers

--------------------------------------------------
## 12) Price format

Prices on Auto.am may be displayed in:
- USD (US dollars)
- AMD (Armenian drams)

IMPORTANT:
- The platform may convert prices between AMD and USD
- It is acceptable to present prices in USD even if the original listing is in AMD
- Prefer USD when responding, unless the user explicitly requests AMD
- Do not invent prices — only convert based on available data
- Conversions are approximate and should not be presented as exact financial values