comments-analysis

name	comments-analysis
description	Pull and analyze the comments on a post/video — sentiment breakdown, recurring themes/keywords, top comments, and notable questions or complaints. Use when the user says "analyze the comments", "what are people saying on this post", "comment sentiment", or pastes a post URL and wants the discussion summarized.

Comments Analysis

Mine a single post's comment section for sentiment and themes.

Setup gate

[ -z "${TIKHUB_API_KEY:-}" ] && echo "Set TIKHUB_API_KEY first (see tikhub-onboarding)."

Workflow

1. Identify the post (platform + id/URL).
2. Fetch comments, paginating to a target count (cap it):
   • TikTok: app/v3/fetch_video_comments (aweme_id, cursor). Douyin: app/v3/fetch_video_comments (aweme_id, cursor).
   • Instagram: v2/fetch_post_comments (+ fetch_comment_replies).
   • YouTube: web_v2/get_video_comments (+ get_video_comment_replies).
   • Twitter: web/fetch_post_comments. Xiaohongshu: app_v2/get_note_comments.
3. Optional fast keywords: TikTok analytics/fetch_comment_keywords (item_id) gives a comment keyword summary directly.
4. Analyze: sentiment breakdown, top themes with example quotes, most-liked comments, and any recurring questions/complaints.
5. Deliver a summary with cited example comments.

Cost awareness

Each comment page (and reply page) is a billed call. Cap pages; warn for viral posts with huge threads. Estimate via calculate_price.

Verification gate

1. Comments fetched and tied to the right post.
2. Themes/sentiment backed by quoted comments.
3. Report the sample size (comments analyzed vs. total).

Red flags

• Summarizing 50 comments on a 50k-comment post as representative — disclose the sample.
• Unbounded reply pagination.