Skip to main content
Glama
TikTok Intelligence MCP Server

TikTok Intelligence MCP Server

by willowswt

mine_buyer_intent_comments

Read-onlyIdempotent

Scan TikTok comments by keyword or video URL to identify high-intent buyer questions and competitor pain, scoring each lead 0-100 with commenter handles.

Instructions

Scan TikTok video comments (keyword or videoUrl) for high-intent buyers asking "where to buy", "link?", "price?", "what tool is this", or competitor pain, scored 0-100 with commenter handles.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "mine_buyer_intent_comments"
  }
}

Input Schema

NameRequiredDescriptionDefault
keywordNoNiche or competitor keyword (e.g. "shopify tips", "crm software").
maxLeadsNoMaximum buyer-intent comment leads to return (1-20, default 8).
videoUrlNoOptional specific TikTok video URL.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv1.0.0

TDQS

A3.9/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, non-destructive and open-world, so the safety profile is covered. The description goes further by disclosing what counts as a lead, that results are scored 0-100 and include commenter handles, and that scanning is driven by a niche keyword or a specific video URL. It does not mention volume, rate limits or timing, which keeps it below a 5.

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 dense sentence, front-loaded with the verb and resource, and every clause carries information (input modes, intent phrases, scoring, handles). The unbroken phrasing with embedded quoted examples is slightly harder to parse than a short structured breakdown would be.

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 no output schema, the description does supply the key return characteristics (0-100 score plus commenter handles) and the detection categories. The main gap is the unresolved question of whether keyword, videoUrl, or both are required, since no parameters are marked required and the tool cannot run without one.

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 coverage is 100%, so all three parameters, their examples and the maxLeads range are already documented. The description adds only the framing that keyword and videoUrl are alternative scan modes; maxLeads and the 1-20 bound are left entirely to the 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?

Names a specific verb (scan) and resource (TikTok video comments) plus the exact signal being hunted: buyer-intent phrases like "where to buy", "link?", "price?" and competitor pain. This is clearly distinguishable from the sibling tools, which target hooks, sounds, sponsors, emails and video search rather than comment intent.

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?

The parenthetical '(keyword or videoUrl)' implies the two input modes, but there is no explicit when-to-use guidance, no statement of which mode to prefer, and no exclusions relative to alternatives. The agent must infer that this tool is chosen when the goal is lead harvesting from comments.

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