Dokumentáció

Minden, amit a Citallo méréseiről, az MCP-ről és az automatizálásról tudni kell.

Mit mér a Citallo?

  • AI láthatóság – a válaszok hány %-a említi a márkádat (név, alias vagy domain).
  • Share of voice – az összes márkaemlítésből (te + konkurensek) mekkora a te részed.
  • Citálási arány – a válaszok hány %-ában szerepel a domained forrásként.
  • Átlagos pozíció – hányadikként említ az AI a felsorolt márkák közül.
  • Megítélés – 0–100 közötti hangulati pontszám a márkádat említő mondatok alapján.
  • Használt % (források) – egy domain a válaszok hány %-ában szerepel forrásként.

Hogyan mér?

  • Minden aktív promptot minden bekapcsolt modellnek elküldünk webkereséssel: ChatGPT (OpenAI Responses + web_search), Claude (web_search tool), Gemini (Google Search grounding), Perplexity (Sonar), Copilot (Bing-szerű keresés GPT-vel emulálva, mert nincs nyilvános API).
  • A válaszokból kinyerjük a márkák sorrendjét, a forrásokat és a hangnemet, majd mindent eltárolunk a memóriában.
  • Kulcs nélkül az adott modell demó (szimulált) adatot ad – ezt a felület mindenhol jelzi.

Gyors indulás

  • cp .env.example .env.local és add meg az API kulcsokat.
  • npm run dev → http://localhost:3000/dashboard
  • Hozz létre projektet, adj hozzá promptokat (vagy generáltasd a Prompt kutatásban), majd Mérés indítása most.
  • Futtasd a GEO site auditot, és a Teendők oldalon másold ki az agent promptokat a weboldalad kódbázisába.

Claude összekötés (MCP)

  • Integrációk → hozz létre API kulcsot.
  • Claude Code: claude mcp add citallo --transport http http://localhost:3000/api/mcp --header "Authorization: Bearer ctl_..."
  • Claude Desktop: stdio szerver – npm run mcp (CITALLO_URL és CITALLO_API_KEY környezeti változókkal).
  • Heti automatizálás: ütemezett Claude feladat minden hétfőn, ami run_tracking → get_visibility → get_recommendations → add_memory_note.

Telepítés felhőbe (eladható SaaS)

  • Vercel: vercel deploy, a vercel.json cron naponta hívja a /api/cron/weekly végpontot (heti projektek hétfőn futnak).
  • Adatbázis: Turso/libSQL (DATABASE_URL, DATABASE_AUTH_TOKEN) – a séma automatikusan létrejön.
  • Következő lépések eladáshoz: felhasználói fiókok (Clerk / Auth.js), Stripe előfizetés a csomaglimitekkel, workspace szintű adatleválasztás.