socialdatax-skills 0.2.42 → 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.42`
+- 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
@@ -193,6 +194,7 @@ npx -y socialdatax-skills@latest wechat comments --object-id "<object_id>" --obj
 npx -y socialdatax-skills@latest wechat comments --url "<wechat_video_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest wechat replies --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --comment-id "<comment_id>" --pretty
 npx -y socialdatax-skills@latest wechat user-info --user-id "<v2_finder_user_id>" --pretty
+npx -y socialdatax-skills@latest wechat user-info --url "<wechat_work_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest wechat user-posts --user-id "<v2_finder_user_id>" --pretty
 npx -y socialdatax-skills@latest wechat user-posts --url "<wechat_work_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest wechat transcript --url "<wechat_video_url_or_share_text>" --pretty
@@ -277,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.
 
@@ -529,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.
@@ -705,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.42";
+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: [
@@ -788,7 +791,7 @@ const WECHAT_DIRECT_ACTION_OPTIONS = {
     "includeReplies",
     "pretty",
   ],
-  "user-info": ["userId", "pretty"],
+  "user-info": ["userId", "url", "pretty"],
   "user-posts": [
     "userId",
     "url",
@@ -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",
@@ -3077,6 +3082,9 @@ function printHelp() {
   console.log(`  npx -y ${PACKAGE_SPEC} wechat user-info --user-id "<v2_finder_user_id>" --pretty`);
   console.log("      Call the WeChat Channels / 视频号 creator profile tool with a v2_...@finder user_id.");
   console.log("");
+  console.log(`  npx -y ${PACKAGE_SPEC} wechat user-info --url "<wechat_work_url_or_share_text>" --pretty`);
+  console.log("      Resolve a WeChat Channels / 视频号 video or image-post link or share text into creator profile data.");
+  console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} wechat user-posts --user-id "<v2_finder_user_id>" --pretty`);
   console.log("      Call the WeChat Channels / 视频号 creator videos and image posts tool with a v2_...@finder user_id.");
   console.log("");
@@ -3354,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>");
@@ -4400,6 +4408,7 @@ function buildWeiboOperation(action, options) {
           idDisplay: "--post-id",
           urlDisplay: "--post-url",
           pageToken: options.pageToken,
+          extraArguments: buildWeiboCommentsExtraArguments(options),
         }),
         PLATFORMS.weibo
       );
