zaDojo

إعداد وكيل الذكاء الاصطناعي: ربط zaDojo

اربط Claude Code أو Codex أو Claude Cowork أو Hermes أو أي وكيل ذكاء اصطناعي آخر بـ zaDojo بأمر واحد، وتحقق من عمله، وأبقِ مهارات SEO محدّثة.

يحتاج وكيل الذكاء الاصطناعي إلى جزأين من zaDojo. اتصال MCP يتيح له استدعاء أدوات zaDojo للحصول على بيانات SEO مباشرة على https://app.zadojo.com/mcp. والمهارات ملفات 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. انسخ الأمر أدناه. يمكنك أيضًا نسخه من Agent setup داخل تطبيق zaDojo، أو توجيه وكيلك إلى النسخة النصية على 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
Codex في تطبيق ChatGPT لسطح المكتبأمر الإعداد أو الإضافةخطوات Codex لسطح المكتب
محادثة ChatGPT على الويب أو سطح المكتباتصال MCP مخصص (أدوات فقط)دليل ChatGPT
Cursor وعملاء MCP الآخروناتصال MCP، ثم المهارات بشكل منفصلإعداد MCP

Claude Code

داخل جلسة Claude Code، أضف السوق وثبّت الإضافة:

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

شغّل /reload-plugins إذا طلب منك Claude Code تفعيل الإضافة. وافق على تسجيل الدخول إلى 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 البديل في الخطة المجانية.

Codex في تطبيق ChatGPT لسطح المكتب

  1. افتح Codex وابدأ محادثة جديدة.
  2. الصق أمر الإعداد من هذه الصفحة.
  3. وافق على تسجيل الدخول إلى zaDojo عندما يظهر.
  4. إذا قال Codex إن الأدوات لم تُحمَّل بعد، ابدأ محادثة جديدة أخرى.

للتثبيت يدويًا، اتبع خطوات Codex لسطح المكتب. تحدد OpenAI خطط ChatGPT التي تتضمن Codex، لذا راجع صفحة خطط 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. لإضافة SEO Coach:

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

شغّل الأمر نفسه مع اسم مجلد آخر لكل مهارة zaDojo إضافية تريدها، مثل seo-audit أو keyword-research. يسجّل Hermes مصدر كل مهارة ليتحقق من التحديثات لاحقًا. توثيقه الخاص موجود في Hermes skill management.

Grok Bot

الصق أمر الإعداد في Bot الخاص بك ونفّذ أي خطوات يعيدها إليك. توجد المهارات والموصلات الجاهزة ضمن Marketplace في الشريط الجانبي. أما المهارات الخاصة فتجدها ضمن Your plugins > Manage plugins and skills > Private skills، ويستطيع كل Bot في حسابك استخدامها. راجع Grok Bot skills لمرجع xAI.

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

اسأل 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، وانقل تعديلاتك الخاصة. المهارات المرفوعة عبر Customize > Skills في Claude تُستبدل في المكان نفسه.

عند الانتهاء، أعد تحميل المهارات أو افتح جلسة جديدة، ثم اطلب من الوكيل تأكيد أنه يرى مهارات zaDojo المحدّثة.

حل المشكلات

المشكلةالحل
يشرح الوكيل MCP لكنه لا يستدعي أي أداة من zaDojoالاتصال غير محمّل في هذه الجلسة. أعد تحميل الوكيل أو أعد تشغيله، وابدأ محادثة جديدة، وأرسل طلب الفحص مجددًا.
لا تُفتح صفحة تسجيل الدخول أبدًااسمح بالنوافذ المنبثقة للوكيل، ثم أعد محاولة تسجيل الدخول من إعدادات MCP أو الموصلات لديه. الوكلاء دون واجهة يمكنهم استخدام مفتاح API.
الأدوات تعمل لكن لا تظهر أي مهاراتأضفت اتصال MCP دون المهارات. ثبّت الإضافة، أو أضف المهارات بمدير المهارات لدى وكيلك.
يظهر إدخالان لـ zaDojoأبقِ الإضافة واحذف الموصل المخصص أو إدخال MCP الزائد، ليبقى اتصال واحد.
أمر plugin في Codex مرفوضشغّل 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 يورو كل شهر. راجع الأسعار للقائمة الكاملة وأداة تقدير التكلفة.