zaDojo

AI 代理設定:連接 zaDojo 並加入技能

用一段提示詞把 Claude Code、Codex、Claude Cowork、Hermes 或其他 AI 代理連上 zaDojo,確認運作正常,並讓 SEO 技能保持最新。

AI 代理需要 zaDojo 的兩個部分。MCP 連線讓它能呼叫位於 https://app.zadojo.com/mcp 的 zaDojo 工具,取得即時 SEO 資料。技能是 SKILL.md 檔案,告訴它如何從頭到尾完成一項工作,例如稽核或關鍵字研究。同時取得兩者最快的方法,是把下方的設定提示詞貼到你的代理中,讓它自己完成安裝。

使用 ChatGPT?請改看 ChatGPT 指南。一般的 ChatGPT 對話無法安裝任何東西,所以這段提示詞只會讓它列出手動步驟。自訂連線在 ChatGPT Free 與付費方案都能使用。

你需要準備

  • 一個 zaDojo 帳號。註冊即可獲得 €0.10 試用點數,無需信用卡;也可以在設定流程打開登入頁時再建立帳號。
  • 能連接遠端 MCP 伺服器的代理:Claude Code、Claude Cowork、Codex(CLI 或 ChatGPT 桌面應用程式)、Hermes、Grok Bot、Cursor 與類似的用戶端。
  • 一個可以核准 zaDojo 登入的瀏覽器。沒有瀏覽器的無介面代理,請改用 API 金鑰。

設定你的代理

  1. 複製下方的提示詞。你也可以從 zaDojo 應用程式內的 Agent setup 複製,或讓代理讀取純文字版本 https://zadojo.com/agent-setup.txt。
  2. 在代理中開啟新的對話或工作階段並貼上。
  3. 代理會判斷自己是哪一種用戶端,檢查是否已有 zaDojo 連線,並在有外掛的地方安裝外掛。沒有外掛的地方,它會分別加入 MCP 伺服器與公開技能。
  4. 瀏覽器打開 zaDojo 登入頁時,登入並核准存取。
  5. 如果代理要求你重新載入、重新啟動,或點選它無法操作的項目,請完成那一步。它會清楚告訴你要做什麼。
連接 zaDojo 的提示詞
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.

代理最後會顯示簡短的狀態訊息,以及幾項建議的第一個任務。設定過程中它不會建立專案,也不會執行付費研究。

依代理手動設定

如果提示詞已完成安裝,可以略過本節。以下每個區塊都是用手動方式完成同樣的工作。

代理安裝內容完整指南
Claude Code外掛(MCP 連線與 12 項技能)Claude Code 外掛
Claude Cowork 或 Claude 桌面版外掛,從 Customize 選單加入Cowork 步驟
Codex CLI外掛(MCP 連線與 12 項技能)Codex 外掛
ChatGPT 桌面應用程式中的 Codex設定提示詞或外掛Codex 桌面版步驟
ChatGPT 網頁版或桌面版對話自訂 MCP 連線(僅工具)ChatGPT 指南
Cursor 與其他 MCP 用戶端MCP 連線,技能另外安裝MCP 設定

Claude Code

在 Claude Code 工作階段中,加入市集並安裝外掛:

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

如果 Claude Code 要求你啟用外掛,請執行 /reload-plugins。核准 zaDojo 登入後,輸入 /zadojo:seo-coach 確認技能已載入。Claude Code 外掛指南說明了範圍、更新與修正方式。

Claude Cowork

Cowork 的外掛是透過選單加入的,所以代理無法替你完成這部分。前往 Customize > Plugins > Add marketplace > Add from a repository,輸入 https://github.com/zadojo/seo-geo-mcp,然後安裝 zaDojo。這需要 Claude 付費方案。Cowork 步驟說明了 Free 方案的替代做法。

ChatGPT 桌面應用程式中的 Codex

  1. 打開 Codex,開始新的對話。
  2. 貼上本頁的設定提示詞。
  3. zaDojo 登入出現時核准。
  4. 如果 Codex 說工具尚未載入,請再開啟一個新的對話。

若要手動安裝,請依照 Codex 桌面版步驟。哪些 ChatGPT 方案包含 Codex 由 OpenAI 決定,請查看 OpenAI 的方案頁面。Codex 連線與 chatgpt.com 是分開的:一般 ChatGPT 對話看不到它。

Codex CLI

在終端機中執行:

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

如果外掛沒有出現,請重新載入或重新啟動 Codex。接著登入:

codex mcp login zadojo

請 Codex 用 SEO Coach 檢查一切是否正常。Codex 外掛指南列出了你可能看到的錯誤訊息。如果你是從桌面版的外掛目錄安裝,請在該目錄中管理外掛。

Hermes

貼上設定提示詞以連接 MCP 伺服器。技能來自 Hermes skills hub。加入 SEO Coach:

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

每想多加一項 zaDojo 技能,就把資料夾名稱換掉再執行同一個指令,例如 seo-audit 或 keyword-research。Hermes 會記錄每項技能的來源,之後才能檢查更新。Hermes 本身的文件請見 Hermes skill management。

Grok Bot

把設定提示詞貼到你的 Bot 中,並完成它交還給你的步驟。打包好的技能與連接器在側邊欄的 Marketplace 下。私人技能在 Your plugins > Manage plugins and skills > Private skills 下,你帳號中的每個 Bot 都能使用。xAI 的參考資料請見 Grok Bot skills。

Claude 網頁版與其他代理

