MCP وتطبيق ChatGPT

يشغّل AutoPSEO خادم MCP (بروتوكول سياق النموذج) واحدًا على العنوان https://app.autopseo.com/mcp. يمكن لأي مساعد يدعم MCP عبر HTTP الاتصال به، إما بتسجيل الدخول إلى حسابك في AutoPSEO أو بمفتاح API يبدأ بـ apk_live_، ثم يعمل على الخصائص والصلاحيات والخطة نفسها التي تعمل بها أنت. يسجّل الخادم 72 أداة في ثلاث مجموعات: تقارير Search Console وGA4، وبيانات الأبحاث، ومحرّك المحتوى الذي يتيح للذكاء الاصطناعي الخاص بك كتابة مقالات لموقعك.

الاتصال بتسجيل الدخول

الأدوات التي تدعم تسجيل الدخول عبر MCP لا تحتاج إلى مفتاح. أضف العنوان، ثم سجّل الدخول إلى AutoPSEO عندما تطلب الأداة ذلك ووافق على الوصول؛ بعدها تحتفظ الأداة بصلاحية وصولها وتجددها بنفسها.

• Claude Code: شغّل الأمر claude mcp add --transport http autopseo https://app.autopseo.com/mcp، ثم اكتب /mcp واختر autopseo ثم Authenticate.
• Claude على الويب أو سطح المكتب: الإعدادات ← الموصّلات (Connectors) ← Add custom connector، والصق https://app.autopseo.com/mcp، ثم اضغط Connect وسجّل الدخول.
• Cursor: أضف الخادم إلى الملف ~/.cursor/mcp.json (لكل المشاريع) أو .cursor/mcp.json (لمشروع واحد)، ثم استخدم زر Connect الذي يعرضه Cursor بجواره.

{ "mcpServers": { "autopseo": { "url": "https://app.autopseo.com/mcp" } } }

تظهر كل أداة متصلة بهذه الطريقة ضمن Signed-in tools في صفحة MCP & API، حيث يقطع زر Sign out وصولها فورًا. وخير طلب أول هو: «اعرض لي خصائص Search Console في حسابي»؛ فالإجابة تثبت أن الاتصال يعمل، وتمنح المساعد أسماء الخصائص الدقيقة التي تتوقعها بقية الأدوات.

ChatGPT

يتصل ChatGPT عبر وضع المطوّر (developer mode)، وتشرح صفحة MCP & API الخطوات ضمن قسم ChatGPT app. باختصار: في ChatGPT افتح Settings ← Apps & Connectors ← Advanced settings وفعّل Developer mode (يذكر التطبيق خطط ChatGPT Plus وPro وBusiness وEnterprise وEdu)، ثم اختر Create، وسمِّ الموصّل، واضبط عنوان خادم MCP على https://app.autopseo.com/mcp والمصادقة على OAuth، وسجّل الدخول إلى AutoPSEO عندما يطلب ChatGPT ذلك. تتيح موصّلات ChatGPT المصادقة عبر OAuth أو بلا مصادقة فقط، لذا لا تعمل مفاتيح API هناك. للمزيد راجع صفحة ChatGPT.

الاتصال بمفتاح API

المفاتيح مخصصة للسكربتات والمهام المجدولة والأجهزة التي لا تملك متصفحًا. في MCP & API ← API keys سمِّ المفتاح واختر نطاقه:

• Read only: للاستعلام عن البيانات وتشغيل التقارير؛ ولا يمكنه إضافة أي شيء أو تعديله أو حذفه.
• Read & write: كل ما يفعله مفتاح القراءة، إضافةً إلى الأدوات التي تغيّر البيانات أو تستهلك أرصدة الأبحاث.

يظهر المفتاح الكامل، وهو apk_live_ متبوعًا بـ 32 خانة سداسية عشرية، مرة واحدة فقط؛ ولا يحتفظ AutoPSEO إلا بقيمة SHA-256 المشفّرة له. وتعرض قائمة المفاتيح وقت إنشاء كل مفتاح وآخر استخدام له وعدد طلباته، ويوقف Revoke المفتاح فورًا. يمكنك الاحتفاظ بما يصل إلى 25 مفتاحًا نشطًا. أرسل المفتاح بالصيغة Authorization: Bearer apk_live_... (ويعمل الترويس x-api-key أيضًا):

claude mcp add --transport http autopseo https://app.autopseo.com/mcp --header "Authorization: Bearer apk_live_..."

تتضمن الصفحة أيضًا مقتطفات لـ OpenAI Responses API، ولاستدعاءات JSON-RPC الخام عبر curl (يستخدم الخادم نقل Streamable HTTP)، ولواجهة REST API على العنوان https://app.autopseo.com/v1 التي تتيح أدوات Search Console وGA4 الـ 19 بالمفاتيح نفسها، مع وثيقة OpenAPI 3.1 على المسار /v1/openapi.json.

الأدوات

تعرض صفحة MCP & API دائمًا أسماء الأدوات الحالية؛ وكان عددها 72 عند كتابة هذه الصفحة.

Search Console وGA4 (19 أداة)

