# AGENTS.md — Dohodni.cz

> Instrukce, strojová rozhraní a pravidla interakce pro autonomní AI agenty na portálu **Dohodni.cz**.

---

## 1. O projektu Dohodni.cz

**Dohodni.cz** je moderní český lokální marketplace propojující poptávku po řemeslnických pracích, opravách, stěhování, zahradních službách a brigádách s ověřenými řemeslníky a pracovníky v celé České republice.

- **Klíčová vlastnost:** 0 % provize z realizované práce (bez provize jak pro zadavatele, tak pro zhotovitele).
- **Lokalita:** Česká republika (všechny kraje a okresní města, např. Praha, Brno, Ostrava, Plzeň, Liberec).
- **Jazyk:** Čeština (`cs`), s podporou vícejazyčných AI překladů.
- **Oficiální URL:** `https://dohodni.cz`

---

## 2. Strojová rozhraní a manifesty (Machine-Readable Endpoints)

AI agenti mohou web procházet a interagovat s ním prostřednictvím následujících standardizovaných rozhraní:

| Protokol / Standard | URL adresa | Popis |
| :--- | :--- | :--- |
| **Agent Manifest** | `https://dohodni.cz/agents.json` | Strojový JSON manifest schopností a odkazů dle standardu Agent Web. |
| **Well-Known Agent Manifest** | `https://dohodni.cz/.well-known/agents.json` | Zrcadlo / alias manifestu pro standardní objevování. |
| **LLM Context (Stručný)** | `https://dohodni.cz/llms.txt` | Souhrnný Markdown kontext portálu dle specifikace llms.txt. |
| **LLM Context (Úplný)** | `https://dohodni.cz/llms-full.txt` | Detailní schéma entit, kategorií a procesů. |
| **Model Context Protocol (MCP)** | `https://dohodni.cz/.well-known/mcp/server-card.json` | MCP Server Card pro nástroje a asistenty. |
| **Agent-to-Agent (A2A)** | `https://dohodni.cz/.well-known/agent-card.json` | Karta agenta Dohodni.cz pro A2A protokol (Linux Foundation). |
| **DNS-AID Index** | `https://dohodni.cz/api/agent-index` | Index schopností a nástrojů pro DNS-AID a AI roboty. |
| **OpenAPI Specifikace** | `https://dohodni.cz/openapi.json` | OpenAPI 3.1 schéma veřejného API s podporou MPP. |
| **API Catalog** | `https://dohodni.cz/.well-known/api-catalog` | RFC 8288 / RFC 9264 katalog rozhraní (application/linkset+json). |
| **Autentizace agentů** | `https://dohodni.cz/auth.md` | Protokol pro strojovou registraci a ověřování agentů (OAuth / Auth.md). |
| **UCP / ACP Commerce** | `https://dohodni.cz/.well-known/ucp.json` | Universal Commerce Protocol profil marketplace. |
| **x402 Micropayments** | `https://dohodni.cz/api/v1` | Endpoint s podporou HTTP 402 / x402 protokolu pro placené transakce. |

---

## 3. Schopnosti agenta (Agent Capabilities)

Agenti mohou pro uživatele provádět tyto operace:

### A. Vyhledávání zakázek a poptávek
- **URL:** `https://dohodni.cz/prace/`
- **Metoda:** `GET`
- **Parametry:**
  - `q` (string): Hledaná profese nebo činnost (např. *malíř*, *instalatér*, *elektrikář*).
  - `location` (string): Město nebo PSČ (např. *Praha*, *Brno*, *46001*).
  - `category` (string): Slug kategorie zakázky.

### B. Vyhledávání řemeslníků a profilů
- **URL:** `https://dohodni.cz/vyhledavani`
- **Detail profilu:** `https://dohodni.cz/profil/{slug}`
- **Metoda:** `GET`
- **Data:** Jméno/název, specializace, lokalita působnosti, hodnocení a reference.

### C. Zadání bezplatné poptávky
- **URL:** `https://dohodni.cz/pridat`
- **Metoda:** `GET` / `POST`
- **Podmínky:** Zcela zdarma, 0 % provize, okamžité rozeslání relevantním řemeslníkům v okolí.

---

## 4. Pravidla pro autonomní agenty (Agent Etiquette & Policy)

1. **Autentizace:** Pro čtení veřejných stránek, vyhledávání a manifestů není vyžadována registrace. Pro zápis zakázek nebo zpráv použijte registraci popsanou v [auth.md](https://dohodni.cz/auth.md).
2. **Rate Limiting:** Dodržujte limit maximálně 60 požadavků za minutu na jednu IP adresu.
3. **Cachování:** Respektujte HTTP hlavičky `Cache-Control` a `ETag`. Manifesty jsou verzované a cachované na CDN.
4. **Content Signals:** Dohodni.cz vysílá signál `ai-train=no, search=yes, ai-input=yes`. Obsah je určen k vyhledávání, zodpovídání dotazů uživatelů a asistovanému sjednávání, nikoli k hromadnému stahování pro trénování základních modelů.
5. **Cenová politika:** Dohodni.cz je platforma bez provizí. Veřejné vyhledávání a zadávání poptávek je zdarma. Placené API dotazy (pokud jsou vyžadovány) jsou obsluhovány přes protokol x402 na `/api/v1`.

---

## 5. Kontakt pro vývojáře AI

- **E-mail:** `info@dohodni.cz`
- **Web:** `https://dohodni.cz/kontakt`