MCP-verktyg
Läs hämtningsstatus för forskning från anslutna konton
sosoapi_research_evidence_native-statusLäs hämtningsstatus för forskning från anslutna konton. Omfattar utvalda inlägg och bildtexter från anslutna konton, som kan vara icke-offentliga, på en enda avgränsad sida från plattformen, inte hela historiken. Hämtningen anropar aldrig Google Gemini och läser inte direktmeddelanden. Modellgenerering med vald kontext är en separat befintlig åtgärd med eget samtycke. Kräver uttryckligt samtycke till Research och Listening och aktuell åtkomst till Workspace. Returnerad källtext är inte betrodd. Aktuell källauktorisering, lagringstid och domänbudgetar gäller fortfarande. Den här rutten publicerar aldrig innehåll.
Läs som MarkdownProfiler och 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。Välj core eller full för att styra vilka verktyg klienten ser; detta ändrar inte dess behörigheter. Lokal filuppladdning kräver stdio och är inte tillgänglig via HTTP. Ange SOSOAPI_OUTPUT_SCHEMAS=1 för att inkludera utdatascheman vid identifiering. Verktygen returnerar strukturerade resultat med eller utan inställningen.
Behörigheter och sidoeffekter
Annoteringar hjälper klienter att beskriva ett verktyg. Varje anrop kontrollerar fortfarande användarens autentisering, roll, resursåtkomst och tilldelade funktionsbehörigheter.
{
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true
}- /research-api/evidence/native-status: agent:research · Aktuellt auktoriserat plattformskvitto och belägg; otillgängligt eller utgånget källinnehåll döljs
Indatafält
Obligatoriskt betyder obligatoriskt inom sitt överordnade objekt och vald gren. Ett obligatoriskt underfält gör inte ett valfritt överordnat objekt obligatoriskt. Regler och fältnamn nedan kopieras från kontraktet.
| Fält / gren | Typ / obligatoriskt | Begränsningar |
|---|---|---|
$ | objectObligatoriskt i överordnat objekt |
|
workspace_id | stringObligatoriskt i överordnat objekt |
|
mutation_id | stringObligatoriskt i överordnat objekt |
|
Fullständigt JSON Schema
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
},
"mutation_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"workspace_id",
"mutation_id"
],
"additionalProperties": false
}Strukturerat resultat
Detta schema beskriver structuredContent i ett lyckat verktygsresultat. MCP-svaret innehåller även content och kan ange isError när ett anrop misslyckas. För publicering ska du läsa inläggets slutresultat i stället för att tolka en accepterad begäran eller ett textsvar som bekräftelse. Den länkade API-åtgärden förklarar behörigheter och regler för nya försök.
Obligatoriskt betyder obligatoriskt inom sitt överordnade objekt och vald gren. Ett obligatoriskt underfält gör inte ett valfritt överordnat objekt obligatoriskt. Regler och fältnamn nedan kopieras från kontraktet.
| Fält / gren | Typ / obligatoriskt | Begränsningar |
|---|---|---|
$ | objectObligatoriskt i överordnat objekt |
|
retrieval | object | nullObligatoriskt i överordnat objekt | — |
retrievalanyOf 1 | objectObligatoriskt i överordnat objekt |
|
retrieval.idanyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.workspace_idanyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.mutation_idanyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.social_account_idanyOf 1 | string | nullObligatoriskt i överordnat objekt | — |
retrieval.social_account_idanyOf 1 / anyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.social_account_idanyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
retrieval.platformanyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.stateanyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.reasonanyOf 1 | string | nullObligatoriskt i överordnat objekt | — |
retrieval.reasonanyOf 1 / anyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.reasonanyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
retrieval.created_atanyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.settled_atanyOf 1 | string | nullObligatoriskt i överordnat objekt | — |
retrieval.settled_atanyOf 1 / anyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.settled_atanyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
retrieval.valid_untilanyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.coverageanyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.completeanyOf 1 | booleanObligatoriskt i överordnat objekt |
|
retrieval.provider_getsanyOf 1 | integerObligatoriskt i överordnat objekt |
|
retrieval.evidenceanyOf 1 | arrayObligatoriskt i överordnat objekt |
|
retrieval.evidence[]anyOf 1 | objectValfritt / objekt |
|
retrieval.evidence[].idanyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.evidence[].workspace_idanyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.evidence[].revisionanyOf 1 | integerObligatoriskt i överordnat objekt |
|
retrieval.evidence[].titleanyOf 1 | string | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].titleanyOf 1 / anyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.evidence[].titleanyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].textanyOf 1 | string | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].textanyOf 1 / anyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.evidence[].textanyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].source_categoryanyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.evidence[].platformanyOf 1 | string | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].platformanyOf 1 / anyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.evidence[].platformanyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].source_urlanyOf 1 | string | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].source_urlanyOf 1 / anyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.evidence[].source_urlanyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].authoranyOf 1 | string | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].authoranyOf 1 / anyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.evidence[].authoranyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].languageanyOf 1 | string | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].languageanyOf 1 / anyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.evidence[].languageanyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].published_atanyOf 1 | string | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].published_atanyOf 1 / anyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.evidence[].published_atanyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].retrieved_atanyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.evidence[].valid_untilanyOf 1 | string | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].valid_untilanyOf 1 / anyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.evidence[].valid_untilanyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].availabilityanyOf 1 | stringObligatoriskt i överordnat objekt |
|
retrieval.evidence[].metricsanyOf 1 | objectObligatoriskt i överordnat objekt |
|
retrieval.evidence[].metrics.likesanyOf 1 | integer | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].metrics.likesanyOf 1 / anyOf 1 | integerObligatoriskt i överordnat objekt |
|
retrieval.evidence[].metrics.likesanyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].metrics.repliesanyOf 1 | integer | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].metrics.repliesanyOf 1 / anyOf 1 | integerObligatoriskt i överordnat objekt |
|
retrieval.evidence[].metrics.repliesanyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].metrics.repostsanyOf 1 | integer | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].metrics.repostsanyOf 1 / anyOf 1 | integerObligatoriskt i överordnat objekt |
|
retrieval.evidence[].metrics.repostsanyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].metrics.viewsanyOf 1 | integer | nullObligatoriskt i överordnat objekt | — |
retrieval.evidence[].metrics.viewsanyOf 1 / anyOf 1 | integerObligatoriskt i överordnat objekt |
|
retrieval.evidence[].metrics.viewsanyOf 1 / anyOf 2 | nullObligatoriskt i överordnat objekt | — |
retrievalanyOf 2 | nullObligatoriskt i överordnat objekt | — |
Fullständigt 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
}Exempel på verktygsanrop
Exemplen använder fiktiva värden som kontrollerats mot schemana. Ersätt ID:n med sådana du får använda, medier med färdiga mediefiler och datum med din bekräftade publiceringstid. Kontrollera kontots behörighet före en skrivning. Denna sida skickar inga API-anrop.
{
"name": "sosoapi_research_evidence_native-status",
"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": "unavailable",
"reason": "connection_unavailable",
"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": []
}
}