socialdatax-skills 0.2.43 → 0.2.44

package/README.md

@@ -89,7 +89,7 @@ Common search phrases for this skill package:
 - Reserved future SocialDataX namespace names for existing platform listings without draft files yet: `com.socialdatax/kuaishou-insights`, `com.socialdatax/bilibili-insights`, `com.socialdatax/weibo-insights`, `com.socialdatax/wechat-channels-insights`, `com.socialdatax/zhihu-insights`, `com.socialdatax/instagram-insights`, `com.socialdatax/x-insights`, `com.socialdatax/youtube-insights`, and `com.socialdatax/tiktok-insights`.
 - Hosted endpoint without a repo-tracked standalone listing: Sensitive Words Check.
 - Unified MCP registry name: none; this package installs skills and calls explicit hosted MCP entries.
-- Current public capability version: `0.2.43`
+- Current public capability version: `0.2.44`
 
 ## Direct CLI
 
@@ -169,6 +169,7 @@ npx -y socialdatax-skills@latest weibo search --keyword "露营" --pretty
 npx -y socialdatax-skills@latest weibo detail --post-id "<post_id>" --pretty
 npx -y socialdatax-skills@latest weibo detail --post-url "<weibo_post_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest weibo comments --post-id "<post_id>" --pretty
+npx -y socialdatax-skills@latest weibo comments --post-id "<post_id>" --sort-type time_descending --pretty
 npx -y socialdatax-skills@latest weibo comments --post-id "<post_id>" --all --include-replies --pretty
 npx -y socialdatax-skills@latest weibo comments --post-url "<weibo_post_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest weibo replies --post-id "<post_id>" --comment-id "<comment_id>" --pretty