list_properties وsearch_analytics وtop_queries وtop_pages وtop_countries وcompare_periods وcontent_decay وcannibalization وctr_benchmark وpage_poaching وrank_changes وnew_lost_rankings وurl_inspection وsitemaps وannotations وcreate_annotation وga4_overview وga4_breakdown وga4_key_events. لا تستهلك هذه الأدوات أي أرصدة. وعند عدم تحديد تواريخ تغطي آخر 28 يومًا مستقرة مقارنةً بالـ 28 يومًا التي قبلها، ويمكن لأي شخص تجربتها على الخاصية التجريبية sc-domain:demo.autopseo.app. وعلى الرغم من اسمها، تنتمي content_decay إلى هذه المجموعة: فهي تكشف الصفحات التي تفقد نقرات.

الأبحاث (33 أداة)

• الحساب والمشاريع: whoami وcreate_project وget_project_context وupdate_project_context
• الكلمات المفتاحية: research_keywords وget_keyword_metrics وget_ranked_keywords وget_domain_keyword_suggestions وsave_keywords وlist_saved_keywords
• النطاقات وصفحات النتائج والروابط: get_domain_overview وget_serp_results وfind_serp_competitors وget_backlinks_overview وget_backlinks_profile
• تتبّع الترتيب: create_rank_tracker وget_rank_tracker وadd_rank_tracking_keywords وremove_rank_tracking_keywords وestimate_rank_tracker_cost وrun_rank_tracker
• البحث المحلي: search_local_businesses وget_local_serp_results وget_local_rank_grid وget_business_profile وget_business_reviews وget_business_updates وget_google_business_questions وlist_business_categories
• تدقيق المواقع: run_site_audit وget_audit_status وget_audit_issues وget_audit_pages

يشتري كثير من هذه الأدوات بياناته من DataForSEO ويخصم من أرصدة الأبحاث لديك، فاجعل طلباتك مركّزة وتحقق قبل تشغيل الدفعات الكبيرة.

محرّك المحتوى (20 أداة)

تتيح هذه الأدوات للذكاء الاصطناعي الخاص بك العمل عبر قائمة المهام نفسها التي يعمل عليها كاتب AutoPSEO: content_list_tasks وcontent_claim وcontent_get_brief وcontent_submit وcontent_publish وcontent_unpublish وcontent_get_page وcontent_report وcontent_find_pages وcontent_add_topics وcontent_decline وcontent_merge وcontent_cover وcontent_set_cover وcontent_get_translation وcontent_submit_translation وcontent_instructions وcontent_propose_value وcontent_submit_value وcontent_remove_path. ويقدّم الخادم أيضًا خمسة قوالب توجيه (prompts) هي: write-articles وoptimize-page وrevise-draft وconnect-repo وrefresh-decayed.

تسير الجلسة المعتادة هكذا: تعرض المهام، وتحجز إحداها (يدوم الحجز ساعتين)، وتقرأ الموجز، ثم تكتب وترسل وتصلح ما تعيده الفحوصات، ولا تنشر إلا عندما تأمر بذلك. وللصور الغلاف والترجمات أدواتها الخاصة. تجتاز المقالات المكتوبة بهذه الطريقة الفحوصات نفسها التي تجتازها مقالات AutoPSEO، ولا تستهلك شيئًا من حصة مقالاتك، مع أن أول استدعاء للموجز يقرأ نتائج البحث الحية ويخصم من أرصدة الأبحاث. يرد المسار كاملًا في الكتابة بالذكاء الاصطناعي الخاص بك.

أدوات القراءة والكتابة والأدوات المدفوعة

لكل أداة فئة وصول. أدوات القراءة تطّلع على البيانات فقط (33 أداة)، وأدوات الكتابة تغيّر مساحة عملك (22 أداة)، والأدوات المدفوعة تقرأ فقط لكنها تشتري بيانات الأبحاث (17 أداة). يستطيع مفتاح القراءة فقط استدعاء أدوات القراءة وحدها. وكذلك عضو الفريق ذو صلاحية Read، أيًّا كان المفتاح أو تسجيل الدخول الذي يستخدمه، ولا يصل كل عضو إلا إلى الخصائص التي ذكرتها دعوته (المشاركة وصلاحيات الفريق).

الحدود والأخطاء

الحد الأقصى للاستدعاءات 60 في الدقيقة لكل مفتاح و1,000 في الساعة لكل حساب، عبر جميع مفاتيحه. وعند تجاوز أيٍّ من الحدّين يرد الخادم برمز HTTP 429 مع ترويس Retry-After، وتنتظر معظم العملاء وتعيد المحاولة من تلقاء نفسها؛ ولا تُحتسب مصافحتا initialize وping. وبعد انتهاء الفترة التجريبية دون اشتراك، تردّ الأدوات بعبارة «subscription required». لا يتلقى مزوّد المساعد بياناتك إلا للطلبات التي تجريها أنت؛ سجّل خروج الأداة أو ألغِ مفتاحها لإيقاف ذلك. تجد المزيد من الأمثلة في صفحة Search Console MCP.