BotMarket.sk
Search published real-estate and land listings from BotMarket.sk (Košice, Slovakia).
Hosted MCP Server
npx add-mcp 'https://api.botmarket.sk/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
BotMarket pre AI agentov
Ponuky z BotMarketu (pozemky a komerčné nehnuteľnosti, Košice a východné Slovensko) môže čítať každý AI agent cez MCP server, A2A alebo REST API, bez registrácie a bez kľúča. Vidno len zverejnené inzeráty. Obchod vždy potvrdzuje človek.
MCP server
Adresa (Streamable HTTP): https://api.botmarket.sk/mcp
Nástroje: search_listings (text, kategória, typ, lokalita, cena od/do, limit), get_listing (podľa id), list_categories. Zoznam nástrojov aj volanie nástrojov funguje bez kľúča.
Každý inzerát má štruktúrované polia: price (suma, cena za m², rozpätie, vat – či je cena s DPH, bez DPH alebo predávajúci nie je platca DPH), area (výmery v m²), utilities (siete), access (prístupová cesta), zoning (územný plán), availability a updated_at. Čo predajca neuviedol, je null.
Claude Desktop, Cursor a iné MCP klienty
{
"mcpServers": {
"botmarket": {
"type": "http",
"url": "https://api.botmarket.sk/mcp"
}
}
}
Klient, ktorý podporuje len lokálne (stdio) servery, sa pripojí cez mcp-remote:
{
"mcpServers": {
"botmarket": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.botmarket.sk/mcp"]
}
}
}
Claude Code: claude mcp add --transport http botmarket https://api.botmarket.sk/mcp
S voliteľným kľúčom pridajte hlavičku "headers": { "Authorization": "Bearer VAS_API_KLUC" } (pri Claude Code --header "Authorization: Bearer VAS_API_KLUC").
Rýchly test bez kľúča:
curl -s https://api.botmarket.sk/mcp -H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_listings","arguments":{"query":"pozemok"}}}'
A2A
Agent Card: /.well-known/agent-card.json. JSON-RPC endpoint https://api.botmarket.sk/a2a odpovedá na message/send (A2A 0.3) aj SendMessage (A2A 1.0) textom alebo dátami s filtrami.
REST API
- Zoznam ponúk: /v1/listings
- Detail:
/v1/listings/{id} - Schéma inzerátu: /v1/schema
- Prehľad pre jazykové modely: /llms.txt
Limity a voliteľný API kľúč
Bez kľúča: 30 požiadaviek za minútu na IP adresu (IPv6 po /64) a spolu 600 za minútu pre všetkých anonymných klientov. Pri prekročení dostanete HTTP 429 s hlavičkou Retry-After.
Ak potrebujete viac, napíšte na riso.sala@gmail.com, kto ste a na čo kľúč použijete. S kľúčom v hlavičke Authorization: Bearer … alebo X-API-Key je limit 120 požiadaviek za minútu. Neplatný kľúč vráti chybu, preto ho radšej vynechajte, než aby ste posielali starý.