用 MCP 設定指南連接伺服器,再用你的代理支援的技能管理工具加入技能。在 Claude 中,自訂技能在 Customize > Skills 下管理。使用 Claude 付費方案時,zaDojo 外掛會一起加入連線與技能。

支援 skills CLI 的代理可以從清單中挑選 zaDojo 技能:

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

選擇你目前的代理與偏好的安裝範圍。已安裝外掛時請勿執行這個指令,因為外掛已經包含技能。其他方式請見手動技能設定。

確認設定成功

開始新的對話並傳送:

用 zaDojo 檢查我的連線,並列出我的專案。

設定正確時,代理會呼叫 zaDojo 工具,回傳你的帳號與專案清單。空清單也算通過,只代表你還沒建立專案。這項檢查只讀取資料,不消耗點數。

接著檢查技能。在 Claude Code 中輸入 /zadojo:,找找十二項技能名稱。在 Codex 中輸入 $。在其他代理中,問它「你看得到哪些 zaDojo 技能?」連線正常但沒有任何技能,只算完成一半的設定。

兩項檢查都通過後,請代理執行 SEO Coach。它會查看你的專案現況,並建議一個下一步。

更新你的技能

技能會持續改進,但代理中的副本不會自動更新。重新整理 MCP 連線只會更新工具清單,不會更新技能檔案。

ChatGPT 使用者請改看 ChatGPT 更新步驟。自訂的 ChatGPT 連線沒有需要更新的技能檔案。

最簡單的方式是把這段提示詞貼到你使用 zaDojo 的代理中。它會找出技能的安裝方式,在原處更新,並保留你的登入狀態與你對技能檔案做的修改。

更新 zaDojo 的提示詞
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.

以下是各種安裝方式的手動更新步驟。

更新 Claude Code 外掛

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

如果不想每次手動更新,請打開 /plugin,前往 Marketplaces,選擇 zadojo 並選 Enable auto-update。非 Anthropic 營運的市集,自動更新預設為關閉。Claude Code 告訴你有更新待套用時,請執行 /reload-plugins。Anthropic 在 configure auto-updates 中說明了這項設定。

更新 Codex CLI 外掛

codex plugin marketplace upgrade zadojo

如果沒有看到新版技能,請重新啟動或重新載入 Codex。Codex 的外掛指令在不同版本間有變動,如果這個指令被拒絕,請執行 codex plugin --help 查看你的版本支援什麼。OpenAI 在其外掛文件中說明了市集。

更新 Hermes hub 技能

先問 Hermes 哪些技能有更新,再依名稱更新 zaDojo 技能:

hermes skills check
hermes skills update seo-coach

對每項你安裝的 zaDojo 技能重複執行更新那一行。如果你在本機修改過某項技能,Hermes 預設不會動它。請先檢視你的修改。只有在你願意捨棄修改時,才加上 --force。詳情請見 Hermes update lifecycle。

更新以 skills CLI 安裝的技能

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

換成你實際安裝的技能名稱。使用與安裝時相同的範圍:全域技能用 -g,專案技能用 -p。更新前請先備份你的個人修改。update 不會加入安裝後才新增的技能,請重新執行安裝指令來選擇它們。完整選項請見 skills CLI 文件。

更新 Grok Bot 或手動複製的技能

Grok Bot 請貼上更新提示詞,或打開 Marketplace > Your plugins > Manage plugins and skills 並在那裡更新 zaDojo 項目。xAI 沒有發布專門更新技能的指令,所以請使用你的版本顯示的控制項。

如果你是手動複製技能資料夾,請與目前的技能資料夾比對。以整個資料夾為單位替換,包括 SKILL.md 旁的其他檔案,並把你自己的修改帶過去。透過 Claude 的 Customize > Skills 上傳的技能,在同一處替換即可。

完成後,重新載入技能或開啟新的工作階段,再請代理確認它看得到更新後的 zaDojo 技能。

疑難排解

問題解決方式
代理只解釋 MCP,從不呼叫 zaDojo 工具這個工作階段沒有載入連線。請重新載入或重新啟動代理,開始新的對話,再傳送一次檢查請求。
登入頁一直沒有打開允許代理顯示彈出視窗,再從它的 MCP 或連接器設定重新登入。無介面代理可以使用 API 金鑰。
工具可以用,但沒有出現任何技能你加入了 MCP 連線但沒有技能。請安裝外掛,或用代理的技能管理工具加入技能。
出現兩個 zaDojo 項目保留外掛,移除多餘的自訂連接器或 MCP 項目,只留一個連線。
Codex 的 plugin 指令被拒絕執行 codex plugin --help。子指令名稱在不同 Codex 版本間不同。
不確定更新是否成功開始新的工作階段,請代理列出它看得到的 zaDojo 技能。

其他問題請寄信到 hello@zadojo.com,附上代理名稱與版本、失敗的步驟與確切的錯誤文字。請勿寄送密碼、API 金鑰或登入代碼。

哪些動作會消耗點數

設定、登入、連線檢查與技能更新都不收費。SEO Coach 也免費,除非你要求它執行研究。只有代理取得付費資料時才會消耗點數,1,000 點等於 €1。一些參考價格:

  • 一次關鍵字研究搜尋:約 €0.07。
  • 含一年歷史的網域或反向連結概覽:約 €0.10。
  • 對一個關鍵字執行 Prompt Research:約 €0.25。

讀取 Search Console 與 Google Analytics、專案情境、已儲存的關鍵字、報告與一般網站稽核都免費。方案每月 €10,每月內含 €10 用量。完整清單與費用估算器請見價格。