# Golova.Market

Нишевый маркетплейс профессионального проката-оборудования для мероприятий
(свет, звук, видео, LED, сцена, риггинг, эффекты и т.д.). Продавцы — проверенные
компании-клиенты экосистемы Golova (не анонимы). Площадка сводит покупателя и
продавца; оплат/эквайринга/тарифов на платформе НЕТ — расчёты между сторонами.

## Публичный API (без авторизации, только чтение, JSON)
Base: https://golovamarket.ru/api/public

- GET /brands?q=        — бренды с числом активных объявлений
- GET /categories       — дерево категорий: раздел -> группы
- GET /listings         — поиск объявлений (пагинация). Параметры:
    q, categories[], brands[], city, price_min, price_max,
    deal (sale|rent|service) — тип сделки, state[] (new|used) — состояние товара,
    grades[] (excellent|good|working) — оценка б/у,
    sort (recommended|price_asc|price_desc|newest), per_page (<=50)
- GET /listings/{slug}  — полные данные объявления: спеки, фото, цена, продавец
- GET /sellers/{slug}   — профиль продавца + его объявления
- GET /companies        — компании индустрии (q, city, activity=rent|service|sale, category)
- GET /companies/{slug} — профиль компании: направления, вид деятельности, город
- GET /fleet?brand=&city= — кто держит бренд в парке (аренда): компании с количеством («24», «20+», «есть»)
- GET /services?category=&q=&city= — кто оказывает вид услуги (svc-*): компании с позициями и ставками («от 5 000 ₽/смена» или по запросу)
- GET /openapi.json     — OpenAPI 3.1 спецификация этого API (машиночитаемая)

## MCP-сервер (для ИИ-агентов)
POST https://golovamarket.ru/api/mcp — Model Context Protocol (JSON-RPC 2.0, Streamable HTTP).
Tools: search_listings, get_listing, list_brands, list_categories, get_seller, search_companies, search_fleet, search_services, get_company.

## Цены
У объявления есть единица цены (price_unit): item, kit, day, shift, hour, visit, project,
km, negotiable (договорная ставка — цена не указывается).

## Репутация продавца
Первично — число проведённых сделок (proof of work); стаж в Голове — дополнительно.

## Действия (написать продавцу, предложить сделку)
Требуют авторизации пользователя и появятся отдельным слоем (scoped-токены агента).
Сейчас API — только чтение/браузинг.

## Для людей
https://golovamarket.ru/developers — то же самое человеческим языком.