Skip to main content
Glama

SocialDataX TikTok MCP

tiktok_get_post_comments_by_url

Read-only

根据 TikTok 作品页面链接获取一级评论,支持 page_token 翻页。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
urlYesTikTok 作品页面链接;可直接使用 tiktok_search_posts 返回的 content_type=video 或 image 的 share_url
page_tokenNo分页令牌。首页传空字符串;next_page_token 为空字符串表示没有更多结果。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回;它是不透明令牌,不能修改、截断、脱敏、格式化、重组,也不能跨关键词、筛选条件或不同请求链路复用。

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
itemsYes当前页一级评论列表
pointsYes本次成功调用的积分消耗与调用完成时的账户积分余额。
comment_countYes作品评论总量;当前不可用时为 null
next_page_tokenYes分页令牌。首页传空字符串;next_page_token 为空字符串表示没有更多结果。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回;它是不透明令牌,不能修改、截断、脱敏、格式化、重组,也不能跨关键词、筛选条件或不同请求链路复用。

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.9/5.0
Behavior3/5

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

annotations 已声明 readOnlyHint=true,因此安全性方面由结构化信息覆盖。描述额外补充了“支持 page_token 翻页”和“只返回一级评论”的行为,但没有进一步说明结果数量限制、无评论时的行为等;在已有 annotations 的情况下仍然够用但不算丰富。

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

Conciseness5/5

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

描述只有一句话,但完整包含了动作、资源、范围和分页能力,信息密度高且前置了核心用途。没有任何冗余或重复 schema 的内容。

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

Completeness5/5

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

对于只有 2 个参数、有输出 schema、且已带 readOnlyHint 的只读工具,描述加上 schema 已覆盖调用所需的全部关键信息:URL 来源、一级评论范围、分页令牌规则。没有明显缺失的调用要素。

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 描述覆盖率 100%,url 和 page_token 的语义都已在 input schema 中详细说明,尤其是 page_token 的不透明令牌规则。工具描述本身只重复了翻页能力,未在 schema 之外增加参数含义,因此符合高覆盖率的基线评分。

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

Purpose5/5

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

描述使用具体的动词“获取”、明确的资源“TikTok 作品页面链接”和范围“一级评论”,清楚说明工具做什么。与 tiktok_get_post_comments_by_post_id 和 tiktok_get_post_comment_replies 相比,按 URL 和一级评论的表述足以区分,不需要打开 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?

描述给出了使用场景:有 TikTok 作品页面链接且需要一级评论时使用,并提供翻页能力。但它没有明确说明与替代工具的边界,例如需要评论回复时应改用 tiktok_get_post_comment_replies,或者已有 post ID 时应改用 tiktok_get_post_comments_by_post_id;这些区分只能从工具名和“一级评论”中推断。

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources