MCP-verktøy
Avbryt forskningshenting fra tilknyttede kontoer
sosoapi_research_evidence_native-cancelAvbryt forskningshenting fra tilknyttede kontoer. Omfatter utvalgte innlegg og bildetekster fra tilknyttede kontoer, som kan være ikke-offentlige, på én avgrenset side fra plattformen, ikke hele historikken. Hentingen kaller aldri Google Gemini og leser ikke direktemeldinger. Modellgenerering med valgt kontekst er en separat eksisterende handling med eget samtykke. Krever uttrykkelig samtykke til Research og Listening og gjeldende tilgang til Workspace. Returnert kildetekst er ikke betrodd. Gjeldende kildeautorisasjon, oppbevaring og domenebudsjetter gjelder fortsatt. Denne ruten publiserer aldri innhold.
Les som MarkdownProfiler og transporter
Profiler: full · Transporter: 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。Velg core eller full for å kontrollere hvilke verktøy klienten ser; dette endrer ikke tillatelsene. Lokal filopplasting krever stdio og er utilgjengelig over HTTP. Angi SOSOAPI_OUTPUT_SCHEMAS=1 for å inkludere utdataskjemaer i oppdagelsen. Verktøy returnerer strukturerte resultater med eller uten den innstillingen.
Tillatelser og sideeffekter
Merknader hjelper klienter med å beskrive et verktøy. Hvert kall kontrollerer fortsatt brukerens autentisering, rolle, ressurstilgang og funksjonstillatelser.
{
"readOnlyHint": false,
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": true
}- /research-api/evidence/native-cancel: agent:research · Lagret avbrytingsgrense; forsinkede leseresultater fra plattformen forkastes
Inndatafelter
Påkrevd betyr påkrevd i foreldreobjektet og valgt gren. Et påkrevd underfelt gjør ikke en valgfri forelder påkrevd. Reglene og feltnavnene nedenfor er kopiert fra kontrakten.
| Felt / gren | Type / påkrevd | Begrensninger |
|---|---|---|
$ | objectPåkrevd i forelder |
|
workspace_id | stringPåkrevd i forelder |
|
mutation_id | stringPåkrevd i forelder |
|
Fullstendig JSON Schema
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
},
"mutation_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"workspace_id",
"mutation_id"
],
"additionalProperties": false
}Strukturert utdata
Dette skjemaet beskriver structuredContent i et vellykket verktøyresultat. MCP-svaret inkluderer også content og kan sette isError når et kall mislykkes. Ved publisering, les innleggets endelige resultat i stedet for å regne en akseptert forespørsel eller et tekstsvar som bekreftelse. Den lenkede API-operasjonen forklarer tillatelser og regler for nye forsøk.
Påkrevd betyr påkrevd i foreldreobjektet og valgt gren. Et påkrevd underfelt gjør ikke en valgfri forelder påkrevd. Reglene og feltnavnene nedenfor er kopiert fra kontrakten.
| Felt / gren | Type / påkrevd | Begrensninger |
|---|---|---|
$ | objectPåkrevd i forelder |
|
retrieval | object | nullPåkrevd i forelder | — |
retrievalanyOf 1 | objectPåkrevd i forelder |
|
retrieval.idanyOf 1 | stringPåkrevd i forelder |
|
retrieval.workspace_idanyOf 1 | stringPåkrevd i forelder |
|
retrieval.mutation_idanyOf 1 | stringPåkrevd i forelder |
|
retrieval.social_account_idanyOf 1 | string | nullPåkrevd i forelder | — |
retrieval.social_account_idanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
retrieval.social_account_idanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
retrieval.platformanyOf 1 | stringPåkrevd i forelder |
|
retrieval.stateanyOf 1 | stringPåkrevd i forelder |
|
retrieval.reasonanyOf 1 | string | nullPåkrevd i forelder | — |
retrieval.reasonanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
retrieval.reasonanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
retrieval.created_atanyOf 1 | stringPåkrevd i forelder |
|
retrieval.settled_atanyOf 1 | string | nullPåkrevd i forelder | — |
retrieval.settled_atanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
retrieval.settled_atanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
retrieval.valid_untilanyOf 1 | stringPåkrevd i forelder |
|
retrieval.coverageanyOf 1 | stringPåkrevd i forelder |
|
retrieval.completeanyOf 1 | booleanPåkrevd i forelder |
|
retrieval.provider_getsanyOf 1 | integerPåkrevd i forelder |
|
retrieval.evidenceanyOf 1 | arrayPåkrevd i forelder |
|
retrieval.evidence[]anyOf 1 | objectValgfritt / element |
|
retrieval.evidence[].idanyOf 1 | stringPåkrevd i forelder |
|
retrieval.evidence[].workspace_idanyOf 1 | stringPåkrevd i forelder |
|
retrieval.evidence[].revisionanyOf 1 | integerPåkrevd i forelder |
|
retrieval.evidence[].titleanyOf 1 | string | nullPåkrevd i forelder | — |
retrieval.evidence[].titleanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
retrieval.evidence[].titleanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
retrieval.evidence[].textanyOf 1 | string | nullPåkrevd i forelder | — |
retrieval.evidence[].textanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
retrieval.evidence[].textanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
retrieval.evidence[].source_categoryanyOf 1 | stringPåkrevd i forelder |
|
retrieval.evidence[].platformanyOf 1 | string | nullPåkrevd i forelder | — |
retrieval.evidence[].platformanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
retrieval.evidence[].platformanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
retrieval.evidence[].source_urlanyOf 1 | string | nullPåkrevd i forelder | — |
retrieval.evidence[].source_urlanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
retrieval.evidence[].source_urlanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
retrieval.evidence[].authoranyOf 1 | string | nullPåkrevd i forelder | — |
retrieval.evidence[].authoranyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
retrieval.evidence[].authoranyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
retrieval.evidence[].languageanyOf 1 | string | nullPåkrevd i forelder | — |
retrieval.evidence[].languageanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
retrieval.evidence[].languageanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
retrieval.evidence[].published_atanyOf 1 | string | nullPåkrevd i forelder | — |
retrieval.evidence[].published_atanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
retrieval.evidence[].published_atanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
retrieval.evidence[].retrieved_atanyOf 1 | stringPåkrevd i forelder |
|
retrieval.evidence[].valid_untilanyOf 1 | string | nullPåkrevd i forelder | — |
retrieval.evidence[].valid_untilanyOf 1 / anyOf 1 | stringPåkrevd i forelder |
|
retrieval.evidence[].valid_untilanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
retrieval.evidence[].availabilityanyOf 1 | stringPåkrevd i forelder |
|
retrieval.evidence[].metricsanyOf 1 | objectPåkrevd i forelder |
|
retrieval.evidence[].metrics.likesanyOf 1 | integer | nullPåkrevd i forelder | — |
retrieval.evidence[].metrics.likesanyOf 1 / anyOf 1 | integerPåkrevd i forelder |
|
retrieval.evidence[].metrics.likesanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
retrieval.evidence[].metrics.repliesanyOf 1 | integer | nullPåkrevd i forelder | — |
retrieval.evidence[].metrics.repliesanyOf 1 / anyOf 1 | integerPåkrevd i forelder |
|
retrieval.evidence[].metrics.repliesanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
retrieval.evidence[].metrics.repostsanyOf 1 | integer | nullPåkrevd i forelder | — |
retrieval.evidence[].metrics.repostsanyOf 1 / anyOf 1 | integerPåkrevd i forelder |
|
retrieval.evidence[].metrics.repostsanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
retrieval.evidence[].metrics.viewsanyOf 1 | integer | nullPåkrevd i forelder | — |
retrieval.evidence[].metrics.viewsanyOf 1 / anyOf 1 | integerPåkrevd i forelder |
|
retrieval.evidence[].metrics.viewsanyOf 1 / anyOf 2 | nullPåkrevd i forelder | — |
retrievalanyOf 2 | nullPåkrevd i forelder | — |
Fullstendig 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
}Eksempel på verktøykall
Disse eksemplene bruker fiktive verdier kontrollert mot skjemaene. Erstatt ID-ene med noen du har lov til å bruke, mediene med klare ressurser og datoene med bekreftet publiseringstidspunkt. Kontroller kontoens kvalifikasjon før en skriveoperasjon sendes inn. Siden sender ingen API-forespørsler.
{
"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": []
}
}