Nastavení AI agenta: zaDojo a SEO skills

AI agent potřebuje od zaDojo dvě části. Připojení MCP mu umožní volat nástroje zaDojo pro živá SEO data na adrese https://app.zadojo.com/mcp. Skills jsou soubory SKILL.md, které mu říkají, jak udělat práci jako audit nebo výzkum klíčových slov od začátku do konce. Nejrychleji získáš obojí tak, že níže uvedený prompt pro nastavení vložíš do svého agenta a necháš ho instalaci udělat.

Používáš ChatGPT? Jdi raději na průvodce pro ChatGPT. Běžný chat v ChatGPT nic instalovat neumí, takže prompt by jen vypsal ruční kroky. Vlastní připojení funguje na ChatGPT Free i na placených tarifech.

Co potřebuješ

• Účet zaDojo. Zaregistruj se a dostaneš 0,10 € zkušebních kreditů bez karty, nebo si účet založ, až ti postup nastavení otevře přihlašovací stránku.
• Agenta, který se umí připojit ke vzdálenému MCP serveru: Claude Code, Claude Cowork, Codex (CLI nebo desktopová aplikace ChatGPT), Hermes, Grok Bot, Cursor a podobné klienty.
• Prohlížeč, ve kterém schválíš přihlášení do zaDojo. Pro agenta bez rozhraní a bez prohlížeče použij místo toho API klíč.

Nastavení agenta

1. Zkopíruj prompt níže. Můžeš ho zkopírovat i z Agent setup v aplikaci zaDojo, nebo agenta nasměrovat na textovou verzi na https://zadojo.com/agent-setup.txt.
2. Vlož ho do nového chatu nebo relace ve svém agentovi.
3. Agent zjistí, jaký je klient, zkontroluje existující připojení k zaDojo a tam, kde plugin existuje, ho nainstaluje. Kde plugin není, přidá MCP server a veřejné skills zvlášť.
4. Až prohlížeč otevře přihlášení do zaDojo, přihlas se a schval přístup.
5. Pokud tě agent požádá o nové načtení, restart nebo kliknutí na něco, kam sám nedosáhne, udělej to. Řekne ti přesně, co udělat.

Set up zaDojo in this agent. Do what you can; guide me through anything that needs my input.

## 1. Check this agent

- Identify this agent and its version. Ask only if you cannot tell.
- Check for an existing zaDojo connection. Preserve other integrations and avoid duplicates.
- Check for zaDojo skills separately. A connection without skills is incomplete.

## 2. If this is ChatGPT

If I pasted this into a regular ChatGPT conversation (web or desktop app, not Codex), you cannot install zaDojo from here. Don't run commands or edit files. Instead, give me these steps and stop:

1. On chatgpt.com, open **Settings → Security and login** and turn on **Developer mode**. This works on Free and paid plans; no upgrade is needed.
2. Open **Settings → Plugins → Developer mode** (or **Plugins → + → Create MCP App**). Name it zaDojo, enter the server URL `https://app.zadojo.com/mcp` in full, including `https://` (otherwise ChatGPT reports "Unsafe URL"), and keep **OAuth** selected.
3. Create it, sign in to zaDojo, and approve the connection.
4. Start a new chat, select zaDojo from the **+** menu, and send: "Use zaDojo to check my connection and list my projects."

