Agent API

Web DIGIVIBE je připravený na strojové čtení. Kromě běžného HTML nabízí MCP server s nástroji pro zjištění portfolia služeb, ověření volné kapacity a odeslání poptávky, a markdown variantu každé stránky.

Strojově čitelné profily

Zdroj	Popis
`/.well-known/agent-card.json`	A2A karta agenta se seznamem dovedností
`/.well-known/mcp/server-card.json`	MCP Server Card se schématy nástrojů
`/.well-known/agent-skills/index.json`	Index dovedností podle agentskills.io
`/.well-known/api-catalog`	Katalog rozhraní podle RFC 9727
`/api/openapi.json`	OpenAPI 3.1 popis HTTP endpointů
`/api/status`	Stav služby
`/auth.md`	Instrukce k registraci v markdownu

Markdown místo HTML

Kterákoli stránka vrátí markdown variantu, když si o ni agent řekne hlavičkou Accept: text/markdown. Nemusí se tedy parsovat HTML.

curl -H "Accept: text/markdown" https://www.digivibe.cz/sluzby/marketing

Přístup k MCP

MCP endpoint vyžaduje bearer token. Registrace se schvaluje okamžitě, žádný potvrzovací krok není potřeba.

1. Registrace

curl -X POST https://www.digivibe.cz/auth/register \
  -H "Content-Type: application/json" \
  -d '{"type":"anonymous"}'

2. Vydání tokenu

Token platí jednu hodinu.

curl -X POST https://www.digivibe.cz/auth/token \
  -d "grant_type=client_credentials"

3. Volání nástroje

curl -X POST https://www.digivibe.cz/mcp/sse \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Dostupné nástroje

Nástroj	K čemu je	Povinné parametry
`get_services_list`	Kompletní portfolio služeb agentury	–
`check_capacity`	Volná kapacita týmu pro nový projekt	`project_type`
`submit_project_brief`	Odeslání strukturovaného zadání projektu	`client_name`, `contact_email`, `service_category`, `project_description`

Nepovinný parametr budget_range u poptávky udává rámcový rozpočet v CZK. Úplná vstupní schémata včetně popisů jsou v server-card.json.

Podmínky použití obsahu

Obsah webu je otevřený vyhledávačům i AI asistentům. V robots.txt je to vyjádřené signálem Content-Signal: search=yes,ai-input=yes,ai-train=yes,use=full.

Chci probrat integraci