SosoAPI
AR
EN繁中繁體中文（台灣）简体中文日本語한국어DeutschFrançaisEspañolPortuguês (Brasil)العربيةעבריתNederlandsहिन्दीBahasa IndonesiaNorsk bokmålSvenskaMagyar
تسجيل الدخول

يُحمّل البحث عند استخدامه فقط. تصفّح جميع الفئات أدناه.

أداة MCP

جلب ملف المشروع

sosoapi_get_project_profile

قراءة ملف العلامة التجارية لمشروع (الشعار اللفظي والنبرة والجمهور المستهدف والأهداف ولوحة الألوان وغيرها)؛ يكون profile بقيمة null عند غيابه.

اقرأ بصيغة Markdown

الملفات التعريفية ووسائل النقل

الملفات التعريفية: full · وسائل النقل: stdio, http

اختر core أو full للأدوات التي يراها عميلك؛ لا يغيّر ذلك أذوناته. يحتاج رفع الملفات المحلية stdio ولا يتاح بـ HTTP. اضبط SOSOAPI_OUTPUT_SCHEMAS=1 لمخططات المخرجات بالاكتشاف. النتائج منظّمة بهذا الإعداد أوبدونه.

الأذونات والآثار الجانبية

تساعد الشروح العملاء على وصف الأداة. يظل كل استدعاء يفحص مصادقة المستخدم ودوره ووصوله إلى المورد وتفويض الإمكانات.

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": false
}

حقول الإدخال

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

حقول الإدخال
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
project_idstringمطلوب في العنصر الأب
  • format: "uuid"
مخطط JSON Schema الكامل
{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "project_id"
  ],
  "additionalProperties": false
}

مخرجات منظّمة

يصف المخطط structuredContent في نتيجة أداة ناجحة. تشمل استجابة MCP أيضاً content وقد تضبط isError عند الفشل. للنشر، اقرأ النتيجة النهائية بدلاً من اعتبار القبول أوالنص تأكيداً. تشرح عملية API المرتبطة الأذونات وقواعد المحاولة.

تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.

مخرجات منظّمة
الحقل / الفرعالنوع / مطلوبالقيود
$objectمطلوب في العنصر الأب
  • additionalProperties: false
contract_versionstringمطلوب في العنصر الأب
  • const: "project/v1"
profileobject | nullمطلوب في العنصر الأب—
profileanyOf 1objectمطلوب في العنصر الأب
  • additionalProperties: false
profile.project_idanyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
profile.workspace_idanyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
profile.taglineanyOf 1string | nullمطلوب في العنصر الأب—
profile.taglineanyOf 1 / anyOf 1stringمطلوب في العنصر الأب—
profile.taglineanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
profile.descriptionanyOf 1string | nullمطلوب في العنصر الأب—
profile.descriptionanyOf 1 / anyOf 1stringمطلوب في العنصر الأب—
profile.descriptionanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
profile.voiceanyOf 1string | nullمطلوب في العنصر الأب—
profile.voiceanyOf 1 / anyOf 1stringمطلوب في العنصر الأب—
profile.voiceanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
profile.target_audienceanyOf 1string | nullمطلوب في العنصر الأب—
profile.target_audienceanyOf 1 / anyOf 1stringمطلوب في العنصر الأب—
profile.target_audienceanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
profile.color_paletteanyOf 1arrayمطلوب في العنصر الأب—
profile.color_palette[]anyOf 1stringاختياري / عنصر—
profile.goalsanyOf 1arrayمطلوب في العنصر الأب—
profile.goals[]anyOf 1stringاختياري / عنصر—
profile.no_go_topicsanyOf 1arrayمطلوب في العنصر الأب—
profile.no_go_topics[]anyOf 1stringاختياري / عنصر—
profile.language_primaryanyOf 1stringمطلوب في العنصر الأب—
profile.positioninganyOf 1string | nullمطلوب في العنصر الأب—
profile.positioninganyOf 1 / anyOf 1stringمطلوب في العنصر الأب—
profile.positioninganyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
profile.uspanyOf 1string | nullمطلوب في العنصر الأب—
profile.uspanyOf 1 / anyOf 1stringمطلوب في العنصر الأب—
profile.uspanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
profile.visual_identityanyOf 1object | nullمطلوب في العنصر الأب—
profile.visual_identityanyOf 1 / anyOf 1objectمطلوب في العنصر الأب
  • additionalProperties: {}
profile.visual_identity.*anyOf 1 / anyOf 1any JSON valueاختياري / عنصر—
profile.visual_identityanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
profile.forbidden_claimsanyOf 1arrayمطلوب في العنصر الأب—
profile.forbidden_claims[]anyOf 1stringاختياري / عنصر—
profile.north_star_metricanyOf 1string | nullمطلوب في العنصر الأب—
profile.north_star_metricanyOf 1 / anyOf 1stringمطلوب في العنصر الأب—
profile.north_star_metricanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
profile.posting_cadenceanyOf 1object | nullمطلوب في العنصر الأب—
profile.posting_cadenceanyOf 1 / anyOf 1objectمطلوب في العنصر الأب
  • additionalProperties: {}
