SocialDataX TikTok MCP

tiktok_get_user_posts_by_tiktok_id

Read-only

根据 TikTok 号获取用户作品列表，支持 page_token 翻页。

Input Schema

Name	Required	Description	Default
`tiktok_id`	Yes	非空 TikTok 号，即用户主页 @ 后的标识；可使用用户搜索结果中的 TikTok 号，也可使用其他搜索、详情、评论或评论回复结果中 author.tiktok_id 的值；不要带 @，不要传用户主页链接
`page_token`	No	请求分页令牌是不透明令牌。请求的 page_token 为空字符串表示首页；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；不能修改、截断、脱敏、格式化、重组，也不能跨关键词、筛选条件或不同请求链路复用。

Output Schema

Name	Required	Description
`items`	Yes	当前页用户作品列表
`points`	Yes	本次成功调用的积分消耗与账户积分余额。
`next_page_token`	Yes	响应分页令牌是不透明令牌。响应的 next_page_token 为空字符串表示没有更多结果；非空时必须将完整令牌原样作为下一次请求的 page_token 传回；不能修改、截断、脱敏、格式化、重组，也不能跨关键词、筛选条件或不同请求链路复用。

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedNov 4, 2026

changedOutput schema / properties / points / description

Previous value: -"本次成功调用的积分消耗与调用完成时的账户积分余额。"New value: +"本次成功调用的积分消耗与账户积分余额。"

changedOutput schema / properties / points / properties / balance / description

Previous value: -"本次接口完成时看到的当前积分余额，可为负数。"New value: +"优先返回调用完成时查询到的账户积分余额。查询失败时，回退到本次预扣后的余额快照。余额可为负数。"

Changed2 schema fields changedNov 4, 2026
- changedOutput schema / properties / points / properties / balance / description
```
Previous value: -"本次接口完成时看到的当前积分余额。"New value: +"本次接口完成时看到的当前积分余额，可为负数。"
```
- removedOutput schema / properties / points / properties / balance / minimum
```
Removed value: -0
```

Changed29 schema fields changedNov 3, 2026

addedOutput schema / properties / items / items / properties / author / properties / avatar_url / title
```
Added value: +"Avatar Url"
```
addedOutput schema / properties / items / items / properties / author / properties / bio / title
```
Added value: +"Bio"
```
addedOutput schema / properties / items / items / properties / author / properties / name / title
```
Added value: +"Name"
```
addedOutput schema / properties / items / items / properties / author / properties / profile_url / title
```
Added value: +"Profile Url"
```
addedOutput schema / properties / items / items / properties / author / properties / tiktok_id / title
```
Added value: +"Tiktok Id"
```
addedOutput schema / properties / items / items / properties / author / properties / user_id / title
```
Added value: +"User Id"
```
addedOutput schema / properties / items / items / properties / author / properties / verified / title
```
Added value: +"Verified"
```
addedOutput schema / properties / items / items / properties / author / title
```
Added value: +"TikTokPostSearchAuthorData"
```
addedOutput schema / properties / items / items / properties / collect_count / title
```
Added value: +"Collect Count"
```
addedOutput schema / properties / items / items / properties / comment_count / title
```
Added value: +"Comment Count"
```
addedOutput schema / properties / items / items / properties / cover_image_url / title
```
Added value: +"Cover Image Url"
```
addedOutput schema / properties / items / items / properties / description / title
```
Added value: +"Description"
```
addedOutput schema / properties / items / items / properties / is_pinned / title
```
Added value: +"Is Pinned"
```
addedOutput schema / properties / items / items / properties / like_count / title
```
Added value: +"Like Count"
```

changedOutput schema / properties / items / items / properties / music / anyOf

Previous value: -[
-  {
-    "properties": {
-      "author": {
-        "description": "音乐作者；当前不可用时为空字符串",
-        "type": "string"
-      },
-      "duration_ms": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "音乐时长，毫秒；当前不可用时为 null"
-      },
-      "music_id": {
-        "description": "音乐 ID；长数字字符串，原样保留，不要转为数字；当前仅作为作品音乐标识返回",
-        "type": "string"
-      },
-      "play_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "音乐播放资源链接；可能随时间失效；当前不可用时为 null；不要把 play_url 当作音乐 ID 使用"
-      },
-      "title": {
-        "description": "音乐标题；当前不可用时为空字符串",
-        "type": "string"
-      }
-    },
-    "required": [
-      "music_id",
-      "title",
-      "author",
-      "play_url",
-      "duration_ms"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "author": {
+        "description": "音乐作者；当前不可用时为空字符串",
+        "title": "Author",
+        "type": "string"
+      },
+      "duration_ms": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "音乐时长，毫秒；当前不可用时为 null",
+        "title": "Duration Ms"
+      },
+      "music_id": {
+        "description": "音乐 ID；长数字字符串，原样保留，不要转为数字；当前仅作为作品音乐标识返回",
+        "title": "Music Id",
+        "type": "string"
+      },
+      "play_url": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "音乐播放资源链接；可能随时间失效；当前不可用时为 null；不要把 play_url 当作音乐 ID 使用",
+        "title": "Play Url"
+      },
+      "title": {
+        "description": "音乐标题；当前不可用时为空字符串",
+        "title": "Title",
+        "type": "string"
+      }
+    },
+    "required": [
+      "music_id",
+      "title",
+      "author",
+      "play_url",
+      "duration_ms"
+    ],
+    "title": "TikTokUserPostMusicData",
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / items / items / properties / play_count / title
```
Added value: +"Play Count"
```
addedOutput schema / properties / items / items / properties / post_id / title
```
Added value: +"Post Id"
```
addedOutput schema / properties / items / items / properties / publish_time / title
```
Added value: +"Publish Time"
```
addedOutput schema / properties / items / items / properties / share_count / title
```
Added value: +"Share Count"
```
addedOutput schema / properties / items / items / properties / share_url / title
```
Added value: +"Share Url"
```
addedOutput schema / properties / items / items / properties / topic_tags / items / properties / name / title
```
Added value: +"Name"
```
addedOutput schema / properties / items / items / properties / topic_tags / items / properties / topic_id / title
```
Added value: +"Topic Id"
```
addedOutput schema / properties / items / items / properties / topic_tags / items / title
```
Added value: +"TikTokTopicTagData"
```
addedOutput schema / properties / items / items / properties / topic_tags / title
```
Added value: +"Topic Tags"
```

