socialdatax-skills 0.2.12 → 0.2.14

package/README.md

@@ -46,12 +46,12 @@ Common search phrases for this skill package:
 
 ## Platform MCPs
 
-- XHS hosted MCP endpoint: `https://mcp.52choujiang.com/xhs/mcp`
-- Douyin hosted MCP endpoint: `https://mcp.52choujiang.com/douyin/mcp`
-- Kuaishou hosted MCP endpoint: `https://mcp.52choujiang.com/kuaishou/mcp`
-- Weibo hosted MCP endpoint: `https://mcp.52choujiang.com/weibo/mcp`
-- WeChat Channels hosted MCP endpoint: `https://mcp.52choujiang.com/wechat/mcp`
-- Sensitive Check hosted MCP endpoint: `https://mcp.52choujiang.com/sensitive-check/mcp`
+- XHS hosted MCP endpoint: `https://mcp.socialdatax.com/xhs/mcp`
+- Douyin hosted MCP endpoint: `https://mcp.socialdatax.com/douyin/mcp`
+- Kuaishou hosted MCP endpoint: `https://mcp.socialdatax.com/kuaishou/mcp`
+- Weibo hosted MCP endpoint: `https://mcp.socialdatax.com/weibo/mcp`
+- WeChat Channels hosted MCP endpoint: `https://mcp.socialdatax.com/wechat/mcp`
+- Sensitive Check hosted MCP endpoint: `https://mcp.socialdatax.com/sensitive-check/mcp`
 - Hosted transport: `streamable-http`
 - Authentication: `Authorization: Bearer <SOCIALDATAX_API_KEY>`
 - Website: <https://socialdatax.com>
@@ -68,7 +68,7 @@ Common search phrases for this skill package:
 - Sensitive Check MCP server name: `sensitive-check`
 - Sensitive Check future MCP registry name: `com.socialdatax/sensitive-check`
 - Unified MCP registry name: none; this package installs skills and calls explicit platform services.
-- Current public capability version: `0.2.12`
+- Current public capability version: `0.2.14`
 
 ## Direct CLI
 
@@ -78,6 +78,7 @@ Examples:
 
 ```bash
 npx -y socialdatax-skills@latest xhs search --keyword "露营" --pretty
+npx -y socialdatax-skills@latest xhs search --keyword "露营" --since-days 7 --pages 2 --pretty
 npx -y socialdatax-skills@latest xhs hot-search --pretty
 npx -y socialdatax-skills@latest xhs detail --note-id "<note_id>" --pretty
 npx -y socialdatax-skills@latest xhs comments --note-id "<note_id>" --pretty
@@ -85,6 +86,7 @@ npx -y socialdatax-skills@latest xhs comments --note-id "<note_id>" --all --incl
 npx -y socialdatax-skills@latest xhs sub-comments --note-id "<note_id>" --comment-id "<comment_id>" --pretty
 npx -y socialdatax-skills@latest xhs user-info --user-id "<user_id>" --pretty
 npx -y socialdatax-skills@latest xhs user-posts --user-id "<user_id>" --pretty
+npx -y socialdatax-skills@latest xhs user-posts --user-id "<user_id>" --since-days 30 --pretty
 npx -y socialdatax-skills@latest douyin hot-search --pretty
 npx -y socialdatax-skills@latest douyin search --keyword "露营" --pretty
 npx -y socialdatax-skills@latest douyin detail --aweme-id "<aweme_id>" --pretty
@@ -97,8 +99,8 @@ npx -y socialdatax-skills@latest douyin user-posts --sec-user-id "<sec_user_id>"
 npx -y socialdatax-skills@latest douyin user-posts --profile-url "<profile_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest douyin user-series --sec-user-id "<sec_user_id>" --pretty
 npx -y socialdatax-skills@latest douyin user-series --profile-url "<profile_url_or_share_text>" --pretty
-npx -y socialdatax-skills@latest kuaishou hot-search --pretty
 npx -y socialdatax-skills@latest kuaishou search --keyword "露营" --pretty
+npx -y socialdatax-skills@latest kuaishou user-search --keyword "露营" --pretty
 npx -y socialdatax-skills@latest kuaishou detail --photo-id "<photo_id>" --pretty
 npx -y socialdatax-skills@latest kuaishou detail --url "<kuaishou_content_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest kuaishou comments --photo-id "<photo_id>" --pretty
@@ -118,7 +120,9 @@ npx -y socialdatax-skills@latest weibo comments --post-id "<post_id>" --all --in
 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
 npx -y socialdatax-skills@latest weibo likers --post-id "<post_id>" --pretty
+npx -y socialdatax-skills@latest weibo likers --post-url "<weibo_post_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest weibo reposts --post-id "<post_id>" --pretty
+npx -y socialdatax-skills@latest weibo reposts --post-url "<weibo_post_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest weibo user-info --user-id "<user_id>" --pretty
 npx -y socialdatax-skills@latest weibo user-info --profile-url "<profile_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest weibo user-posts --user-id "<user_id>" --pretty
@@ -143,6 +147,8 @@ For XHS outputs with a returned `note_url` field, when `note_url` is non-null, p
 
 For list-style commands, use `--pages <n>` to fetch N pages from the current starting point and `--max-items <n>` to cap the merged `data.items` output. Search commands support `--pages` but not `--all`, because search has no stable complete-result boundary.
 
+For search and creator content-list commands, use `--since-days <1-365>` to keep only items whose public `publish_time` is within the last N days. Search remains bounded by `--pages` and does not promise complete platform coverage; creator content lists continue until the publish-time boundary when `--pages` is omitted.
+
 For comments, replies, creator content lists, and Douyin creator series, use `--all` to continue until the returned `next_page_token` is empty. `--all` has no default item or page cap; add `--max-items <n>` or use `--pages <n>` when you want a bounded run.
 
 For first-level comments, add `--include-replies` to fetch the second-level replies under each returned first-level comment. Multi-page output keeps `data.items` as the merged first-level list; each item gets `replies`, `replies_page_count`, and `replies_next_page_token`.
@@ -152,7 +158,7 @@ For commands that accept `--page-token`, continue only with the complete returne
 Search pagination uses `--page-token` when continuing with a returned `next_page_token`. Omit `--page-token` on the first search request and pass the complete returned `next_page_token` only when continuing the same search chain.
 
 XHS, Douyin, Kuaishou, Weibo, and WeChat Channels search use `--keyword` and optional `--page-token`.
-Kuaishou search uses `--keyword` and optional `--page-token`. Kuaishou search does not accept Douyin semantic filters.
+Kuaishou work search uses `kuaishou search --keyword` and optional `--page-token`; Kuaishou creator search uses `kuaishou user-search --keyword` and optional `--page-token`. Kuaishou search does not accept Douyin semantic filters, and `kuaishou user-search` does not support `--since-days`.
 Weibo and WeChat Channels search use `--keyword` and optional `--page-token`.
 
 Douyin search filters use semantic values: `--sort-type` supports `general`,
@@ -162,8 +168,8 @@ Douyin search filters use semantic values: `--sort-type` supports `general`,
 supports `all`, `video`, and `image`.
 
 WeChat Channels search filters use semantic values: `--sort-type` supports
-`all`, `latest`, and `popular`; `--duration-range` supports `all`,
-`under_5_min`, `between_5_and_20_min`, and `over_20_min`.
+`general`, `time_descending`, and `popularity_descending`; `--duration-range`
+supports `all`, `under_5_min`, `between_5_and_20_min`, and `over_20_min`.
 
 ### Runtime Requirements
 
@@ -249,7 +255,6 @@ npx -y socialdatax-skills@latest xhs hot-search --pretty
 npx -y socialdatax-skills@latest douyin hot-search --pretty
 npx -y socialdatax-skills@latest douyin search --keyword "露营" --pretty
 npx -y socialdatax-skills@latest douyin user-series --sec-user-id "<sec_user_id>" --pretty
-npx -y socialdatax-skills@latest kuaishou hot-search --pretty
 npx -y socialdatax-skills@latest kuaishou search --keyword "露营" --pretty
 npx -y socialdatax-skills@latest weibo hot-search --pretty
 npx -y socialdatax-skills@latest weibo search --keyword "露营" --pretty
@@ -301,8 +306,8 @@ Current XHS workflows include:
 
 Current Kuaishou workflows include:
 
-- Fetch the current Kuaishou / 快手 short-video hot list.
 - Search related Kuaishou works by keyword.
+- Search Kuaishou creator or account candidates by keyword before profile lookup.
 - Resolve a Kuaishou work page link, short link, share text, or photo_id into structured work details.
 - Fetch paginated first-level comments for comment analysis.
 - Fetch paginated replies under a first-level comment.
@@ -331,9 +336,10 @@ Current Weibo workflows include:
 - 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 replies under a first-level comment.
+- Fetch paginated liker and repost lists from a post_id, post URL, short link, or share text.
 - Continue Weibo list pagination only when `next_page_token` is non-empty; an empty string means there are no more results to request.
-- Read creator profile data from a profile link, short link, share text, or user_id.
-- Fetch paginated creator post lists from a user_id, profile link, short link, or share text.
+- Read user profile data from a profile link, short link, share text, or user_id.
+- Fetch paginated user post lists from a user_id, profile link, short link, or share text.
 - Submit and check Weibo video 口播转文字 / speech-to-text transcript jobs; submit tools 提交完成后最多短等 15 秒.
 
 Current WeChat Channels / 视频号 workflows include:
@@ -399,8 +405,8 @@ Current Sensitive Check workflows include:
 
 | Tool | Public purpose |
 | --- | --- |
-| `kuaishou_get_hot_search_list` | Get the current Kuaishou / 快手 short-video hot list. |
 | `kuaishou_search_videos` | Search Kuaishou works by natural-language keyword with optional `page_token` continuation; do not pass `page`. |
+| `kuaishou_search_users` | Search Kuaishou creators by keyword with optional `page_token` continuation; do not pass `page`. |
 | `kuaishou_get_video_detail_by_photo_id` | Fetch structured work details when the caller already has a photo_id. |
 | `kuaishou_get_video_detail_by_url` | Resolve a Kuaishou work page link, short link, or share text into structured work details. |
 | `kuaishou_get_video_comments_by_photo_id` | Fetch paginated first-level comments when the caller already has a photo_id. |
@@ -425,10 +431,14 @@ Current Sensitive Check workflows include:
 | `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_comment_replies_by_comment_id` | Fetch paginated replies under a first-level comment by post_id and comment_id. |
-| `weibo_get_user_info_by_user_id` | Fetch creator profile data when the caller already has a user_id. |
-| `weibo_get_user_info_by_profile_url` | Resolve a Weibo profile link, short link, or share text into creator profile data. |
-| `weibo_get_user_posts_by_user_id` | Fetch a paginated list of posts published by a creator when the caller already has a user_id. |
-| `weibo_get_user_posts_by_profile_url` | Fetch a paginated list of posts published by a creator from a profile link, short link, or share text. |
+| `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 URL, short link, or share text. |
+| `weibo_get_post_repost_list_by_post_id` | Fetch paginated reposts for a Weibo post by post_id. |
+| `weibo_get_post_repost_list_by_post_url` | Fetch paginated reposts for a Weibo post from a post URL, short link, or share text. |
+| `weibo_get_user_info_by_user_id` | Fetch user profile data when the caller already has a user_id. |
+| `weibo_get_user_info_by_profile_url` | Resolve a Weibo profile link, short link, or share text into user profile data. |
+| `weibo_get_user_posts_by_user_id` | Fetch a paginated list of posts published by a user when the caller already has a user_id. |
+| `weibo_get_user_posts_by_profile_url` | Fetch a paginated list of posts published by a user from a profile link, short link, or share text. |
 | `weibo_submit_video_speech_text_by_post_url` | Submit a Weibo video speech-to-text transcript job from a post URL, short link, or share text; submit waits up to 15 seconds. |
 | `weibo_submit_video_speech_text_by_post_id` | Submit a Weibo video speech-to-text transcript job when the caller already has a post_id; submit waits up to 15 seconds. |
 | `weibo_get_video_speech_text_job` | Check a Weibo speech-to-text transcript job by job_id without creating a new task. |

