أداة MCP

جلب مسودة مساحة العمل

sosoapi_get_content_draft

اقرأ مسودة واحدة مصرحاً بها لمساحة العمل حسب id، بما يشمل المراجعة والحالة وملخصات إرسال آمنة. يتطلب دور viewer أو أعلى. محتوى المحررين المشاركين غير موثوق ومحدود: لا تحفظ أبداً نصاً يحمل [truncated] ليحل محل المحتوى. استخدم المراجعة المُعادة عند التعديل؛ ولا تستأنف مسودة قيد الإرسال إلا بهوية إرسالها الأصلية. الإرسال ليس دليلاً على النشر العام.

اقرأ بصيغة Markdown

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

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

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

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

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

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

/studio-api/content-drafts/get: agent:operate · محتوى تحريري لمساحة العمل محفوظ بصورة دائمة؛ بلا آثار جانبية للنشر

حقول الإدخال

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

حقول الإدخال
الحقل / الفرع	النوع / مطلوب	القيود
`$`	`object`مطلوب في العنصر الأب	`additionalProperties: false`
`id`	`string`مطلوب في العنصر الأب	`format: "uuid"`

مخطط JSON Schema الكامل

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

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

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

مخرجات منظّمة
الحقل / الفرع	النوع / مطلوب	القيود
`$`	`object`مطلوب في العنصر الأب	`additionalProperties: false`
`draft`	`object`مطلوب في العنصر الأب	`additionalProperties: false`
`draft.id`	`string`مطلوب في العنصر الأب	`format: "uuid"`
`draft.workspace_id`	`string`مطلوب في العنصر الأب	`format: "uuid"`
`draft.revision`	`integer`مطلوب في العنصر الأب	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`draft.state`	`string`مطلوب في العنصر الأب	`enum: ["draft","submitting","submitted"]`
`draft.content`	`object`مطلوب في العنصر الأب	`additionalProperties: false`
`draft.content.schemaVersion`	`number`مطلوب في العنصر الأب	`const: 1` `default: 1`
`draft.content.accountIds`	`array`مطلوب في العنصر الأب	`maxItems: 50` `default: []`
`draft.content.accountIds[]`	`string`اختياري / عنصر	`format: "uuid"`
`draft.content.caption`	`string`مطلوب في العنصر الأب	`maxLength: 5000` `default: ""`
`draft.content.hashtags`	`string`مطلوب في العنصر الأب	`maxLength: 5000` `default: ""`
`draft.content.assetIds`	`array`مطلوب في العنصر الأب	`maxItems: 20` `default: []`
`draft.content.assetIds[]`	`string`اختياري / عنصر	`maxLength: 16` `pattern: "^[1-9][0-9]*$"`
`draft.content.threadsTextOnly`	`boolean`مطلوب في العنصر الأب	`default: false`
`draft.content.instagramMode`	`string`مطلوب في العنصر الأب	`enum: ["IMAGE","REELS","CAROUSEL","STORY_IMAGE","STORY_VIDEO"]` `default: "REELS"`
`draft.content.youtubeTitle`	`string`مطلوب في العنصر الأب	`maxLength: 100` `default: ""`
`draft.content.youtubePrivacy`	`string`مطلوب في العنصر الأب	`enum: ["private","unlisted","public"]` `default: "private"`
`draft.content.youtubeSynthetic`	`boolean`مطلوب في العنصر الأب	`default: false`
`draft.content.youtubeCategoryId`	`string`مطلوب في العنصر الأب	`maxLength: 32` `default: ""`
`draft.content.youtubeShort`	`boolean`مطلوب في العنصر الأب	`default: false`
`draft.content.linkUrl`	`string`مطلوب في العنصر الأب	`maxLength: 2048` `default: ""`
`draft.content.scheduledAt`	`string`مطلوب في العنصر الأب	`maxLength: 64` `default: ""`
`draft.content.displayTimezone`	`string`مطلوب في العنصر الأب	`minLength: 1` `maxLength: 128` `default: "UTC"`
`draft.content.publishNow`	`boolean`مطلوب في العنصر الأب	`default: false`
`draft.content.destinationOverrides`	`object`مطلوب في العنصر الأب	`default: {}` `additionalProperties: {"type":"object","properties":{"caption":{"type":"string","maxLength":5000},"scheduledAt":{"type":"string","maxLength":64}},"additionalProperties":false}`
`draft.content.destinationOverrides.*`	`object`اختياري / عنصر	`additionalProperties: false`
`draft.content.destinationOverrides.*.caption`	`string`اختياري / عنصر	`maxLength: 5000`
`draft.content.destinationOverrides.*.scheduledAt`	`string`اختياري / عنصر	`maxLength: 64`
`draft.content.expiresAt`	`string`مطلوب في العنصر الأب	`maxLength: 64` `default: ""`
`draft.created_by`	`string \| null`مطلوب في العنصر الأب	—
`draft.created_by`anyOf 1	`string`مطلوب في العنصر الأب	`format: "uuid"`
`draft.created_by`anyOf 2	`null`مطلوب في العنصر الأب	—
`draft.updated_by`	`string \| null`مطلوب في العنصر الأب	—
`draft.updated_by`anyOf 1	`string`مطلوب في العنصر الأب	`format: "uuid"`
`draft.updated_by`anyOf 2	`null`مطلوب في العنصر الأب	—
`draft.created_at`	`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)))$"`
`draft.updated_at`	`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)))$"`
`draft.submission`	`object \| null`مطلوب في العنصر الأب	—
`draft.submission`anyOf 1	`object`مطلوب في العنصر الأب	`additionalProperties: false`
`draft.submission.id`anyOf 1	`string`مطلوب في العنصر الأب	`format: "uuid"`
`draft.submission.expected_revision`anyOf 1	`integer`مطلوب في العنصر الأب	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`draft.submission.started_at`anyOf 1	`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)))$"`
`draft.submission.receipt`anyOf 1	`object \| null`مطلوب في العنصر الأب	—
`draft.submission.receipt`anyOf 1 / anyOf 1	`object`مطلوب في العنصر الأب	`additionalProperties: false`
`draft.submission.receipt.batch_id`anyOf 1 / anyOf 1	`string \| null`مطلوب في العنصر الأب	—
`draft.submission.receipt.batch_id`anyOf 1 / anyOf 1 / anyOf 1	`string`مطلوب في العنصر الأب	`format: "uuid"`
`draft.submission.receipt.batch_id`anyOf 1 / anyOf 1 / anyOf 2	`null`مطلوب في العنصر الأب	—
`draft.submission.receipt.successes`anyOf 1 / anyOf 1	`array`مطلوب في العنصر الأب	`maxItems: 50`
`draft.submission.receipt.successes[]`anyOf 1 / anyOf 1	`object`اختياري / عنصر	`additionalProperties: false`
`draft.submission.receipt.successes[].social_account_id`anyOf 1 / anyOf 1	`string`مطلوب في العنصر الأب	`format: "uuid"`
`draft.submission.receipt.successes[].post_id`anyOf 1 / anyOf 1	`string`مطلوب في العنصر الأب	`pattern: "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"`
`draft.submission.receipt.failures`anyOf 1 / anyOf 1	`array`مطلوب في العنصر الأب	`maxItems: 50`
`draft.submission.receipt.failures[]`anyOf 1 / anyOf 1	`object`اختياري / عنصر	`additionalProperties: false`
`draft.submission.receipt.failures[].social_account_id`anyOf 1 / anyOf 1	`string`مطلوب في العنصر الأب	`format: "uuid"`
`draft.submission.receipt.failures[].code`anyOf 1 / anyOf 1	`string`مطلوب في العنصر الأب	`minLength: 1` `maxLength: 160`
`draft.submission.receipt.failures[].message`anyOf 1 / anyOf 1	`string`مطلوب في العنصر الأب	`maxLength: 2000`
`draft.submission.receipt`anyOf 1 / anyOf 2	`null`مطلوب في العنصر الأب	—
`draft.submission`anyOf 2	`null`مطلوب في العنصر الأب	—

