# PartsByBot API
> Spare parts pricing & availability API for heavy machinery (JCB and other brands)
> by ArmadaDetal (https://www.armadadetal.ru). Answers per-article queries; not a catalog dump.

## Endpoints
- REST: GET https://ai-partsbybot.ru/v1/price/{article} — price/stock/crosses by exact article (URL-encode "/" as %2F)
- REST: GET https://ai-partsbybot.ru/v1/find?q={part name} — search by part NAME when article is unknown (Russian queries work best)
- MCP:  https://ai-partsbybot.ru/mcp — tools: find_part (by name), get_price (by article); key via X-API-Key header or ?key= query param
- OpenAPI schema: https://ai-partsbybot.ru/openapi.json
- Interactive docs: https://ai-partsbybot.ru/docs

## Try it now (public demo key, 3 req/min, 20/day)
X-API-Key: ad_live_18aa4bb681a0367b18276ee1d239c9bb13a9505949b86b0d
Example: curl -H "X-API-Key: <demo key>" "https://ai-partsbybot.ru/v1/find?q=фильтр масляный JCB"

## Access
Production key (20 req/min, 2000/day): request via https://www.armadadetal.ru (contacts page).
Responses cached ~10 min.

## Typical flow for an AI agent
1. User asks for a part by name → call find_part("сальник полуоси JCB") → list of positions with articles.
2. Pick the article → call get_price("904/50033") → full picture: our stock (Moscow/SPb), market offers
   (ORIGINAL / OEM / analog), prices in RUB, delivery, cross-numbers.