MediaAtlasRazpisnikZa agenteRazpisiZapiskiPrijavaPrijavite podjetje

Za agente in AI pomočnike

Razpise, ki jih Razpisnik izbere za vaše podjetje, dobi tudi vaš agent: z vašim ključem ali s prijavo v Claudu, z istimi vrati in z zahtevami iz dokumentacije.

Claude: konektor s prijavo MediaAtlas (najlažje)

  1. V Claudu (aplikacija na računalniku ali claude.ai) odprite Customize → Connectors, izberite Add in Add custom connector.
  2. Ime: Razpisnik. Naslov strežnika MCP: https://tenders.mediaatlas.si/mcp.
  3. Pri Authentication pustite Sign in now, ki ga Claude sam zazna. Pri OAuth client pustite Use Claude’s published identity (Recommended). Request headers pustite prazne. Kliknite Add.
  4. Odpre se prijava MediaAtlas (če se ne, kliknite Connect): prijavite se z istim računom kot na Razpisniku in kliknite Dovoli.
  5. Claude ima orodja Razpisnika: vse, kar vam Razpisnik da na strani. Vprašajte: »Kateri razpisi so ta teden zame?«

Ključa ni treba prepisovati. Povezavo vidite in prekinete na računu MediaAtlas pri Ključih (»Claude«).

Claude: dodajanje konektorja Razpisnik in vprašanje, kateri razpisi so ta teden za nas

Jutranji klic

Vsako jutro en klic orodja razpisnik_today: kaj je za vaše podjetje novega od dneva, ki ga pošljete. Ključ pošljete v glavi Authorization: Bearer …; kateri koli ključ vašega računa MediaAtlas, na katerem teče paket te storitve. Za rabo ključa veljajo Pogoji uporabe.

curl -H "Authorization: Bearer $KLJUC" \
  "https://tenders.mediaatlas.si/api/v1/razpisnik_today?since=2026-11-21"

Isto v Pythonu, z zapisom zadnjega dne:

import json, os, pathlib, urllib.parse, urllib.request
KLJUC = os.environ["KLJUC"]
f = pathlib.Path("zadnji-dan.txt")                      # until of the last answer
url = "https://tenders.mediaatlas.si/api/v1/razpisnik_today" + ("?since=" + f.read_text().strip() if f.exists() else "")
while url:
    q = urllib.request.Request(url, headers={"Authorization": "Bearer " + KLJUC})
    a = json.load(urllib.request.urlopen(q))
    for it in a["items"]:
        print(it["day"], it["what"], "-", it["why"], it["url"])
    r = a.get("rest") if a["more"] else None            # the same question, further on
    url = r and "https://tenders.mediaatlas.si/api/v1/" + r["tool"] + "?" + urllib.parse.urlencode(r["args"])
f.write_text(a["until"])

Za pomočnike, ki govorijo Model Context Protocol, je naslov https://tenders.mediaatlas.si/mcp, z istim ključem:

claude mcp add --transport http razpisnik https://tenders.mediaatlas.si/mcp \
  --header "Authorization: Bearer $KLJUC"

Kaj pride nazaj

since, untildneva, ki ju odgovor pokrije: po since do vključno until. Naslednje jutro pošljete until kot since; tako ne izpustite nobenega dne in nobene postavke ne dobite dvakrat.
profilez besedami, po čem je bil odgovor presejan (kar ste izbrali na svoji strani).
itemsnajveč 50 postavk, najtežje najprej. Vsaka ima id, what (dejstvo), why (zakaj je na vašem seznamu), source (vir in datum), url (kje jo preveri človek) in next (orodja, ki povedo več).
more, restkoliko postavk je še ostalo in klic, ki da naslednje (isto vprašanje s skip).
saidocene modelov, ki so se izkazale, kot stavek; brez verjetnosti. Zneski v eur so samo tisti, ki jih pove vir.
sourcesvsak vir, ali danes teče in do katerega dne sega.
empty, nextna dan brez novega: stavek, da ni nič, in kaj pride naslednje in kdaj.

Primer odgovora (izmišljeno podjetje in naročnik):