Link the [ChatGPT setup guide](https://zadojo.com/docs/chatgpt) for screenshots and troubleshooting. If I'm in Codex, continue below.

## 3. Install the plugin first

The official plugin bundles MCP + SEO skills, with zaDojo namespacing and shared updates.

- **Codex:** follow the [plugin guide](https://zadojo.com/docs/codex-plugin).
- **Claude Code:** follow the [plugin guide](https://zadojo.com/docs/claude-code-plugin).
- **Claude Cowork or the Claude desktop app:** you cannot install plugins from this chat, so don't run commands. Tell me to open **Customize** (in Cowork, the **Cowork** tab first) → **Plugins** → **+** or **Add** → **Add marketplace** → **Add from a repository**, enter `https://github.com/zadojo/seo-geo-mcp`, and install **zaDojo**. Then I start a new task and type `/` to check that zaDojo skills appear. If I already have a custom zaDojo connector, have me remove it once the plugin signs in. Plugins need a paid Claude plan. If I'm on Claude Free, have me add `https://app.zadojo.com/mcp` under **Customize → Connectors** → **Add custom connector** and upload the [public skills](https://zadojo.com/docs/skills/setup) in **Customize → Skills**. Then continue at step 5.
- **Other agents:** verify plugin compatibility in their current documentation.
- Check the installed client's help before running commands.

## 4. Fall back to MCP + skills

If the plugin is unsupported:

- Add `https://app.zadojo.com/mcp` using the [MCP guide](https://zadojo.com/docs/mcp).
- Install the [public SEO skills](https://zadojo.com/docs/skills/setup) for this agent only.
- Do not copy internal repository skills or duplicate bundled skills.
- If skills are unsupported, use MCP alone and link to the workflow guides.

## 5. Sign in

- Prefer OAuth and let me approve login in my browser. If this client cannot use OAuth, send me to `https://app.zadojo.com/settings` → API keys. Have me enter the key in the client's secret settings or environment, never chat or a repository.
- **Manual setup needed?** Use this agent’s current documentation and give only the steps I need to do myself.

## 6. Reload and verify

- Use the current agent’s native reload flow, checking its installed version, help, or official documentation. Prefer automatic discovery or an in-place reload; restart only if required to load the new tools and skills.
- Once tools load in this session, run whoami and list_projects (free reads). Check skill discovery too. If a reload needs my action, give the instructions rather than repeatedly retrying unavailable tools.
- Track installation, sign-in, and verification separately. A connected server is not proof that this session can use its tools. Never claim verification before the free reads succeed.
- Do not create projects or run paid research during installation.

## 7. Finish with a short handoff

Keep progress updates brief. The final reply must be **140 words or fewer** and follow this template:

**Status**
[Briefly say what succeeded or what blocked setup.]

**Next**

1. `[Give the native reload command or UI action for this agent, only if needed.]` Then say “Check that zaDojo is connected.” Approve sign-in if prompted.
2. Try one of these:
   - `[SEO Audit invocation]` **(recommended)**: find your website's biggest SEO issues.
   - `[SEO Project Setup invocation]`: interview you about your website and set up its project context.
   - `[Keyword Research invocation]`: find keywords worth targeting.
   - `[Local SEO invocation]`: review your Google Business Profile and local competitors.

Want to know what was set up? Just ask.

Adapt the template to the actual result:

- If I must install the plugin by hand, as in Claude Cowork, replace step 1 with those clicks.
- If installation failed, name the blocker and replace reload with the fix. If fully verified, say it is ready and omit reload. Do not claim sign-in failed or is required merely because tools need reloading.
- Recommend this agent’s idiomatic way to invoke each installed skill: its native command, mention, picker, or natural-language request. Use the discovered skill name and plugin namespace; do not assume `/skill-name` works everywhere or create aliases to force it. Check the agent’s help or official documentation when unsure. If skills are unsupported, give equivalent plain-language requests using the connected tools. Recommend workflows; do not run them during installation.
- Keep tool names such as whoami and list_projects in your checks, not the final reply. Omit versions, paths, connection details, skill counts, other integrations, and cleanup commands unless they explain the blocker or I ask. Do not add more sections or a verification checklist.

Agent skončí krátkou zprávou o stavu a pár návrhy prvních úkolů. Během nastavení nevytváří projekty ani nespouští placený výzkum.

Ruční nastavení podle agenta

Pokud prompt instalaci už dokončil, tuto sekci přeskoč. Každý blok níže dělá stejnou práci ručně.

Claude Code

V relaci Claude Code přidej marketplace a nainstaluj plugin:

/plugin marketplace add zadojo/seo-geo-mcp
/plugin install zadojo@zadojo

Pokud tě Claude Code požádá o aktivaci pluginu, spusť /reload-plugins. Schval přihlášení do zaDojo a pak napiš /zadojo:seo-coach, abys ověřil, že se skills načetly. Průvodce pluginem pro Claude Code popisuje rozsahy, aktualizace a opravy.

Claude Cowork

Pluginy se v Cowork přidávají přes menu, takže tuto část za tebe agent neudělá. Jdi do Customize > Plugins > Add marketplace > Add from a repository, zadej https://github.com/zadojo/seo-geo-mcp a nainstaluj zaDojo. Potřebuješ k tomu placený tarif Claude. Kroky pro Cowork vysvětlují alternativu pro tarif Free.

Codex v desktopové aplikaci ChatGPT

1. Otevři Codex a začni nový chat.
2. Vlož prompt pro nastavení z této stránky.
3. Až se objeví přihlášení do zaDojo, schval ho.
4. Pokud Codex hlásí, že nástroje ještě nejsou načtené, začni další nový chat.

Pro ruční instalaci postupuj podle kroků pro Codex desktop. Které tarify ChatGPT obsahují Codex, určuje OpenAI, takže se podívej na stránku tarifů OpenAI. Připojení v Codexu je oddělené od chatgpt.com: běžný chat v ChatGPT ho neuvidí.

Codex CLI

Z terminálu:

codex plugin marketplace add zadojo/seo-geo-mcp
codex plugin add zadojo@zadojo

Pokud se plugin neobjeví, načti Codex znovu nebo ho restartuj. Pak se přihlas:

codex mcp login zadojo

Požádej Codex, ať přes SEO Coach ověří, že vše funguje. Průvodce pluginem pro Codex uvádí chybové hlášky, na které můžeš narazit. Pokud jsi instaloval přes adresář pluginů v desktopové aplikaci, spravuj plugin z toho adresáře.

Hermes

Vlož prompt pro nastavení, který připojí MCP server. Skills se berou z hubu skills Hermesu. Přidání SEO Coach:

hermes skills install zadojo/seo-geo-mcp/plugins/seo-geo-mcp/skills/seo-coach

Pro každou další skill zaDojo, kterou chceš, spusť stejný příkaz s jiným názvem složky, například seo-audit nebo keyword-research. Hermes si zaznamená, odkud každá skill pochází, aby později mohl hledat aktualizace. Jeho vlastní dokumentace je v Hermes skill management.

Grok Bot

Vlož prompt pro nastavení do svého Bota a udělej kroky, které ti vrátí. Zabalené skills a konektory najdeš v postranním panelu pod Marketplace. Soukromé skills jsou v Your plugins > Manage plugins and skills > Private skills a může je používat každý Bot na tvém účtu. Referenci od xAI najdeš v Grok Bot skills.

Claude na webu a další agenti

Připoj server podle průvodce nastavením MCP. Pak přidej skills přes správce skills, kterého tvůj agent podporuje. V Claude se vlastní skills spravují v Customize > Skills. Na placeném tarifu Claude přidá plugin zaDojo připojení i skills najednou.

Agenti, kteří pracují s CLI skills, si mohou skills zaDojo vybrat ze seznamu:

npx skills add https://github.com/zadojo/seo-geo-mcp/tree/main/plugins/seo-geo-mcp/skills

Vyber svého aktuálního agenta a rozsah instalace, který ti vyhovuje. Nespouštěj to navíc k pluginu, protože plugin už skills obsahuje. Další cesty popisuje ruční nastavení skills.

Ověř, že to funguje

Začni nový chat a pošli:

Pomocí zaDojo zkontroluj moje připojení a vypiš moje projekty.

Funkční nastavení zavolá nástroje zaDojo a vrátí tvůj účet a seznam projektů. I prázdný seznam znamená úspěch: jen jsi ještě nevytvořil projekt. Tato kontrola jen čte data a nespotřebuje žádné kredity.

Pak zkontroluj skills. V Claude Code napiš /zadojo: a hledej dvanáct názvů skills. V Codexu napiš $. V jiných agentech se zeptej „Které skills zaDojo vidíš?“. Připojení, které funguje bez jakýchkoli skills, je nastavené jen napůl.

Pokud obě kontroly projdou, požádej agenta, ať spustí SEO Coach. Podívá se, kde tvůj projekt stojí, a doporučí jeden další krok.

Aktualizace skills

Skills se časem zlepšují a kopie v tvém agentovi se samy neaktualizují. Obnovení připojení MCP aktualizuje seznam nástrojů, ne soubory skills.

Uživatelé ChatGPT by měli postupovat podle kroků aktualizace pro ChatGPT. Vlastní připojení v ChatGPT nemá žádné soubory skills k aktualizaci.

Nejjednodušší je vložit tento prompt do agenta, ve kterém zaDojo používáš. Zjistí, jak byly skills nainstalované, aktualizuje je na stejném místě a zachová tvoje přihlášení i všechny úpravy, které jsi v souborech skills udělal.

Update my installed zaDojo skills using https://zadojo.com/docs/agent-setup#update-your-skills.

If this is ChatGPT on the web or a regular desktop chat, use https://zadojo.com/docs/chatgpt#update-zadojo. For a public directory plugin, start a new chat to load the available tools and skills; reconnect only if sign-in needs attention. For a custom MCP connection, select Refresh in its details, then start a new chat. Refreshing a custom connection updates tools, not skill files. Do not run local Codex commands to update ChatGPT web.

Identify this agent and how zaDojo was installed. Use the matching plugin or skills installer, checking the installed client's help before running commands. Update only zaDojo in its existing scope. Preserve my MCP endpoint, sign-in, and personal skill edits; ask before replacing conflicting edits. Avoid duplicate skills and do not install internal repository skills.

If the skills were copied manually, compare them with https://github.com/zadojo/seo-geo-mcp/tree/main/plugins/seo-geo-mcp/skills and update the installed public skill folders, including their supporting files. For Grok Bot or another agent without a verified update command, use its supported skill management flow or give me the exact manual steps available in this version.

Reload skills if supported. If I need to reload or start a new session, tell me what to do. Verify the updated skill files and that this agent can discover them; an active MCP connection alone does not prove the skills updated. Briefly tell me what changed and anything left to do. Do not run SEO research during the update.

Následují ruční kroky aktualizace pro každý způsob instalace.

Aktualizace pluginu pro Claude Code

/plugin marketplace update zadojo
/plugin update zadojo@zadojo
/reload-plugins

Pokud to už nechceš dělat ručně, otevři /plugin, jdi do Marketplaces, vyber zadojo a zvol Enable auto-update. U marketplaces, které neprovozuje Anthropic, je automatická aktualizace zpočátku vypnutá. Když ti Claude Code oznámí čekající aktualizaci, spusť /reload-plugins. Anthropic nastavení popisuje v configure auto-updates.

Aktualizace pluginu pro Codex CLI

codex plugin marketplace upgrade zadojo

Pokud se nové verze skills neobjeví, restartuj nebo znovu načti Codex. Příkazy pluginů Codexu se mezi verzemi měnily, takže pokud tento neprojde, spusť codex plugin --help a uvidíš, co tvoje verze přijímá. OpenAI popisuje marketplaces ve své dokumentaci pluginů.

Aktualizace skills z hubu Hermes

Zeptej se Hermesu, které skills mají aktualizace, a pak aktualizuj ty od zaDojo podle názvu:

hermes skills check
hermes skills update seo-coach

Řádek s aktualizací zopakuj pro každou nainstalovanou skill zaDojo. Pokud jsi skill upravil lokálně, Hermes ji ve výchozím stavu nechá být. Nejdřív si své úpravy přečti. --force přidej, jen když ti nevadí o ně přijít. Podrobnosti jsou v Hermes update lifecycle.

Aktualizace skills nainstalovaných přes skills CLI

npx skills list
npx skills update seo-coach seo-audit

Dosaď názvy skills, které máš skutečně nainstalované. Použij stejný rozsah, do kterého jsi instaloval: -g pro globální skills nebo -p pro projektové. Před aktualizací si ulož kopii osobních úprav. Nové skills přidané od tvé instalace update nezachytí, takže pro jejich výběr spusť instalační příkaz znovu. Dokumentace skills CLI obsahuje úplný seznam voleb.

Aktualizace Grok Bota nebo ručně zkopírovaných skills

U Grok Bota vlož prompt pro aktualizaci, nebo otevři Marketplace > Your plugins > Manage plugins and skills a aktualizuj tam položku zaDojo. xAI nezveřejňuje samostatný příkaz pro aktualizaci skills, takže použij ovládání, které ukazuje tvoje verze.

Pokud jsi složky skills kopíroval ručně, porovnej je s aktuálními složkami skills. Každou složku nahraď celou, včetně souborů vedle SKILL.md, a přenes své vlastní úpravy. Skills nahrané přes Customize > Skills v Claude se nahrazují na stejném místě.

Až skončíš, znovu načti skills nebo otevři novou relaci a požádej agenta, ať potvrdí, že vidí aktualizované skills zaDojo.

Řešení problémů

S čímkoli dalším napiš na hello@zadojo.com název a verzi agenta, krok, který selhal, a přesné znění chyby. Nikdy neposílej hesla, API klíče ani přihlašovací kódy.

Co spotřebovává kredity

Nastavení, přihlášení, kontrola připojení a aktualizace skills nestojí nic. SEO Coach je také zdarma, pokud ho nepožádáš o výzkum. Kredity se čerpají, jen když tvůj agent stahuje placená data, a 1 000 kreditů odpovídá 1 €. Pár obvyklých cen:

• Vyhledávání při výzkumu klíčových slov: asi 0,07 €.
• Přehled domény nebo zpětných odkazů s ročním vývojem: asi 0,10 €.
• Prompt Research pro jedno klíčové slovo: asi 0,25 €.

Čtení ze Search Console a Google Analytics, kontext projektu, uložená klíčová slova, reporty a samotné audity webu jsou zdarma. Tarif stojí 10 € měsíčně a každý měsíc obsahuje používání za 10 €. Úplný seznam a kalkulačku nákladů najdeš v cenách.