Fejlesztési és funkció terv v1.0 2026-04-21

Vyzor

Fejlesztési és funkció terv

Lead fejlesztő

Ádám

Koordinál

Horváth Szilveszter

Érintettek

Pelczer D., Katona Z., Pál Zs., Wéber-Bódis P.

A doksi célja

Nem technikai döntéseket diktál, hanem tisztázza mit szeretnénk a Vyzorba építeni, milyen adatforrásokból, milyen funkciókat. A technikai végrehajtás Ádám döntése — a javaslatok csak kiindulásnak.

0 Egy mondatban

A Vyzor az Ádám által fejlesztett AI-alapú hotel weboldal elemző szoftver. Jelenleg Microsoft Clarity adatokat dolgoz fel UX/CRO audithoz, és URL alapján CRO landing elemzést ad (21 Reddit-alapú preset prompt, textuális output üzenet-átírási javaslatokkal). Bővítjük SEO-audit, teljesítmény-audit és AI tartalom-generáló modulokkal — a Morgens SEO szolgáltatás-bevezetésének technikai fegyvere lesz.

1 Kontextus — miért most

Piaci igény

Wellness Hotel Gyula 1M Ft/hó SEO ajánlatot kapott külsős cégtől — sok. Mi hotel-szaktudással olcsóbban, AI-val automatizálva akarjuk.

Módszertan megvan

Szabi csomagnet.hu esete bizonyította: a 3+1 pilléres SEO működik (kódszintű / on-site / tartalom / off-site).

Innovation minta

Ugyanaz a bevezetési minta mint a CBX-nél — Innovation csapat készíti elő, Advisory+Marketing+Web viszi.

Egyetlen szoftver

Szétszórt tool-ok helyett egy szoftver több modullal, Morgens-arculattal, partnereknek eladható.

2 Adatforrás → funkció mátrix

Ez a doksi legfontosabb szekciója: milyen külső/belső forrás milyen adatot ad, és az melyik Vyzor funkciót hajtja meg.

Adatforrás	Típus	Mit ad	Melyik funkció használja
Microsoft Clarity	külső SaaS API	session replay, heatmap, rage-click, scroll depth	UX/CRO audit modul meglévő
PageSpeed Insights	Google API	Lighthouse scorek, Core Web Vitals, Opportunities	Teljesítmény audit modul új
HTML scrape	saját fetch	oldal forráskód	Kódszintű SEO audit, tracking audit, tartalom briefelő
Google Search Console	Google API (OAuth2)	top kulcsszavak, impressziók, CTR, pozíció, indexelés	SEO tartalom modul (long-tail)
Oldal tartalom	saját scrape	meglévő szöveg tisztítva	Tartalom átíró, GYIK generátor
Claude API	Anthropic LLM	generált szöveg/kód/struktúra	Tartalom, GYIK, CRO prompt engine
Soro (trysoro.com)	3rd party SaaS	long-tail kulcsszó, AI cikk, képgenerálás, belső link	Külső input teszt
Design extract	Pelczer saját skill	brand design leírás URL-ből	Landing generátor (külön tool, API-n át)

3 Modulok

3.1 UX/CRO audit meglévő scope tisztázandó

Jelenlegi állapot: Ádám fejlesztette. Két funkció áll a modulban:

MS Clarity feldolgozó — Clarity adatait dolgozza fel előre-gyártott promptokkal UX/UI + CRO audithoz.
CRO landing elemző — URL alapján, 21 Reddit-alapú preset CRO prompttal (pl. social proof megoldások, érzelmi megszólítás, célcsoport-illesztés). Kimenet: textuális elemzés + üzenet-átírási javaslatok. A prompt végén megkérdezi, hogy "csináljak-e wireframe-et?" — ez csak prompt szöveg, wireframe-generálás NEM implementált, Zoli "következő lépés"-ként említette.

Kritikus nyitott kérdés Ádámnak

Ez a modul még fejlesztés alatt van. Kérjük dokumentáld:

Milyen MS Clarity API mezőket/adatokat olvas be?
Milyen promptok dolgozzák fel, milyen output (struktúrált adat / riport / UI)?
CRO landing elemző — pontosan melyik 21 prompt, kimenet formátuma?
Multi-URL megy, vagy single-URL per request?
Wireframe-generátor: tervezed-e "következő lépés" gombként? (opcionális)

