MCP 工具

在本機建立依序排列的圖片 PDF

sosoapi_build_image_pdf

依陣列順序，將 1–20 張已獲授權存取的 Workspace PNG/JPEG 圖片製成可下載的純圖片 PDF，以及對應的 JPEG 頁面預覽。完整放入圖片而不裁切；支援 Unicode 標題，以及正方形、直向或橫向頁面。輸出最大 50 MiB。回傳本機檔案及來源記錄。不依賴 LinkedIn 存取權限；不會將 PDF 登記為圖片，也不會發布。

閱讀 Markdown

設定與傳輸方式

設定： core、full · 傳輸方式： stdio

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

權限與副作用

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

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

/assets-api/get：agent:operate · synchronous_http_response

輸入欄位

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

輸入欄位
欄位 / 分支	類型 / 必填	約束
`$`	`object`在父物件中必填	`additionalProperties: false`
`workspace_id`	`string`在父物件中必填	`format: "uuid"`
`source_asset_ids`	`array`在父物件中必填	`minItems: 1` `maxItems: 20`
`source_asset_ids[]`	`integer`選填／項目	`maximum: 9007199254740991` `exclusiveMinimum: 0`
`title`	`string`在父物件中必填	`minLength: 1` `maxLength: 200`
`preset`	`string`在父物件中必填	`enum: ["square","portrait","landscape"]`

完整 JSON Schema

{
  "type": "object",
  "properties": {
    "workspace_id": {
      "type": "string",
      "format": "uuid"
    },
    "source_asset_ids": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "integer",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991
      }
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "preset": {
      "type": "string",
      "enum": [
        "square",
        "portrait",
        "landscape"
      ]
    }
  },
  "required": [
    "workspace_id",
    "source_asset_ids",
    "title",
    "preset"
  ],
  "additionalProperties": false
}

結構化輸出

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

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

結構化輸出
欄位 / 分支	類型 / 必填	約束
`$`	`object`在父物件中必填	`additionalProperties: {}`
`stage`	`string`在父物件中必填	`enum: ["ready","failed"]`
`output_directory`	`string`選填／項目	—
`manifest_path`	`string`選填／項目	—
`preview_path`	`string`選填／項目	—
`retryable`	`boolean`選填／項目	—
`$.*`	`any JSON value`選填／項目	—

完整 JSON Schema

{
  "type": "object",
  "properties": {
    "stage": {
      "type": "string",
      "enum": [
        "ready",
        "failed"
      ]
    },
    "output_directory": {
      "type": "string"
    },
    "manifest_path": {
      "type": "string"
    },
    "preview_path": {
      "type": "string"
    },
    "retryable": {
      "type": "boolean"
    }
  },
  "required": [
    "stage"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": {}
}

工具呼叫範例

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

{
  "name": "sosoapi_build_image_pdf",
  "arguments": {
    "workspace_id": "11111111-1111-4111-8111-111111111111",
    "source_asset_ids": [
      42,
      43
    ],
    "title": "圖片 / Images",
    "preset": "portrait"
  }
}

structuredContent

{
  "stage": "ready",
  "output_directory": "/tmp/sosoapi-preparation-example",
  "manifest_path": "/tmp/sosoapi-preparation-example/manifest.json",
  "preview_path": "/tmp/sosoapi-preparation-example/preview.html",
  "file_path": "/tmp/sosoapi-preparation-example/document.pdf",
  "title": "圖片 / Images",
  "preset": "portrait",
  "pages": [
    {
      "source_asset_id": 42
    },
    {
      "source_asset_id": 43
    }
  ]
}

/assets-api/get

安裝或連結 MCP