API și MCP
Tot catalogul se poate citi gratuit, de oameni și de mașini. Partea contorizată este acțiunea asupra unui anunț.
Nuntrix este construit pentru o lume în care cumpărătorul poate fi un om care tastează, un om care își întreabă asistentul sau un agent care lucrează în numele cuiva. Toți trei primesc același corpus. Citirea este deschisă, neautentificată și documentată. A acționa — a obține datele de contact ale unei afaceri, a publica un anunț, a răspunde la unul — se face în numele unui cont: pe site, după autentificare, sau de un agent care are o cheie API emisă de titular exact pentru asta. Se aplică aceleași reguli și aceleași limite în ambele cazuri.
API public de citire
/api/public/v1/catalogcategorii și niveluri de venit/api/public/v1/localitieslocalități cu centroid și rază/api/public/v1/nuntiosnuntio-uri deschise, paginate prin cursor; ?q= filtrează după termen/api/public/v1/nuntios/{slug}un nuntio cu brieful lui structurat/api/public/v1/providersmeseriași cu notă, timp de răspuns și nivel de verificare/api/public/v1/providers/{slug}un profil de meseriaș/api/public/v1/coveragematricea live categorie × localitate, cu numere/api/public/v1/openapi.jsonschemă citibilă de mașiniServer MCP
Serverul MCP este la /api/mcp — un singur endpoint, HTTP streamabil, fără instalare. Șase unelte de citire acoperă corpusul: caută și citește nuntios, caută și citește afaceri, listează categoriile și locurile. Nu cer cont, pentru că un asistent care citește piața este chiar produsul la lucru. Trei unelte acționează în numele contului căruia îi aparține o cheie API Nuntrix, fiecare doar dacă titularul i-a permis cheii: contact_provider dezvăluie datele de contact ale unei afaceri și îi trimite afacerii un e-mail despre asta; post_nuntio publică un anunț, iar contul primește un e-mail despre el; answer_nuntio răspunde la unul. Respectă aceleași reguli ca site-ul — datele de contact sunt scoase din textul public, un singur răspuns așteaptă per anunț, un cont suspendat nu poate acționa — și se socotesc în aceleași limite zilnice. Emite chei, alege ce poate face fiecare și revocă-le din Contul tău. Citirea prin HTTP simplu funcționează exact ca înainte — endpointurile de mai sus sunt același corpus, iar uneltele MCP întorc aceleași forme.
Ce este public și ce este restricționat
| Public, gratuit, indexabil | Restricționat, în spatele unui apel autentificat |
|---|---|
| Tipul serviciului și descrierea | Număr de telefon |
| Zona acoperită și localitatea | Adresă de e-mail |
| Calificări, autorizații, asigurări | Linkul de rezervare, dacă meseriașul a dat unul |
| Nivel de verificare și insigne | — |
| Note și număr de recenzii | — |
| Interval de preț și ferestre de disponibilitate | — |
| Fotografiile anunțului, în două mărimi | — |
| URL canonic stabil al anunțului | — |
Un agent poate evalua și clasa complet meseriașii noștri fără cont. Ca să acționeze — să contacteze o afacere, să publice un anunț sau să răspundă la unul — prezintă o cheie API, iar fapta este a titularului ei.
Limitați API-ul de citire?
Da, după adresa de rețea și generos: șase sute de citiri pe oră, mai mult decât ia citirea întregii piețe. Un refuz este un 429 cu Retry-After, niciodată o blocare — dacă ai nevoie de mai mult, spune-ne ce construiești.
Pot păstra corpusul la mine?
Da. Fiecare răspuns poartă un antet cu versiunea corpusului și un link către licență. URL-urile canonice ale anunțurilor sunt permanente și nu se refolosesc niciodată.
Blocați crawlerele AI?
Dimpotrivă. GPTBot, ClaudeBot, PerplexityBot, Google-Extended, CCBot și celelalte sunt permise explicit în robots.txt.
Există o integrare ACP sau UCP?
Nu încă. Ambele protocoale sunt astăzi croite pe produse — fluxuri, coșuri, variante, stoc — iar serviciile nu au cod de produs, nu au coș și nu au stoc. Urmărim apariția unei extensii pentru servicii.