Za agente in AI pomočnike
Kar vam Dobitnik pokaže na strani in pošlje po pošti, dobi tudi vaš agent: z vašim ključem ali s prijavo v Claudu, za vaše podjetje, po filtru, ki ste ga izbrali.
Claude: konektor s prijavo MediaAtlas (najlažje)
- V Claudu (aplikacija na računalniku ali claude.ai) odprite Customize → Connectors, izberite Add in Add custom connector.
- Ime:
Dobitnik. Naslov strežnika MCP:https://dobitnik.mediaatlas.si/mcp. - 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.
- Odpre se prijava MediaAtlas (če se ne, kliknite Connect): prijavite se z istim računom kot na Dobitniku in kliknite Dovoli.
- Claude ima orodja Dobitnika: vse, kar vam Dobitnik da na strani. Vprašajte: »Kaj je novega zame na Dobitniku?«
Ključa ni treba prepisovati. Povezavo vidite in prekinete na računu MediaAtlas pri Ključih (»Claude«).

Jutranji klic
Vsako jutro en klic orodja dobitnik_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://dobitnik.mediaatlas.si/api/v1/dobitnik_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://dobitnik.mediaatlas.si/api/v1/dobitnik_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://dobitnik.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://dobitnik.mediaatlas.si/mcp, z istim ključem:
claude mcp add --transport http dobitnik https://dobitnik.mediaatlas.si/mcp \ --header "Authorization: Bearer $KLJUC"
Kaj pride nazaj
since, until | dneva, 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. |
profile | z besedami, po čem je bil odgovor presejan (kar ste izbrali na svoji strani). |
items | največ 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, rest | koliko postavk je še ostalo in klic, ki da naslednje (isto vprašanje s skip). |
said | ocene modelov, ki so se izkazale, kot stavek; brez verjetnosti. Zneski v eur so samo tisti, ki jih pove vir. |
sources | vsak vir, ali danes teče in do katerega dne sega. |
empty, next | na dan brez novega: stavek, da ni nič, in kaj pride naslednje in kdaj. |
Primer odgovora (izmišljeno podjetje in naročnik):
{
"service": "dobitnik",
"version": 1,
"since": "2026-11-21",
"until": "2026-11-22",
"profile": "kar ste izbrali na svoji strani",
"items": [
{
"id": "deal:123456:1",
"kind": "d_award",
"day": "2026-11-22",
"trigger": "award",
"what": "Občina Primerjevo: obnova vrtca, sklop 1 je dobil Gradbeništvo Zgled d.o.o. za 412.300 €",
"why": "zmagovalec v vaši obrti, v vaši regiji, nad vašim zneskom",
"said": [],
"ordered_by": [],
"source": {
"name": "Portal javnih naročil",
"date": "2026-11-20"
},
"url": "https://dobitnik.mediaatlas.si/",
"eur": null,
"buyer": "Občina Primerjevo",
"region": "osrednjeslovenska",
"next": [
{
"tool": "dobitnik_deal",
"args": {
"notice": "123456",
"lot": "1"
}
}
],
"mark": {
"tool": "dobitnik_mark",
"id": "deal:123456:1",
"marks": [
"zanimivo",
"poznam",
"prepozno",
"ni",
"poklical",
"nedosegljiv",
"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 dobitnik_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.
zanimivo | zanimivo, shranjeno za pozneje |
poznam | to že vem |
prepozno | prišlo je prepozno |
ni | ni za nas |
poklical | poklicali ali pisali smo |
nedosegljiv | nismo jih dosegli |
oddal | oddali smo ponudbo |
dobil | dobili smo posel |
izgubil | nismo 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 razpisu | 500 |
| zapisanih oznak | 300 |
Klic, ki ne uspe, vrne stanje in error:
| 400 | `since`, `kinds` ali `skip` se ne da prebrati |
| 401 | ni ključa ali ga shramba ne pozna |
| 402 | paket ne teče ali je porabljen |
| 403 | ključ ne odpre te storitve |
| 429 | dnevna meja podjetja je dosežena (ali preveč napačnih ključev z enega naslova); `retry_after` pove, čez koliko sekund |
| 503 | shramba 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.
dobitnik_today: What is new for your firm since a day: the awarded public contracts that pass the filter you chose on your Dobitnik page (what you sell, where, from what amount), the calls that still take bids and pass it, and your own reminders that came due.dobitnik_deal: One awarded lot: the winner, the buyer, the amount, the dates, and what the winner said it will hand on to subcontractors.dobitnik_winner: A winner's public record by its registry number: what it won in the last year and from whom.dobitnik_buyer: A public buyer's record by its registry number: what it awarded in the last year and to whom.dobitnik_mark: Write down what your firm did with a deal, as the buttons on your Dobitnik page do: zanimivo (zanimivo, shranjeno za pozneje), poznam (to že vem), prepozno (prišlo je prepozno), ni (ni za nas), poklical (poklicali ali pisali smo), nedosegljiv (nismo jih dosegli), oddal (oddali smo ponudbo), dobil (dobili smo posel), izgubil (nismo bili izbrani).