隱私偏好

必要功能

用於安全驗證及網站基本功能。

一律啟用

Landing 診斷與遮蔽重播

使用僅限此分頁的匿名識別碼，衡量公開網站造訪、流失及註冊連結互動，不會連結帳號。所有文字均會遮蔽，表單也會封鎖。

選用的使用分析

允許 PostHog 使用分析嗎？可隨時在頁尾更改選擇。

同時允許在此公開網站進行工作階段重播

選用跨網站模式的重播會顯示公開頁面與互動，並遮蔽輸入內容及私人內容。應用程式重播需另外選擇。

需要允許選用分析；此跨網站模式的重播預設關閉。上方的 Landing 模式會獨立運作。

我們如何使用資料

預設 Landing 模式只會在此分頁的 sessionStorage 儲存匿名識別碼，不會連結應用程式、帳號或選用的跨網站識別碼。允許選用分析後，會切換至另一個獨立識別碼，且不會合併先前的 Landing 記錄。

允許選用分析後，PostHog 可在本網站與我們的應用程式之間共用一個匿名 cookie，並在各網站使用瀏覽器本機儲存空間。在您同意的前提下，註冊確認後，同一分頁中已驗證的造訪可連結至您的新帳號。

選用跨網站模式的重播預設關閉。取消勾選其重播選項並儲存，即可停止該模式的新錄製；Landing 診斷及遮蔽重播需在上方另外關閉。這些選擇不會變更帳號設定。

隱私聲明及獨立的 Cloudflare 彙總測量。

瀏覽器分析選擇不會啟用帳戶分析。

SosoAPI
免費開始
ZH-TW
EN繁中繁體中文（台灣）简体中文日本語한국어DeutschFrançaisEspañolPortuguês (Brasil)العربيةעבריתNederlandsहिन्दीBahasa IndonesiaNorsk bokmålSvenskaMagyar
免費開始

僅在使用時載入搜尋。在下方瀏覽所有類別。

MCP 工具

讀取公開社群來源擷取狀態

sosoapi_research_evidence_social-status

以 mutation_id 讀取同一次社群來源擷取；未經驗證的來源文字可能已過期或無法取得。需要 agent:research。

閱讀 Markdown

設定與傳輸方式

設定： full · 傳輸方式： 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。

選擇 core 或 full 以控制用戶端顯示的工具；這不會變更權限。本機檔案上傳需要 stdio，無法透過 HTTP 使用。設定 SOSOAPI_OUTPUT_SCHEMAS=1 可在探索結果加入輸出結構描述。無論是否啟用此設定，工具皆會回傳結構化結果。

權限與副作用

註解幫助用戶端描述工具。每次呼叫仍會檢查使用者身分驗證、角色、資源存取和能力授權。

{
  "readOnlyHint": true,
  "destructiveHint": false,
  "idempotentHint": true,
  "openWorldHint": true
}

輸入欄位

「必填」是指在其父物件及所選分支內必填。必填子欄位不會使選填父物件變成必填。下列規則與欄位名稱均複製自契約。

輸入欄位
欄位 / 分支類型 / 必填約束
$object在父物件中必填
  • additionalProperties: false
workspace_idstring在父物件中必填
  • format: "uuid"
mutation_idstring在父物件中必填
  • format: "uuid"
完整 JSON Schema
{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "mutation_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "workspace_id",
    "mutation_id"
  ],
  "additionalProperties": false
}

結構化輸出

此 schema 描述成功工具結果中的 structuredContent。MCP 回應也包含 content，並可能在呼叫失敗時設定 isError。對於發布，請讀取貼文的最終結果，不要把已接受的請求或文字回應當作確認。連結的 API 操作說明了權限和重試規則。

「必填」是指在其父物件及所選分支內必填。必填子欄位不會使選填父物件變成必填。下列規則與欄位名稱均複製自契約。

結構化輸出
欄位 / 分支類型 / 必填約束
$object在父物件中必填
  • additionalProperties: false