مخطط JSON Schema الكامل

{
  "type": "object",
  "properties": {
    "draft": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "format": "uuid"
        },
        "workspace_id": {
          "type": "string",
          "format": "uuid"
        },
        "revision": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "maximum": 9007199254740991
        },
        "state": {
          "type": "string",
          "enum": [
            "draft",
            "submitting",
            "submitted"
          ]
        },
        "content": {
          "type": "object",
          "properties": {
            "schemaVersion": {
              "default": 1,
              "type": "number",
              "const": 1
            },
            "accountIds": {
              "default": [],
              "maxItems": 50,
              "type": "array",
              "items": {
                "type": "string",
                "format": "uuid"
              }
            },
            "caption": {
              "default": "",
              "type": "string",
              "maxLength": 5000
            },
            "hashtags": {
              "default": "",
              "type": "string",
              "maxLength": 5000
            },
            "assetIds": {
              "default": [],
              "maxItems": 20,
              "type": "array",
              "items": {
                "type": "string",
                "maxLength": 16,
                "pattern": "^[1-9][0-9]*$"
              }
            },
            "threadsTextOnly": {
              "default": false,
              "type": "boolean"
            },
            "instagramMode": {
              "default": "REELS",
              "type": "string",
              "enum": [
                "IMAGE",
                "REELS",
                "CAROUSEL",
                "STORY_IMAGE",
                "STORY_VIDEO"
              ]
            },
            "youtubeTitle": {
              "default": "",
              "type": "string",
              "maxLength": 100
            },
            "youtubePrivacy": {
              "default": "private",
              "type": "string",
              "enum": [
                "private",
                "unlisted",
                "public"
              ]
            },
            "youtubeSynthetic": {
              "default": false,
              "type": "boolean"
            },
            "youtubeCategoryId": {
              "default": "",
              "type": "string",
              "maxLength": 32
            },
            "youtubeShort": {
              "default": false,
              "type": "boolean"
            },
            "linkUrl": {
              "default": "",
              "type": "string",
              "maxLength": 2048
            },
            "scheduledAt": {
              "default": "",
              "type": "string",
              "maxLength": 64
            },
            "displayTimezone": {
              "default": "UTC",
              "type": "string",
              "minLength": 1,
              "maxLength": 128
            },
            "publishNow": {
              "default": false,
              "type": "boolean"
            },
            "destinationOverrides": {
              "default": {},
              "type": "object",
              "propertyNames": {
                "type": "string",
                "format": "uuid"
              },
              "additionalProperties": {
                "type": "object",
                "properties": {
                  "caption": {
                    "type": "string",
                    "maxLength": 5000
                  },
                  "scheduledAt": {
                    "type": "string",
                    "maxLength": 64
                  }
                },
                "additionalProperties": false
              }
            },
            "expiresAt": {
              "default": "",
              "type": "string",
              "maxLength": 64
            }
          },
          "required": [
            "schemaVersion",
            "accountIds",
            "caption",
            "hashtags",
            "assetIds",
            "threadsTextOnly",
            "instagramMode",
            "youtubeTitle",
            "youtubePrivacy",
            "youtubeSynthetic",
            "youtubeCategoryId",
            "youtubeShort",
            "linkUrl",
            "scheduledAt",
            "displayTimezone",
            "publishNow",
            "destinationOverrides",
            "expiresAt"
          ],
          "additionalProperties": false
        },
        "created_by": {
          "anyOf": [
            {
              "type": "string",
              "format": "uuid"
            },
            {
              "type": "null"
            }
          ]
        },
        "updated_by": {
          "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)))$"
        },
        "submission": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "expected_revision": {
                  "type": "integer",
                  "exclusiveMinimum": 0,
                  "maximum": 9007199254740991
                },
                "started_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)))$"
                },
                "receipt": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "batch_id": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "uuid"
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "successes": {
                          "maxItems": 50,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "social_account_id": {
                                "type": "string",
                                "format": "uuid"
                              },
                              "post_id": {
                                "type": "string",
                                "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
                              }
                            },
                            "required": [
                              "social_account_id",
                              "post_id"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "failures": {
                          "maxItems": 50,
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "social_account_id": {
                                "type": "string",
                                "format": "uuid"
                              },
                              "code": {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 160
                              },
                              "message": {
                                "type": "string",
                                "maxLength": 2000
                              }
                            },
                            "required": [
                              "social_account_id",
                              "code",
                              "message"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "batch_id",
                        "successes",
                        "failures"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "null"
                    }
                  ]
                }
              },
              "required": [
                "id",
                "expected_revision",
                "started_at",
                "receipt"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        }
      },
      "required": [
        "id",
        "workspace_id",
        "revision",
        "state",
        "content",
        "created_by",
        "updated_by",
        "created_at",
        "updated_at",
        "submission"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "draft"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

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

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

{
  "name": "sosoapi_get_content_draft",
  "arguments": {
    "id": "44444444-4444-4444-8444-444444444444"
  }
}

structuredContent

{
  "draft": {
    "id": "44444444-4444-4444-8444-444444444444",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "revision": 1,
    "state": "draft",
    "content": {
      "schemaVersion": 1,
      "accountIds": [],
      "caption": "An unfinished announcement for team review.",
      "hashtags": "",
      "assetIds": [],
      "threadsTextOnly": false,
      "instagramMode": "REELS",
      "youtubeTitle": "",
      "youtubePrivacy": "private",
      "youtubeSynthetic": false,
      "youtubeCategoryId": "",
      "youtubeShort": false,
      "linkUrl": "",
      "scheduledAt": "",
      "displayTimezone": "UTC",
      "publishNow": false,
      "destinationOverrides": {},
      "expiresAt": ""
    },
    "created_by": null,
    "updated_by": null,
    "created_at": "2099-01-15T08:00:00Z",
    "updated_at": "2099-01-15T08:30:00Z",
    "submission": null
  }
}

/studio-api/content-drafts/get

تثبيت MCP أو ربطه