علامتك التجارية، من طرفك

قم بتنزيل واجهة سطر الأوامر (CLI) المستقلة، وافحصها، وقم بتعيين مفتاح واجهة برمجة التطبيقات (API) الخاص بك في البيئة. لا تقم بلصق مفتاح حقيقي في المطالبات المشتركة أو ارتكابه في مستودع. JSON هو الإخراج الافتراضي؛ استخدم Markdown لخطة عمل قابلة للقراءة.

# Download, then inspect the CLI before running it (Node 20+).
curl -fSLo mentionry.mjs https://mentionry.com/mentionry.mjs

# Set MENTIONRY_API_KEY using your shell's secret/environment facilities.
node mentionry.mjs work --url https://your-site.com/page
node mentionry.mjs history --url https://your-site.com/page
node mentionry.mjs reviews
node mentionry.mjs capabilities
node mentionry.mjs overview
node mentionry.mjs insights --area SEO --limit 10 --format markdown
node mentionry.mjs workspaces
node mentionry.mjs brief --url https://your-site.com/page --format markdown
node mentionry.mjs keywords --url https://your-site.com/page
node mentionry.mjs connections --url https://your-site.com/page --direction in
node mentionry.mjs results --days 30

استخدم معرف --workspace لعلامة تجارية مملوكة، و --limit 1..100 و --offset N لمتابعة nextOffset. استخدم --area SEO أو GEO أو كليهما. تقرأ الأوامر الموجزة صفحة واحدة وإجراءاتها؛ ولا تقوم بإنشاء أو نشر المحتوى.

استخدم عميلاً يدعم بروتوكول 2025-06-18 أو 2025-11-25 HTTP القابل للبث مع رؤوس حاملة. هذا مثال على التكوين؛ قد يكون لعميلك صيغة تخزين سرية خاصة به.

{
  "mcpServers": {
    "mentionry": {
      "type": "http",
      "url": "https://mentionry.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MENTIONRY_API_KEY"
      }
    }
  }
}

ابدأ بـ read_brand_overview، ثم read_actionable_insights. استخدم read_page_insights لعنوان URL المحدد. تظل أدوات البحث القديمة وأدوات الوكيل متاحة عبر tools/list وتحتفظ بحصصها الخاصة؛ تدعم واجهة سطر الأوامر أيضًا وظائف التحضير المطلوبة بشكل صريح.

استخدم OpenAPI للتكامل عبر HTTP، و سير عمل الوكيل للتنفيذ والتحقق، أو عينة خيالية بدون حساب. تكشف الخطط المدفوعة عن بيانات SEO/GEO المحفوظة الخاصة بها ضمن التغطية الحالية. العينات المجانية لا تؤدي إلى أي عمل من الموفر. اقرأ القدرات لمعرفة المخصصات الحالية؛ يتم جدولة التجميع ويشارك ميزانية لوحة التحكم. تفصل النتائج الأسئلة التي تسمي علامتك التجارية عن أسئلة الاكتشاف غير المسماة. يعيد العمل النسخ المقترحة المحفوظة والمقاطع المصدر؛ يعيد السجل عينات ترتيب قاعدة البيانات المؤرخة، مع الحفاظ على الأسواق. تتطلب المسودات مراجعة تحريرية ولا يتم تمييزها أبدًا على أنها تم نشرها تلقائيًا.

اقرأ الإجراءات للحصول على معرف إجراء محفوظ مؤهل، ثم قم بتقديم التحضير باستخدام مفتاح منع التكرار. استعلم عن معرف الوظيفة المُعاد. إعادة محاولة نفس المفتاح يعيد نفس الوظيفة؛ لا تنشئ مفتاحًا جديدًا لمجرد أن الاستجابة انتهت مهلتها. يشارك التحضير مسودتك ومخصصات الموفر، مع محاولة موفر واحدة و $0.02 كحد أقصى مخطط لكل طلب. تتم إعادة استخدام المسودات المكتملة الموجودة. يمكن إلغاء الوظائف المعلقة؛ لا يمكن للإلغاء قيد التشغيل أن يعد باسترداد أو إزالة قطعة أثرية. لا شيء ينشر صفحة عميل أو يرسل تواصلًا.

node mentionry.mjs actions
node mentionry.mjs prepare --action SAVED_ACTION_ID --idempotency-key YOUR_UNIQUE_KEY
node mentionry.mjs job --job JOB_ID
node mentionry.mjs cancel-job --job JOB_ID

HTTP: POST /api/v1/jobs للتحضير/الإلغاء، GET /api/v1/jobs?jobId=ID للحالة. MCP: prepare_page_changes، read_preparation_job، cancel_preparation_job. الإنشاء لديه حدود قائمة انتظار/يوم وفحوصات الأهلية الحالية. يتم الاحتفاظ بسجلات منع التكرار لمدة 90 أيام. قراءات الحالة لا تنفذ وظيفة أبدًا.

بعد تطبيق مسودة تمت مراجعتها، سجل معرف المستند الخاص بها، ووقت التطبيق الفعلي، ومفتاح منع تكرار ثابت. يقوم Mentionry بفحص الصفحة العامة الأصلية تلقائيًا. يسجل هذا إعلانك و HTML المرصود بشكل منفصل؛ ولا ينشر أو يثبت رفع الترتيب. GET للحالة لا يبدأ فحصًا أبدًا.

node mentionry.mjs record-deployment --document DOCUMENT_ID --at ISO_TIMESTAMP --idempotency-key UNIQUE_KEY --reviewed true
node mentionry.mjs deployments --deployment DEPLOYMENT_ID

HTTP: /api/v1/deployments. MCP: record_page_deployment و read_page_deployments. تنطبق الحدود المعلقة والمشتركة اليومية؛ لا توجد مكالمات موفر مدفوعة.

استخدم الحملة أو read_live_search_campaign لفحوصات سطح المكتب المحفوظة من Google، واقتراحات الكلمات الرئيسية لقاعدة البيانات، ومجموعات تداخل النتائج. تظل البلد واللغة والطوابع الزمنية والعمق المُعاد صريحًا. النتائج المفقودة غير معروفة، وليست في المرتبة صفر. تشترك الأهداف في مخصص مالك واحد عبر العلامات التجارية: Lite حتى 10 أسبوعيًا، Growth 30 يوميًا، Agency 75 يوميًا، تخضع لميزانية الموفر الحالية. المجاني يتضمن عينة محفوظة دائمة، مع 20 قراءات API محفوظة يوميًا ولا يوجد تجميع متكرر. قراءة الحملة لا تحدثها أبدًا.

node mentionry.mjs campaign
node mentionry.mjs campaign --url https://your-site.com/page

curl --get https://mentionry.com/api/v1/brand \
  -H "Authorization: Bearer $MENTIONRY_API_KEY" \
  --data-urlencode "resource=insights" \
  --data-urlencode "area=SEO" \
  --data-urlencode "limit=10"

GET /api/v1/brand يدعم resource=capabilities، overview، insights، pages، page، keywords، connections، results، workspaces، work، history، actions، campaign، performance أو reviews. تتطلب قراءات الصفحة والكلمة الرئيسية والاتصال عنوان URL. المعلمات الشائعة: workspace، area، limit، offset، days (reviews: 1..7؛ other resources: 1..90)، direction (in، out، both). تتضمن الاستجابات schemaVersion، وتغطية العينة، والطوابع الزمنية. تستخدم الأخطاء error.code ورسالة مع HTTP 400, 401, 403, 404, 429 أو 503. يتضمن 429 Retry-After. معدل قراءة البيانات المحفوظة: 120/ دقيقة لكل حساب فوترة.

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