Ezen épül minden új modul — fundamentumként kell értenünk.

3.2 Kódszintű SEO audit új

Mit csinál: URL kap → letölti a HTML-t → kinyeri a SEO-szempontból fontos struktúrát → prioritizált javaslatlistát ad.

Mit vizsgál:

H1 jelenléte és egyedisége
<title> és <meta name="description"> — hosszúság, kulcsszó, duplikáció
Képek alt attribútuma
<meta name="robots">, <link rel="canonical">, hreflang
Open Graph és Twitter Card tagek
JSON-LD strukturált adat (Organization, LocalBusiness, Hotel, FAQPage)
Heading hierarchia (H2–H6 struktúra)
Belső linkek aránya és anchor szövegek

Adatforrás: saját HTML scrape (regex/parser), kiegészítésként PSI API SEO kategóriája.

Output: táblázat + prioritizált javaslatok magyarul — pl. "A /szobak oldalon nincs H1 → fontossági sorrendben első helyen álló kulcsszóval add hozzá."

Javaslat (nem fix)

Node.js-ben Cheerio / Python-ban BeautifulSoup egyszerű parse-ra bőven elég — nem kell headless browser. Scoring (kritikus/közepes/alacsony) logika is átvehető.

3.3 Teljesítmény audit — Core Web Vitals új

Mit csinál: PSI API mobile+desktop hívás URL-enként, Lighthouse scorek + Core Web Vitals + Opportunities kinyerése, riport.

Mit vizsgál:

Performance / Accessibility / Best Practices / SEO score (mobile és desktop)
LCP, INP, CLS, FCP, TTFB (field + lab data)
Lighthouse "opportunities" (pl. kép optimalizálás, JS késleltetés)
"diagnostics" (technikai mélyebb infók)

Adatforrás: PageSpeed Insights API v5. API key szükséges (Google Cloud projekt → PSI API enable → credentials → API key). Napi 25k hívás ingyenes — bőven elég.

Output: scorecard színkóddal, CWV értékek státusszal ("jó / javítandó / rossz"), prioritizált opportunity-lista magyar fordítással.

Scoring küszöbök (Google hivatalos értékek alapján):

Kategória	Performance	LCP	CLS	INP
Kritikus	< 50	> 4s	> 0.25	> 500ms
Közepes	50–89	2.5–4s	0.1–0.25	200–500ms
Rendben	90+	< 2.5s	< 0.1	< 200ms

Javaslat

Szekvenciális URL-futtatás, 2 mp várakozás hívások között (rate limit védelem). PSI audit title-ek magyar fordítása mapping table-ből (~30 leggyakoribb).

3.4 Tracking / pixel audit új

Mit csinál: HTML-ből regex-szel detektálja a telepített tracking kódokat, jelzi ami hiányzik az alapcsomagból.

Tracking	Detektálási minta
GTM konténer	`GTM-` prefix
GA4	`gtag` vagy `G-` measurement ID
Meta Pixel	`fbq(` vagy `facebook.com/tr`
Google Ads	`googleads.g.doubleclick.net` vagy `AW-`
LinkedIn Insight	`snap.licdn.com`
TikTok Pixel	`analytics.tiktok.com`
Hotjar	`static.hotjar.com`
Microsoft Clarity	`clarity.ms`
Cookie consent	CookieBot, OneTrust stb. patternek

Output: checklist ("mi van, mi hiányzik"), javaslatok a hiányokra. Nem kell headless browser — a tracking kódok 90%-ban a <head>-ben vannak.

3.5 Tartalom briefelő / átíró új

Mit csinál: URL + kulcsszó(ak) input → oldal tartalma betöltve → Claude-dal SEO-kompatibilis átírás javaslat.

Mit ad ki:

Átírt szövegjavaslat (kulcsszó-sűrűség figyelve, de nem túltömve)
Meta description javaslat (150–160 karakter)
Heading struktúra (H1–H3) javaslat
Belső linkelési javaslatok

Adatforrás: HTML scrape (csak szöveg rész), Claude API, opcionálisan GSC kulcsszó adatok.