profile.posting_cadence.*anyOf 1 / anyOf 1any JSON valueاختياري / عنصر—
profile.posting_cadenceanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
profile.app_store_url_iosanyOf 1string | nullمطلوب في العنصر الأب—
profile.app_store_url_iosanyOf 1 / anyOf 1stringمطلوب في العنصر الأب—
profile.app_store_url_iosanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
profile.app_store_url_androidanyOf 1string | nullمطلوب في العنصر الأب—
profile.app_store_url_androidanyOf 1 / anyOf 1stringمطلوب في العنصر الأب—
profile.app_store_url_androidanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
profile.app_metadataanyOf 1objectمطلوب في العنصر الأب
  • additionalProperties: {}
profile.app_metadata.*anyOf 1any JSON valueاختياري / عنصر—
profile.profile_versionanyOf 1integerمطلوب في العنصر الأب
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
profile.updated_byanyOf 1string | nullمطلوب في العنصر الأب—
profile.updated_byanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
profile.updated_byanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
profile.updated_by_kindanyOf 1stringمطلوب في العنصر الأب
  • enum: ["jwt","api_key","delegated_ai","migration"]
profile.updated_by_api_key_idanyOf 1string | nullمطلوب في العنصر الأب—
profile.updated_by_api_key_idanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
profile.updated_by_api_key_idanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
profile.updated_by_delegated_grant_idanyOf 1string | nullمطلوب في العنصر الأب—
profile.updated_by_delegated_grant_idanyOf 1 / anyOf 1stringمطلوب في العنصر الأب
  • format: "uuid"
profile.updated_by_delegated_grant_idanyOf 1 / anyOf 2nullمطلوب في العنصر الأب—
profile.created_atanyOf 1stringمطلوب في العنصر الأب
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
profile.updated_atanyOf 1stringمطلوب في العنصر الأب
  • format: "date-time"
  • pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
profileanyOf 2nullمطلوب في العنصر الأب—
مخطط JSON Schema الكامل
{
  "type": "object",
  "properties": {
    "contract_version": {
      "type": "string",
      "const": "project/v1"
    },
    "profile": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "project_id": {
              "type": "string",
              "format": "uuid"
            },
            "workspace_id": {
              "type": "string",
              "format": "uuid"
            },
            "tagline": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "description": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "voice": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "target_audience": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "color_palette": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "goals": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "no_go_topics": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "language_primary": {
              "type": "string"
            },
            "positioning": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "usp": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "visual_identity": {
              "anyOf": [
                {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {}
                },
                {
                  "type": "null"
                }
              ]
            },
            "forbidden_claims": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "north_star_metric": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "posting_cadence": {
              "anyOf": [
                {
                  "type": "object",
                  "propertyNames": {
                    "type": "string"
                  },
                  "additionalProperties": {}
                },
                {
                  "type": "null"
                }
              ]
            },
            "app_store_url_ios": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "app_store_url_android": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "app_metadata": {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            "profile_version": {
              "type": "integer",
              "exclusiveMinimum": 0,
              "maximum": 9007199254740991
            },
            "updated_by": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ]
            },
            "updated_by_kind": {
              "type": "string",
              "enum": [
                "jwt",
                "api_key",
                "delegated_ai",
                "migration"
              ]
            },
            "updated_by_api_key_id": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ]
            },
            "updated_by_delegated_grant_id": {
              "anyOf": [
                {
                  "type": "string",
                  "format": "uuid"
                },
                {
                  "type": "null"
                }
              ]
            },
            "created_at": {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
            },
            "updated_at": {
              "type": "string",
              "format": "date-time",
              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
            }
          },
          "required": [
            "project_id",
            "workspace_id",
            "tagline",
            "description",
            "voice",
            "target_audience",
            "color_palette",
            "goals",
            "no_go_topics",
            "language_primary",
            "positioning",
            "usp",
            "visual_identity",
            "forbidden_claims",
            "north_star_metric",
            "posting_cadence",
            "app_store_url_ios",
            "app_store_url_android",
            "app_metadata",
            "profile_version",
            "updated_by",
            "updated_by_kind",
            "updated_by_api_key_id",
            "updated_by_delegated_grant_id",
            "created_at",
            "updated_at"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "contract_version",
    "profile"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

مثال لاستدعاء أداة

تستخدم الأمثلة قيماً خيالية مفحوصة بالمخططات. استبدل المعرّفات بالمفوّض لك، والوسائط بأصول جاهزة، والتواريخ بوقت نشر مؤكد. افحص أهلية الحساب قبل الكتابة. لا تُرسل الصفحة طلبات API.

{
  "name": "sosoapi_get_project_profile",
  "arguments": {
    "project_id": "11111111-1111-4111-8111-111111111111"
  }
}

structuredContent

{
  "contract_version": "project/v1",
  "profile": null
}
تثبيت MCP أو ربطه