package/cli.mjs

@@ -7,7 +7,7 @@ import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const PACKAGE_NAME = "socialdatax-skills";
-const PACKAGE_VERSION = "0.2.12";
+const PACKAGE_VERSION = "0.2.14";
 const PACKAGE_SPEC = `${PACKAGE_NAME}@latest`;
 const LOG_PREFIX = `[${PACKAGE_NAME}]`;
 const MIN_NODE_VERSION = "20.18.1";
@@ -85,6 +85,7 @@ const XHS_DIRECT_ACTION_OPTIONS = {
     "pages",
     "all",
     "maxItems",
+    "sinceDays",
     "sortType",
     "noteType",
     "publishTimeRange",
@@ -112,7 +113,16 @@ const XHS_DIRECT_ACTION_OPTIONS = {
     "pretty",
   ],
   "user-info": ["userId", "profileUrl", "pretty"],
-  "user-posts": ["userId", "profileUrl", "pageToken", "pages", "all", "maxItems", "pretty"],
+  "user-posts": [
+    "userId",
+    "profileUrl",
+    "pageToken",
+    "pages",
+    "all",
+    "maxItems",
+    "sinceDays",
+    "pretty",
+  ],
 };
 const XHS_DIRECT_ACTION_NAMES = Object.keys(XHS_DIRECT_ACTION_OPTIONS).join(", ");
 const XHS_OPTION_DISPLAY_NAMES = {
@@ -126,6 +136,7 @@ const XHS_OPTION_DISPLAY_NAMES = {
   pageToken: "--page-token",
   pages: "--pages",
   maxItems: "--max-items",
+  sinceDays: "--since-days",
   all: "--all",
   includeReplies: "--include-replies",
   profileUrl: "--profile-url",
@@ -151,6 +162,7 @@ const DOUYIN_DIRECT_ACTION_OPTIONS = {
     "pages",
     "all",
     "maxItems",
+    "sinceDays",
     "sortType",
     "publishTimeRange",
     "durationRange",
@@ -179,7 +191,16 @@ const DOUYIN_DIRECT_ACTION_OPTIONS = {
     "pretty",
   ],
   "user-info": ["secUserId", "profileUrl", "pretty"],
-  "user-posts": ["secUserId", "profileUrl", "pageToken", "pages", "all", "maxItems", "pretty"],
+  "user-posts": [
+    "secUserId",
+    "profileUrl",
+    "pageToken",
+    "pages",
+    "all",
+    "maxItems",
+    "sinceDays",
+    "pretty",
+  ],
   "user-series": ["secUserId", "profileUrl", "pageToken", "pages", "all", "maxItems", "pretty"],
 };
 const DOUYIN_DIRECT_ACTION_NAMES = Object.keys(DOUYIN_DIRECT_ACTION_OPTIONS).join(", ");
@@ -197,6 +218,7 @@ const DOUYIN_OPTION_DISPLAY_NAMES = {
   pageToken: "--page-token",
   pages: "--pages",
   maxItems: "--max-items",
+  sinceDays: "--since-days",
   all: "--all",
   includeReplies: "--include-replies",
   sortType: "--sort-type",
@@ -210,8 +232,8 @@ const DOUYIN_OPTION_DISPLAY_NAMES = {
   secUserId: "--sec-user-id",
 };
 const KUAISHOU_DIRECT_ACTION_OPTIONS = {
-  "hot-search": ["pretty"],
-  search: ["keyword", "pageToken", "pages", "all", "maxItems", "pretty"],
+  search: ["keyword", "pageToken", "pages", "all", "maxItems", "sinceDays", "pretty"],
+  "user-search": ["keyword", "pageToken", "pages", "maxItems", "pretty"],
   detail: ["photoId", "url", "pretty"],
   comments: [
     "photoId",
@@ -234,7 +256,16 @@ const KUAISHOU_DIRECT_ACTION_OPTIONS = {
     "pretty",
   ],
   "user-info": ["userId", "profileUrl", "pretty"],
-  "user-posts": ["userId", "profileUrl", "pageToken", "pages", "all", "maxItems", "pretty"],
+  "user-posts": [
+    "userId",
+    "profileUrl",
+    "pageToken",
+    "pages",
+    "all",
+    "maxItems",
+    "sinceDays",
+    "pretty",
+  ],
 };
 const KUAISHOU_DIRECT_ACTION_NAMES = Object.keys(KUAISHOU_DIRECT_ACTION_OPTIONS).join(", ");
 const KUAISHOU_OPTION_DISPLAY_NAMES = {
@@ -242,6 +273,7 @@ const KUAISHOU_OPTION_DISPLAY_NAMES = {
   pageToken: "--page-token",
   pages: "--pages",
   maxItems: "--max-items",
+  sinceDays: "--since-days",
   all: "--all",
   includeReplies: "--include-replies",
   url: "--url",
@@ -252,7 +284,7 @@ const KUAISHOU_OPTION_DISPLAY_NAMES = {
 };
 const WEIBO_DIRECT_ACTION_OPTIONS = {
   "hot-search": ["pretty"],
-  search: ["keyword", "pageToken", "pages", "all", "maxItems", "pretty"],
+  search: ["keyword", "pageToken", "pages", "all", "maxItems", "sinceDays", "pretty"],
   detail: ["postId", "postUrl", "pretty"],
   comments: [
     "postId",
@@ -274,10 +306,19 @@ const WEIBO_DIRECT_ACTION_OPTIONS = {
     "includeReplies",
     "pretty",
   ],
-  likers: ["postId", "pageToken", "pages", "all", "maxItems", "pretty"],
-  reposts: ["postId", "pageToken", "pages", "all", "maxItems", "pretty"],
+  likers: ["postId", "postUrl", "pageToken", "pages", "all", "maxItems", "pretty"],
+  reposts: ["postId", "postUrl", "pageToken", "pages", "all", "maxItems", "pretty"],
   "user-info": ["userId", "profileUrl", "pretty"],
-  "user-posts": ["userId", "profileUrl", "pageToken", "pages", "all", "maxItems", "pretty"],
+  "user-posts": [
+    "userId",
+    "profileUrl",
+    "pageToken",
+    "pages",
+    "all",
+    "maxItems",
+    "sinceDays",
+    "pretty",
+  ],
 };
 const WEIBO_DIRECT_ACTION_NAMES = Object.keys(WEIBO_DIRECT_ACTION_OPTIONS).join(", ");
 const WEIBO_OPTION_DISPLAY_NAMES = {
@@ -285,6 +326,7 @@ const WEIBO_OPTION_DISPLAY_NAMES = {
   pageToken: "--page-token",
   pages: "--pages",
   maxItems: "--max-items",
+  sinceDays: "--since-days",
   all: "--all",
   includeReplies: "--include-replies",
   postId: "--post-id",
@@ -301,6 +343,7 @@ const WECHAT_DIRECT_ACTION_OPTIONS = {
     "pages",
     "all",
     "maxItems",
+    "sinceDays",
     "sortType",
     "durationRange",
     "pretty",
@@ -329,10 +372,23 @@ const WECHAT_DIRECT_ACTION_OPTIONS = {
     "pretty",
   ],
   "user-info": ["userId", "pretty"],
-  "user-posts": ["userId", "url", "pageToken", "pages", "all", "maxItems", "pretty"],
+  "user-posts": [
+    "userId",
+    "url",
+    "pageToken",
+    "pages",
+    "all",
+    "maxItems",
+    "sinceDays",
+    "pretty",
+  ],
 };
 const WECHAT_DIRECT_ACTION_NAMES = Object.keys(WECHAT_DIRECT_ACTION_OPTIONS).join(", ");
-const WECHAT_SEARCH_SORT_TYPES = ["all", "latest", "popular"];
+const WECHAT_SEARCH_SORT_TYPES = [
+  "general",
+  "time_descending",
+  "popularity_descending",
+];
 const WECHAT_SEARCH_DURATION_RANGES = [
   "all",
   "under_5_min",
@@ -344,6 +400,7 @@ const WECHAT_OPTION_DISPLAY_NAMES = {
   pageToken: "--page-token",
   pages: "--pages",
   maxItems: "--max-items",
+  sinceDays: "--since-days",
   all: "--all",
   includeReplies: "--include-replies",
   sortType: "--sort-type",
@@ -373,7 +430,7 @@ const PLATFORMS = {
     status: "public",
     registryName: "com.52choujiang/xhs-insights",
     futureRegistryName: "com.socialdatax/xhs-insights",
-    endpoint: "https://mcp.52choujiang.com/xhs/mcp",
+    endpoint: "https://mcp.socialdatax.com/xhs/mcp",
     apiKeyEnv: API_KEY_ENV_NAMES,
     upstreamEnv: [
       "SOCIAL_MEDIA_XHS_MCP_UPSTREAM_URL",
@@ -455,7 +512,7 @@ const PLATFORMS = {
     status: "public",
     registryName: "com.52choujiang/douyin-insights",
     futureRegistryName: "com.socialdatax/douyin-insights",
-    endpoint: "https://mcp.52choujiang.com/douyin/mcp",
+    endpoint: "https://mcp.socialdatax.com/douyin/mcp",
     apiKeyEnv: API_KEY_ENV_NAMES,
     upstreamEnv: [
       "SOCIAL_MEDIA_DOUYIN_MCP_UPSTREAM_URL",
@@ -539,7 +596,7 @@ const PLATFORMS = {
     status: "public",
     registryName: "com.52choujiang/kuaishou-insights",
     futureRegistryName: "com.socialdatax/kuaishou-insights",
-    endpoint: "https://mcp.52choujiang.com/kuaishou/mcp",
+    endpoint: "https://mcp.socialdatax.com/kuaishou/mcp",
     apiKeyEnv: API_KEY_ENV_NAMES,
     upstreamEnv: [
       "SOCIAL_MEDIA_KUAISHOU_MCP_UPSTREAM_URL",
@@ -547,15 +604,16 @@ const PLATFORMS = {
       "KUAISHOU_MCP_UPSTREAM_URL",
     ],
     tools: [
-      {
-        name: "kuaishou_get_hot_search_list",
-        description: "Get the current Kuaishou / 快手 short-video hot list.",
-      },
       {
         name: "kuaishou_search_videos",
         description:
           "Search Kuaishou works by natural-language keyword with optional page_token continuation; do not pass page.",
       },
+      {
+        name: "kuaishou_search_users",
+        description:
+          "Search Kuaishou creators by keyword with optional page_token continuation; do not pass page.",
+      },
       {
         name: "kuaishou_get_video_detail_by_photo_id",
         description: "Fetch structured Kuaishou work details when the caller already has a photo_id.",
@@ -615,7 +673,7 @@ const PLATFORMS = {
     status: "public",
     registryName: "com.52choujiang/weibo-insights",
     futureRegistryName: "com.socialdatax/weibo-insights",
-    endpoint: "https://mcp.52choujiang.com/weibo/mcp",
+    endpoint: "https://mcp.socialdatax.com/weibo/mcp",
     apiKeyEnv: API_KEY_ENV_NAMES,
     upstreamEnv: [
       "SOCIAL_MEDIA_WEIBO_MCP_UPSTREAM_URL",
@@ -656,10 +714,20 @@ const PLATFORMS = {
         name: "weibo_get_post_liker_list_by_post_id",
         description: "Fetch a paginated list of users who liked a Weibo post by post_id.",
       },
+      {
+        name: "weibo_get_post_liker_list_by_post_url",
+        description:
+          "Fetch a paginated list of users who liked a Weibo post from a post URL, short link, or share text.",
+      },
       {
         name: "weibo_get_post_repost_list_by_post_id",
         description: "Fetch a paginated repost list for a Weibo post by post_id.",
       },
+      {
+        name: "weibo_get_post_repost_list_by_post_url",
+        description:
+          "Fetch a paginated repost list for a Weibo post from a post URL, short link, or share text.",
+      },
       {
         name: "weibo_get_user_info_by_user_id",
         description: "Fetch creator profile data when the caller already has a user_id.",
@@ -699,7 +767,7 @@ const PLATFORMS = {
     status: "public",
     registryName: "com.52choujiang/wechat-channels-insights",
     futureRegistryName: "com.socialdatax/wechat-channels-insights",
-    endpoint: "https://mcp.52choujiang.com/wechat/mcp",
+    endpoint: "https://mcp.socialdatax.com/wechat/mcp",
     apiKeyEnv: API_KEY_ENV_NAMES,
     upstreamEnv: [
       "SOCIAL_MEDIA_WECHAT_MCP_UPSTREAM_URL",
@@ -771,7 +839,7 @@ const PLATFORMS = {
     status: "public",
     registryName: "sensitive-check",
     futureRegistryName: "com.socialdatax/sensitive-check",
-    endpoint: "https://mcp.52choujiang.com/sensitive-check/mcp",
+    endpoint: "https://mcp.socialdatax.com/sensitive-check/mcp",
     apiKeyEnv: API_KEY_ENV_NAMES,
     upstreamEnv: [
       "SOCIALDATAX_SENSITIVE_CHECK_MCP_UPSTREAM_URL",
@@ -1015,6 +1083,9 @@ function validateDirectPaginationOptions(platformId, action, options) {
   if (options.maxItems !== undefined) {
     parsePositiveIntegerOption(options.maxItems, "--max-items");
   }
+  if (options.sinceDays !== undefined) {
+    parseSinceDaysOption(options.sinceDays);
+  }
   if (options.all && action === "search") {
     throw new Error(`--all is not supported for ${platformId} search. Use --pages instead.`);
   }
@@ -1035,6 +1106,37 @@ function parsePositiveIntegerOption(value, displayName) {
   return parsed;
 }
 
+function parseSinceDaysOption(value) {
+  const text = String(value);
+  if (!/^\d+$/.test(text)) {
+    throw new Error("--since-days must be an integer between 1 and 365.");
+  }
+  const parsed = Number(text);
+  if (!Number.isSafeInteger(parsed) || parsed < 1 || parsed > 365) {
+    throw new Error("--since-days must be an integer between 1 and 365.");
+  }
+  return parsed;
+}
+
+function parseOptionalSinceDays(options) {
+  return options.sinceDays === undefined
+    ? undefined
+    : parseSinceDaysOption(options.sinceDays);
+}
+
+function nativePublishTimeRangeForSinceDays(sinceDays) {
+  if (sinceDays <= 1) {
+    return "day";
+  }
+  if (sinceDays <= 7) {
+    return "week";
+  }
+  if (sinceDays <= 180) {
+    return "half_year";
+  }
+  return undefined;
+}
+
 function parseAllowedStringOption(value, displayName, allowedValues, label) {
   const normalized = String(value).trim();
   if (!allowedValues.includes(normalized)) {
@@ -1500,6 +1602,9 @@ function printHelp() {
   console.log(`  npx -y ${PACKAGE_SPEC} xhs search --keyword "露营" --pretty`);
   console.log("      Call the XHS search tool directly and print JSON.");
   console.log("");
+  console.log(`  npx -y ${PACKAGE_SPEC} xhs search --keyword "露营" --since-days 7 --pages 2 --pretty`);
+  console.log("      Search recent XHS results and keep items published in the last 7 days.");
+  console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} xhs hot-search --pretty`);
   console.log("      Call the XHS search hot list tool directly and print JSON.");
   console.log("");
@@ -1523,6 +1628,9 @@ function printHelp() {
   console.log(`  npx -y ${PACKAGE_SPEC} xhs user-posts --user-id "<user_id>" --pretty`);
   console.log("      Call the XHS creator posts tool directly and print JSON.");
   console.log("");
+  console.log(`  npx -y ${PACKAGE_SPEC} xhs user-posts --user-id "<user_id>" --since-days 30 --pretty`);
+  console.log("      Fetch recent creator posts until the publish-time boundary is reached.");
+  console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} douyin hot-search --pretty`);
   console.log("      Call the Douyin main hot search list tool directly and print JSON.");
   console.log("");
@@ -1561,12 +1669,12 @@ function printHelp() {
   console.log(`  npx -y ${PACKAGE_SPEC} douyin user-series --profile-url "<profile_url_or_share_text>" --pretty`);
   console.log("      Call the Douyin creator short-drama series tool from a profile link or share text.");
   console.log("");
-  console.log(`  npx -y ${PACKAGE_SPEC} kuaishou hot-search --pretty`);
-  console.log("      Call the Kuaishou short-video hot list tool directly and print JSON.");
-  console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} kuaishou search --keyword "露营" --pretty`);
   console.log("      Call the Kuaishou work search tool directly and print JSON.");
   console.log("");
+  console.log(`  npx -y ${PACKAGE_SPEC} kuaishou user-search --keyword "露营" --pretty`);
+  console.log("      Call the Kuaishou creator search tool directly and print JSON.");
+  console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} kuaishou detail --photo-id "<photo_id>" --pretty`);
   console.log("      Call the Kuaishou work detail tool directly and print JSON.");
   console.log("");
@@ -1623,9 +1731,15 @@ function printHelp() {
   console.log(`  npx -y ${PACKAGE_SPEC} weibo likers --post-id "<post_id>" --pretty`);
   console.log("      Call the Weibo post liker list tool directly and print JSON.");
   console.log("");
+  console.log(`  npx -y ${PACKAGE_SPEC} weibo likers --post-url "<weibo_post_url_or_share_text>" --pretty`);
+  console.log("      Call the Weibo post liker list tool from a post link or share text.");
+  console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} weibo reposts --post-id "<post_id>" --pretty`);
   console.log("      Call the Weibo post repost list tool directly and print JSON.");
   console.log("");
+  console.log(`  npx -y ${PACKAGE_SPEC} weibo reposts --post-url "<weibo_post_url_or_share_text>" --pretty`);
+  console.log("      Call the Weibo post repost list tool from a post link or share text.");
+  console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} weibo user-info --user-id "<user_id>" --pretty`);
   console.log("      Call the Weibo creator profile tool directly and print JSON.");
   console.log("");
@@ -1757,11 +1871,13 @@ function printHelp() {
   console.log("  --platform <generic|xhs|douyin|kuaishou>");
   console.log("      Target platform for sensitive-check text; default is generic.");
   console.log("  --pages <number>");
-  console.log("      Fetch and merge N pages from the current starting point for search, comments, replies, creator content lists, and creator series.");
+  console.log("      Fetch and merge N pages from the current starting point for search, Kuaishou creator search, comments, replies, creator content lists, and creator series.");
   console.log("  --all");
   console.log("      Continue comments, replies, creator content lists, and creator series until next_page_token is empty; not supported for search.");
   console.log("  --max-items <number>");
   console.log("      Stop after collecting this many primary items.");
+  console.log("  --since-days <1-365>");
+  console.log("      Keep search or creator content-list items with publish_time in the last N days. Search stays bounded by --pages; creator lists continue until the time boundary when --pages is omitted.");
   console.log("  --include-replies");
   console.log("      For comments commands, also fetch nested second-level replies for each returned first-level comment.");
   console.log("  --sort-type <general|time_descending|like_count_descending|comment_count_descending|collect_count_descending>");
@@ -1779,7 +1895,7 @@ function printHelp() {
   console.log("      Douyin content type filter; omit for all content types.");
   console.log("  --page-token <token>");
   console.log("      Continue token-paginated commands with the complete returned next_page_token. For search, omit it on the first request.");
-  console.log("  --sort-type <all|latest|popular>");
+  console.log("  --sort-type <general|time_descending|popularity_descending>");
   console.log("      WeChat Channels / 视频号 search sort; omit for default sort.");
   console.log("  --duration-range <all|under_5_min|between_5_and_20_min|over_20_min>");
   console.log("      WeChat Channels / 视频号 duration filter; omit for no duration filter.");
@@ -1811,18 +1927,18 @@ function printRemovedMcpConfigHelp(command) {
   console.error("  com.socialdatax/wechat-channels-insights");
   console.error("");
   console.error("Use hosted streamable HTTP when your client supports remote MCP:");
-  console.error("  https://mcp.52choujiang.com/xhs/mcp");
-  console.error("  https://mcp.52choujiang.com/douyin/mcp");
-  console.error("  https://mcp.52choujiang.com/kuaishou/mcp");
-  console.error("  https://mcp.52choujiang.com/weibo/mcp");
-  console.error("  https://mcp.52choujiang.com/wechat/mcp");
+  console.error("  https://mcp.socialdatax.com/xhs/mcp");
+  console.error("  https://mcp.socialdatax.com/douyin/mcp");
+  console.error("  https://mcp.socialdatax.com/kuaishou/mcp");
+  console.error("  https://mcp.socialdatax.com/weibo/mcp");
+  console.error("  https://mcp.socialdatax.com/wechat/mcp");
   console.error("");
   console.error("For command/stdio-only clients, use mcp-remote:");
-  console.error(`  npx -y mcp-remote https://mcp.52choujiang.com/xhs/mcp --header "Authorization: Bearer <${PRIMARY_API_KEY_ENV}>"`);
-  console.error(`  npx -y mcp-remote https://mcp.52choujiang.com/douyin/mcp --header "Authorization: Bearer <${PRIMARY_API_KEY_ENV}>"`);
-  console.error(`  npx -y mcp-remote https://mcp.52choujiang.com/kuaishou/mcp --header "Authorization: Bearer <${PRIMARY_API_KEY_ENV}>"`);
-  console.error(`  npx -y mcp-remote https://mcp.52choujiang.com/weibo/mcp --header "Authorization: Bearer <${PRIMARY_API_KEY_ENV}>"`);
-  console.error(`  npx -y mcp-remote https://mcp.52choujiang.com/wechat/mcp --header "Authorization: Bearer <${PRIMARY_API_KEY_ENV}>"`);
+  console.error(`  npx -y mcp-remote https://mcp.socialdatax.com/xhs/mcp --header "Authorization: Bearer <${PRIMARY_API_KEY_ENV}>"`);
+  console.error(`  npx -y mcp-remote https://mcp.socialdatax.com/douyin/mcp --header "Authorization: Bearer <${PRIMARY_API_KEY_ENV}>"`);
+  console.error(`  npx -y mcp-remote https://mcp.socialdatax.com/kuaishou/mcp --header "Authorization: Bearer <${PRIMARY_API_KEY_ENV}>"`);
+  console.error(`  npx -y mcp-remote https://mcp.socialdatax.com/weibo/mcp --header "Authorization: Bearer <${PRIMARY_API_KEY_ENV}>"`);
+  console.error(`  npx -y mcp-remote https://mcp.socialdatax.com/wechat/mcp --header "Authorization: Bearer <${PRIMARY_API_KEY_ENV}>"`);
 }
 
 async function runXhsDirectCommand(args) {
@@ -2173,21 +2289,18 @@ function buildDouyinOperation(action, options) {
 
 function buildKuaishouOperation(action, options) {
   switch (action) {
-    case "hot-search":
-      return buildDirectOperation(
-        "hot-search",
-        {
-          tool: "kuaishou_get_hot_search_list",
-          toolArguments: {},
-        },
-        PLATFORMS.kuaishou
-      );
     case "search":
       return buildDirectOperation(
         "search",
         buildKuaishouSearchCall(options),
         PLATFORMS.kuaishou
       );
+    case "user-search":
+      return buildDirectOperation(
+        "user-search",
+        buildKuaishouUserSearchCall(options),
+        PLATFORMS.kuaishou
+      );
     case "detail":
       return buildDirectOperation(
         "detail",
@@ -2320,13 +2433,33 @@ function buildWeiboOperation(action, options) {
     case "likers":
       return buildDirectOperation(
         "likers",
-        buildWeiboPostListByPostIdCall(options, "likers", "weibo_get_post_liker_list_by_post_id"),
+        buildOneOfCall(options, {
+          idOption: "postId",
+          urlOption: "postUrl",
+          idTool: "weibo_get_post_liker_list_by_post_id",
+          urlTool: "weibo_get_post_liker_list_by_post_url",
+          idArgument: "post_id",
+          urlArgument: "post_url",
+          idDisplay: "--post-id",
+          urlDisplay: "--post-url",
+          pageToken: options.pageToken,
+        }),
         PLATFORMS.weibo
       );
     case "reposts":
       return buildDirectOperation(
         "reposts",
-        buildWeiboPostListByPostIdCall(options, "reposts", "weibo_get_post_repost_list_by_post_id"),
+        buildOneOfCall(options, {
+          idOption: "postId",
+          urlOption: "postUrl",
+          idTool: "weibo_get_post_repost_list_by_post_id",
+          urlTool: "weibo_get_post_repost_list_by_post_url",
+          idArgument: "post_id",
+          urlArgument: "post_url",
+          idDisplay: "--post-id",
+          urlDisplay: "--post-url",
+          pageToken: options.pageToken,
+        }),
         PLATFORMS.weibo
       );
     case "user-info":
@@ -2475,8 +2608,13 @@ function buildXhsSearchCall(options) {
   if (!options.keyword) {
     throw new Error("Missing --keyword for xhs search.");
   }
+  const sinceDays = parseOptionalSinceDays(options);
+  const requestedSortType =
+    options.sortType === undefined && sinceDays !== undefined
+      ? "time_descending"
+      : options.sortType || "general";
   const sortType = parseSemanticOption(
-    options.sortType || "general",
+    requestedSortType,
     "--sort-type",
     XHS_SEARCH_SORT_TYPES,
     XHS_LEGACY_SEARCH_SORT_TYPE_ALIASES,
@@ -2504,12 +2642,19 @@ function buildXhsSearchCall(options) {
   }
   if (options.sortType !== undefined) {
     toolArguments.sort_type = sortType;
+  } else if (sinceDays !== undefined) {
+    toolArguments.sort_type = "time_descending";
   }
   if (options.noteType !== undefined) {
     toolArguments.note_type = noteType;
   }
   if (options.publishTimeRange !== undefined) {
     toolArguments.publish_time_range = publishTimeRange;
+  } else if (sinceDays !== undefined) {
+    const nativeRange = nativePublishTimeRangeForSinceDays(sinceDays);
+    if (nativeRange) {
+      toolArguments.publish_time_range = nativeRange;
+    }
   }
   return {
     tool: "xhs_search_notes",
@@ -2576,6 +2721,7 @@ function buildDouyinSearchCall(options) {
   if (!options.keyword) {
     throw new Error("Missing --keyword for douyin search.");
   }
+  const sinceDays = parseOptionalSinceDays(options);
   const toolArguments = {
     keyword: options.keyword,
   };
@@ -2586,6 +2732,8 @@ function buildDouyinSearchCall(options) {
       DOUYIN_SEARCH_SORT_TYPES,
       DOUYIN_SEARCH_SORT_TYPES.join(", ")
     );
+  } else if (sinceDays !== undefined) {
+    toolArguments.sort_type = "time_descending";
   }
   if (options.publishTimeRange !== undefined) {
     toolArguments.publish_time_range = parseAllowedStringOption(
@@ -2594,6 +2742,11 @@ function buildDouyinSearchCall(options) {
       DOUYIN_SEARCH_PUBLISH_TIME_RANGES,
       DOUYIN_SEARCH_PUBLISH_TIME_RANGES.join(", ")
     );
+  } else if (sinceDays !== undefined) {
+    const nativeRange = nativePublishTimeRangeForSinceDays(sinceDays);
+    if (nativeRange) {
+      toolArguments.publish_time_range = nativeRange;
+    }
   }
   if (options.durationRange !== undefined) {
     toolArguments.duration_range = parseAllowedStringOption(
@@ -2636,6 +2789,22 @@ function buildKuaishouSearchCall(options) {
   };
 }
 
+function buildKuaishouUserSearchCall(options) {
+  if (!options.keyword) {
+    throw new Error("Missing --keyword for kuaishou user-search.");
+  }
+  const toolArguments = {
+    keyword: options.keyword,
+  };
+  if (options.pageToken) {
+    toolArguments.page_token = options.pageToken;
+  }
+  return {
+    tool: "kuaishou_search_users",
+    toolArguments,
+  };
+}
+
 function buildWeiboSearchCall(options) {
   if (!options.keyword) {
     throw new Error("Missing --keyword for weibo search.");
@@ -2656,6 +2825,7 @@ function buildWechatSearchCall(options) {
   if (!options.keyword) {
     throw new Error("Missing --keyword for wechat search.");
   }
+  const sinceDays = parseOptionalSinceDays(options);
   const toolArguments = {
     keyword: options.keyword,
   };
@@ -2666,6 +2836,8 @@ function buildWechatSearchCall(options) {
       WECHAT_SEARCH_SORT_TYPES,
       WECHAT_SEARCH_SORT_TYPES.join(", ")
     );
+  } else if (sinceDays !== undefined) {
+    toolArguments.sort_type = "time_descending";
   }
   if (options.durationRange !== undefined) {
     toolArguments.duration_range = parseAllowedStringOption(
@@ -2763,22 +2935,6 @@ function buildWeiboRepliesCall(options) {
   };
 }
 
-function buildWeiboPostListByPostIdCall(options, action, tool) {
-  if (!options.postId) {
-    throw new Error(`Missing --post-id for weibo ${action}.`);
-  }
-  const toolArguments = {
-    post_id: options.postId,
-  };
-  if (options.pageToken) {
-    toolArguments.page_token = options.pageToken;
-  }
-  return {
-    tool,
-    toolArguments,
-  };
-}
-
 function buildWechatCommentsCall(options) {
   const hasObjectInput = Boolean(options.objectId || options.objectNonceId);
   const hasUrlInput = Boolean(options.url);
@@ -2875,7 +3031,8 @@ function shouldUsePaginatedDirectOutput(options) {
     options.all ||
       options.pages !== undefined ||
       options.maxItems !== undefined ||
-      options.includeReplies
+      options.includeReplies ||
+      options.sinceDays !== undefined
   );
 }
 
@@ -2897,6 +3054,7 @@ function parseDirectPaginationOptions(options) {
       options.maxItems === undefined
         ? undefined
         : parsePositiveIntegerOption(options.maxItems, "--max-items"),
+    sinceDays: parseOptionalSinceDays(options),
   };
 }
 
@@ -2905,7 +3063,14 @@ async function collectPaginatedDirectData(
   pagination,
   { includeReplies = false } = {}
 ) {
-  const pageLimit = pagination.all ? Number.POSITIVE_INFINITY : pagination.pages || 1;
+  const pageLimit =
+    pagination.all || shouldAutoPaginateSinceDays(operation, pagination)
+      ? Number.POSITIVE_INFINITY
+      : pagination.pages || 1;
+  const sinceDaysCutoff =
+    pagination.sinceDays === undefined
+      ? undefined
+      : cutoffPublishTimeForSinceDays(pagination.sinceDays);
   const collectedItems = [];
   const itemDedupeState = createPaginatedItemDedupeState();
   const seenNextMarkers = initialPaginationMarkers(operation);
@@ -2914,6 +3079,7 @@ async function collectPaginatedDirectData(
   let nextMarker;
   let parentContextData = {};
   let currentOperation = cloneDirectOperation(operation);
+  let stoppedBySinceDays = false;
 
   while (pageCount < pageLimit) {
     const pageData = await callDirectOperation(currentOperation);
@@ -2926,8 +3092,12 @@ async function collectPaginatedDirectData(
       directPageItems(pageData),
       itemDedupeState
     );
+    const filteredPage = filterItemsBySinceDays(pageItems, sinceDaysCutoff);
+    if (shouldStopAtSinceDaysBoundary(operation, sinceDaysCutoff, pageItems)) {
+      stoppedBySinceDays = true;
+    }
     const candidateItems = itemsForRemainingLimit(
-      pageItems,
+      filteredPage.items,
       collectedItems.length,
       pagination.maxItems
     );
@@ -2948,6 +3118,7 @@ async function collectPaginatedDirectData(
     if (
       !nextMarker ||
       reachedMaxItems(collectedItems, pagination.maxItems) ||
+      stoppedBySinceDays ||
       pageCount >= pageLimit
     ) {
       if (markerRepeated) {
@@ -2971,6 +3142,7 @@ async function collectPaginatedDirectData(
     items: collectedItems,
     pageCount,
     nextMarker,
+    stoppedBySinceDays,
   });
 }
 
@@ -2985,6 +3157,54 @@ function directPageItems(pageData) {
   return Array.isArray(pageData?.items) ? pageData.items : [];
 }
 
+function shouldAutoPaginateSinceDays(operation, pagination) {
+  return (
+    operation.operation === "user-posts" &&
+    pagination.sinceDays !== undefined &&
+    pagination.pages === undefined
+  );
+}
+
+function cutoffPublishTimeForSinceDays(sinceDays) {
+  return Math.floor(Date.now() / 1000) - sinceDays * 86400;
+}
+
+function itemPublishTimeSeconds(item) {
+  const value = item?.publish_time;
+  const timestamp =
+    typeof value === "number"
+      ? value
+      : typeof value === "string"
+        ? Number(value)
+        : NaN;
+  if (!Number.isFinite(timestamp) || timestamp <= 0) {
+    return undefined;
+  }
+  return timestamp;
+}
+
+function filterItemsBySinceDays(items, cutoffPublishTime) {
+  if (cutoffPublishTime === undefined) {
+    return { items };
+  }
+  return {
+    items: items.filter((item) => {
+      const publishTime = itemPublishTimeSeconds(item);
+      return publishTime !== undefined && publishTime >= cutoffPublishTime;
+    }),
+  };
+}
+
+function shouldStopAtSinceDaysBoundary(operation, cutoffPublishTime, items) {
+  if (operation.operation !== "user-posts" || cutoffPublishTime === undefined) {
+    return false;
+  }
+  return items.some((item) => {
+    const publishTime = itemPublishTimeSeconds(item);
+    return publishTime !== undefined && publishTime < cutoffPublishTime;
+  });
+}
+
 function createPaginatedItemDedupeState() {
   return { seenKeys: new Set() };
 }
@@ -3014,6 +3234,10 @@ function recordPaginatedItemDedupeKeys(itemDedupeState, dedupeKeys) {
 }
 
 function paginatedItemDedupeKeys(operation, item) {
+  if (operation.operation === "user-search") {
+    const userId = itemStringField(item, "user_id");
+    return userId ? [`${operation.operation}:${operation.platform.id}:user_id:${userId}`] : [];
+  }
   if (shouldDeduplicateCommentItems(operation)) {
     const commentId = itemStringField(item, "comment_id");
     return commentId ? [`comment:${commentId}`] : [];
@@ -3204,6 +3428,7 @@ function buildPaginatedData({
   items,
   pageCount,
   nextMarker,
+  stoppedBySinceDays,
 }) {
   const data = {
     ...(lastPageData && typeof lastPageData === "object" ? lastPageData : {}),
@@ -3214,6 +3439,9 @@ function buildPaginatedData({
   };
   delete data.next_page;
   data.next_page_token = nextMarker || "";
+  if (stoppedBySinceDays) {
+    data.stopped_by_since_days = true;
+  }
   return data;
 }
 

package/package.json

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

package/skills/media-search/SKILL.md

@@ -76,11 +76,12 @@ Optional arguments:
 - Douyin `--pages <n>`: fetch and merge N search pages from the current starting point; continue with returned `next_page_token`.
 - Kuaishou `--pages <n>`: fetch and merge N search pages from the current starting point; continue with returned `next_page_token`.
 - `--max-items <n>`: stop after collecting N search results.
+- `--since-days <1-365>`: keep only results whose public `publish_time` is within the last N days. Search remains bounded by `--pages` and does not promise complete platform coverage.
 - `--pretty`: output formatting only.
 - Kuaishou `--page-token <next_page_token>`: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.
 - Weibo `--page-token <next_page_token>`: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.
 - WeChat Channels / 视频号 `--page-token <next_page_token>`: opaque pagination token; omit it on the first search request. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.
-- WeChat Channels / 视频号 `--sort-type <all|latest|popular>`: optional sort value; omit it for the default sort.
+- WeChat Channels / 视频号 `--sort-type <general|time_descending|popularity_descending>`: optional sort value; omit it for the default sort.
 - WeChat Channels / 视频号 `--duration-range <all|under_5_min|between_5_and_20_min|over_20_min>`: optional duration filter; omit it for no duration filter.
 - Weibo `--pages <n>`: fetch and merge N search pages from the current starting point; continue with returned `next_page_token`.
 - WeChat Channels / 视频号 `--pages <n>`: fetch and merge N search pages from the current starting point; continue with returned `next_page_token`.
@@ -126,14 +127,15 @@ Douyin content type filter values:
 - `image`: image/text posts.
 
 The command prints JSON with `platform`, `tool`, `arguments`, and `data`. Search supports `--pages` and `--max-items`, but not `--all`, because search has no stable complete-result boundary. Multi-page output keeps merged results in `data.items` and adds `page_count`, `item_count`, and the next-page marker.
+With CLI `--since-days <n>`, XHS and Douyin search automatically prefer newest-first sorting and the closest native publish-time range unless the user explicitly sets sort or publish-time filters; WeChat Channels search defaults to `time_descending`; Kuaishou and Weibo only apply CLI-side `publish_time` filtering.
 Kuaishou search pagination:
 - Continue only when `next_page_token` is not empty.
 - Pass the complete returned `next_page_token` back unchanged as `page_token` for the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.
 
 WeChat Channels / 视频号 sort values:
-- `all`: default sorting.
-- `latest`: newest first.
-- `popular`: most popular first.
+- `general`: default sorting.
+- `time_descending`: newest first.
+- `popularity_descending`: platform heat first.
 
 WeChat Channels / 视频号 duration filter values:
 - `all`: no duration filter.
@@ -195,9 +197,10 @@ For WeChat Channels / 视频号, call `wechat_search_videos` with:
 - `keyword`: required search phrase or topic.
 - `page_token`: optional opaque pagination token. Continue only with the complete returned `next_page_token` from the same search pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.
 Do not pass `page` to `wechat_search_videos`; omit `page_token` on the first request.
-- `sort_type`: optional, one of `all`, `latest`, `popular`; omit it for the default sort.
+- `sort_type`: optional, one of `general`, `time_descending`, `popularity_descending`; omit it for the default sort.
 - `duration_range`: optional duration filter, one of `all`, `under_5_min`, `between_5_and_20_min`, `over_20_min`; omit it for no duration filter.
 Continue WeChat Channels pagination only when `next_page_token` is not empty. Pass the complete returned `next_page_token` back unchanged as `page_token` for the same keyword and filter chain.
+`--since-days` uses CLI-side filtering only and is not an MCP tool argument; for MCP-only calls, request newest-first/native publish-time filters where available and filter returned `publish_time` values in your analysis.
 
 ## Output Guidance
 

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

@@ -28,6 +28,7 @@ Current platform support:
 - Xiaohongshu / XHS / RedNote creators through the `xhs_get_user_info_by_*` tools.
 - Douyin / 抖音 creators through the `douyin_get_user_info_by_*` tools.
 - Kuaishou / 快手 creators through the `kuaishou_get_user_info_by_*` tools.
+- Kuaishou / 快手 creator discovery through `kuaishou_search_users` before profile lookup when only an account keyword or niche is known.
 - Weibo / 微博 creators through the `weibo_get_user_info_by_*` tools.
 - WeChat Channels / 视频号 creators through `wechat_get_user_info_by_user_id`.
 
@@ -45,6 +46,7 @@ npx -y socialdatax-skills@latest xhs user-info --user-id "<user_id>" --pretty
 npx -y socialdatax-skills@latest xhs user-info --profile-url "<profile_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest douyin user-info --sec-user-id "<sec_user_id>" --pretty
 npx -y socialdatax-skills@latest douyin user-info --profile-url "<profile_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest kuaishou user-search --keyword "<creator_keyword>" --pretty
 npx -y socialdatax-skills@latest kuaishou user-info --user-id "<user_id>" --pretty
 npx -y socialdatax-skills@latest kuaishou user-info --profile-url "<profile_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest weibo user-info --user-id "<user_id>" --pretty
@@ -59,6 +61,9 @@ Optional arguments:
 - Douyin `--sec-user-id <sec_user_id>`: preferred when the creator sec_user_id is already known.
 - Douyin `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text.
 - `--pretty`: output formatting only.
+- Kuaishou `user-search --keyword <creator_keyword>`: use when the user only has a creator name, account keyword, or niche and needs possible Kuaishou user_id candidates before profile lookup.
+- Kuaishou user-search `--page-token <next_page_token>`: opaque pagination token; omit it on the first request and continue only with the complete returned `next_page_token` from the same creator-search chain.
+- Kuaishou user-search `--pages <n>` and `--max-items <n>`: fetch and merge bounded creator-search pages; user-search does not support `--since-days` because creator search results are accounts, not published content items.
 - Kuaishou `--user-id <user_id>`: preferred when the creator user_id is already known.
 - Kuaishou `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text.
 - Weibo `--user-id <user_id>`: preferred when the creator user_id is already known.
@@ -81,6 +86,7 @@ MCP tools matching the direct CLI commands above:
 - `xhs_get_user_info_by_profile_url`
 - `douyin_get_user_info_by_sec_user_id`
 - `douyin_get_user_info_by_profile_url`
+- `kuaishou_search_users`
 - `kuaishou_get_user_info_by_user_id`
 - `kuaishou_get_user_info_by_profile_url`
 - `weibo_get_user_info_by_user_id`
@@ -92,6 +98,7 @@ If MCP tools are already available in the current agent, use one of these tools:
 - `xhs_get_user_info_by_profile_url`: use for profile URLs, short links, or profile share text.
 - `douyin_get_user_info_by_sec_user_id`: preferred when `sec_user_id` is already known from search, detail, comments, or creator work lists.
 - `douyin_get_user_info_by_profile_url`: use for profile URLs, short links, or profile share text.
+- `kuaishou_search_users`: use when the user only has a creator keyword and needs possible Kuaishou user_id candidates. Pass `keyword`; pass `page_token` only for continuation. Do not pass `page`.
 - `kuaishou_get_user_info_by_user_id`: preferred when `user_id` is already known from search, detail, comments, or creator work lists.
 - `kuaishou_get_user_info_by_profile_url`: use for profile URLs, short links, or profile share text.
 - `weibo_get_user_info_by_user_id`: preferred when `user_id` is already known.
@@ -101,3 +108,4 @@ If MCP tools are already available in the current agent, use one of these tools:
 ## Output Guidance
 
 Report profile fields such as name, platform IDs, bio, verification, follower count, following count, received like count, IP location, and gender when available. Separate profile facts from strategic interpretation.
+For Kuaishou creator search results, present account candidates separately from confirmed profile facts; use a returned `user_id` for profile lookup when the user chooses a candidate.

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

@@ -73,6 +73,7 @@ Optional arguments:
 - `--pages <n>`: fetch and merge N pages of creator content or creator series.
 - `--all`: continue until `next_page_token` is empty; there is no default item or page cap.
 - `--max-items <n>`: stop after collecting N creator content or series items.
+- `--since-days <1-365>`: keep only creator content whose public `publish_time` is within the last N days. When `--pages` is omitted, the CLI continues creator content lists until the publish-time boundary is reached.
 - `--pretty`: output formatting only.
 - Kuaishou `--user-id <user_id>`: preferred when the creator user_id is already known.
 - Kuaishou `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text.
@@ -84,6 +85,7 @@ Optional arguments:
 Use either the ID option or the profile URL option for a single command, not both.
 
 The command prints JSON with `platform`, `tool`, `arguments`, and `data`. Multi-page output keeps merged creator content or series items in `data.items` and adds `page_count`, `item_count`, and `next_page_token`.
+For recent creator research, prefer CLI `--since-days 30` or another user-specified day window. `--since-days` applies to creator content lists only, not Douyin `user-series`.
 
 ## Safety Boundary
 
@@ -124,6 +126,7 @@ Weibo creator post pagination uses opaque `page_token` values; pass the complete
 - `wechat_get_user_posted_videos_by_user_id`: preferred when the WeChat Channels / 视频号 `@finder` user_id is already known.
 - `wechat_get_user_posted_videos_by_url`: use a WeChat Channels / 视频号 video link or share text to resolve the author and list that creator's videos.
 WeChat Channels / 视频号 creator video pagination uses opaque `page_token` values; pass the complete returned `next_page_token` back unchanged for the same user. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.
+`--since-days` uses CLI-side filtering only and is not an MCP tool argument; for MCP-only calls, continue pages as needed and filter returned `publish_time` values in your analysis.
 
 ## Output Guidance
 

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

@@ -27,7 +27,6 @@ Current platform support:
 
 - Xiaohongshu / XHS / RedNote search hot list through `xhs_get_search_hot_list`.
 - Douyin / 抖音 hot-search through `douyin_get_hot_search_list`.
-- Kuaishou / 快手 hot-search through `kuaishou_get_hot_search_list`.
 - Weibo / 微博 hot-search through `weibo_get_hot_search_list`.
 - WeChat Channels / 视频号 hot-search through `wechat_get_hot_search_list`.
 - Xiaohongshu / XHS / RedNote notes through `xhs_search_notes`.
@@ -48,6 +47,7 @@ Current platform support:
 - Xiaohongshu / XHS / RedNote creators through the `xhs_get_user_info_by_*` tools.
 - Douyin / 抖音 creators through the `douyin_get_user_info_by_*` tools.
 - Kuaishou / 快手 creators through the `kuaishou_get_user_info_by_*` tools.
+- Kuaishou / 快手 creator discovery through `kuaishou_search_users` before profile lookup when only an account keyword or niche is known.
 - Weibo / 微博 creators through the `weibo_get_user_info_by_*` tools.
 - WeChat Channels / 视频号 creators through `wechat_get_user_info_by_user_id`.
 - Xiaohongshu / XHS / RedNote creator notes through the `xhs_get_user_posted_notes_by_*` tools.
@@ -85,9 +85,9 @@ npx -y socialdatax-skills@latest douyin comments --aweme-id "<aweme_id>" --all -
 npx -y socialdatax-skills@latest douyin user-info --sec-user-id "<sec_user_id>" --pretty
 npx -y socialdatax-skills@latest douyin user-posts --sec-user-id "<sec_user_id>" --pretty
 npx -y socialdatax-skills@latest douyin user-posts --sec-user-id "<sec_user_id>" --all --pretty
-npx -y socialdatax-skills@latest kuaishou hot-search --pretty
 npx -y socialdatax-skills@latest kuaishou search --keyword "<keyword>" --pretty
 npx -y socialdatax-skills@latest kuaishou search --keyword "<keyword>" --pages 3 --pretty
+npx -y socialdatax-skills@latest kuaishou user-search --keyword "<creator_keyword>" --pretty
 npx -y socialdatax-skills@latest kuaishou detail --photo-id "<photo_id>" --pretty
 npx -y socialdatax-skills@latest kuaishou comments --photo-id "<photo_id>" --pretty
 npx -y socialdatax-skills@latest kuaishou comments --photo-id "<photo_id>" --all --include-replies --pretty
@@ -115,7 +115,6 @@ npx -y socialdatax-skills@latest wechat user-posts --user-id "<finder_user_id>"
 ```
 
 Additional direct CLI entrypoints:
-
 ```bash
 npx -y socialdatax-skills@latest xhs detail --url "<note_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest xhs comments --url "<note_url_or_share_text>" --pretty
@@ -130,6 +129,7 @@ npx -y socialdatax-skills@latest douyin user-series --sec-user-id "<sec_user_id>
 npx -y socialdatax-skills@latest douyin user-series --profile-url "<profile_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest xhs sub-comments --note-id "<note_id>" --comment-id "<comment_id>" --pretty
 npx -y socialdatax-skills@latest douyin replies --aweme-id "<aweme_id>" --comment-id "<comment_id>" --pretty
+npx -y socialdatax-skills@latest kuaishou user-search --keyword "<creator_keyword>" --pages 3 --pretty
 npx -y socialdatax-skills@latest kuaishou detail --url "<kuaishou_content_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest kuaishou comments --url "<kuaishou_content_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest kuaishou user-info --profile-url "<profile_url_or_share_text>" --pretty
@@ -138,7 +138,9 @@ npx -y socialdatax-skills@latest kuaishou replies --photo-id "<photo_id>" --comm
 npx -y socialdatax-skills@latest weibo detail --post-url "<weibo_post_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest weibo comments --post-url "<weibo_post_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest weibo likers --post-id "<post_id>" --pretty
+npx -y socialdatax-skills@latest weibo likers --post-url "<weibo_post_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest weibo reposts --post-id "<post_id>" --pretty
+npx -y socialdatax-skills@latest weibo reposts --post-url "<weibo_post_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest weibo user-info --profile-url "<profile_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest weibo user-posts --profile-url "<profile_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest weibo replies --post-id "<post_id>" --comment-id "<comment_id>" --pretty
@@ -155,19 +157,19 @@ Required arguments:
 - Use `xhs hot-search` without keyword when the user asks for current Xiaohongshu / XHS / RedNote hot topics or 小红书搜索热榜.
 - Use `douyin hot-search` without keyword when the user asks for current Douyin hot topics.
 - Use `xhs search --keyword <text>`, `douyin search --keyword <text>`, `kuaishou search --keyword <text>`, `weibo search --keyword <text>`, or `wechat search --keyword <text>` for keyword research.
+- Use `kuaishou user-search --keyword <creator_keyword>` when the user wants to discover Kuaishou creator or account candidates by name, keyword, or niche before profile lookup.
 - For detail, comments, replies, creator profile, creator posts, and creator series commands, use the ID argument shown in the CLI example or the matching URL/profile-url entrypoint, not both.
-- Use `kuaishou hot-search` without keyword when the user asks for current Kuaishou / 快手 hot topics.
-- Use `kuaishou search --keyword <text>` for Kuaishou keyword research.
-- Use `weibo hot-search` without keyword when the user asks for current Weibo / 微博 hot topics.
 - Use `wechat hot-search` without keyword when the user asks for current WeChat Channels / 视频号 hot topics.
 
 Optional arguments:
 
 - Search continuation uses `--page-token <next_page_token>` when a returned `next_page_token` is available. Omit `page_token` on the first token-paginated search request, and continue only with the complete returned `next_page_token` from the same chain.
-- `--page-token <next_page_token>`: use for XHS/Douyin/Kuaishou/Weibo/WeChat Channels search continuation and for token-paginated comments, replies, creator posts, creator notes, creator videos, and creator series. Keep the original topic, content item, or creator target stable. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.
+- `--page-token <next_page_token>`: use for XHS/Douyin/Kuaishou/Weibo/WeChat Channels search continuation, Kuaishou creator search continuation, and token-paginated comments, replies, creator posts, creator notes, creator videos, and creator series. Keep the original topic, content item, creator-search keyword, or creator target stable. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.
 - `--pages <n>`: fetch and merge N pages for search, comments, replies, creator posts, or creator series.
 - `--all`: fetch comments, replies, creator posts, or creator series until `next_page_token` is empty; do not use it for search.
 - `--max-items <n>`: stop after collecting N primary results.
+- Kuaishou `user-search` supports `--pages <n>` and `--max-items <n>` for bounded creator candidate discovery; it does not support `--since-days`.
+- `--since-days <1-365>`: keep search or creator content-list items whose public `publish_time` is within the last N days. Search stays bounded by `--pages`; creator content lists continue until the publish-time boundary when `--pages` is omitted.
 - `--include-replies`: for first-level comments, also fetch nested second-level replies under each returned comment.
 - `--sort-type`, `--note-type`, `--publish-time-range`, `--duration-range`, and `--content-type`: apply only to XHS, Douyin, or WeChat Channels keyword research commands when the user asks for filtering; Kuaishou and Weibo search currently use `--keyword` and optional `--page-token`.
 - `--comment-id`: required for reply/sub-comment commands together with the content ID.
@@ -177,7 +179,7 @@ Optional arguments:
 
 - Use XHS commands for Xiaohongshu / XHS / RedNote / 小红书 search hot list, notes, comments, creators, and creator note lists.
 - Use Douyin commands for Douyin / 抖音 works, comments, creators, hot topics, creator works, and creator short-drama series.
-- Use Kuaishou commands for Kuaishou / 快手 short videos, comments, creators, creator works, and hot topics.
+- Use Kuaishou commands for Kuaishou / 快手 short videos, keyword research, comments, creators, and creator works.
 - Use Weibo commands for Weibo / 微博 posts, comments, creators, creator posts, and hot topics.
 - Use WeChat Channels / 视频号 commands for videos, comments, creators, creator videos, and hot topics.
 - If the user asks for both platforms, keep findings separated by platform before comparing patterns.
@@ -185,6 +187,7 @@ Optional arguments:
 ## Choose The Narrowest Entry
 
 Use the most specific direct CLI command for the user's task instead of forcing every request through keyword research. The command prints JSON with `platform`, `tool`, `arguments`, and `data`.
+When the user asks for recent content, pass CLI `--since-days <n>` with bounded `--pages`; keep in mind this filters returned `publish_time` values and does not promise complete platform coverage.
 
 ## Safety Boundary
 
@@ -196,8 +199,8 @@ MCP tools matching the direct CLI commands above:
 
 - XHS: `xhs_get_search_hot_list`, `xhs_search_notes`, `xhs_get_note_detail_by_note_id`, `xhs_get_note_comments_by_note_id`, `xhs_get_user_info_by_user_id`, `xhs_get_user_posted_notes_by_user_id`, `xhs_get_note_detail_by_note_url`, `xhs_get_note_comments_by_note_url`, `xhs_get_user_info_by_profile_url`, `xhs_get_user_posted_notes_by_profile_url`, `xhs_get_note_sub_comments_by_comment_id`
 - DOUYIN: `douyin_get_hot_search_list`, `douyin_search_videos`, `douyin_get_video_detail_by_aweme_id`, `douyin_get_video_comments_by_aweme_id`, `douyin_get_user_info_by_sec_user_id`, `douyin_get_user_posted_videos_by_sec_user_id`, `douyin_get_video_detail_by_url`, `douyin_get_video_comments_by_url`, `douyin_get_user_info_by_profile_url`, `douyin_get_user_posted_videos_by_profile_url`, `douyin_get_user_series_by_sec_user_id`, `douyin_get_user_series_by_profile_url`, `douyin_get_video_comment_replies_by_comment_id`
-- KUAISHOU: `kuaishou_get_hot_search_list`, `kuaishou_search_videos`, `kuaishou_get_video_detail_by_photo_id`, `kuaishou_get_video_comments_by_photo_id`, `kuaishou_get_user_info_by_user_id`, `kuaishou_get_user_posted_videos_by_user_id`, `kuaishou_get_video_detail_by_url`, `kuaishou_get_video_comments_by_url`, `kuaishou_get_user_info_by_profile_url`, `kuaishou_get_user_posted_videos_by_profile_url`, `kuaishou_get_video_comment_replies_by_comment_id`
-- 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`
+- KUAISHOU: `kuaishou_search_videos`, `kuaishou_search_users`, `kuaishou_get_video_detail_by_photo_id`, `kuaishou_get_video_comments_by_photo_id`, `kuaishou_get_user_info_by_user_id`, `kuaishou_get_user_posted_videos_by_user_id`, `kuaishou_get_video_detail_by_url`, `kuaishou_get_video_comments_by_url`, `kuaishou_get_user_info_by_profile_url`, `kuaishou_get_user_posted_videos_by_profile_url`, `kuaishou_get_video_comment_replies_by_comment_id`
+- 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_liker_list_by_post_url`, `weibo_get_post_repost_list_by_post_id`, `weibo_get_post_repost_list_by_post_url`, `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_video_comments_by_url`, `wechat_get_user_posted_videos_by_url`, `wechat_get_video_comment_replies_by_comment_id`
 
 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.