Nyitott kérdés — kulcsszó input honnan jön?

(a) felhasználó írja be kézzel
(b) GSC-ből auto (meglévő top kulcsszavak)
(c) Soro-ból (ha integráljuk)

Valószínűleg (a) és (b) MVP-re, (c) később.

3.6 GYIK generátor új

Mit csinál: kulcsoldalhoz generál 10 kérdéses GYIK blokkot + JSON-LD FAQPage schema kódot.

Output:

10 Q&A pár magyarul (hotel-szakmai, kulcsszó-tudatos)
JSON-LD FAQPage schema blokk (copy-pastelhető a <head>-be)
HTML blokk (accordion-kompatibilis struktúra a body-ba)

Adatforrás: oldal tartalom + kulcsszó input → Claude API.

Integrációs függőség

Pircsi (Wéber-Bódis Piroska) dolgozik a beillesztési módszertanon — hogyan kerül be a GYIK a szálloda weboldalába (Zadír template / WordPress / egyéb). Vyzor csak a tartalmat adja, a beillesztés külön munkafolyamat.

3.7 Soro integráció nyitott

Mi az a Soro: trysoro.com — ~$39/hó külső SaaS. GSC-re csatlakozik, long-tail kulcsszavakat talál, blog cikket ír, képet generál, belső linkeket épít.

Státusz: Innovation csapat tesztel (Pelczer Dániel + 1 fő), Kikelet oldal a pilot.

Integrációs probléma: Soro zárt SaaS, az eddigi kutatás alapján nincs publikus API.

4 opció Ádám mérlegelhet (2026-04-17-es kutatásból):

Opció 1

Partnership megkeresés

API hozzáférés kérés Soro-tól. Ismeretlen kimenet, időigényes.

Opció 2

WordPress middleware

Soro WP plugin (soro-seo, API key) + saját WP "proxy" közt. MA működik.

Opció 3

Manuális / teszt fázis

Vyzor ne próbáljon API-ra menni, Soro-t kézzel használjuk.

Opció 4

Saját content engine

Claude API + DataForSEO (vagy GSC), teljes kontroll. Hosszabb fejlesztés, saját stack.

Javaslat (nem fix)

Első körben ne integráljuk Soro-t Vyzorba — tesztelési fázisban használjuk párhuzamosan.
Hibrid stratégia: Opció 1 (partnership) + Opció 4 (saját engine) párhuzamosan — így nem blokkol a Soro válasz.
Ha a Soro long-tail algoritmusa bizonyít → a funkciót clone-oljuk saját Vyzor modulként (GSC + Claude alapon).

3.8 GSC integráció fázis 5

Mit csinál: a Morgens által verified property-knél a Google Search Console adatait húzza (utolsó 28 nap).

Kinyert adatok:

Keresési teljesítmény: kattintás, impressziók, CTR, átlag pozíció
Top kulcsszavak + top oldalak
Indexelési állapot (indexelt / kizárt, hibák)
Sitemap státusz (beküldött sitemapek állapota)
Mobil használhatóság — mobilbarát-e, milyen problémák
Core Web Vitals field data (valós felhasználói mérések)

Felhasználás: bemenetet ad a tartalom briefelőnek + SEO audit riportot gazdagítja + content performance trackinghez alap.

Auth: OAuth2 service account (Google Cloud). Pál Zsuzsanna + Domián Dávid dolgoznak az advisory-szintű account management módszertanon.

3.9 GTM API integráció fázis 2, opcionális

Mit csinál: ahol Morgens-nek van GTM auth (saját konténerek), a Tag Manager API v2-n keresztül részletes tag audit.

Kinyert adatok: tagek listája (név, típus, firing trigger), triggerek és változók, verziók, publish history, aktív / szünetelő tagek, ütközések.

Auth: OAuth2 service account, konténerenként hozzá kell adni.

Kapcsolódás: a 3.4 Tracking/pixel audit modul kiegészítése — HTML scrape mindig megy, GTM API auth-tal mélyebb adatokat ad.

3.10 Content motor bővítések későbbi fázisok

Ezek nem MVP-funkciók, de a 2-tool koncepcióból (Site Analyzer + SEO Autopilot) átvett irányok, hogy Ádám tudja merre tart a tool:

Brand voice learning — URL alapján tanulja az oldal tónusát, stílusát, szókincsét. Soro ezt crawlinggal csinálja, mi GSC + oldal scrape + Claude prompt alapján.
Content performance tracking — publikált cikkek GSC adatainak automatikus összekötése. Tartalom ROI mérés: melyik cikk hozza a forgalmat, melyik gyengélkedik.
Autopilot mód — ütemezett cikkgenerálás + publikálás emberi review-val vagy anélkül (napi/heti).
CMS publikálás — elsődlegesen Zadír (Morgens saját CMS), másodlagos WordPress REST API, tercier manuális export (MD/HTML).
Unified riport — egy dokumentumban "diagnózis + terápia + eredmény" end-to-end partner-audit PDF.
Versenytárs elemzés — mit írnak a konkurens hotelek, hol vannak tartalom-rések.

3.11 Landing generátor külön tool, nem Vyzor-része

Pelczer Dániel saját tool-ja: URL alapú design extract + DESIGN.md alapú landing HTML generátor. Nem része Vyzor-nak, de a SEO kulcsszó-kutatás outputjából landing tud születni.

Integrációs kérdés: ha Vyzor kulcsszó-hiányt talál → külső tool-t meghívja API-n át, visszakap HTML-t, és azt ajánlja letétre. Technikai döntés Ádám + Dániel kettesen.

4 Adatáramlás — teljes kép

┌─────────────────────────────────────────────────────────────┐
│                         INPUT                               │
│   URL(-ek)  +  kulcsszó(-k)  +  hotel partner azonosító     │
└──────────────────────────┬──────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────┐
│                         VYZOR                               │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  Data fetchers (input oldalról):                            │
│    ├── MS Clarity API  ──→ UX/CRO                           │
│    ├── PSI API ──────────→ Teljesítmény                     │
│    ├── HTML scrape ─────→ SEO kód + Tracking + Tartalom     │
│    ├── GSC API (opc.) ──→ Tartalom + SEO tippek             │
│    └── Oldal szöveg ────→ Tartalom + GYIK                   │
│                                                             │
│  Processing (belső):                                        │
│    ├── Scoring/prioritizáló logika                          │
│    └── Claude API (prompt engine)                           │
│                                                             │
│  Output generation:                                         │
│    ├── Strukturált audit riport (UI / Google Docs / PDF)    │
│    ├── Akciólista (prioritizált, magyarul)                  │
│    ├── Generált tartalom (átírt szöveg, meta, GYIK+schema)  │
│    └── CRO elemzés (textuális + üzenet-átírási javaslat)    │
└──────────────────────────┬──────────────────────────────────┘
                           │
                           ▼
┌─────────────────────────────────────────────────────────────┐
│               FELHASZNÁLÓ (Morgens)                         │
│   Webes csapat (technikai javítások)                        │
│   Advisory (partner-kommunikáció, stratégia)                │
│   Marketing (tartalom, kampány)                             │
└─────────────────────────────────────────────────────────────┘

5 Fázisjavaslat

NEM fix sorrend

A sorrend Ádám + Szilveszter döntése. Ez egy javaslat a függőségek és ROI alapján.

FÁZIS 1 · ASAP

Fundamentum

MS Clarity + CRO funkciók dokumentálása
Közös adatmodell / URL registry
Ezen épül minden új modul

FÁZIS 2 · QUICK WIN

Kódszintű SEO audit

Nincs külső API függőség
Pilot-olható VHG + Kikelet + Gyula oldalakon
Látható ROI partnereknek

FÁZIS 3

Teljesítmény audit (PSI)

Egyszerű HTTP integráció, ingyenes
Átvehető teljes logika

FÁZIS 4

Tartalom briefelő + GYIK

Claude API van, prompt engineering
Pircsi GYIK beillesztési módszertanával párhuzamosan

FÁZIS 5

GSC + AI SEO irányok

OAuth2, időigényesebb
AI kereső láthatóság ide illeszthető

FÁZIS 6

Soro funkciók saját modulként

Csak Soro teszt után döntendő
Ha érdemes: GSC + Claude alapon clone-olva

6 Technikai javaslatok — csak referencia