retrievalobject | null在父物件中必填—
retrievalanyOf 1object在父物件中必填
  • additionalProperties: false
retrieval.idanyOf 1string在父物件中必填
  • format: "uuid"
retrieval.workspace_idanyOf 1string在父物件中必填
  • format: "uuid"
retrieval.mutation_idanyOf 1string在父物件中必填
  • format: "uuid"
retrieval.kindanyOf 1string在父物件中必填
  • const: "public_social"
retrieval.stateanyOf 1string在父物件中必填
  • enum: ["pending","running","completed","cancelled","unconfirmed","expired"]
retrieval.created_atanyOf 1string在父物件中必填
  • 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)))$"
retrieval.settled_atanyOf 1string | null在父物件中必填—
retrieval.settled_atanyOf 1 / anyOf 1string在父物件中必填
  • 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)))$"
retrieval.settled_atanyOf 1 / anyOf 2null在父物件中必填—
retrieval.valid_untilanyOf 1string在父物件中必填
  • 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)))$"
retrieval.resultanyOf 1object | null在父物件中必填—
retrieval.resultanyOf 1 / anyOf 1object在父物件中必填
  • additionalProperties: false
retrieval.result.sourceanyOf 1 / anyOf 1string在父物件中必填
  • enum: ["facebook_public_web","instagram_public_web","threads_public_web"]
retrieval.result.platformanyOf 1 / anyOf 1string在父物件中必填
  • enum: ["facebook","instagram","threads"]
retrieval.result.canonical_urlanyOf 1 / anyOf 1string在父物件中必填
  • format: "uri"
  • maxLength: 2048
retrieval.result.fetched_atanyOf 1 / anyOf 1string在父物件中必填
  • 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)))$"
retrieval.result.expires_atanyOf 1 / anyOf 1string在父物件中必填
  • 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)))$"
retrieval.result.upstream_updated_atanyOf 1 / anyOf 1null在父物件中必填—
retrieval.result.statusanyOf 1 / anyOf 1string在父物件中必填
  • enum: ["available","partial","unavailable"]
retrieval.result.profileanyOf 1 / anyOf 1object | null在父物件中必填—
retrieval.result.profileanyOf 1 / anyOf 1 / anyOf 1object在父物件中必填
  • additionalProperties: false
retrieval.result.profile.source_account_idanyOf 1 / anyOf 1 / anyOf 1string在父物件中必填
  • pattern: "^[0-9]{1,30}$"
retrieval.result.profile.id_namespaceanyOf 1 / anyOf 1 / anyOf 1string在父物件中必填
  • const: "public_web"
retrieval.result.profile.usernameanyOf 1 / anyOf 1 / anyOf 1string在父物件中必填
  • minLength: 1
  • maxLength: 50
retrieval.result.profile.nameanyOf 1 / anyOf 1 / anyOf 1string | null在父物件中必填—
retrieval.result.profile.nameanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1string在父物件中必填
  • minLength: 1
  • maxLength: 200
retrieval.result.profile.nameanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2null在父物件中必填—
retrieval.result.profile.followersanyOf 1 / anyOf 1 / anyOf 1integer | null在父物件中必填—
retrieval.result.profile.followersanyOf 1 / anyOf 1 / anyOf 1 / anyOf 1integer在父物件中必填
  • minimum: 0
  • maximum: 9007199254740991
retrieval.result.profile.followersanyOf 1 / anyOf 1 / anyOf 1 / anyOf 2null在父物件中必填—
retrieval.result.profileanyOf 1 / anyOf 1 / anyOf 2null在父物件中必填—
retrieval.result.postsanyOf 1 / anyOf 1array在父物件中必填
  • maxItems: 20
retrieval.result.posts[]anyOf 1 / anyOf 1object選填／項目
  • additionalProperties: false
retrieval.result.posts[].source_post_idanyOf 1 / anyOf 1string在父物件中必填
  • pattern: "^[0-9]{1,30}$"
retrieval.result.posts[].id_namespaceanyOf 1 / anyOf 1string在父物件中必填
  • const: "public_web"
