أداة MCP

البحث عن مشاريع بحث

sosoapi_research_projects_query

البحث عن مشاريع بحث مع ترقيم صفحات UUID؛ لا تحتوي العناصر المحفوظة غير المتاحة على نص قديم. يتطلب agent:research.

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

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

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

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

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

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

/research-api/projects/query: agent:research · بيانات مورد البحث الدقيقة المصرح بها حاليًا

حقول الإدخال

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

حقول الإدخال
الحقل / الفرع	النوع / مطلوب	القيود
`$`	`object`مطلوب في العنصر الأب	`additionalProperties: false`
`workspace_id`	`string`مطلوب في العنصر الأب	`format: "uuid"`
`query`	`string`اختياري / عنصر	`maxLength: 200`
`archived`	`boolean`اختياري / عنصر	—
`cursor`	`string`اختياري / عنصر	المتابعة بعد UUID سجل البحث هذا بترتيب UUID تصاعدي؛ تشمل العلامة خانات المكتبة غير المتاحة. `format: "uuid"`
`limit`	`integer`اختياري / عنصر	`minimum: 1` `maximum: 50`

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

{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "query": {
      "type": "string",
      "maxLength": 200
    },
    "archived": {
      "type": "boolean"
    },
    "cursor": {
      "description": "Continue after this Research record UUID in ascending UUID order; the marker includes unavailable library slots.",
      "type": "string",
      "format": "uuid"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "workspace_id"
  ],
  "additionalProperties": false
}

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

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

مخرجات منظّمة
الحقل / الفرع	النوع / مطلوب	القيود
`$`	`object`مطلوب في العنصر الأب	`additionalProperties: false`
`items`	`array`مطلوب في العنصر الأب	`maxItems: 50`
`items[]`	`object`اختياري / عنصر	`additionalProperties: false`
`items[].id`	`string`مطلوب في العنصر الأب	`format: "uuid"`
`items[].workspace_id`	`string`مطلوب في العنصر الأب	`format: "uuid"`
`items[].revision`	`integer`مطلوب في العنصر الأب	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`items[].archived`	`boolean`مطلوب في العنصر الأب	—
`items[].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)))$"`
`items[].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)))$"`
`items[].content`	`object`مطلوب في العنصر الأب	`additionalProperties: false`
`items[].content.title`	`string`مطلوب في العنصر الأب	`minLength: 1` `maxLength: 200`
`items[].content.question`	`string`مطلوب في العنصر الأب	`minLength: 1` `maxLength: 2000`
`items[].content.purpose`	`string`مطلوب في العنصر الأب	`maxLength: 1000`
`items[].content.audience`	`string`مطلوب في العنصر الأب	`maxLength: 2000`
`items[].content.brands`	`array`مطلوب في العنصر الأب	`maxItems: 20`
`items[].content.brands[]`	`object`اختياري / عنصر	`additionalProperties: false`
`items[].content.brands[].id`	`string`مطلوب في العنصر الأب	`format: "uuid"`
`items[].content.brands[].name`	`string`مطلوب في العنصر الأب	`minLength: 1` `maxLength: 100`
`items[].content.brands[].terms`	`array`مطلوب في العنصر الأب	`minItems: 1` `maxItems: 20`
`items[].content.brands[].terms[]`	`string`اختياري / عنصر	`minLength: 1` `maxLength: 100`
`items[].content.scope`	`object`مطلوب في العنصر الأب	`additionalProperties: false`
`items[].content.scope.query`	`string`مطلوب في العنصر الأب	`maxLength: 2000`
`items[].content.scope.excluded_terms`	`array`مطلوب في العنصر الأب	`maxItems: 50`
`items[].content.scope.excluded_terms[]`	`string`اختياري / عنصر	`minLength: 1` `maxLength: 100`
`items[].content.scope.platforms`	`array`مطلوب في العنصر الأب	`maxItems: 7`
`items[].content.scope.platforms[]`	`string`اختياري / عنصر	`enum: ["threads","instagram","facebook","youtube","x","reddit","web"]`
`items[].content.scope.source_categories`	`array`مطلوب في العنصر الأب	`minItems: 1` `maxItems: 3`
`items[].content.scope.source_categories[]`	`string`اختياري / عنصر	`enum: ["your_accounts","public_posts","team_notes"]`
`items[].content.scope.languages`	`array`مطلوب في العنصر الأب	`maxItems: 18`
`items[].content.scope.languages[]`	`string`اختياري / عنصر	`minLength: 1` `maxLength: 35`
`items[].content.scope.since`	`string \| null`مطلوب في العنصر الأب	—
`items[].content.scope.since`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)))$"`
`items[].content.scope.since`anyOf 2	`null`مطلوب في العنصر الأب	—
`items[].content.scope.until`	`string \| null`مطلوب في العنصر الأب	—
`items[].content.scope.until`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)))$"`
`items[].content.scope.until`anyOf 2	`null`مطلوب في العنصر الأب	—
`unavailable_items`	`array`مطلوب في العنصر الأب	`maxItems: 50` `default: []`
`unavailable_items[]`	`object`اختياري / عنصر	`additionalProperties: false`
`unavailable_items[].id`	`string`مطلوب في العنصر الأب	`format: "uuid"`
`unavailable_items[].workspace_id`	`string`مطلوب في العنصر الأب	`format: "uuid"`
`unavailable_items[].revision`	`integer`مطلوب في العنصر الأب	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`unavailable_items[].archived`	`boolean`مطلوب في العنصر الأب	—
`unavailable_items[].availability`	`string`مطلوب في العنصر الأب	`const: "dependency_unavailable"`
`next_cursor`	`string \| null`مطلوب في العنصر الأب	UUID آخر سجل مستهلك عبر items وunavailable_items عند وجود خانة أخرى؛ null عند النهاية. —
`next_cursor`anyOf 1	`string`مطلوب في العنصر الأب	`format: "uuid"`
`next_cursor`anyOf 2	`null`مطلوب في العنصر الأب	—

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