Ádám dönt

Az alábbi táblák kiindulási javaslatokat tartalmaznak. A stack, DB, hosting, AI modell választás Ádám fejlesztői döntése — nem diktátum.

Kérdés	Javaslat	Megjegyzés
Backend stack	amit a meglévő Vyzor használ	Ne vezessünk be új függőséget
HTML parse	Cheerio (Node) / BeautifulSoup (Python)	Headless browser nem kell MVP-re
LLM	Claude (Morgens API meglévő)	OpenAI-ra kapcsolóval átváltható (Zsuzsi kérése)
Output storage	Google Docs + Drive (meglévő Morgens)	Egyszerű delivery a webes csapatnak
Audit trigger	On-demand + opcionális ütemezés (cron)	Pilot fázisban on-demand elég
Multi-user	MVP-ben NEM	Belső tool, Morgens-only
Historical adat	Google Sheets elég MVP-re	Natív DB későbbi fázis
Rate limiting	Szekvenciális, 2 mp várakozás	Külső API-k limitjei miatt
Magyarítás	Mapping table a PSI audit title-höz	~30 leggyakoribb audit fix fordítással

6.1 Külső API összesítő

API	Típus	Auth	Rate limit	Költség
PageSpeed Insights v5	REST	API key (opc.)	25k/nap	Ingyenes
Search Console API	REST	OAuth2 / SA	1200 req/min	Ingyenes
Tag Manager API v2	REST	OAuth2 / SA	100 req/100s	Ingyenes
Microsoft Clarity API	REST	API token	Tier-függő	Ingyenes (Clarity acct)
Claude API	REST	API key	Tier-függő	Token-alapú
Soro	zárt SaaS	—	—	~$39/hó
WordPress REST API	REST	App password / OAuth	Szerver-függő	Ingyenes
Zadír CMS	saját	—	—	Belső

Egyetlen Google Cloud projekt kezeli a 3 Google API-t (PSI + GSC + GTM). Service account-ot hozzá kell adni a GSC property-khez és GTM konténerekhez külön-külön.

7 Nyitott kérdések Ádámnak

Kritikus · 1

Jelenlegi MS Clarity modul — milyen adatmezőket olvas, milyen promptokkal, milyen output?

CRO landing elemző — pontosan melyik 21 Reddit-prompt, mi a kimenet formátuma?

Wireframe-generátor — Zoli "következő lépés"-ként említette. Roadmap-on szerepel-e? (opcionális)

Vyzor jelenlegi stack (nyelv, framework, hosting)?

Multi-URL futtatás van-e, vagy single-URL per request?

Meglévő audit history / storage? (Sheets, DB, semmi)

Kulcsszó-input preferencia új modulokhoz (kézi / GSC auto / Soro)?

Roadmap · 8

Prioritás — Ádám melyik fázist venné előre?

8 Pilot tervek

Elsődleges · fizet

Wellness Hotel Gyula

Havas Pisti kérte, van Search Console adat.

Másodlagos · fizet

VHG

Dev környezetben van (Pircsi szerint kijátszható az elemzés).

Teszt · nem fizet

Kikelet

Tartalom van, GYIK+blog igény van.

9 Kapcsolódó projektek

SEO product design — a Vyzor ennek a projektnek a technikai fegyvere
CBX projekt — ugyanaz a bevezetési minta (Innovation → partner)
2026-04-17 SEO bevezetés meeting — a Vyzor scope itt dőlt el

10 Nem Vyzor-része — kapcsolódó önálló munkák

Landing generátor (Pelczer Dániel) — külön tool, Vyzor-ral API-n át integrálódhat
Google vélemény válasz generátor (Pelczer Dániel, Innovation task) — külön tool
GYIK beillesztési módszertan kódba (Pircsi) — Vyzor csak a tartalmat adja, a technikai beillesztés külön munkafolyamat (Zadír / WordPress specifikus)
AI SEO láthatóság kutatás (Zsuzsi + Dániel) — külön Innovation task, később Vyzor modulba beépíthető

Következő lépés

Ádám olvassa végig, a 7. pont nyitott kérdéseit válaszolja meg, majd Szilveszter + Dániellel roadmap egyeztetés.