AI návrhy meta tagů (OpenAI)

Puluno Pro umí vygenerovat SEO titulek, meta popis a focus keyword podle obsahu stránky. Používá model OpenAI — vlastní API klíč (BYOK), data nejdou přes puluno.io.

Free verze má inteligentní návrhy bez AI (pravidla z obsahu stránky). AI je jen v Pro.

---

Kdo co platí (důležité)

AI není součástí ceny Pro ve smyslu „neomezené tokeny od Puluno“. Platí se dvě věci zvlášť:

Co	Komu platíte	Poznámka
Puluno Pro	Puluno (puluno.io)	1 490 Kč / rok / web — odemkne funkci AI v pluginu
OpenAI API	OpenAI přímo	Pay-as-you-go — platíte jen za reálné kliknutí na „AI návrh“

Puluno za vás OpenAI neplatí a neúčtuje poplatky za AI. Pro licence neobsahuje kredit u OpenAI.

Napojení je na vás

1. Pro licenci koupíte / obdržíte u nás.
2. OpenAI účet a API klíč si založíte sami na platform.openai.com.
3. Klíč vložíte do Puluno → Settings na svém WordPressu.

Bez Pro → AI v pluginu nejde.

Bez OpenAI klíče → Pro funguje (redirecty, GSC…), ale tlačítko AI se nezobrazí.

Co se děje technicky

• Volání jde z vašeho serveru přímo na OpenAI — ne přes puluno.io.
• Puluno nevidí váš OpenAI klíč na našich serverech (ukládá se jen v databázi vašeho WP).
• Obsah stránek pro generování meta posílá váš web OpenAI — ne my.

Pro majitele webu: AI je volitelné. Plugin bez OpenAI používáte normálně.

Pro agentury: Klient může mít vlastní OpenAI účet, nebo agentura jeden účet pro víc webů — klíč vkládáte do Settings každého webu zvlášť.

---

Co potřebujete

Požadavek	Kde
Puluno Pro licence	Ceník → klíč ISC-…
OpenAI účet + API klíč	platform.openai.com
Kredit / billing u OpenAI	Pay-as-you-go — bez něj API nefunguje
WordPress 6.4+, PHP 8.1+	Server musí umět HTTPS volání na api.openai.com

---

Postup krok za krokem

1. Aktivujte Puluno Pro

1. Objednejte Pro (nebo klíč od prodejce).
2. WordPress → Puluno → Settings.
3. Pole Licence → vložte ISC-… → Uložit nastavení.
4. Ověřte hlášku Pro aktivní.

Detail licence: Pro licence & platby.

---

2. Účet OpenAI

1. Registrace: platform.openai.com/signup
2. Přihlášení: platform.openai.com/login

---

3. Nastavte billing (důležité)

API bez předplaceného kreditu vrací chybu typu *insufficient quota*.

1. Otevřete Billing → Overview
2. Přidejte platební metodu a kredit (typicky od cca 5 USD).
3. Volitelně: Usage limits — měsíční strop pro klid v duši.

Orientační cena: model gpt-4o-mini — řádově haléře až koruny za desítky návrhů (záleží na délce obsahu stránky).

---

4. Vytvořte API klíč

1. API keys → Create new secret key
2. Pojmenujte klíč (např. Puluno production).
3. Zkopírujte klíč (sk-…) — zobrazí se jen jednou.

Bezpečnost:

• Klíč nesdílejte v e-mailech ani ticketech.
• U větších agentur zvažte projekt / service account a rotaci klíče.
• Klíč ukládáme v wp_options na vašem serveru (jako heslo v poli).

---

5. Vložte klíč do Puluno

1. Puluno → Settings
2. OpenAI API key (Pro) → vložte sk-…
3. Uložit nastavení

Stav:

• Pro aktivní + klíč vyplněný = AI návrhy zapnuté
• Pro bez klíče = tlačítko AI se nezobrazí

---

6. Použití v editoru

1. Otevřete stránku, článek nebo produkt v administraci.
2. V meta boxu Puluno SEO (pod editorem) klikněte AI návrh (Puluno Pro).
3. Po pár sekundách se vyplní titulek, popis a focus keyword.
4. Upravte ručně — AI je návrh, ne finální text. Zkontrolujte SERP preview v tom samém boxu.
5. Uložte / publikujte stránku.

Tlačítko AI je zatím v meta boxu (klasický editor i Gutenberg — box pod obsahem). Sidebar Gutenberg panel zatím nemá vlastní AI tlačítko; pole můžete vyplnit z meta boxu.

---

Co plugin posílá OpenAI

Při jednom kliknutí na AI návrh server pošle:

• typ obsahu (stránka / produkt / …)
• název stránky (WordPress title)
• výňatek textu (max. ~2000 znaků z obsahu, bez HTML)
• název značky z filtru indexscope_brand (pokud je nastaven)

Neposíláme: celou databázi, e-maily uživatelů, licenci Pro na OpenAI.

Volání jde přímo z vašeho WordPress serveru na:

https://api.openai.com/v1/chat/completions

Model: gpt-4o-mini (lze změnit vývojářem přes filtr indexscope_openai_model).

---

Ochrana údajů

• OpenAI Privacy Policy
• OpenAI API data usage policies
• Puluno — ochrana údajů

Obsah stránek putuje na servery OpenAI podle jejich podmínek. U citlivých klientů (zdravotnictví, právní…) zvažte interní schválení.

---

Řešení problémů

Problém	Co zkusit
Tlačítko AI nevidím	Pro licence + API klíč uložený? Obnovte stránku editoru.
*Puluno Pro + OpenAI API klíč jsou vyžadovány*	Licence neplatná nebo prázdný klíč.
*insufficient quota* / 429	Doplňte kredit na OpenAI Billing.
*Could not resolve host* / timeout	Hosting blokuje odchozí HTTPS — kontaktujte hosting.
*AI odpověď nelze parsovat*	Zkuste znovu; občas model vrátí nevalidní JSON.
Návrh v angličtině	Prompt je nastaven na češtinu; při prázdném obsahu upravte ručně.
Chci jiný model	Filtr indexscope_openai_model v child theme / mu-pluginu.

---

AI vs llms.txt — neplést

Funkce	Účel
AI návrhy meta (Pro)	Pomoc editorovi napsat title/description
llms.txt (Free)	Soubor pro AI crawlery na webu — mapa URL

llms.txt nenahrazuje OpenAI klíč a naopak.

---

Pro agentury — co říct klientovi

„AI návrhy jsou volitelné a nejsou v ceně Pro jako placené tokeny od Puluno. Pro platíte ročně za plugin; OpenAI si platíte sami podle použití (haléře za návrh). Klíč si napojíte sami v administraci — my za vaše AI nic neplatíme a do textů nevidíme. Vždy text zkontrolujte před publikací.“

Častá otázka: *„Musím mít AI?“* — Ne. Free i Pro fungují bez OpenAI. AI jen urychlí psaní titulků a popisů.

Více: FAQ pro agentury.

---

Odkazy na jednom místě

Služba	URL
OpenAI registrace	https://platform.openai.com/signup
API klíče	https://platform.openai.com/api-keys
Billing	https://platform.openai.com/settings/organization/billing/overview
Usage / limity	https://platform.openai.com/usage
Puluno Pro	/pricing
Licence v pluginu	Puluno → Settings