AI Visibility / GEO
Cum ajunge catalogul tău să fie citit și recomandat de asistenții AI — ChatGPT, Gemini, Perplexity.
NAP v3 — Native AI Protocol
Motoarele AI nu „văd" site-ul ca un browser. NAP v3 expune date structurate și verificate direct către crawlerii AI, fără randare HTML:
| Componentă | Unde trăiește | Rol |
|---|---|---|
llms.txt | GET /geo/v2/llms.txt?domain=X | Document de protocol pentru agenții AI |
| Well-known | /.well-known/* | Descoperire standard (inclusiv chei JWKS) |
| Index agentic | GET /geo/v2/catalog/agentic-index.txt | Indexul complet al catalogului, pentru agenți |
| GEO Answer | POST /geo/v2/answer | Răspuns la întrebare, semnat EdDSA |
| JWKS | GET /.well-known/jwks.json | Cheia publică de verificare a semnăturilor |
Detectarea crawlerilor AI (GPTBot, ClaudeBot, GoogleOther etc.) se face dedicat, pe middleware — fiecare tip primește răspunsul potrivit.
Semnătura răspunsurilor
Răspunsurile GEO pot fi semnate criptografic (Ed25519) și verificate public prin JWKS. Dacă datele sunt manipulate, verificarea eșuează — AI-ul poate refuza conținutul nesemnat. Detalii în Arhitectura → NAP V3.
Endpoint-uri publice și rate limits
Limitele de mai jos sunt cele reale, din configurația de producție (src/config/geo-rate-limits.js) — per IP, în Redis, fail-open:
| Endpoint | Autentificare | Limită |
|---|---|---|
GET /geo/v2/lookup (catalog public afiliere) | — | 30 req / minut |
GET /geo/v2/lookup?widget_id=… | widget UUID | 120 req / oră |
GET /geo/v2/catalog | X-API-Key | 60 req / oră |
GET /geo/v2/catalog/agentic-index.txt | — | 10 req / oră |
POST /geo/v2/answer | vezi API Overview | 60 req / oră |
Parametrii de căutare ai lookup-ului public: q, gtin, sku, pid, max_price, category, merchant, limit. Lookup-ul pe widget: widget_id + sku / pid.
Verificare live
# Cifrele publice ale catalogului
curl -s https://api.catyai.io/api/public/catalog-stats
# Documentul de protocol pentru domeniul tău
curl -s "https://api.catyai.io/geo/v2/llms.txt?domain=exemplu.ro"
# Cheile publice de verificare a semnăturilor
curl -s https://api.catyai.io/.well-known/jwks.jsonCatalogul public demonstrativ: shop.catyai.io — aceleași cifre ca în catalog-stats (merchanți activi, produse), actualizate la fiecare build de catalog.