{
 "service": "razpisnik",
 "version": 1,
 "since": "2026-11-21",
 "until": "2026-11-22",
 "profile": "kar ste izbrali na svoji strani",
 "items": [
  {
   "id": "call:789012",
   "kind": "r_call",
   "day": "2026-11-22",
   "trigger": "call",
   "what": "Občina Primerjevo: dobava pisarniškega materiala, rok 6. 12. 2026",
   "why": "gre skozi vrata vaše firme: področje pisarniški material",
   "said": [],
   "ordered_by": [],
   "source": {
    "name": "Portal javnih naročil",
    "date": "2026-11-20"
   },
   "url": "https://tenders.mediaatlas.si/",
   "eur": null,
   "buyer": "Občina Primerjevo",
   "region": "osrednjeslovenska",
   "next": [
    {
     "tool": "razpisnik_call",
     "args": {
      "id": "789012"
     }
    }
   ],
   "mark": {
    "tool": "razpisnik_mark",
    "id": "call:789012",
    "marks": [
     "ni",
     "bomo",
     "oddal",
     "dobil",
     "izgubil"
    ],
    "eur": true
   }
  }
 ],
 "more": 0,
 "sources": [
  {
   "name": "Portal javnih naročil",
   "runs": true,
   "as_of": "2026-11-22"
  }
 ],
 "held": 0
}

Kaj je podjetje naredilo

Z orodjem razpisnik_mark agent zapiše, kaj ste naredili s postavko, enako kot gumbi na strani; oznaka pride na isto mesto. id je mark.id postavke. Ena oznaka na postavko: nova zamenja staro. Ob »dobil« lahko pošlje še eur, za koliko je bil posel. Razloga s prostim besedilom orodje ne sprejme.

Oznake urejajo naslednje odgovore. Kar vaša firma označi kot nekoristno (ni, poznam, prepozno), pride zanjo na konec, če je tega jasno več kot pri ostalem (ordered_by: own_marks); kar ste vzeli v delo, ostane spredaj. Kar večina firm označi kot nekoristno, gre na konec tudi drugim (marks); šteje se brez imena firme. Zaradi oznak drugih firm nobena postavka ne izgine; kar ste sami označili kot nekoristno, se vam ne vrne.

nini za nas
bomoprijavili se bomo
oddaloddali smo ponudbo
dobildobili smo posel
izgubilnismo bili izbrani

Meje in napake

Meje veljajo za podjetje (vse ključe enega računa skupaj), za en dan; dan se obrne ob polnoči.

klicev »danes«100
poizvedb po enem poslu, naročniku ali razpisu500
zapisanih oznak300

Klic, ki ne uspe, vrne stanje in error:

400`since`, `kinds` ali `skip` se ne da prebrati
401ni ključa ali ga shramba ne pozna
402paket ne teče ali je porabljen
403ključ ne odpre te storitve
429dnevna meja podjetja je dosežena (ali preveč napačnih ključev z enega naslova); `retry_after` pove, čez koliko sekund
503shramba ključev ne odgovori; poskusite čez minuto

Orodja

Opis z argumenti: /api/v1/ (brez ključa) ali tools/list v MCP. Za branje GET, za zapis POST s telesom JSON.

  • razpisnik_today: What is new for your firm since a day: the calls for tenders and grants that passed your firm's gate (the areas you chose and what you wrote of your firm), with what their documentation asks for, the deadlines that come near, and decisions of the review commission about your calls and their buyers.
  • razpisnik_call: One call your firm was given: the facts of its notice (deadline, questions, value, criteria, corrections), what its documentation asks for, and the habits of its buyer.
  • razpisnik_mark: Write down what your firm did with a call, as the buttons on its page do: ni (ni za nas), bomo (prijavili se bomo), oddal (oddali smo ponudbo), dobil (dobili smo posel), izgubil (nismo bili izbrani).

Več podjetij na enem računu

Kdor ima na enem računu več podjetij, pove z argumentom firm, za katero sprašuje; številka gre po vrsti, kot so se podjetja naročila (1 za prvo). Brez njega odgovor pove, koliko jih je.