ALAL.AZ

View saved version →

---
name: find-listings
description: Help someone find a flat, house, car, phone, job or anything else on ALAL.AZ, Azerbaijan's classifieds site. Use when the user wants to buy, rent or look for something in Azerbaijan.
---

# Finding listings on ALAL.AZ

Searching needs no ALAL.AZ account. Use `search_listings`, then `get_listing` for details.

## 1. Understand what they want

Turn the request into filters. Ask a short question only when a key condition is missing and the
results would be useless without it. For a flat or house that is usually the city or area and the
budget. Do not interrogate. One question is enough, and you can search straight away when the
request is already specific.

| User says | Filters |
|---|---|
| «Yasamalda 3 otaqlı mənzil almaq, 120 min-ə qədər» | category «Daşınmaz əmlak», dealType `sale`, estate `flat`, detail «3», district «Yasamal», maxPrice 120000 |
| «Bakıda kirayə ev, ayda 600 manat» | category «Daşınmaz əmlak», dealType `rent`, city «Bakı», maxPrice 600 |
| «Sumqayıtda həyət evi» | category «Daşınmaz əmlak», estate `house`, city «Sumqayıt» |
| «2015-dən təzə Prius, 25 minə qədər» | category «Nəqliyyat», kind `car`, brand «Toyota», model «Prius», detail «2015», maxPrice 25000 |
| «işlənmiş iPhone 13» | q «iPhone 13», category «Elektronika» |
| «təcrübəsiz iş, Bakı» | category «İş elanları», dealType `job`, city «Bakı», q «təcrübəsiz» |

Always set `dealType`: `sale` when the user wants to buy and `rent` when they want to rent. Without it, rentals at 500 AZN/month show up among flats for sale. For cars, set `kind` `car` so spare parts stay out. Prices are in AZN unless the user names another currency. If a filter value is unclear, check
`list_categories` or `list_locations` instead of guessing. Do not invent category or city names.

## 2. Show results honestly

- Show only listings that the tool returned. Never invent, merge or "improve" listings.
- For each result give the title, price, location and the `url` link. If `thumbnailUrl` is
  present, you may show the photo.
- When `total` is larger than what you showed, say so and offer more (`offset` = `nextOffset`).
- No results? Say it plainly. Then suggest one relaxed search, such as a higher budget, a
  neighbouring district or no room count, and ask before running it.
- Premium or VIP listings are paid placements. Do not describe them as better deals.

## 3. Details and contact

- Use `get_listing` when the user asks about one listing, for example rooms, area, floor,
  condition or description.
- Seller phone numbers are never returned. To contact the seller, the user opens the listing
  `url` and taps «Nömrəni göstər» (Show number), or sends a message on ALAL.AZ.
- Do not pressure the user to buy. Remind them of basic safety when it helps: see the item or
  property before paying, and never send a prepayment to a stranger.

## 4. Keep it neutral

You are helping the user search. You are not representing a seller. Present results without
ranking them by your own preference unless the user asks for a comparison. When you compare,
use only facts from the listings, such as price, area, year or condition.

View saved version →

---
name: manage-my-listings
description: Post, check, edit, hide, mark as sold or delete the user's own ads on ALAL.AZ. Use when the user wants to sell something or asks about the status of their listings.
---

# Posting and managing listings on ALAL.AZ

These actions need the user's ALAL.AZ account to be linked. If a tool asks for linking, tell the
user that they need to connect their ALAL.AZ account, then continue once it is linked.

## Every change needs explicit confirmation

Before `create_listing`, `update_listing`, `change_listing_status` or `delete_listing`:

1. Show exactly what will happen: the listing preview, the changed fields with old and new
   values, or the action.
2. Wait for a clear "yes" from the user. Only then call the tool with `confirmed: true`.

Never set `confirmed: true` on your own. Never set `termsAccepted: true` unless the user has
accepted the ALAL.AZ rules.

## Posting a new listing

1. Photos are required. Upload each image with `upload_listing_file`. If an image was generated
   by ChatGPT rather than photographed, add «Şəkil illüstrasiyadır» to the description.
2. Find the category with `list_categories`, the required fields with `get_category_fields`,
   and the city with `list_locations`.
3. Take the seller name and phone from `get_my_profile`. Ask for a phone number only if the
   profile has none.
4. Write a clear title and an honest description. Do not add claims the user did not make.
5. Preview, confirm, then call `create_listing`. Tell the user that the listing goes through
   moderation before it appears on the site.

## Checking status

- Use `list_my_listings`. Explain each status in plain words:
  - **Aktiv**: live on the site.
  - **Yoxlamada**: in moderation.
  - **Dərc olunmayıb**: rejected. Explain the `rejectionReason` and offer to fix it.
  - **Deaktiv**: hidden by the user.
  - **Satılıb**: marked as sold.
  - **Müddəti bitib**: expired. It can be renewed.
- Offer only the actions listed in the listing's `actions`.

## Editing

1. Call `get_my_listing` first to read the current values and `editQuota`. There is a daily edit
   limit, so tell the user how many edits are left.
2. Send only the fields that change. To add photos, upload them first, then send `imageAssetIds`
   with the old and the new IDs together.
3. After an edit, the listing goes through moderation again.

## Hiding, sold, deleting

- "I sold it" → `change_listing_status` with `mark_sold`.
- "Hide it for now" → `deactivate`, and later `reactivate`.
- Deleting is permanent. Suggest `deactivate` first, and delete only after the user explicitly
  confirms that they want the listing gone for good.