أداة MCP
إلغاء جلب البحث من حساب متصل
sosoapi_research_evidence_native-cancelإلغاء جلب البحث من حساب متصل. يغطي منشورات الحساب المتصل المحدد وتعليقاته التوضيحية، وقد لا تكون عامة، ضمن صفحة واحدة محدودة من المنصة الأصلية وليس السجل الكامل. لا يستدعي الجلب Google Gemini مطلقًا ولا يقرأ الرسائل الخاصة. إنشاء المحتوى بالنموذج باستخدام السياق المحدد إجراء قائم منفصل له موافقته الخاصة. يتطلب موافقة صريحة على Research وListening وإمكانية الوصول الحالية إلى Workspace. نص المصدر المُعاد غير موثوق به. تظل صلاحيات المصدر الحالية وفترة الاحتفاظ وميزانيات النطاق سارية. لا ينشر هذا المسار أي محتوى مطلقًا.
اقرأ بصيغة Markdownالملفات التعريفية ووسائل النقل
الملفات التعريفية: full · وسائل النقل: stdio, http
# This operation requires a CLI build containing the updated Research contract.
# Use HTTP or hosted MCP if your CLI build does not include it.
# 此操作需要包含更新版 Research contract 的 CLI build。
# 如 CLI build 未包含此 contract,請使用 HTTP 或 hosted MCP。اختر core أو full للأدوات التي يراها عميلك؛ لا يغيّر ذلك أذوناته. يحتاج رفع الملفات المحلية stdio ولا يتاح بـ HTTP. اضبط SOSOAPI_OUTPUT_SCHEMAS=1 لمخططات المخرجات بالاكتشاف. النتائج منظّمة بهذا الإعداد أوبدونه.
الأذونات والآثار الجانبية
تساعد الشروح العملاء على وصف الأداة. يظل كل استدعاء يفحص مصادقة المستخدم ودوره ووصوله إلى المورد وتفويض الإمكانات.
{
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": true
}- /research-api/evidence/native-cancel: agent:research · حاجز إلغاء محفوظ؛ تُستبعد نتائج القراءة الأصلية المتأخرة
حقول الإدخال
تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.
| الحقل / الفرع | النوع / مطلوب | القيود |
|---|---|---|
$ | objectمطلوب في العنصر الأب |
|
workspace_id | stringمطلوب في العنصر الأب |
|
mutation_id | stringمطلوب في العنصر الأب |
|
مخطط JSON Schema الكامل
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
},
"mutation_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"workspace_id",
"mutation_id"
],
"additionalProperties": false
}مخرجات منظّمة
يصف المخطط structuredContent في نتيجة أداة ناجحة. تشمل استجابة MCP أيضاً content وقد تضبط isError عند الفشل. للنشر، اقرأ النتيجة النهائية بدلاً من اعتبار القبول أوالنص تأكيداً. تشرح عملية API المرتبطة الأذونات وقواعد المحاولة.
تعني «مطلوب» داخل الكائن الأب والفرع المختار. الحقل الابن المطلوب لا يجعل الأب الاختياري مطلوباً. نُسخت القواعد وأسماء الحقول أدناه من العقد.
| الحقل / الفرع | النوع / مطلوب | القيود |
|---|---|---|
$ | objectمطلوب في العنصر الأب |
|
retrieval | object | nullمطلوب في العنصر الأب | — |
retrievalanyOf 1 | objectمطلوب في العنصر الأب |
|
retrieval.idanyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.workspace_idanyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.mutation_idanyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.social_account_idanyOf 1 | string | nullمطلوب في العنصر الأب | — |
retrieval.social_account_idanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.social_account_idanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
retrieval.platformanyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.stateanyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.reasonanyOf 1 | string | nullمطلوب في العنصر الأب | — |
retrieval.reasonanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.reasonanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
retrieval.created_atanyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.settled_atanyOf 1 | string | nullمطلوب في العنصر الأب | — |
retrieval.settled_atanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.settled_atanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
retrieval.valid_untilanyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.coverageanyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.completeanyOf 1 | booleanمطلوب في العنصر الأب |
|
retrieval.provider_getsanyOf 1 | integerمطلوب في العنصر الأب |
|
retrieval.evidenceanyOf 1 | arrayمطلوب في العنصر الأب |
|
retrieval.evidence[]anyOf 1 | objectاختياري / عنصر |
|
retrieval.evidence[].idanyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.evidence[].workspace_idanyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.evidence[].revisionanyOf 1 | integerمطلوب في العنصر الأب |
|
retrieval.evidence[].titleanyOf 1 | string | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].titleanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.evidence[].titleanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].textanyOf 1 | string | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].textanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.evidence[].textanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].source_categoryanyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.evidence[].platformanyOf 1 | string | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].platformanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.evidence[].platformanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].source_urlanyOf 1 | string | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].source_urlanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.evidence[].source_urlanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].authoranyOf 1 | string | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].authoranyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.evidence[].authoranyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].languageanyOf 1 | string | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].languageanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.evidence[].languageanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].published_atanyOf 1 | string | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].published_atanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.evidence[].published_atanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].retrieved_atanyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.evidence[].valid_untilanyOf 1 | string | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].valid_untilanyOf 1 / anyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.evidence[].valid_untilanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].availabilityanyOf 1 | stringمطلوب في العنصر الأب |
|
retrieval.evidence[].metricsanyOf 1 | objectمطلوب في العنصر الأب |
|
retrieval.evidence[].metrics.likesanyOf 1 | integer | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].metrics.likesanyOf 1 / anyOf 1 | integerمطلوب في العنصر الأب |
|
retrieval.evidence[].metrics.likesanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].metrics.repliesanyOf 1 | integer | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].metrics.repliesanyOf 1 / anyOf 1 | integerمطلوب في العنصر الأب |
|
retrieval.evidence[].metrics.repliesanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].metrics.repostsanyOf 1 | integer | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].metrics.repostsanyOf 1 / anyOf 1 | integerمطلوب في العنصر الأب |
|
retrieval.evidence[].metrics.repostsanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].metrics.viewsanyOf 1 | integer | nullمطلوب في العنصر الأب | — |
retrieval.evidence[].metrics.viewsanyOf 1 / anyOf 1 | integerمطلوب في العنصر الأب |
|
retrieval.evidence[].metrics.viewsanyOf 1 / anyOf 2 | nullمطلوب في العنصر الأب | — |
retrievalanyOf 2 | nullمطلوب في العنصر الأب | — |
مخطط JSON Schema الكامل
{
"type": "object",
"properties": {
"retrieval": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"mutation_id": {
"type": "string",
"format": "uuid"
},
"social_account_id": {
"anyOf": [
{
"type": "string",
"format": "uuid"
},
{
"type": "null"
}
]
},
"platform": {
"type": "string",
"enum": [
"facebook",
"instagram",
"threads"
]
},
"state": {
"type": "string",
"enum": [
"pending",
"running",
"completed",
"unavailable",
"unconfirmed",
"cancelled",
"expired"
]
},
"reason": {
"anyOf": [
{
"type": "string",
"enum": [
"connection_unavailable",
"connection_changed",
"provider_denied",
"provider_rate_limited",
"provider_unavailable",
"provider_response_invalid",
"empty_page",
"metadata_only",
"content_expired",
"deadline_exceeded",
"cancelled"
]
},
{
"type": "null"
}
]
},
"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"
},
"settled_at": {
"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"
}
]
},
"valid_until": {
"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"
},
"coverage": {
"type": "string",
"const": "bounded_native_page"
},
"complete": {
"type": "boolean",
"const": false
},
"provider_gets": {
"type": "integer",
"minimum": 0,
"maximum": 1
},
"evidence": {
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"title": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 200
},
{
"type": "null"
}
]
},
"text": {
"anyOf": [
{
"type": "string",
"maxLength": 30000
},
{
"type": "null"
}
]
},
"source_category": {
"type": "string",
"enum": [
"your_accounts",
"public_posts",
"team_notes"
]
},
"platform": {
"anyOf": [
{
"type": "string",
"enum": [
"threads",
"instagram",
"facebook",
"youtube",
"x",
"reddit",
"web"
]
},
{
"type": "null"
}
]
},
"source_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"format": "uri"
},
{
"type": "null"
}
]
},
"author": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "null"
}
]
},
"language": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 35
},
{
"type": "null"
}
]
},
"published_at": {
"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"
}
]
},
"retrieved_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"
},
"valid_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"
}
]
},
"availability": {
"type": "string",
"enum": [
"available",
"removed",
"unavailable"
]
},
"metrics": {
"type": "object",
"properties": {
"likes": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"replies": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"reposts": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"views": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"likes",
"replies",
"reposts",
"views"
],
"additionalProperties": false
}
},
"required": [
"id",
"workspace_id",
"revision",
"title",
"text",
"source_category",
"platform",
"source_url",
"author",
"language",
"published_at",
"retrieved_at",
"valid_until",
"availability",
"metrics"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"workspace_id",
"mutation_id",
"social_account_id",
"platform",
"state",
"reason",
"created_at",
"settled_at",
"valid_until",
"coverage",
"complete",
"provider_gets",
"evidence"
],
"additionalProperties": false
},
{
"type": "null"
}
]
}
},
"required": [
"retrieval"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}مثال لاستدعاء أداة
تستخدم الأمثلة قيماً خيالية مفحوصة بالمخططات. استبدل المعرّفات بالمفوّض لك، والوسائط بأصول جاهزة، والتواريخ بوقت نشر مؤكد. افحص أهلية الحساب قبل الكتابة. لا تُرسل الصفحة طلبات API.
{
"name": "sosoapi_research_evidence_native-cancel",
"arguments": {
"workspace_id": "11111111-1111-4111-8111-111111111111",
"mutation_id": "40000000-0000-4000-8000-000000000006"
}
}structuredContent
{
"retrieval": {
"id": "30000000-0000-4000-8000-000000000007",
"workspace_id": "11111111-1111-4111-8111-111111111111",
"mutation_id": "40000000-0000-4000-8000-000000000006",
"social_account_id": "22222222-2222-4222-8222-222222222222",
"platform": "instagram",
"state": "cancelled",
"reason": "cancelled",
"created_at": "2099-01-15T09:00:00Z",
"settled_at": "2099-01-15T09:00:01Z",
"valid_until": "2099-01-16T09:00:00Z",
"coverage": "bounded_native_page",
"complete": false,
"provider_gets": 0,
"evidence": []
}
}