retrieval.result.posts[].shortcodeanyOf 1 / anyOf 1string | null在父物件中必填—
retrieval.result.posts[].shortcodeanyOf 1 / anyOf 1 / anyOf 1string在父物件中必填
  • minLength: 1
  • maxLength: 64
retrieval.result.posts[].shortcodeanyOf 1 / anyOf 1 / anyOf 2null在父物件中必填—
retrieval.result.posts[].source_account_idanyOf 1 / anyOf 1string在父物件中必填
  • pattern: "^[0-9]{1,30}$"
retrieval.result.posts[].authoranyOf 1 / anyOf 1string在父物件中必填
  • minLength: 1
  • maxLength: 50
retrieval.result.posts[].canonical_urlanyOf 1 / anyOf 1string在父物件中必填
  • format: "uri"
  • maxLength: 2048
retrieval.result.posts[].textanyOf 1 / anyOf 1string在父物件中必填
  • maxLength: 30000
retrieval.result.posts[].published_atanyOf 1 / anyOf 1string | null在父物件中必填—
retrieval.result.posts[].published_atanyOf 1 / anyOf 1 / anyOf 1string在父物件中必填
  • 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)))$"
retrieval.result.posts[].published_atanyOf 1 / anyOf 1 / anyOf 2null在父物件中必填—
retrieval.result.posts[].media_kindanyOf 1 / anyOf 1string在父物件中必填
  • enum: ["text","image","video","carousel","unknown"]
retrieval.result.posts[].metricsanyOf 1 / anyOf 1object在父物件中必填
  • additionalProperties: false
retrieval.result.posts[].metrics.likesanyOf 1 / anyOf 1integer | null在父物件中必填—
retrieval.result.posts[].metrics.likesanyOf 1 / anyOf 1 / anyOf 1integer在父物件中必填
  • minimum: 0
  • maximum: 9007199254740991
retrieval.result.posts[].metrics.likesanyOf 1 / anyOf 1 / anyOf 2null在父物件中必填—
retrieval.result.posts[].metrics.commentsanyOf 1 / anyOf 1integer | null在父物件中必填—
retrieval.result.posts[].metrics.commentsanyOf 1 / anyOf 1 / anyOf 1integer在父物件中必填
  • minimum: 0
  • maximum: 9007199254740991
retrieval.result.posts[].metrics.commentsanyOf 1 / anyOf 1 / anyOf 2null在父物件中必填—
retrieval.result.posts[].metrics.reactionsanyOf 1 / anyOf 1integer | null在父物件中必填—
retrieval.result.posts[].metrics.reactionsanyOf 1 / anyOf 1 / anyOf 1integer在父物件中必填
  • minimum: 0
  • maximum: 9007199254740991
retrieval.result.posts[].metrics.reactionsanyOf 1 / anyOf 1 / anyOf 2null在父物件中必填—
retrieval.result.posts[].metrics.sharesanyOf 1 / anyOf 1integer | null在父物件中必填—
retrieval.result.posts[].metrics.sharesanyOf 1 / anyOf 1 / anyOf 1integer在父物件中必填
  • minimum: 0
  • maximum: 9007199254740991
retrieval.result.posts[].metrics.sharesanyOf 1 / anyOf 1 / anyOf 2null在父物件中必填—
retrieval.result.posts[].metrics.viewsanyOf 1 / anyOf 1integer | null在父物件中必填—
retrieval.result.posts[].metrics.viewsanyOf 1 / anyOf 1 / anyOf 1integer在父物件中必填
  • minimum: 0
  • maximum: 9007199254740991
retrieval.result.posts[].metrics.viewsanyOf 1 / anyOf 1 / anyOf 2null在父物件中必填—
retrieval.result.coverageanyOf 1 / anyOf 1object在父物件中必填
  • additionalProperties: false
retrieval.result.coverage.completeanyOf 1 / anyOf 1boolean在父物件中必填
  • const: false
retrieval.result.coverage.reasonsanyOf 1 / anyOf 1array在父物件中必填
  • maxItems: 20
