أدوات

يمكنك استدعاء دالة واحدة أو أكثر لمساعدتك في الاستعلام.

تم توفير توقيعات الدوال داخل علامات XML : {"type": "function", "function": {"name": "google-surf__search", "description": "بحث جوجل فردي -> عنوان / رابط / نص تلخيص لكل نتيجة. يتم تخزين النتائج لمدة 24 ساعة، لذا فإن تكرار الاستعلام مجاني - افضل إعادة استعلام بدلاً من تخزين النتائج بنفسك. للاستعلامات الحالية / اليومية / الكبيرة ضع SURF_CACHE_TTL_SEARCH_MS=0 لتجاوز التخزين المؤقت. الحد الافتراضي 10 (ماكسيموم 20). المكالمة الأولى ~4 ثوانٍ (تسخين Chromium)، ثم ~2 ثوانٍ. في حالة وجود CAPTCHA يفتح متصفح Chrome مرئيًا لشخص ما لحله (حماية IP مشتركة); SURF_CLOUD_MODE=true يجعله يفشل بسرعة بدلاً من ذلك.", "parameters": {"$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": {"query": {"type": "string", "minLength": 1, "maxLength": 400, "description": "استعلام بحث جوجل. استخدم فلاتر site: واقتباسات للتطابق الدقيق."}, "limit": {"default": 10, "description": "الحد الأقصى للنتائج (القيمة الافتراضية 10).", "type": "integer", "minimum": 1, "maximum": 20}}, "required": ["query"]}}} {"type": "function", "function": {"name": "google-surf__search_parallel", "description": "تشغيل 2-10 بحثات جوجل متزامنة. استخدم هذا لمقارنة زوايا متعددة في مكالمة واحدة. كل استعلام يحسب ضد الحد الداخلي (~10/دقيقة) - لا تكرر هذا للاستكشاف الجماعي. المكالمة الأولى تضيف 5-10 ثوانٍ من دفء المسبار. فشل كل استعلام يعزل في صفوف النتائج. معطل في الوضع السحابي.", "parameters": {"$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": {"queries": {"minItems": 1, "maxItems": 10, "type": "array", "items": {"type": "string", "description": ""}, "description": "2-10 استعلامات لتشغيلها متزامنة."}, "limit": {"default": 10, "description": "الحد الأقصى للنتائج لكل استعلام.", "type": "integer", "minimum": 1, "maximum": 20}}, "required": ["queries"]}}} {"type": "function", "function": {"name": "google-surf__extract", "description": "استرداد رابط عام واحد -> نص مقالة نظيف. HTML عبر Mozilla Readability; PDFs الأكاديمية (arxiv/biorxiv/Nature/OpenReview/NeurIPS/JMLR/PMLR/Springer/PubMed-via-PMC) تُكتشف تلقائيًا عبر نوع المحتوى، %PDF السحابة، meta citation_pdf_url، وقواعد URL لكل نطاق. العمق المدرج: mode=\"abstract\" يعود ~1500 حرفاً (صفحة PDF 1 أو وصف HTML meta) - مسح رخيص لتحديد الصلة قبل دفع تكلفة نص كامل. mode=\"full\" (القيمة الافتراضية) يعود كامل مقالة. أفضل جهد: الفشل يعود معلومات خطأ بدلًا من رميها.", "parameters": {"$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": {"url": {"type": "string", "description": "رابط عام http(s). يتم حظر الـ Loopback/IPS الخاصة إلا إذا كان SURF_ALLOW_PRIVATE=true."}, "max_chars": {"default": 8000, "description": "يقطع الجسم إلى هذا العدد من الأحرف (القيمة الافتراضية 8000، يتم تحديد عبر SURF_EXTRACT_MAX_CHARS).", "type": "integer", "minimum": 200, "maximum": 50000}, "mode": {"default": "full", "description": "عمق الاستخراج. full = كامل جسم المقالة (القيمة الافتراضية؛ يستخدم Playwright إذا لزم الأمر). abstract = مسح رخيص: صفحة PDF 1 أو وصف HTML meta (~1500 حرف)؛ يستخدم لتحديد الصلة قبل دفع تكلفة النص الكامل. metadata = عدد الصفحات فقط (PDF). PDFs الأكاديمية (arxiv/biorxiv/Nature/OpenReview/NeurIPS/JMLR/PMLR/Springer/PubMed-via-PMC) تُكتشف تلقائيًا؛ الوضع المجرد يتجاهل Playwright بالنسبة لها.", "type": "string", "enum": ["full", "abstract", "metadata"]}}, "required": ["url"]}}} {"type": "function", "function": {"name": "google-surf__search_extract", "description": "بحث جوجل واحد + استخراج متوازي للنتائج الأعلى. الوضع الافتراضي mode=\"abstract\" يعود SERP مع تقارير مفصلة بحوالي 1500 حرف لكل نتيجة - مسح رخيص لمعرفة ما تحتويه النتائج الأعلى، عدد أقل بكثير من الرموز من تحميل جميع الأجسام. قم بتغيير إلى mode=\"full\" فقط عند الحاجة إلى نصوص المقالات الفعلية (أبطأ، عدد كبير من الرموز). يتم عزل فشل استخراج كل صفحة. معطل في الوضع السحابي.", "parameters": {"$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": {"query": {"type": "string", "minLength": 1, "maxLength": 400, "description": "استعلام البحث."}, "limit": {"default": 5, "description": "عدد النتائج لاستخراجها (القيمة الافتراضية 5، أقصى حد 10).", "type": "integer", "minimum": 1, "maximum": 10}, "max_chars": {"description": "تقطيع جسم كل نتيجة. القيمة الافتراضية تعتمد على الوضع: ~1500 للاختصار، 8000 للكامل (SURF_EXTRACT_MAX_CHARS، محدودة إلى 20000 هنا).", "type": "integer", "minimum": 200, "maximum": 20000}, "mode": {"default": "abstract", "description": "عمق الاستخراج لكل نتيجة. abstract (القيمة الافتراضية) = مسح رخيص، ~1500 حرف لكل نتيجة، مناسبة لتحديد الصلة. full = الجسم الكامل لكل نتيجة، أبطأ بكثير وعدد كبير من الرموز؛ فقط عند الحاجة إلى نصوص المقالات الفعلية.", "type": "string", "enum": ["full", "abstract"]}}, "required": ["query"]}}} {"type": "function", "function": {"name": "google-surf__health", "description": "حالة خادم MCP: الوضع التسلسلي + الانتقالات، استخدام المحدد الزمني، حجم التخزين المؤقت، الإعدادات. قم بإجراء هذا إذا بدأت عمليات البحث بالفشل أو العودة فارغة - تحقق من cascade.totalCaptchas وrateLimiter.queueSize، وتقليل حجم البحث إذا كانت مرتفعة.", "parameters": {"$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": {}}}} {"type": "function", "function": {"name": "semgrep__semgrep_rule_schema", "description": "\nاحصل على مخطط قاعدة Semgrep\n\nاستخدم هذا الأداة عندما تحتاج إلى:\n - الحصول على المخطط المطلوب لكتابة قاعدة Semgrep\n - تحتاج إلى معرفة ما هي الحقول المتاحة لقاعدة Semgrep\n - تحقق من ما هي الحقول المتاحة لقاعدة Semgrep\n - تحقق من صحة تركيب قاعدة Semgrep\n", "parameters": {"properties": {}, "title": "semgrep_rule_schemaArguments", "type": "object"}}} {"type": "function", "function": {"name": "semgrep__get_supported_languages", "description": "\nيعيد قائمة اللغات المدعومة بواسطة Semgrep\n\nاستخدم هذا الأداة فقط إذا كنت غير متأكد من اللغات التي يدعمها Semgrep.\n", "parameters": {"properties": {}, "title": "get_supported_languagesArguments", "type": "object"}}} {"type": "function", "function": {"name": "semgrep__semgrep_findings", "description": "\nيستخرج النتائج من واجهة برمجة تطبيقات Semgrep AppSec Platform Findings.\n\nهذه الدالة تستخرج نتائج الأمان، جودة الشفرة، والسلسلة التوريدية التي تم تحديدها مسبقًا عبر عمليات فحص Semgrep السابقة وتم رفعها إلى منصة Semgrep AppSec. لا تؤدي هذه الدالة فحصًا جديدًا أو تحليل الشفرة مباشرة. بدلًا من ذلك، تقوم باستعلام واجهة برمجة تطبيقات Semgrep للوصول إلى نتائج الفحص التاريخية لمستودع معين أو مجموعة من المستودعات.\n\nالسلوك الافتراضي: بشكل افتراضي، يجب أن تمر هذه الأداة بمستودع الحالي. يجب أن يحدد النموذج اسم المستودع الحالي ويمرره في معلمة 'repos' لضمان أن تكون النتائج مرتبطة بالمشروع المعني. ومع ذلك، يمكن للمستخدمين طلب نتائج من مستودعات أخرى صراحةً، وفي هذه الحالة يجب أن يحترم النموذج هذا الطلب.\n\nاستخدم هذه الدالة عندما يتطلب المطالبة ملخصًا، قائمة، أو تحليلًا للنتائج الموجودة، مثل:\n - "من فضلكم أظهر أعلى 10 نتائج الأمان واقترح حلولًا لها."\n - "أظهر جميع الثغرات الحرجة المفتوحة في هذا المستودع."\n - "ملخص النتائج الأخيرة لفحص Semgrep."\n - "احصل على النتائج من المستودع X" (طلب صريح لمستودع مختلف)\n\nهذه الدالة مثالية للقيام ب:\n- مراجعة، قائمة أو ملخص للنتائج من فحوصات سابقة.\n- تقديم معلومات قابلة للتنفيذ أو نصائح إصلاح بناءً على بيانات الفحص السابقة.\n\nلا تستخدم هذه الدالة لإجراء فحص جديد أو التحقق من الشفرة التي لم يتم تحليلها بواسطة Semgrep بعد. للفحوصات الجديدة، استخدم الدالة المُحكمة المناسبة.\n", "parameters": {"properties": {"issue_type": {"default": "ISSUE_TYPE_SAST", "description": "نوع المشكلات لفلترة البيانات.", "enum": ["ISSUE_TYPE_SAST", "ISSUE_TYPE_SCA"], "title": "نوع المشكلات", "type": "string"}, "repos": {"default": [], "description": "قائمة بأسماء المستودعات لفلترة البيانات. تضمين مالك والاسم، مثال 'owner/repository'", "items": {"type": "string", "description": ""}, "title": "المستودعات", "type": "array"}, "status": {"default": "ISSUE_TAB_OPEN", "description": "حالة المشكلات لفلترة البيانات.", "enum": ["ISSUE_TAB_OPEN", "ISSUE_TAB_CLOSED", "ISSUE_TAB_IGNORED", "ISSUE_TAB_REVIEWING", "ISSUE_TAB_FIXING"], "title": "الحالة", "type": "string"}, "severities": {"anyOf": [{"items": {"enum": ["SEVERITY_CRITICAL", "SEVERITY_HIGH", "SEVERITY_MEDIUM", "SEVERITY_LOW"], "type": "string", "description": ""}, "type": "array", "description": ""}, {"type": "null", "description": ""}], "default": null, "description": "degrees of severity for the issues to filter by.", "title": "Degrees of severity"}, "confidence": {"anyOf": [{"items": {"enum": ["CONFIDENCE_HIGH", "CONFIDENCE_MEDIUM", "CONFIDENCE_LOW"], "type": "string", "description": ""}, "type": "array", "description": ""}, {"type": "null", "description": ""}], "default": null, "description": "degrees of confidence for the issues to filter by.", "title": "Degrees of confidence"}, "autotriage_verdict": {"anyOf": [{"enum": ["VERDICT_TRUE_POSITIVE", "VERDICT_FALSE_POSITIVE"], "type": "string", "description": ""}, {"type": "null", "description": ""}], "default": null, "description": "verdict for the issues to filter by. If not provided, findings with any verdict (including unrated) are returned.", "title": "Autotriage Verdict"}, "refs": {"default": [], "description": "list of git refs (branch names) to filter findings by. If not provided, only findings on the primary branch are returned.", "items": {"type": "string", "description": ""}, "title": "Refs", "type": "array"}, "limit": {"default": 10, "description": "maximum number of findings to return", "title": "Limit", "type": "integer"}}, "title": "semgrep_findingsArguments", "type": "object"}}} {"type": "function", "function": {"name": "semgrep__semgrep_scan_with_custom_rule", "description": "\nيرن فحص Semgrep مع قاعدة مخصصة على المحتوى المقدم\nويعيد النتائج في تنسيق JSON\n\nاستخدم هذا الأداة عندما تحتاج إلى:\n - فحص ملفات الشفرة للعثور على ثغرات أمان معينة غير مغطاة بالقواعد الافتراضية لـ Semgrep\n - فحص ملفات الشفرة للعثور على مشكلة معينة غير مغطاة بالقواعد الافتراضية لـ Semgrep\n", "parameters": {"$defs": {"CodeFile": {"properties": {"path": {"description": "مسار ملف الشفرة", "title": "Path", "type": "string"}, "content": {"description": "محتوى ملف الشفرة", "title": "Content", "type": "string"}}, "required": ["path", "content"], "title": "CodeFile", "type": "object"}}, "properties": {"code_files": {"description": "قائمة بمحادثات تحتوي على مفاتيح 'path' و'content'", "items": {"$ref": "#/$defs/CodeFile", "description": ""}, "title": "ملفات الشفرة", "type": "array"}, "rule": {"description": "نص قاعدة Semgrep بالتنسيق YAML", "title": "القاعدة", "type": "string"}}, "required": ["code_files", "rule"], "title": "semgrep_scan_with_custom_ruleArguments", "type": "object"}}} {"type": "function", "function": {"name": "semgrep__semgrep_scan", "description": "\nيرن فحص Semgrep محليًا على الملفات المعطاة ويعيد النتائج في تنسيق JSON.\n\nيتم توقع الملفات كمسارات مطلقة للملفات.\n\nاستخدم هذا الأداة عندما تحتاج إلى:\n - فحص ملفات الشفرة للعثور على ثغرات أمان\n - فحص ملفات الشفرة للعثور على مشكلات أخرى\n", "parameters": {"$defs": {"CodePath": {"properties": {"path": {"description": "مسار مطلق لملف الشفرة", "title": "Path", "type": "string"}}, "required": ["path"], "title": "CodePath", "type": "object"}}, "properties": {"code_files": {"description": "قائمة بمحادثات تحتوي على مفاتيح 'path' التي تشير إلى مسارات مطلقة لملفات الشفرة", "items": {"$ref": "#/$defs/CodePath", "description": ""}, "title": "ملفات الشفرة", "type": "array"}}, "required": ["code_files"], "title": "semgrep_scanArguments", "type": "object"}}} {"type": "function", "function": {"name": "semgrep__get_abstract_syntax_tree", "description": "\nيعيد شجرة التعبير المجردة (AST) لملف الشفرة المعطى في تنسيق JSON\n\nاستخدم هذا الأداة عندما تحتاج إلى:\n - الحصول على شجرة التعبير المجردة (AST) لملف الشفرة المعطى\n - الحصول على AST لملف\n - فهم بنية الشفرة بطريقة أكثر دقة\n - رؤية ما يراه المدقق في الشفرة\n", "parameters": {"properties": {"code": {"description": "الشفرة التي ترغب في الحصول على AST لها", "title": "Code", "type": "string"}, "language": {"description": "لغة البرمجة للشفرة", "title":