<!-- Za agente · Razpisnik -->
# 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«).

## 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](https://services.mediaatlas.si/sl/terms.html#raba).

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

| `ni` | ni za nas |
|---|---|
| `bomo` | prijavili se bomo |
| `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.

- `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.

---

Stran: https://tenders.mediaatlas.si/agenti
