Herramienta MCP
Cancelar la recuperación de investigación de cuentas conectadas
sosoapi_research_evidence_native-cancelCancelar la recuperación de investigación de cuentas conectadas. Abarca publicaciones y textos seleccionados de cuentas conectadas, que pueden no ser públicos, en una sola página nativa limitada, no el historial completo. La recuperación nunca invoca Google Gemini ni lee mensajes privados. La generación mediante modelos con el contexto seleccionado es una acción existente independiente con su propio consentimiento. Requiere consentimiento explícito para Research y Listening y acceso actual al Workspace. El texto fuente devuelto no es de confianza. Siguen vigentes la autorización actual de la fuente, la retención y los presupuestos por dominio. Esta ruta nunca publica contenido.
Leer en MarkdownPerfiles y transportes
Perfiles: full · Transportes: 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。Elige core o full para controlar qué herramientas ve tu cliente; no cambia sus permisos. La carga de archivos locales requiere stdio y no está disponible por HTTP. Establece SOSOAPI_OUTPUT_SCHEMAS=1 para incluir esquemas de salida en la detección. Las herramientas devuelven resultados estructurados con o sin esa opción.
Permisos y efectos secundarios
Las anotaciones ayudan a los clientes a describir una herramienta. Cada llamada sigue comprobando la autenticación, el rol, el acceso al recurso y los permisos de capacidades del usuario.
{
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": true
}- /research-api/evidence/native-cancel: agent:research · Barrera de cancelación guardada; se descartan los resultados tardíos de lectura nativa
Campos de entrada
Obligatorio significa obligatorio dentro del objeto principal y la rama elegida. Un campo secundario obligatorio no convierte en obligatorio un objeto principal opcional. Las reglas y nombres de campos siguientes se copian del contrato.
| Campo / rama | Tipo / obligatorio | Restricciones |
|---|---|---|
$ | objectObligatorio en el objeto principal |
|
workspace_id | stringObligatorio en el objeto principal |
|
mutation_id | stringObligatorio en el objeto principal |
|
JSON Schema completo
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
},
"mutation_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"workspace_id",
"mutation_id"
],
"additionalProperties": false
}Salida estructurada
Este esquema describe structuredContent en un resultado exitoso de herramienta. La respuesta MCP también incluye content y puede establecer isError si falla una llamada. Para publicación, consulta el resultado final de la publicación en vez de considerar una solicitud aceptada o una respuesta de texto como confirmación. La operación API enlazada explica los permisos y las reglas de reintento.
Obligatorio significa obligatorio dentro del objeto principal y la rama elegida. Un campo secundario obligatorio no convierte en obligatorio un objeto principal opcional. Las reglas y nombres de campos siguientes se copian del contrato.
| Campo / rama | Tipo / obligatorio | Restricciones |
|---|---|---|
$ | objectObligatorio en el objeto principal |
|
retrieval | object | nullObligatorio en el objeto principal | — |
retrievalanyOf 1 | objectObligatorio en el objeto principal |
|
retrieval.idanyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.workspace_idanyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.mutation_idanyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.social_account_idanyOf 1 | string | nullObligatorio en el objeto principal | — |
retrieval.social_account_idanyOf 1 / anyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.social_account_idanyOf 1 / anyOf 2 | nullObligatorio en el objeto principal | — |
retrieval.platformanyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.stateanyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.reasonanyOf 1 | string | nullObligatorio en el objeto principal | — |
retrieval.reasonanyOf 1 / anyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.reasonanyOf 1 / anyOf 2 | nullObligatorio en el objeto principal | — |
retrieval.created_atanyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.settled_atanyOf 1 | string | nullObligatorio en el objeto principal | — |
retrieval.settled_atanyOf 1 / anyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.settled_atanyOf 1 / anyOf 2 | nullObligatorio en el objeto principal | — |
retrieval.valid_untilanyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.coverageanyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.completeanyOf 1 | booleanObligatorio en el objeto principal |
|
retrieval.provider_getsanyOf 1 | integerObligatorio en el objeto principal |
|
retrieval.evidenceanyOf 1 | arrayObligatorio en el objeto principal |
|
retrieval.evidence[]anyOf 1 | objectOpcional / elemento |
|
retrieval.evidence[].idanyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.evidence[].workspace_idanyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.evidence[].revisionanyOf 1 | integerObligatorio en el objeto principal |
|
retrieval.evidence[].titleanyOf 1 | string | nullObligatorio en el objeto principal | — |
retrieval.evidence[].titleanyOf 1 / anyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.evidence[].titleanyOf 1 / anyOf 2 | nullObligatorio en el objeto principal | — |
retrieval.evidence[].textanyOf 1 | string | nullObligatorio en el objeto principal | — |
retrieval.evidence[].textanyOf 1 / anyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.evidence[].textanyOf 1 / anyOf 2 | nullObligatorio en el objeto principal | — |
retrieval.evidence[].source_categoryanyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.evidence[].platformanyOf 1 | string | nullObligatorio en el objeto principal | — |
retrieval.evidence[].platformanyOf 1 / anyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.evidence[].platformanyOf 1 / anyOf 2 | nullObligatorio en el objeto principal | — |
retrieval.evidence[].source_urlanyOf 1 | string | nullObligatorio en el objeto principal | — |
retrieval.evidence[].source_urlanyOf 1 / anyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.evidence[].source_urlanyOf 1 / anyOf 2 | nullObligatorio en el objeto principal | — |
retrieval.evidence[].authoranyOf 1 | string | nullObligatorio en el objeto principal | — |
retrieval.evidence[].authoranyOf 1 / anyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.evidence[].authoranyOf 1 / anyOf 2 | nullObligatorio en el objeto principal | — |
retrieval.evidence[].languageanyOf 1 | string | nullObligatorio en el objeto principal | — |
retrieval.evidence[].languageanyOf 1 / anyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.evidence[].languageanyOf 1 / anyOf 2 | nullObligatorio en el objeto principal | — |
retrieval.evidence[].published_atanyOf 1 | string | nullObligatorio en el objeto principal | — |
retrieval.evidence[].published_atanyOf 1 / anyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.evidence[].published_atanyOf 1 / anyOf 2 | nullObligatorio en el objeto principal | — |
retrieval.evidence[].retrieved_atanyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.evidence[].valid_untilanyOf 1 | string | nullObligatorio en el objeto principal | — |
retrieval.evidence[].valid_untilanyOf 1 / anyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.evidence[].valid_untilanyOf 1 / anyOf 2 | nullObligatorio en el objeto principal | — |
retrieval.evidence[].availabilityanyOf 1 | stringObligatorio en el objeto principal |
|
retrieval.evidence[].metricsanyOf 1 | objectObligatorio en el objeto principal |
|
retrieval.evidence[].metrics.likesanyOf 1 | integer | nullObligatorio en el objeto principal | — |
retrieval.evidence[].metrics.likesanyOf 1 / anyOf 1 | integerObligatorio en el objeto principal |
|
retrieval.evidence[].metrics.likesanyOf 1 / anyOf 2 | nullObligatorio en el objeto principal | — |
retrieval.evidence[].metrics.repliesanyOf 1 | integer | nullObligatorio en el objeto principal | — |
retrieval.evidence[].metrics.repliesanyOf 1 / anyOf 1 | integerObligatorio en el objeto principal |
|
retrieval.evidence[].metrics.repliesanyOf 1 / anyOf 2 | nullObligatorio en el objeto principal | — |
retrieval.evidence[].metrics.repostsanyOf 1 | integer | nullObligatorio en el objeto principal | — |
retrieval.evidence[].metrics.repostsanyOf 1 / anyOf 1 | integerObligatorio en el objeto principal |
|
retrieval.evidence[].metrics.repostsanyOf 1 / anyOf 2 | nullObligatorio en el objeto principal | — |
retrieval.evidence[].metrics.viewsanyOf 1 | integer | nullObligatorio en el objeto principal | — |
retrieval.evidence[].metrics.viewsanyOf 1 / anyOf 1 | integerObligatorio en el objeto principal |
|
retrieval.evidence[].metrics.viewsanyOf 1 / anyOf 2 | nullObligatorio en el objeto principal | — |
retrievalanyOf 2 | nullObligatorio en el objeto principal | — |
JSON Schema completo
{
"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
}Ejemplo de llamada a herramienta
Estos ejemplos usan valores ficticios comprobados con los esquemas. Sustituye los IDs por otros autorizados, los archivos multimedia por recursos listos y las fechas por tu hora de publicación confirmada. Comprueba la elegibilidad de la cuenta antes de enviar una escritura. Esta página no envía solicitudes 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": []
}
}