retrieval.result.coverage.reasons[]anyOf 1 / anyOf 1string選填／項目
  • enum: ["initial_page_only","public_web_ids","metrics_unavailable","profile_only","no_attributable_posts","foreign_or_malformed_rows","parser_limit","unsupported_payload","blocked","rate_limited","upstream_http_error","redirect_rejected","unsupported_content_type","response_too_large","timeout","aborted","network_error","inconsistent_identity","research_limit","source_removed"]
retrieval.result.coverage.omitted_rowsanyOf 1 / anyOf 1integer在父物件中必填
  • minimum: 0
  • maximum: 9007199254740991
retrieval.result.coverage.next_cursoranyOf 1 / anyOf 1null在父物件中必填—
retrieval.resultanyOf 1 / anyOf 2null在父物件中必填—
retrieval.evidenceanyOf 1array在父物件中必填
  • maxItems: 20
retrieval.evidence[]anyOf 1object選填／項目
  • additionalProperties: false
retrieval.evidence[].evidence_idanyOf 1string在父物件中必填
  • format: "uuid"
retrieval.evidence[].revisionanyOf 1integer在父物件中必填
  • maximum: 9007199254740991
  • exclusiveMinimum: 0
retrievalanyOf 2null在父物件中必填—
完整 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"
            },
            "kind": {
              "type": "string",
              "const": "public_social"
            },
            "state": {
              "type": "string",
              "enum": [
                "pending",
                "running",
                "completed",
                "cancelled",
                "unconfirmed",
                "expired"
              ]
            },
            "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"
            },
            "result": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "source": {
                      "type": "string",
                      "enum": [
                        "facebook_public_web",
                        "instagram_public_web",
                        "threads_public_web"
                      ]
                    },
                    "platform": {
                      "type": "string",
                      "enum": [
                        "facebook",
                        "instagram",
                        "threads"
                      ]
                    },
                    "canonical_url": {
                      "type": "string",
                      "maxLength": 2048,
                      "format": "uri"
                    },
                    "fetched_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"
                    },
                    "expires_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"
                    },
                    "upstream_updated_at": {
                      "type": "null"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "available",
                        "partial",
                        "unavailable"
                      ]
                    },
                    "profile": {
                      "anyOf": [
                        {
                          "type": "object",
                          "properties": {
                            "source_account_id": {
                              "type": "string",
                              "pattern": "^[0-9]{1,30}$"
                            },
                            "id_namespace": {
                              "type": "string",
                              "const": "public_web"
                            },
                            "username": {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 50
                            },
                            "name": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 200
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "followers": {
                              "anyOf": [
                                {
                                  "type": "integer",
                                  "minimum": 0,
                                  "maximum": 9007199254740991
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            }
                          },
                          "required": [
                            "source_account_id",
                            "id_namespace",
                            "username",
                            "name",
                            "followers"
                          ],
                          "additionalProperties": false
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "posts": {
                      "maxItems": 20,
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "source_post_id": {
                            "type": "string",
                            "pattern": "^[0-9]{1,30}$"
                          },
                          "id_namespace": {
                            "type": "string",
                            "const": "public_web"
                          },
                          "shortcode": {
                            "anyOf": [
                              {
                                "type": "string",
                                "minLength": 1,
                                "maxLength": 64
                              },
                              {
                                "type": "null"
                              }
                            ]
                          },
                          "source_account_id": {
                            "type": "string",
                            "pattern": "^[0-9]{1,30}$"
                          },
                          "author": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 50
                          },
                          "canonical_url": {
                            "type": "string",
                            "maxLength": 2048,
                            "format": "uri"
                          },
                          "text": {
                            "type": "string",
                            "maxLength": 30000
                          },
                          "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"
                              }
                            ]
                          },
                          "media_kind": {
                            "type": "string",
                            "enum": [
                              "text",
                              "image",
                              "video",
                              "carousel",
                              "unknown"
                            ]
                          },
                          "metrics": {
                            "type": "object",
                            "properties": {
                              "likes": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "comments": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "reactions": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "shares": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              },
                              "views": {
                                "anyOf": [
                                  {
                                    "type": "integer",
                                    "minimum": 0,
                                    "maximum": 9007199254740991
                                  },
                                  {
                                    "type": "null"
                                  }
                                ]
                              }
                            },
                            "required": [
                              "likes",
                              "comments",
                              "reactions",
                              "shares",
                              "views"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "required": [
                          "source_post_id",
                          "id_namespace",
                          "shortcode",
                          "source_account_id",
                          "author",
                          "canonical_url",
                          "text",
                          "published_at",
                          "media_kind",
                          "metrics"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "coverage": {
                      "type": "object",
                      "properties": {
                        "complete": {
                          "type": "boolean",
                          "const": false
                        },
                        "reasons": {
                          "maxItems": 20,
                          "type": "array",
                          "items": {
                            "type": "string",
                            "enum": [
                              "initial_page_only",
                              "public_web_ids",
                              "metrics_unavailable",
                              "profile_only",
                              "no_attributable_posts",
                              "foreign_or_malformed_rows",
                              "parser_limit",
                              "unsupported_payload",
                              "blocked",
                              "rate_limited",
                              "upstream_http_error",
                              "redirect_rejected",
                              "unsupported_content_type",
                              "response_too_large",
                              "timeout",
                              "aborted",
                              "network_error",
                              "inconsistent_identity",
                              "research_limit",
                              "source_removed"
                            ]
                          }
                        },
                        "omitted_rows": {
                          "type": "integer",
                          "minimum": 0,
                          "maximum": 9007199254740991
                        },
                        "next_cursor": {
                          "type": "null"
                        }
                      },
                      "required": [
                        "complete",
                        "reasons",
                        "omitted_rows",
                        "next_cursor"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "source",
                    "platform",
                    "canonical_url",
                    "fetched_at",
                    "expires_at",
                    "upstream_updated_at",
                    "status",
                    "profile",
                    "posts",
                    "coverage"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            },
            "evidence": {
              "maxItems": 20,
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "evidence_id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "revision": {
                    "type": "integer",
                    "exclusiveMinimum": 0,
                    "maximum": 9007199254740991
                  }
                },
                "required": [
                  "evidence_id",
                  "revision"
                ],
                "additionalProperties": false
              }
            }
          },
          "required": [
            "id",
            "workspace_id",
            "mutation_id",
            "kind",
            "state",
            "created_at",
            "settled_at",
            "valid_until",
            "result",
            "evidence"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "retrieval"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

工具呼叫範例

這些範例使用已依結構描述檢查的虛構值。請將 ID 替換為您有權使用的 ID、將媒體替換為已就緒素材，並將日期替換為已確認的發布時間。提交寫入前，請檢查帳號資格。本頁不會傳送 API 請求。

{
  "name": "sosoapi_research_evidence_social-status",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "mutation_id": "40000000-0000-4000-8000-000000000005"
  }
}

structuredContent

{
  "retrieval": {
    "id": "30000000-0000-4000-8000-000000000007",
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "mutation_id": "40000000-0000-4000-8000-000000000005",
    "kind": "public_social",
    "state": "completed",
    "created_at": "2099-01-15T09:00:00Z",
    "settled_at": "2099-01-15T09:00:01Z",
    "valid_until": "2099-01-16T09:00:00Z",
    "evidence": [],
    "result": {
      "source": "instagram_public_web",
      "platform": "instagram",
      "canonical_url": "https://www.instagram.com/fictional_example/",
      "fetched_at": "2099-01-15T09:00:00Z",
      "expires_at": "2099-01-16T09:00:00Z",
      "upstream_updated_at": null,
      "status": "unavailable",
      "profile": null,
      "posts": [],
      "coverage": {
        "complete": false,
        "reasons": [
          "blocked"
        ],
        "omitted_rows": 0,
        "next_cursor": null
      }
    }
  }
}
安裝或連結 MCP