changedOutput schema / properties / items / items / properties / video / anyOf

Previous value: -[
-  {
-    "properties": {
-      "duration_ms": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "视频时长，毫秒；当前不可用时为 null"
-      },
-      "height": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "视频高度，像素；当前不可用时为 null"
-      },
-      "play_url": {
-        "description": "视频播放资源链接；不是作品页面链接；可能随时间失效；如果不可用，外层 video 为 null",
-        "type": "string"
-      },
-      "width": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "视频宽度，像素；当前不可用时为 null"
-      }
-    },
-    "required": [
-      "play_url",
-      "duration_ms",
-      "width",
-      "height"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "duration_ms": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "视频时长，毫秒；当前不可用时为 null",
+        "title": "Duration Ms"
+      },
+      "height": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "视频高度，像素；当前不可用时为 null",
+        "title": "Height"
+      },
+      "play_url": {
+        "description": "视频播放资源链接；不是作品页面链接；可能随时间失效；如果不可用，外层 video 为 null",
+        "title": "Play Url",
+        "type": "string"
+      },
+      "width": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "视频宽度，像素；当前不可用时为 null",
+        "title": "Width"
+      }
+    },
+    "required": [
+      "play_url",
+      "duration_ms",
+      "width",
+      "height"
+    ],
+    "title": "TikTokUserPostVideoData",
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / items / items / title
```
Added value: +"TikTokUserPostItemData"
```
addedOutput schema / properties / items / title
```
Added value: +"Items"
```
addedOutput schema / properties / next_page_token / title
```
Added value: +"Next Page Token"
```
addedOutput schema / title
```
Added value: +"TikTokUserPostsResult"
```

Changed1 schema field changedOct 20, 2026

addedOutput schema / properties / items / items / properties / is_pinned

Added value: +{
+  "default": false,
+  "description": "是否为主页置顶作品",
+  "type": "boolean"
+}

Changed5 schema fields changedOct 2, 2026

changedInput schema / properties / page_token / description

Previous value: -"分页令牌。首页传空字符串；next_page_token 为空字符串表示没有更多结果。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；它是不透明令牌，不能修改、截断、脱敏、格式化、重组，也不能跨关键词、筛选条件或不同请求链路复用。"New value: +"请求分页令牌是不透明令牌。请求的 page_token 为空字符串表示首页；继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；不能修改、截断、脱敏、格式化、重组，也不能跨关键词、筛选条件或不同请求链路复用。"

changedInput schema / properties / tiktok_id / description

Previous value: -"TikTok 号，即用户主页 @ 后的标识；可直接使用搜索、详情、评论或评论回复结果中 author.tiktok_id 的值；不要带 @，不要传用户主页链接"New value: +"非空 TikTok 号，即用户主页 @ 后的标识；可使用用户搜索结果中的 TikTok 号，也可使用其他搜索、详情、评论或评论回复结果中 author.tiktok_id 的值；不要带 @，不要传用户主页链接"

addedInput schema / properties / tiktok_id / minLength
```
Added value: +1
```
addedInput schema / properties / tiktok_id / pattern
```
Added value: +".*\\S.*"
```

changedOutput schema / properties / next_page_token / description

Previous value: -"分页令牌。首页传空字符串；next_page_token 为空字符串表示没有更多结果。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；它是不透明令牌，不能修改、截断、脱敏、格式化、重组，也不能跨关键词、筛选条件或不同请求链路复用。"New value: +"响应分页令牌是不透明令牌。响应的 next_page_token 为空字符串表示没有更多结果；非空时必须将完整令牌原样作为下一次请求的 page_token 传回；不能修改、截断、脱敏、格式化、重组，也不能跨关键词、筛选条件或不同请求链路复用。"

First observedSep 1, 2026

TDQS

A3.5/5.0

Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true and openWorldHint=true, so safety is covered. The description only adds that pagination is supported; it says nothing about result ordering, page size, whether a full history is returned, or the cost/limits of repeated paging calls, which matters for an open-world scraper-style endpoint.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single short sentence with the core action front-loaded and no filler. It is efficient, though so terse that it borders on under-specification rather than optimal conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema present and full parameter documentation in the schema, the description needn't explain return values. The main remaining gap is disambiguation from the profile-URL sibling and any note on paging depth, which keeps it from a 5.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so both tiktok_id and page_token are already documented in detail, including the 'no @, no URL' constraint and the opaque-token rule. The description's '支持 page_token 翻页' merely restates what the schema says, adding no new meaning.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: retrieve a user's post/video list identified by TikTok ID. It implicitly contrasts with the URL-based sibling ('根据 TikTok 号' vs. by_profile_url), but never names that sibling explicitly, so an agent must infer the distinction from the schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage is only implied: the phrasing suggests using this when you have a TikTok ID rather than a profile URL. There is no explicit when-to-use/when-not-to-use statement nor a pointer to tiktok_get_user_posts_by_profile_url as the alternative.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All SocialDataX TikTok MCP tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?