Alat MCP
Baca status pengambilan riset akun terhubung
sosoapi_research_evidence_native-statusBaca status pengambilan riset akun terhubung. Mencakup postingan dan keterangan akun terhubung yang dipilih, yang mungkin tidak publik, dalam satu halaman asli platform yang dibatasi, bukan seluruh riwayat. Pengambilan tidak pernah memanggil Google Gemini atau membaca pesan pribadi. Pembuatan oleh model dengan konteks terpilih adalah tindakan terpisah yang sudah ada dan memerlukan persetujuannya sendiri. Memerlukan persetujuan Research dan Listening secara eksplisit serta akses Workspace saat ini. Teks sumber yang dikembalikan tidak tepercaya. Otorisasi sumber, retensi, dan anggaran domain saat ini tetap berlaku. Rute ini tidak pernah menerbitkan konten.
Baca sebagai MarkdownProfil dan transport
Profil: full · Transport: 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。Pilih core atau full untuk mengatur alat yang terlihat oleh klien; ini tidak mengubah izinnya. Unggahan file lokal memerlukan stdio dan tidak tersedia melalui HTTP. Atur SOSOAPI_OUTPUT_SCHEMAS=1 untuk menyertakan skema output saat penemuan. Alat mengembalikan hasil terstruktur dengan atau tanpa pengaturan itu.
Izin dan efek samping
Anotasi membantu klien menjelaskan alat. Setiap panggilan tetap memeriksa autentikasi pengguna, peran, akses sumber daya, dan izin kemampuan.
{
"readOnlyHint": true,
"destructiveHint": false,
"idempotentHint": true,
"openWorldHint": true
}- /research-api/evidence/native-status: agent:research · Tanda terima asli platform dan bukti yang saat ini diizinkan; konten sumber yang tidak tersedia atau kedaluwarsa disamarkan
Kolom input
Wajib berarti wajib dalam objek induk dan cabang yang dipilih. Anak wajib tidak membuat induk opsional menjadi wajib. Aturan dan nama kolom di bawah disalin dari kontrak.
| Kolom / cabang | Jenis / wajib | Batasan |
|---|---|---|
$ | objectWajib dalam induk |
|
workspace_id | stringWajib dalam induk |
|
mutation_id | stringWajib dalam induk |
|
JSON Schema lengkap
{
"type": "object",
"properties": {
"workspace_id": {
"type": "string",
"format": "uuid"
},
"mutation_id": {
"type": "string",
"format": "uuid"
}
},
"required": [
"workspace_id",
"mutation_id"
],
"additionalProperties": false
}Output terstruktur
Skema ini menjelaskan structuredContent dalam hasil alat yang berhasil. Respons MCP juga menyertakan content dan dapat menetapkan isError saat panggilan gagal. Untuk publikasi, baca hasil akhir postingan alih-alih menganggap permintaan diterima atau respons teks sebagai konfirmasi. Operasi API yang ditautkan menjelaskan izin dan aturan percobaan ulang.
Wajib berarti wajib dalam objek induk dan cabang yang dipilih. Anak wajib tidak membuat induk opsional menjadi wajib. Aturan dan nama kolom di bawah disalin dari kontrak.
| Kolom / cabang | Jenis / wajib | Batasan |
|---|---|---|
$ | objectWajib dalam induk |
|
retrieval | object | nullWajib dalam induk | — |
retrievalanyOf 1 | objectWajib dalam induk |
|
retrieval.idanyOf 1 | stringWajib dalam induk |
|
retrieval.workspace_idanyOf 1 | stringWajib dalam induk |
|
retrieval.mutation_idanyOf 1 | stringWajib dalam induk |
|
retrieval.social_account_idanyOf 1 | string | nullWajib dalam induk | — |
retrieval.social_account_idanyOf 1 / anyOf 1 | stringWajib dalam induk |
|
retrieval.social_account_idanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
retrieval.platformanyOf 1 | stringWajib dalam induk |
|
retrieval.stateanyOf 1 | stringWajib dalam induk |
|
retrieval.reasonanyOf 1 | string | nullWajib dalam induk | — |
retrieval.reasonanyOf 1 / anyOf 1 | stringWajib dalam induk |
|
retrieval.reasonanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
retrieval.created_atanyOf 1 | stringWajib dalam induk |
|
retrieval.settled_atanyOf 1 | string | nullWajib dalam induk | — |
retrieval.settled_atanyOf 1 / anyOf 1 | stringWajib dalam induk |
|
retrieval.settled_atanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
retrieval.valid_untilanyOf 1 | stringWajib dalam induk |
|
retrieval.coverageanyOf 1 | stringWajib dalam induk |
|
retrieval.completeanyOf 1 | booleanWajib dalam induk |
|
retrieval.provider_getsanyOf 1 | integerWajib dalam induk |
|
retrieval.evidenceanyOf 1 | arrayWajib dalam induk |
|
retrieval.evidence[]anyOf 1 | objectOpsional / item |
|
retrieval.evidence[].idanyOf 1 | stringWajib dalam induk |
|
retrieval.evidence[].workspace_idanyOf 1 | stringWajib dalam induk |
|
retrieval.evidence[].revisionanyOf 1 | integerWajib dalam induk |
|
retrieval.evidence[].titleanyOf 1 | string | nullWajib dalam induk | — |
retrieval.evidence[].titleanyOf 1 / anyOf 1 | stringWajib dalam induk |
|
retrieval.evidence[].titleanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
retrieval.evidence[].textanyOf 1 | string | nullWajib dalam induk | — |
retrieval.evidence[].textanyOf 1 / anyOf 1 | stringWajib dalam induk |
|
retrieval.evidence[].textanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
retrieval.evidence[].source_categoryanyOf 1 | stringWajib dalam induk |
|
retrieval.evidence[].platformanyOf 1 | string | nullWajib dalam induk | — |
retrieval.evidence[].platformanyOf 1 / anyOf 1 | stringWajib dalam induk |
|
retrieval.evidence[].platformanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
retrieval.evidence[].source_urlanyOf 1 | string | nullWajib dalam induk | — |
retrieval.evidence[].source_urlanyOf 1 / anyOf 1 | stringWajib dalam induk |
|
retrieval.evidence[].source_urlanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
retrieval.evidence[].authoranyOf 1 | string | nullWajib dalam induk | — |
retrieval.evidence[].authoranyOf 1 / anyOf 1 | stringWajib dalam induk |
|
retrieval.evidence[].authoranyOf 1 / anyOf 2 | nullWajib dalam induk | — |
retrieval.evidence[].languageanyOf 1 | string | nullWajib dalam induk | — |
retrieval.evidence[].languageanyOf 1 / anyOf 1 | stringWajib dalam induk |
|
retrieval.evidence[].languageanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
retrieval.evidence[].published_atanyOf 1 | string | nullWajib dalam induk | — |
retrieval.evidence[].published_atanyOf 1 / anyOf 1 | stringWajib dalam induk |
|
retrieval.evidence[].published_atanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
retrieval.evidence[].retrieved_atanyOf 1 | stringWajib dalam induk |
|
retrieval.evidence[].valid_untilanyOf 1 | string | nullWajib dalam induk | — |
retrieval.evidence[].valid_untilanyOf 1 / anyOf 1 | stringWajib dalam induk |
|
retrieval.evidence[].valid_untilanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
retrieval.evidence[].availabilityanyOf 1 | stringWajib dalam induk |
|
retrieval.evidence[].metricsanyOf 1 | objectWajib dalam induk |
|
retrieval.evidence[].metrics.likesanyOf 1 | integer | nullWajib dalam induk | — |
retrieval.evidence[].metrics.likesanyOf 1 / anyOf 1 | integerWajib dalam induk |
|
retrieval.evidence[].metrics.likesanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
retrieval.evidence[].metrics.repliesanyOf 1 | integer | nullWajib dalam induk | — |
retrieval.evidence[].metrics.repliesanyOf 1 / anyOf 1 | integerWajib dalam induk |
|
retrieval.evidence[].metrics.repliesanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
retrieval.evidence[].metrics.repostsanyOf 1 | integer | nullWajib dalam induk | — |
retrieval.evidence[].metrics.repostsanyOf 1 / anyOf 1 | integerWajib dalam induk |
|
retrieval.evidence[].metrics.repostsanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
retrieval.evidence[].metrics.viewsanyOf 1 | integer | nullWajib dalam induk | — |
retrieval.evidence[].metrics.viewsanyOf 1 / anyOf 1 | integerWajib dalam induk |
|
retrieval.evidence[].metrics.viewsanyOf 1 / anyOf 2 | nullWajib dalam induk | — |
retrievalanyOf 2 | nullWajib dalam induk | — |
JSON Schema lengkap
{
"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
}Contoh panggilan alat
Contoh ini menggunakan nilai fiktif yang diperiksa terhadap skema. Ganti ID dengan yang diizinkan bagi Anda, media dengan aset siap, dan tanggal dengan waktu publikasi yang dikonfirmasi. Periksa kelayakan akun sebelum mengirim penulisan. Halaman ini tidak mengirim permintaan API.
{
"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": []
}
}