SocialDataX 今日头条 MCP

Every tool targets a distinct resource+action, and the potentially confusing pairs (post detail vs. comments, comments vs. comment replies, user info vs. user posts, search posts vs. search users vs. suggestions) are explicitly differentiated in their descriptions. The by-post-id vs. by-url variants self-document their routing rule ("use X when you have a numeric ID, Y when you have a link"), leaving no real ambiguity.

All tools follow a strict snake_case namespace_verb_object_qualifier pattern (toutiao_get_post_detail_by_post_id, toutiao_search_users, etc.), with consistent get_/search_ verb usage and uniform _by_post_id/_by_user_id/_by_url suffixes. The single account tool uses the socialdatax_ namespace prefix but the same verb_noun shape, which reads as intentional scoping rather than inconsistency.

14 tools is comfortably within the well-scoped range and each covers a real read path (detail, comments, replies, user profile, user posts, search, hot list, balance). The one inefficiency is the id/url duplication, which inflates the surface by roughly five pairs that a single input-flexible tool could handle.

The read-only surface covers the core Toutiao workflows end to end: discovery (hot search, suggestions), search (posts/users), content detail, two-level comments, and user profile plus works, with clear pagination semantics. Minor gaps exist—no standalone lookup of a comment by ID, no follower/following or topic-detail endpoints, and no non-hot-list trend browsing—but nothing that blocks typical agent tasks.