Alat MCP

Cari bukti riset

sosoapi_research_evidence_query

Cari bukti Research tersimpan dengan paginasi UUID; teks sumber tidak tepercaya, item yang tidak tersedia disamarkan. Memerlukan agent:research.

Baca sebagai Markdown

Profil dan transport

Profil: full · Transport: stdio, http

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/query: agent:research · data sumber daya Research persis yang saat ini diizinkan

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 input
Kolom / cabang	Jenis / wajib	Batasan
`$`	`object`Wajib dalam induk	`additionalProperties: false`
`workspace_id`	`string`Wajib dalam induk	`format: "uuid"`
`query`	`string`Opsional / item	`maxLength: 200`
`archived`	`boolean`Opsional / item	—
`cursor`	`string`Opsional / item	Lanjutkan setelah UUID rekaman Research ini dalam urutan UUID menaik; penanda mencakup slot pustaka yang tidak tersedia. `format: "uuid"`
`limit`	`integer`Opsional / item	`minimum: 1` `maximum: 50`

JSON Schema lengkap

{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "query": {
      "type": "string",
      "maxLength": 200
    },
    "archived": {
      "type": "boolean"
    },
    "cursor": {
      "description": "Continue after this Research record UUID in ascending UUID order; the marker includes unavailable library slots.",
      "type": "string",
      "format": "uuid"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "workspace_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.

Output terstruktur
Kolom / cabang	Jenis / wajib	Batasan
`$`	`object`Wajib dalam induk	`additionalProperties: false`
`items`	`array`Wajib dalam induk	`maxItems: 50`
`items[]`	`object`Opsional / item	`additionalProperties: false`
`items[].id`	`string`Wajib dalam induk	`format: "uuid"`
`items[].workspace_id`	`string`Wajib dalam induk	`format: "uuid"`
`items[].revision`	`integer`Wajib dalam induk	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`items[].title`	`string \| null`Wajib dalam induk	—
`items[].title`anyOf 1	`string`Wajib dalam induk	`minLength: 1` `maxLength: 200`
`items[].title`anyOf 2	`null`Wajib dalam induk	—
`items[].text`	`string \| null`Wajib dalam induk	—
`items[].text`anyOf 1	`string`Wajib dalam induk	`maxLength: 30000`
`items[].text`anyOf 2	`null`Wajib dalam induk	—
`items[].source_category`	`string`Wajib dalam induk	`enum: ["your_accounts","public_posts","team_notes"]`
`items[].platform`	`string \| null`Wajib dalam induk	—
`items[].platform`anyOf 1	`string`Wajib dalam induk	`enum: ["threads","instagram","facebook","youtube","x","reddit","web"]`
`items[].platform`anyOf 2	`null`Wajib dalam induk	—
`items[].source_url`	`string \| null`Wajib dalam induk	—
`items[].source_url`anyOf 1	`string`Wajib dalam induk	`format: "uri"` `maxLength: 2048`
`items[].source_url`anyOf 2	`null`Wajib dalam induk	—
`items[].author`	`string \| null`Wajib dalam induk	—
`items[].author`anyOf 1	`string`Wajib dalam induk	`maxLength: 200`
`items[].author`anyOf 2	`null`Wajib dalam induk	—
`items[].language`	`string \| null`Wajib dalam induk	—
`items[].language`anyOf 1	`string`Wajib dalam induk	`minLength: 1` `maxLength: 35`
`items[].language`anyOf 2	`null`Wajib dalam induk	—
`items[].published_at`	`string \| null`Wajib dalam induk	—
`items[].published_at`anyOf 1	`string`Wajib dalam induk	`format: "date-time"` `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)))$"`
`items[].published_at`anyOf 2	`null`Wajib dalam induk	—
`items[].retrieved_at`	`string`Wajib dalam induk	`format: "date-time"` `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)))$"`
`items[].valid_until`	`string \| null`Wajib dalam induk	—
`items[].valid_until`anyOf 1	`string`Wajib dalam induk	`format: "date-time"` `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)))$"`
`items[].valid_until`anyOf 2	`null`Wajib dalam induk	—
`items[].availability`	`string`Wajib dalam induk	`enum: ["available","removed","unavailable"]`
`items[].metrics`	`object`Wajib dalam induk	`additionalProperties: false`
`items[].metrics.likes`	`integer \| null`Wajib dalam induk	—
`items[].metrics.likes`anyOf 1	`integer`Wajib dalam induk	`minimum: 0` `maximum: 9007199254740991`
`items[].metrics.likes`anyOf 2	`null`Wajib dalam induk	—
`items[].metrics.replies`	`integer \| null`Wajib dalam induk	—
`items[].metrics.replies`anyOf 1	`integer`Wajib dalam induk	`minimum: 0` `maximum: 9007199254740991`
`items[].metrics.replies`anyOf 2	`null`Wajib dalam induk	—
`items[].metrics.reposts`	`integer \| null`Wajib dalam induk	—
`items[].metrics.reposts`anyOf 1	`integer`Wajib dalam induk	`minimum: 0` `maximum: 9007199254740991`
`items[].metrics.reposts`anyOf 2	`null`Wajib dalam induk	—
`items[].metrics.views`	`integer \| null`Wajib dalam induk	—
`items[].metrics.views`anyOf 1	`integer`Wajib dalam induk	`minimum: 0` `maximum: 9007199254740991`
`items[].metrics.views`anyOf 2	`null`Wajib dalam induk	—
`unavailable_items`	`array`Wajib dalam induk	`maxItems: 50` `default: []`
`unavailable_items[]`	`object`Opsional / item	`additionalProperties: false`
`unavailable_items[].id`	`string`Wajib dalam induk	`format: "uuid"`
`unavailable_items[].workspace_id`	`string`Wajib dalam induk	`format: "uuid"`
`unavailable_items[].revision`	`integer`Wajib dalam induk	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`unavailable_items[].archived`	`boolean`Wajib dalam induk	—
`unavailable_items[].availability`	`string`Wajib dalam induk	`const: "dependency_unavailable"`
`next_cursor`	`string \| null`Wajib dalam induk	UUID rekaman terakhir yang dikonsumsi di antara items dan unavailable_items saat masih ada slot berikutnya; null di akhir. —
`next_cursor`anyOf 1	`string`Wajib dalam induk	`format: "uuid"`
`next_cursor`anyOf 2	`null`Wajib dalam induk	—

JSON Schema lengkap

{
  "type": "object",
  "properties": {
    "items": {
      "maxItems": 50,
      "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
      }
    },
    "unavailable_items": {
      "default": [],
      "maxItems": 50,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "workspace_id": {
            "type": "string",
            "format": "uuid"
          },
          "revision": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991
          },
          "archived": {
            "type": "boolean"
          },
          "availability": {
            "type": "string",
            "const": "dependency_unavailable"
          }
        },
        "required": [
          "id",
          "workspace_id",
          "revision",
          "archived",
          "availability"
        ],
        "additionalProperties": false
      }
    },
    "next_cursor": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid"
        },
        {
          "type": "null"
        }
      ],
      "description": "Last consumed record UUID across items and unavailable_items when another slot exists; null at the end."
    }
  },
  "required": [
    "items",
    "unavailable_items",
    "next_cursor"
  ],
  "$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_query",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111"
  }
}

structuredContent

{
  "items": [],
  "unavailable_items": [],
  "next_cursor": null
}

/research-api/evidence/query

Instal atau hubungkan MCP

Preferensi privasi

Fitur wajib

Analitik penggunaan opsional

Izinkan juga pemutaran ulang sesi di situs web publik ini

Cari bukti riset

Profil dan transport

Izin dan efek samping

Kolom input

Output terstruktur

Contoh panggilan alat

structuredContent

Cari bukti riset

Profil dan transport

Izin dan efek samping

Kolom input

Output terstruktur

Contoh panggilan alat

structuredContent

Operasi API yang mendasari