MCP-tool
Het ophalen van een openbare bron op sociale media annuleren
sosoapi_research_evidence_social-cancelDe exacte ophaalactie voor sociale media annuleren via mutation_id; late inhoud kan niet worden opgeslagen. Teruggegeven brontekst is niet vertrouwd. Vereist agent:research.
Lezen als MarkdownProfielen en transporten
Profielen: full · Transporten: 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。Kies core of full om te bepalen welke tools je client ziet; dit verandert geen machtigingen. Lokale bestandsupload vereist stdio en is niet beschikbaar via HTTP. Stel SOSOAPI_OUTPUT_SCHEMAS=1 in om uitvoerschema's bij detectie op te nemen. Tools geven met en zonder die instelling gestructureerde resultaten terug.
Machtigingen en neveneffecten
Annotaties helpen clients een tool te beschrijven. Elke aanroep controleert nog steeds gebruikersauthenticatie, rol, resourcetoegang en verleende bevoegdheden.
{
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": true
}- /research-api/evidence/social-cancel: agent:research · Opgeslagen annuleringsgrens; late leesresultaten van sociale media worden verworpen
Invoervelden
Verplicht betekent verplicht binnen het bovenliggende object en de gekozen variant. Een verplicht onderliggend veld maakt een optioneel bovenliggend object niet verplicht. Onderstaande regels en veldnamen zijn uit het contract gekopieerd.
| Veld / variant | Type / verplicht | Beperkingen |
|---|---|---|
$ | objectVerplicht in bovenliggend object |
|
workspace_id | stringVerplicht in bovenliggend object |
|
mutation_id | stringVerplicht in bovenliggend object |
|
Volledig JSON Schema
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
},
"mutation_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"workspace_id",
"mutation_id"
],
"additionalProperties": false
}Gestructureerde uitvoer
Dit schema beschrijft structuredContent in een geslaagd toolresultaat. Het MCP-antwoord bevat ook content en kan isError instellen wanneer een aanroep mislukt. Lees bij publiceren het definitieve berichtresultaat; beschouw een geaccepteerd verzoek of tekstantwoord niet als bevestiging. De gekoppelde API-bewerking beschrijft machtigingen en regels voor opnieuw proberen.
Verplicht betekent verplicht binnen het bovenliggende object en de gekozen variant. Een verplicht onderliggend veld maakt een optioneel bovenliggend object niet verplicht. Onderstaande regels en veldnamen zijn uit het contract gekopieerd.
| Veld / variant | Type / verplicht | Beperkingen |
|---|---|---|
$ | objectVerplicht in bovenliggend object |
|
retrieval | objectVerplicht in bovenliggend object |
|
retrieval.id | stringVerplicht in bovenliggend object |
|
retrieval.workspace_id | stringVerplicht in bovenliggend object |
|
retrieval.mutation_id | stringVerplicht in bovenliggend object |
|
retrieval.kind | stringVerplicht in bovenliggend object |
|
retrieval.state | stringVerplicht in bovenliggend object |
|
retrieval.created_at | stringVerplicht in bovenliggend object |
|
retrieval.settled_at | string | nullVerplicht in bovenliggend object | — |
retrieval.settled_atanyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.settled_atanyOf 2 | nullVerplicht in bovenliggend object | — |
retrieval.valid_until | stringVerplicht in bovenliggend object |
|
retrieval.result | object | nullVerplicht in bovenliggend object | — |
retrieval.resultanyOf 1 | objectVerplicht in bovenliggend object |
|
retrieval.result.sourceanyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.platformanyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.canonical_urlanyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.fetched_atanyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.expires_atanyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.upstream_updated_atanyOf 1 | nullVerplicht in bovenliggend object | — |
retrieval.result.statusanyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.profileanyOf 1 | object | nullVerplicht in bovenliggend object | — |
retrieval.result.profileanyOf 1 / anyOf 1 | objectVerplicht in bovenliggend object |
|
retrieval.result.profile.source_account_idanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.profile.id_namespaceanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.profile.usernameanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.profile.nameanyOf 1 / anyOf 1 | string | nullVerplicht in bovenliggend object | — |
retrieval.result.profile.nameanyOf 1 / anyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.profile.nameanyOf 1 / anyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
retrieval.result.profile.followersanyOf 1 / anyOf 1 | integer | nullVerplicht in bovenliggend object | — |
retrieval.result.profile.followersanyOf 1 / anyOf 1 / anyOf 1 | integerVerplicht in bovenliggend object |
|
retrieval.result.profile.followersanyOf 1 / anyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
retrieval.result.profileanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
retrieval.result.postsanyOf 1 | arrayVerplicht in bovenliggend object |
|
retrieval.result.posts[]anyOf 1 | objectOptioneel / item |
|
retrieval.result.posts[].source_post_idanyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.posts[].id_namespaceanyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.posts[].shortcodeanyOf 1 | string | nullVerplicht in bovenliggend object | — |
retrieval.result.posts[].shortcodeanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.posts[].shortcodeanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
retrieval.result.posts[].source_account_idanyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.posts[].authoranyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.posts[].canonical_urlanyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.posts[].textanyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.posts[].published_atanyOf 1 | string | nullVerplicht in bovenliggend object | — |
retrieval.result.posts[].published_atanyOf 1 / anyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.posts[].published_atanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
retrieval.result.posts[].media_kindanyOf 1 | stringVerplicht in bovenliggend object |
|
retrieval.result.posts[].metricsanyOf 1 | objectVerplicht in bovenliggend object |
|
retrieval.result.posts[].metrics.likesanyOf 1 | integer | nullVerplicht in bovenliggend object | — |
retrieval.result.posts[].metrics.likesanyOf 1 / anyOf 1 | integerVerplicht in bovenliggend object |
|
retrieval.result.posts[].metrics.likesanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
retrieval.result.posts[].metrics.commentsanyOf 1 | integer | nullVerplicht in bovenliggend object | — |
retrieval.result.posts[].metrics.commentsanyOf 1 / anyOf 1 | integerVerplicht in bovenliggend object |
|
retrieval.result.posts[].metrics.commentsanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
retrieval.result.posts[].metrics.reactionsanyOf 1 | integer | nullVerplicht in bovenliggend object | — |
retrieval.result.posts[].metrics.reactionsanyOf 1 / anyOf 1 | integerVerplicht in bovenliggend object |
|
retrieval.result.posts[].metrics.reactionsanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
retrieval.result.posts[].metrics.sharesanyOf 1 | integer | nullVerplicht in bovenliggend object | — |
retrieval.result.posts[].metrics.sharesanyOf 1 / anyOf 1 | integerVerplicht in bovenliggend object |
|
retrieval.result.posts[].metrics.sharesanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
retrieval.result.posts[].metrics.viewsanyOf 1 | integer | nullVerplicht in bovenliggend object | — |
retrieval.result.posts[].metrics.viewsanyOf 1 / anyOf 1 | integerVerplicht in bovenliggend object |
|
retrieval.result.posts[].metrics.viewsanyOf 1 / anyOf 2 | nullVerplicht in bovenliggend object | — |
retrieval.result.coverageanyOf 1 | objectVerplicht in bovenliggend object |
|
retrieval.result.coverage.completeanyOf 1 | booleanVerplicht in bovenliggend object |
|
retrieval.result.coverage.reasonsanyOf 1 | arrayVerplicht in bovenliggend object |
|
retrieval.result.coverage.reasons[]anyOf 1 | stringOptioneel / item |
|
retrieval.result.coverage.omitted_rowsanyOf 1 | integerVerplicht in bovenliggend object |
|
retrieval.result.coverage.next_cursoranyOf 1 | nullVerplicht in bovenliggend object | — |
retrieval.resultanyOf 2 | nullVerplicht in bovenliggend object | — |
retrieval.evidence | arrayVerplicht in bovenliggend object |
|
retrieval.evidence[] | objectOptioneel / item |
|
retrieval.evidence[].evidence_id | stringVerplicht in bovenliggend object |
|
retrieval.evidence[].revision | integerVerplicht in bovenliggend object |
|
Volledig JSON Schema
{
"type": "object",
"properties": {
"retrieval": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"workspace_id": {
"type": "string",
"format": "uuid"
},
"mutation_id": {
"type": "string",
"format": "uuid"
},
"kind": {
"type": "string",
"const": "public_social"
},
"state": {
"type": "string",
"enum": [
"pending",
"running",
"completed",
"cancelled",
"unconfirmed",
"expired"
]
},
"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"
},
"result": {
"anyOf": [
{
"type": "object",
"properties": {
"source": {
"type": "string",
"enum": [
"facebook_public_web",
"instagram_public_web",
"threads_public_web"
]
},
"platform": {
"type": "string",
"enum": [
"facebook",
"instagram",
"threads"
]
},
"canonical_url": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"fetched_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"
},
"expires_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"
},
"upstream_updated_at": {
"type": "null"
},
"status": {
"type": "string",
"enum": [
"available",
"partial",
"unavailable"
]
},
"profile": {
"anyOf": [
{
"type": "object",
"properties": {
"source_account_id": {
"type": "string",
"pattern": "^[0-9]{1,30}$"
},
"id_namespace": {
"type": "string",
"const": "public_web"
},
"username": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"name": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 200
},
{
"type": "null"
}
]
},
"followers": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"source_account_id",
"id_namespace",
"username",
"name",
"followers"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"posts": {
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"source_post_id": {
"type": "string",
"pattern": "^[0-9]{1,30}$"
},
"id_namespace": {
"type": "string",
"const": "public_web"
},
"shortcode": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"maxLength": 64
},
{
"type": "null"
}
]
},
"source_account_id": {
"type": "string",
"pattern": "^[0-9]{1,30}$"
},
"author": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"canonical_url": {
"type": "string",
"maxLength": 2048,
"format": "uri"
},
"text": {
"type": "string",
"maxLength": 30000
},
"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"
}
]
},
"media_kind": {
"type": "string",
"enum": [
"text",
"image",
"video",
"carousel",
"unknown"
]
},
"metrics": {
"type": "object",
"properties": {
"likes": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"comments": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"reactions": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"shares": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"views": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
}
},
"required": [
"likes",
"comments",
"reactions",
"shares",
"views"
],
"additionalProperties": false
}
},
"required": [
"source_post_id",
"id_namespace",
"shortcode",
"source_account_id",
"author",
"canonical_url",
"text",
"published_at",
"media_kind",
"metrics"
],
"additionalProperties": false
}
},
"coverage": {
"type": "object",
"properties": {
"complete": {
"type": "boolean",
"const": false
},
"reasons": {
"maxItems": 20,
"type": "array",
"items": {
"type": "string",
"enum": [
"initial_page_only",
"public_web_ids",
"metrics_unavailable",
"profile_only",
"no_attributable_posts",
"foreign_or_malformed_rows",
"parser_limit",
"unsupported_payload",
"blocked",
"rate_limited",
"upstream_http_error",
"redirect_rejected",
"unsupported_content_type",
"response_too_large",
"timeout",
"aborted",
"network_error",
"inconsistent_identity",
"research_limit",
"source_removed"
]
}
},
"omitted_rows": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"next_cursor": {
"type": "null"
}
},
"required": [
"complete",
"reasons",
"omitted_rows",
"next_cursor"
],
"additionalProperties": false
}
},
"required": [
"source",
"platform",
"canonical_url",
"fetched_at",
"expires_at",
"upstream_updated_at",
"status",
"profile",
"posts",
"coverage"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"evidence": {
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"evidence_id": {
"type": "string",
"format": "uuid"
},
"revision": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"evidence_id",
"revision"
],
"additionalProperties": false
}
}
},
"required": [
"id",
"workspace_id",
"mutation_id",
"kind",
"state",
"created_at",
"settled_at",
"valid_until",
"result",
"evidence"
],
"additionalProperties": false
}
},
"required": [
"retrieval"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}Voorbeeld van een toolaanroep
Deze voorbeelden gebruiken fictieve waarden die tegen de schema's zijn gecontroleerd. Vervang IDs door toegestane IDs, media door gereedstaande bestanden en datums door je bevestigde publicatietijd. Controleer accountgeschiktheid vóór een schrijfhandeling. Deze pagina verstuurt geen API-verzoeken.
{
"name": "sosoapi_research_evidence_social-cancel",
"arguments": {
"workspace_id": "11111111-1111-4111-8111-111111111111",
"mutation_id": "40000000-0000-4000-8000-000000000005"
}
}structuredContent
{
"retrieval": {
"id": "30000000-0000-4000-8000-000000000007",
"workspace_id": "11111111-1111-4111-8111-111111111111",
"mutation_id": "40000000-0000-4000-8000-000000000005",
"kind": "public_social",
"state": "cancelled",
"created_at": "2099-01-15T09:00:00Z",
"settled_at": "2099-01-15T09:00:01Z",
"valid_until": "2099-01-16T09:00:00Z",
"evidence": [],
"result": null
}
}