إعداد وكيل الذكاء الاصطناعي

Essentras في Gemini CLI

يتصل Gemini CLI بـ Essentras عبر الكائن mcpServers في settings.json. استخدم httpUrl للعنوان https://essentras.com/api/mcp، لأن Gemini CLI يقرأ url على أنه عنوان SSE. لا تحتاج Essentras إلى حساب ولا مفتاح API ولا OAuth. يبحث Gemini في المنصات الإعلامية، ويسعّر السلة، ويشغّل أدوات التحقق، ثم يمنحك رابط دفع لتفتحه وتدفع.

بداية سريعة

أضف الخادم
شغّل الأمر أدناه. النطاق الافتراضي هو المشروع، وينفّذ -s user الحفظ لكل المجلدات.
تحقق منه
شغّل gemini mcp list، أو اكتب /mcp داخل جلسة لترى CONNECTED والأدوات.
اطلب ثم أكّد
يسألك Gemini قبل كل استدعاء: Proceed once أو Always allow this tool أو Always allow this server أو Cancel.

إعدادات MCP

يكتب في .gemini/settings.json للمشروع، أو في ~/.gemini/settings.json عند استخدام -s user.

BASH

gemini mcp add --transport http essentras https://essentras.com/api/mcp

أو عدّل settings.json يدوياً. يعني httpUrl بروتوكول Streamable HTTP، ويعني url بروتوكول SSE.

JSON

{
  "mcpServers": {
    "essentras": {
      "httpUrl": "https://essentras.com/api/mcp"
    }
  }
}

أمثلة على الأوامر

ابحث في Essentras عن منصات إعلامية في البرازيل بسعر أقل من 300$.
احسب سعر msn وyahoo-finance معًا واعرض لي رابط الدفع.
هل يمكن إزالة مراجعة تتضمن تهديدًا بالابتزاز من Google؟
هل تُحتسب مقابلة في صحيفة محلية ضمن معيار الأهمية الموسوعية في Wikipedia؟
ما الطريق القانوني لإزالة عنوان منزلي من نتائج Google؟

ما يمكنه فعله هنا

10 أدوات للقراءة فقط. لا تتولى أيٌّ منها أي عملية دفع.

search_outlets

ابحث عن المنصات الإعلامية حسب الدولة أو الموضوع أو السعر أو الصلاحية أو سياسة الروابط

get_outlet

اطّلع على تفاصيل منصة واحدة كاملة

quote_placements

سعّر سلة من المنشورات واحصل على رابط الدفع

list_services

اعرض كل خدمة إلى جانب المنشورات، مع سعرها

quote_service

سعّر خدمة واحدة واحصل على الصفحة التي يدفع فيها المشتري

check_review_removability

هل يمكن حذف مراجعة Google هذه بموجب قاعدة محددة من Google؟

check_knowledge_panel_readiness

ما مدى جاهزية هذا الشخص أو العلامة التجارية للحصول على Google Knowledge Panel؟

check_wikipedia_notability

هل يُحتسب كل مصدر ضمن معيار الأهمية الموسوعية في Wikipedia؟

find_removal_route

ما الطريق القانوني لإزالة نتيجة تخص شخصًا من Google؟

check_instagram_recovery_path

ما طريق الاستعادة الرسمي لحساب Instagram المخترق أو المعطّل أو المقفل؟

مسارات العمل الشائعة

من البحث ضمن الميزانية إلى الدفع

حدد هدفًا ودولة وسقفًا للسعر. يستدعي Gemini الأداة search_outlets ثم quote_placements، ويعرض البنود وأي خصم على الكمية وcheckout_url. افتح الرابط وراجع السلة وادفع.

REST دون أي إعداد

إذا فضلت عدم تغيير الإعدادات، فاطلب من Gemini تشغيل curl على https://essentras.com/api/agent/v1. لا تحتاج استدعاءات REST إلى أي إعداد، وتعيد عرض السعر وcheckout_url نفسيهما.

افحص حالة

صف مراجعة أو طلب إزالة. يستدعي Gemini أداة الفحص بخيارات ثابتة ويعرض الحكم والقاعدة التي يستند إليها. يأتي سعر أي خدمة مناسبة بعد المسار المجاني.

نصائح للنجاح

تظهر الأدوات بأسماء مثل mcp_essentras_search_outlets وغيرها. احرص على أن تخلو أسماء الخوادم من الشرطة السفلية.
أبقِ trust على false. فتفعيله يتجاوز كل رسائل التأكيد الخاصة بالخادم.
استخدم includeTools لإتاحة بعض الأدوات فقط، مثل search_outlets وquote_placements.
شغّل gemini --debug للحصول على مخرجات مفصلة، واضغط F12 لفتح وحدة التصحيح.

الأسئلة الشائعة

هل أستخدم url أم httpUrl؟▾

استخدم httpUrl. في Gemini CLI يحدد httpUrl بروتوكول Streamable HTTP، بينما يحدد url بروتوكول SSE. تعمل Essentras عبر Streamable HTTP، لذا لا يتوافق معها إدخال يعتمد url. كما أن الخيار --transport http في gemini mcp add يحدد Streamable HTTP أيضًا، فكلاهما صالح.

انتقلت إلى Antigravity CLI. هل تعمل Essentras هناك؟▾

يقرأ Antigravity CLI خوادم MCP من ~/.gemini/config/mcp_config.json، أو من .agents/mcp_config.json داخل المشروع، ضمن mcpServers. وتذكر وثائقه أن الحقلين القديمين url وhttpUrl غير مدعومين. استخدم serverUrl مع https://essentras.com/api/mcp، ثم اكتب /mcp لفتح المدير. ولا تتطلب Essentras تسجيل دخول هناك أيضًا.

هل يستطيع Gemini CLI دفع تكلفة النشر؟▾

لا. تعيد quote_placements رابط checkout_url. تفتحه أنت، وتراجع السلة والإجمالي، ثم تأذن بالدفع بنفسك. يُخصم المبلغ من البطاقة عند تقديم الطلب، ويُسترد إذا لم يُنشر المحتوى أو لم يُلتزم بمدة التنفيذ.

هل يحتاج Gemini CLI إلى OAuth مع Essentras؟▾

لا. يبدأ Gemini CLI مسار OAuth عندما يرد الخادم بالرمز 401 Unauthorized، ويحتاج هذا المسار إلى متصفح محلي. Essentras عامة ولا تطلب أي بيانات اعتماد، فلا توجد خطوة متصفح ولا رمز مميز لحفظه.

حل المشكلات

تظهر Essentras بحالة DISCONNECTED في /mcp

تأكد من أنك استخدمت httpUrl وليس url، وأن عنوان URL هو بالضبط https://essentras.com/api/mcp. شغّل gemini mcp list لمعرفة تفاصيل الخطأ.

لا يظهر أي خطأ عند البدء

يُبقي Gemini CLI أخطاء اتصال MCP في الخلفية صامتة افتراضيًا ويعرض تلميحًا واحدًا. شغّل /mcp list أو gemini mcp list.

الخطأ 429 أو rate_limited

تسمح Essentras بـ 120 طلب MCP لكل IP في الدقيقة. انتظر نحو 60 ثانية ثم أعد المحاولة.

مرجع

وثائق Gemini CLI · تم التحقق في 2026-10-18
نقطة نهاية MCP · https://essentras.com/api/mcp
REST API وOpenAPI
دليل الوكيل (agents.md)

هل أنت مستعد لتسعير المنشورات الإعلامية والخدمات عبر Gemini CLI؟

ابحث في أكثر من 3,800 منفذ، وسعّر سلة أو خدمة، وسلّم المشتري رابط الدفع. دون حاجة إلى حساب.

تصفح الناشرين اقرأ agents.md