@@ -278,7 +279,7 @@ YouTube reply pagination starts from the returned first-level comment `reply_tok
 XHS comments accept optional `--sort-type` values: `default`,
 `time_descending`, and `like_count_descending`; omit it for the platform
 default comment order.
-Bilibili and YouTube comments accept optional `--sort-type` values: `hot` and
+Bilibili, Weibo, and YouTube comments accept optional `--sort-type` values: `hot` and
 `time_descending`; Zhihu comments accept `default` and `time_descending`.
 Omit comment sort values for the platform default order.
 
@@ -530,7 +531,7 @@ Current Weibo workflows include:
 - Fetch the current Weibo / 微博 hot-search list.
 - Search related Weibo posts by keyword.
 - Resolve a Weibo post URL, short link, share text, or post_id into structured post details.
-- Fetch paginated first-level comments for comment analysis.
+- Fetch paginated first-level comments for comment analysis, optionally sorted by `hot` or `time_descending`.
 - Fetch paginated replies under a first-level comment.
 - Continue Weibo list pagination only when `next_page_token` is non-empty; an empty string means there are no more results to request.
 - Read Weibo creator profile data from a user profile link or user_id.
@@ -706,8 +707,8 @@ Current Sensitive Words Check workflows include:
 | `weibo_search_posts` | Search Weibo posts by keyword with optional `page_token` continuation; do not pass `page`. |
 | `weibo_get_post_detail_by_post_id` | Fetch structured Weibo post details when the caller already has a post_id. |
 | `weibo_get_post_detail_by_post_url` | Resolve a Weibo post URL, short link, or share text into structured post details. |
-| `weibo_get_post_comments_by_post_id` | Fetch paginated first-level comments when the caller already has a post_id. |
-| `weibo_get_post_comments_by_post_url` | Fetch paginated first-level comments directly from a Weibo post URL, short link, or share text. |
+| `weibo_get_post_comments_by_post_id` | Fetch paginated first-level comments by post_id with optional `sort_type` (`hot` or `time_descending`). |
+| `weibo_get_post_comments_by_post_url` | Fetch paginated first-level comments from a Weibo post URL, short link, or share text with optional `sort_type` (`hot` or `time_descending`). |
 | `weibo_get_post_comment_replies_by_comment_id` | Fetch paginated replies under a first-level comment by post_id and comment_id. |
 | `weibo_get_post_liker_list_by_post_id` | Fetch paginated users who liked a Weibo post by post_id. |
 | `weibo_get_post_liker_list_by_post_url` | Fetch paginated users who liked a Weibo post from a post page link, short link, or share text. |

package/cli.mjs

@@ -22,7 +22,7 @@ import { decryptWechatMediaCommand } from "./lib/media/wechat-decrypt.mjs";
 export { decryptWechatMediaCommand };
 
 const PACKAGE_NAME = "socialdatax-skills";
-const PACKAGE_VERSION = "0.2.43";
+const PACKAGE_VERSION = "0.2.44";
 const PACKAGE_SPEC = `${PACKAGE_NAME}@latest`;
 const LOG_PREFIX = `[${PACKAGE_NAME}]`;
 const MIN_NODE_VERSION = "20.18.1";
@@ -702,6 +702,7 @@ const WEIBO_DIRECT_ACTION_OPTIONS = {
     "all",
     "maxItems",
     "includeReplies",
+    "sortType",
     "pretty",
   ],
   replies: [
@@ -739,6 +740,7 @@ const WEIBO_OPTION_DISPLAY_NAMES = {
   sinceDays: "--since-days",
   all: "--all",
   includeReplies: "--include-replies",
+  sortType: "--sort-type",
   postId: "--post-id",
   postUrl: "--post-url",
   commentId: "--comment-id",
@@ -751,6 +753,7 @@ const WEIBO_OPTION_DISPLAY_NAMES = {
   outputDir: "--output-dir",
   proxy: "--proxy",
 };
+const WEIBO_COMMENT_SORT_TYPES = ["hot", "time_descending"];
 const WECHAT_DIRECT_ACTION_OPTIONS = {
   "hot-search": ["pretty"],
   search: [
@@ -1251,11 +1254,13 @@ const PLATFORMS = {
       },
       {
         name: "weibo_get_post_comments_by_post_id",
-        description: "Fetch paginated first-level comments when the caller already has a post_id.",
+        description:
+          "Fetch paginated first-level comments by post_id with optional hot or newest-first sorting.",
       },
       {
         name: "weibo_get_post_comments_by_post_url",
-        description: "Fetch paginated first-level comments from a Weibo post URL, short link, or share text.",
+        description:
+          "Fetch paginated first-level comments from a Weibo post URL, short link, or share text with optional hot or newest-first sorting.",
       },
       {
         name: "weibo_get_post_comment_replies_by_comment_id",
@@ -3357,7 +3362,7 @@ function printHelp() {
   console.log("  --publish-time-range <all|day|week|month|three_months|half_year|year>");
   console.log("      Zhihu search publish-time filter; omit for no filter.");
   console.log("  --sort-type <hot|time_descending>");
-  console.log("      X search sort and YouTube comments sort; omit for default sort.");
+  console.log("      X search, Weibo comments, and YouTube comments sort; omit for default sort.");
   console.log("  --sort-type <general|time_descending|view_count_descending|rating>");
   console.log("      YouTube search sort; omit for default sort.");
   console.log("  --video-type <all|video|movie>");
@@ -4403,6 +4408,7 @@ function buildWeiboOperation(action, options) {
           idDisplay: "--post-id",
           urlDisplay: "--post-url",
           pageToken: options.pageToken,
+          extraArguments: buildWeiboCommentsExtraArguments(options),
         }),
         PLATFORMS.weibo
       );
@@ -5135,6 +5141,19 @@ function buildXhsCommentsExtraArguments(options) {
   return toolArguments;
 }
 
+function buildWeiboCommentsExtraArguments(options) {
+  const toolArguments = {};
+  if (options.sortType !== undefined) {
+    toolArguments.sort_type = parseAllowedStringOption(
+      options.sortType,
+      "--sort-type",
+      WEIBO_COMMENT_SORT_TYPES,
+      WEIBO_COMMENT_SORT_TYPES.join(", ")
+    );
+  }
+  return toolArguments;
+}
+
 function buildTranscriptCall(
   options,
   {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "socialdatax-skills",
-  "version": "0.2.43",
+  "version": "0.2.44",
   "description": "SocialDataX / 社媒数据助手 skill installer and direct CLI helper for hosted MCP services.",
   "license": "MIT",
   "type": "module",

package/skills/media-comments/SKILL.md

@@ -242,6 +242,7 @@ Optional arguments:
 - TikTok `--post-id <post_id>` or `--url <tiktok_post_url_or_share_text>`: use for first-level comments; replies require `--post-id <post_id>` and `--comment-id <comment_id>`.
 - Weibo `--post-id <post_id>`: preferred when the Weibo post ID is already known and should anchor the comment thread.
 - Weibo `--post-url <weibo_post_url_or_share_text>`: use for a Weibo post URL, short link, or share text for first-level comments.
+- Weibo comments `--sort-type <hot|time_descending>`: optional first-level comment sort order; omit it for the default `hot` order, and keep it unchanged when continuing with `--page-token`.
 - WeChat Channels / 视频号 `--object-id <object_id>` and `--object-nonce-id <object_nonce_id>`: use together when both values are already known and should anchor the comment thread.
 - WeChat Channels / 视频号 `--url <wechat_video_url_or_share_text>`: use for a WeChat Channels video link or share text for first-level comments.
 - `--source-client socialdatax-skills --source-platform npm --source-skill media-comments`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.
@@ -300,8 +301,8 @@ If MCP tools are already available in the current agent, use one of these tools:
 - `tiktok_get_post_comments_by_post_id`: use when the TikTok post_id is known.
 - `tiktok_get_post_comments_by_url`: use for TikTok post URLs or share text.
 - `tiktok_get_post_comment_replies`: use when the TikTok post_id and first-level comment ID are known.
-- `weibo_get_post_comments_by_post_id`: use when the post_id is known.
-- `weibo_get_post_comments_by_post_url`: use for Weibo post URLs, short links, or share text.
+- `weibo_get_post_comments_by_post_id`: use when the post_id is known; optional `sort_type` accepts `hot` or `time_descending`.
+- `weibo_get_post_comments_by_post_url`: use for Weibo post URLs, short links, or share text; optional `sort_type` accepts `hot` or `time_descending`.
 - `weibo_get_post_comment_replies_by_comment_id`: use when the post_id and first-level comment ID are known.
 - For Weibo comments and replies, continue only when `next_page_token` is non-empty; an empty string means there are no more comments or replies to request.
 - `wechat_get_video_comments_by_object_id`: use when both object_id and object_nonce_id are known.