{
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "workspace_id": {
            "type": "string",
            "format": "uuid"
          },
          "revision": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "archived": {
            "type": "boolean"
          },
          "created_at": {
            "type": "string",
            "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)))$",
            "format": "date-time"
          },
          "updated_at": {
            "type": "string",
            "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)))$",
            "format": "date-time"
          },
          "content": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string",
                "minLength": 1,
                "maxLength": 200
              },
              "question": {
                "type": "string",
                "minLength": 1,
                "maxLength": 2000
              },
              "purpose": {
                "type": "string",
                "maxLength": 1000
              },
              "audience": {
                "type": "string",
                "maxLength": 2000
              },
              "brands": {
                "maxItems": 20,
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string",
                      "format": "uuid"
                    },
                    "name": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    },
                    "terms": {
                      "minItems": 1,
                      "maxItems": 20,
                      "type": "array",
                      "items": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      }
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "terms"
                  ],
                  "additionalProperties": false
                }
              },
              "scope": {
                "type": "object",
                "properties": {
                  "query": {
                    "type": "string",
                    "maxLength": 2000
                  },
                  "excluded_terms": {
                    "maxItems": 50,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 100
                    }
                  },
                  "platforms": {
                    "maxItems": 7,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "threads",
                        "instagram",
                        "facebook",
                        "youtube",
                        "x",
                        "reddit",
                        "web"
                      ]
                    }
                  },
                  "source_categories": {
                    "minItems": 1,
                    "maxItems": 3,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "your_accounts",
                        "public_posts",
                        "team_notes"
                      ]
                    }
                  },
                  "languages": {
                    "maxItems": 18,
                    "type": "array",
                    "items": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 35
                    }
                  },
                  "since": {
                    "anyOf": [
                      {
                        "type": "string",
                        "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)))$",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "until": {
                    "anyOf": [
                      {
                        "type": "string",
                        "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)))$",
                        "format": "date-time"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  }
                },
                "required": [
                  "query",
                  "excluded_terms",
                  "platforms",
                  "source_categories",
                  "languages",
                  "since",
                  "until"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "title",
              "question",
              "purpose",
              "audience",
              "brands",
              "scope"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "id",
          "workspace_id",
          "revision",
          "archived",
          "created_at",
          "updated_at",
          "content"
        ],
        "additionalProperties": false
      }
    },
    "unavailable_items": {
      "default": [],
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "workspace_id": {
            "type": "string",
            "format": "uuid"
          },
          "revision": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "archived": {
            "type": "boolean"
          },
          "availability": {
            "type": "string",
            "const": "dependency_unavailable"
          }
        },
        "required": [
          "id",
          "workspace_id",
          "revision",
          "archived",
          "availability"
        ],
        "additionalProperties": false
      }
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid"
        },
        {
          "type": "null"
        }
      ],
      "description": "Last consumed record UUID across items and unavailable_items when another slot exists; null at the end."
    }
  },
  "required": [
    "items",
    "unavailable_items",
    "next_cursor"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

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

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

{
  "name": "sosoapi_research_projects_query",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111"
  }
}

structuredContent

{
  "items": [],
  "unavailable_items": [],
  "next_cursor": null
}

/research-api/projects/query

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

تفضيلات الخصوصية

الوظائف الضرورية

تحليلات الاستخدام الاختيارية

السماح أيضاً بتسجيل الجلسات لإعادة عرضها على هذا الموقع العام

البحث عن مشاريع بحث

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

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

حقول الإدخال

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

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

structuredContent

البحث عن مشاريع بحث

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

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

حقول الإدخال

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

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

structuredContent

عمليات API الأساسية