MediaAtlasDobitnikPrijavaPrijavite podjetje

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)

  1. V Claudu (aplikacija na računalniku ali claude.ai) odprite Customize → Connectors, izberite Add in Add custom connector.
  2. Ime: Dobitnik. Naslov strežnika MCP: https://dobitnik.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 Dobitniku in kliknite Dovoli.
  5. 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«).

Claude: dodajanje konektorja Dobitnik in vprašanje Dobitniku

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, 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": "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.

zanimivozanimivo, shranjeno za pozneje
poznamto že vem
prepoznoprišlo je prepozno
nini za nas
poklicalpoklicali ali pisali smo
nedosegljivnismo jih dosegli
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.

  • 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).