@@ -4531,12 +4540,15 @@ function buildWechatOperation(action, options) {
     case "user-info":
       return buildDirectOperation(
         "user-info",
-        buildRequiredIdCall(options, {
+        buildOneOfCall(options, {
           idOption: "userId",
-          tool: "wechat_get_user_info_by_user_id",
+          urlOption: "url",
+          idTool: "wechat_get_user_info_by_user_id",
+          urlTool: "wechat_get_user_info_by_url",
           idArgument: "user_id",
+          urlArgument: "url",
           idDisplay: "--user-id",
-          platformLabel: "wechat user-info",
+          urlDisplay: "--url",
         }),
         PLATFORMS.wechat
       );
@@ -5129,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.42",
+  "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.

package/skills/media-user-info/SKILL.md

@@ -142,6 +142,10 @@ npx -y socialdatax-skills@latest weibo user-info \
 npx -y socialdatax-skills@latest wechat user-info \
   --user-id "<v2_finder_user_id>" --pretty --source-client socialdatax-skills \
   --source-platform npm --source-skill media-user-info
+
+npx -y socialdatax-skills@latest wechat user-info \
+  --url "<wechat_work_url_or_share_text>" --pretty --source-client socialdatax-skills \
+  --source-platform npm --source-skill media-user-info
 ```
 
 Optional arguments:
@@ -166,9 +170,10 @@ Optional arguments:
 - Weibo `--user-id <user_id>`: preferred when the creator user_id is already known.
 - Weibo `--profile-url <profile_url>`: use for a Weibo user profile URL.
 - WeChat Channels / 视频号 `--user-id <v2_finder_user_id>`: use when the creator `v2_...@finder` user_id is already known.
+- WeChat Channels / 视频号 `--url <wechat_work_url_or_share_text>`: use for a video or image-post link or share text that can resolve the creator profile.
 - `--source-client socialdatax-skills --source-platform npm --source-skill media-user-info`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.
 
-Use either the ID option or the profile URL option for a single command, not both.
+Use exactly one supported identifier or URL entrypoint for a single command; do not combine them.
 
 The command prints JSON with `platform`, `tool`, `arguments`, and `data`.
 
@@ -190,9 +195,9 @@ MCP tools matching the direct CLI commands above:
 - YOUTUBE: `youtube_get_channel_info_by_url`
 - TIKTOK: `tiktok_get_user_info_by_tiktok_id`, `tiktok_get_user_info_by_profile_url`
 - WEIBO: `weibo_get_user_info_by_user_id`, `weibo_get_user_info_by_profile_url`
-- WECHAT: `wechat_get_user_info_by_user_id`
+- WECHAT: `wechat_get_user_info_by_user_id`, `wechat_get_user_info_by_url`
 
-MCP-only tools not available through the direct CLI: `douyin_get_user_info_by_douyin_id`, `wechat_get_user_info_by_url`
+MCP-only tools not available through the direct CLI: `douyin_get_user_info_by_douyin_id`
 
 If MCP tools are already available in the current agent, use one of these tools:
 - `xhs_get_user_info_by_user_id`: preferred when `user_id` is already known from search, detail, comments, or creator note lists.

package/skills/socialdatax-content-research-assistant/SKILL.md

@@ -254,6 +254,7 @@ npx -y socialdatax-skills@latest weibo replies --post-id "<post_id>" --comment-i
 npx -y socialdatax-skills@latest wechat detail --url "<wechat_work_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
 npx -y socialdatax-skills@latest wechat article --url "<mp_article_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
 npx -y socialdatax-skills@latest wechat comments --url "<wechat_video_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest wechat user-info --url "<wechat_work_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
 npx -y socialdatax-skills@latest wechat user-posts --url "<wechat_work_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
 npx -y socialdatax-skills@latest wechat replies --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --comment-id "<comment_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
 ```
@@ -326,9 +327,9 @@ MCP tools matching the direct CLI commands above:
 - YOUTUBE: `youtube_search_videos`, `youtube_get_video_detail_by_url`, `youtube_get_video_comments_by_url`, `youtube_get_channel_info_by_url`, `youtube_get_user_posted_videos_by_channel_url`, `youtube_get_video_comment_replies`
 - TIKTOK: `tiktok_search_posts`, `tiktok_get_post_detail_by_url`, `tiktok_get_post_comments_by_post_id`, `tiktok_get_user_info_by_tiktok_id`, `tiktok_get_user_posts_by_tiktok_id`, `tiktok_get_post_comments_by_url`, `tiktok_get_post_comment_replies`, `tiktok_get_user_info_by_profile_url`, `tiktok_get_user_posts_by_profile_url`
 - WEIBO: `weibo_get_hot_search_list`, `weibo_search_posts`, `weibo_get_post_detail_by_post_id`, `weibo_get_post_comments_by_post_id`, `weibo_get_user_info_by_user_id`, `weibo_get_user_posts_by_user_id`, `weibo_get_post_detail_by_post_url`, `weibo_get_post_comments_by_post_url`, `weibo_get_post_liker_list_by_post_id`, `weibo_get_post_repost_list_by_post_id`, `weibo_get_user_info_by_profile_url`, `weibo_get_user_posts_by_profile_url`, `weibo_get_post_comment_replies_by_comment_id`
-- WECHAT: `wechat_get_hot_search_list`, `wechat_search_videos`, `wechat_get_video_detail_by_encrypted_object_id`, `wechat_get_video_comments_by_object_id`, `wechat_get_user_info_by_user_id`, `wechat_get_user_posted_videos_by_user_id`, `wechat_get_video_detail_by_url`, `wechat_get_mp_article_detail_by_url`, `wechat_get_video_comments_by_url`, `wechat_get_user_posted_videos_by_url`, `wechat_get_video_comment_replies_by_comment_id`
+- WECHAT: `wechat_get_hot_search_list`, `wechat_search_videos`, `wechat_get_video_detail_by_encrypted_object_id`, `wechat_get_video_comments_by_object_id`, `wechat_get_user_info_by_user_id`, `wechat_get_user_posted_videos_by_user_id`, `wechat_get_video_detail_by_url`, `wechat_get_mp_article_detail_by_url`, `wechat_get_video_comments_by_url`, `wechat_get_user_info_by_url`, `wechat_get_user_posted_videos_by_url`, `wechat_get_video_comment_replies_by_comment_id`
 
-MCP-only tools not available through the direct CLI: `douyin_search_users`, `douyin_get_user_info_by_douyin_id`, `weibo_get_post_liker_list_by_post_url`, `weibo_get_post_repost_list_by_post_url`, `wechat_get_user_info_by_url`
+MCP-only tools not available through the direct CLI: `douyin_search_users`, `douyin_get_user_info_by_douyin_id`, `weibo_get_post_liker_list_by_post_url`, `weibo_get_post_repost_list_by_post_url`
 
 Use the automatically listed MCP tools above as the source of truth for tool names. Pick the narrowest tool for the user's platform and task. For search pagination, omit `page_token` on the first request and pass only the complete returned `next_page_token` when continuing the same chain.