socialdatax-skills 0.2.31 → 0.2.32

package/README.md

@@ -86,7 +86,7 @@ Common search phrases for this skill package:
 - Sensitive Words Check MCP server name: `sensitive-check`
 - Sensitive Words 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.31`
+- Current public capability version: `0.2.32`
 
 ## Direct CLI
 
@@ -172,8 +172,8 @@ npx -y socialdatax-skills@latest wechat comments --object-id "<object_id>" --obj
 npx -y socialdatax-skills@latest wechat comments --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --all --include-replies --pretty
 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 "<finder_user_id>" --pretty
-npx -y socialdatax-skills@latest wechat user-posts --user-id "<finder_user_id>" --pretty
+npx -y socialdatax-skills@latest wechat user-info --user-id "<v2_finder_user_id>" --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_video_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest wechat transcript --url "<wechat_video_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest wechat transcript --encrypted-object-id "<encrypted_object_id>" --pretty
@@ -429,8 +429,8 @@ Current WeChat / 微信 workflows include:
 - Fetch paginated first-level comments for comment analysis.
 - Fetch paginated replies under a first-level comment; pass `object_id`, `object_nonce_id`, and `comment_id`.
 - Continue WeChat Channels 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 finder user_id.
-- Fetch paginated creator video lists from a finder user_id or a video link/share text.
+- Read creator profile data from a `v2_...@finder` user_id.
+- Fetch paginated creator video lists from a `v2_...@finder` user_id or a video link/share text.
 - Submit and check WeChat Channels / 视频号 video 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 210 秒，未完成时继续查询同一个 job_id 直到终态.
 
 Current Sensitive Words Check workflows include:
@@ -537,8 +537,8 @@ Current Sensitive Words Check workflows include:
 | `wechat_get_video_comments_by_object_id` | Fetch paginated first-level comments when object_id and object_nonce_id are known. |
 | `wechat_get_video_comments_by_url` | Fetch paginated first-level comments directly from a WeChat Channels / 视频号 video link or share text. |
 | `wechat_get_video_comment_replies_by_comment_id` | Fetch paginated replies under a first-level comment by object_id, object_nonce_id, and comment_id. |
-| `wechat_get_user_info_by_user_id` | Fetch creator profile data when the finder user_id is already known. |
-| `wechat_get_user_posted_videos_by_user_id` | Fetch a paginated list of videos published by a creator when the finder user_id is already known. |
+| `wechat_get_user_info_by_user_id` | Fetch creator profile data when the `v2_...@finder` user_id is already known. |
+| `wechat_get_user_posted_videos_by_user_id` | Fetch a paginated list of videos published by a creator when the `v2_...@finder` user_id is already known. |
 | `wechat_get_user_posted_videos_by_url` | Fetch a paginated list of videos published by a creator from a video link or share text. |
 | `wechat_submit_video_speech_text_by_video_url` | Submit a WeChat Channels / 视频号 video speech-to-text transcript job from a video link or share text; submit waits up to 210 seconds. If unfinished, continue checking the same job_id with get-job wait_seconds up to 240 until is_terminal is true. |
 | `wechat_submit_video_speech_text_by_encrypted_object_id` | Submit a WeChat Channels / 视频号 video speech-to-text transcript job when encrypted_object_id is already known; submit waits up to 210 seconds. If unfinished, continue checking the same job_id with get-job wait_seconds up to 240 until is_terminal is true. |

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.31";
+const PACKAGE_VERSION = "0.2.32";
 const PACKAGE_SPEC = `${PACKAGE_NAME}@latest`;
 const LOG_PREFIX = `[${PACKAGE_NAME}]`;
 const MIN_NODE_VERSION = "20.18.1";
@@ -926,11 +926,11 @@ const PLATFORMS = {
       },
       {
         name: "wechat_get_user_info_by_user_id",
-        description: "Fetch creator profile data when the finder user_id is already known.",
+        description: "Fetch creator profile data when the v2_...@finder user_id is already known.",
       },
       {
         name: "wechat_get_user_posted_videos_by_user_id",
-        description: "Fetch a paginated list of videos published by a creator when the finder user_id is already known.",
+        description: "Fetch a paginated list of videos published by a creator when the v2_...@finder user_id is already known.",
       },
       {
         name: "wechat_get_user_posted_videos_by_url",
@@ -2129,11 +2129,11 @@ function printHelp() {
   );
   console.log("      Call the WeChat Channels / 视频号 comment replies tool directly and print JSON.");
   console.log("");
-  console.log(`  npx -y ${PACKAGE_SPEC} wechat user-info --user-id "<finder_user_id>" --pretty`);
-  console.log("      Call the WeChat Channels / 视频号 creator profile tool directly and print JSON.");
+  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-posts --user-id "<finder_user_id>" --pretty`);
-  console.log("      Call the WeChat Channels / 视频号 creator videos tool directly and print JSON.");
+  console.log(`  npx -y ${PACKAGE_SPEC} wechat user-posts --user-id "<v2_finder_user_id>" --pretty`);
+  console.log("      Call the WeChat Channels / 视频号 creator videos tool with a v2_...@finder user_id.");
   console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} wechat user-posts --url "<wechat_video_url_or_share_text>" --pretty`);
   console.log("      Call the WeChat Channels / 视频号 creator videos tool from a video link or share text.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "socialdatax-skills",
-  "version": "0.2.31",
+  "version": "0.2.32",
   "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

@@ -235,6 +235,8 @@ Do not pass `page` to `wechat_search_videos`; omit `page_token` on the first req
 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.
 
+XHS search parameter naming reminder: direct CLI uses `--sort-type`, `--publish-time-range`, and `--note-type`; the `xhs_search_notes` MCP tool uses `sort_type`, `publish_time_range`, and `note_type`. Do not pass `sortType`, `publishTimeRange`, or `noteType`.
+
 ## Output Guidance
 
 Summarize visible evidence separately from interpretation. Include useful content IDs, URLs, titles or descriptions, authors, counts, and publish time when the user needs traceability.

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

@@ -33,7 +33,7 @@ Current platform support:
 - 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`.
+- WeChat Channels / 视频号 creators through `wechat_get_user_info_by_user_id` when a `v2_...@finder` user_id is already known.
 
 ## API Key
 
@@ -86,7 +86,7 @@ npx -y socialdatax-skills@latest weibo user-info \
   --source-skill media-user-info
 
 npx -y socialdatax-skills@latest wechat user-info \
-  --user-id "<finder_user_id>" --pretty --source-client socialdatax-skills \
+  --user-id "<v2_finder_user_id>" --pretty --source-client socialdatax-skills \
   --source-platform npm --source-skill media-user-info
 ```
 
@@ -104,7 +104,7 @@ Optional arguments:
 - Kuaishou `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text. Live/fw-user profile shares are supported; successful profile results return a reusable non-empty user_id.
 - Weibo `--user-id <user_id>`: preferred when the creator user_id is already known.
 - Weibo `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text.
-- WeChat Channels / 视频号 `--user-id <finder_user_id>`: use when the creator user_id ending with `@finder` is already known.
+- WeChat Channels / 视频号 `--user-id <v2_finder_user_id>`: use when the creator `v2_...@finder` user_id is already known.
 - `--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.
@@ -140,7 +140,7 @@ If MCP tools are already available in the current agent, use one of these tools:
 - `kuaishou_get_user_info_by_profile_url`: use for profile URLs, short links, or profile share text, including live/fw-user profile shares; successful results return a reusable non-empty `user_id`.
 - `weibo_get_user_info_by_user_id`: preferred when `user_id` is already known.
 - `weibo_get_user_info_by_profile_url`: use for profile URLs, short links, or profile share text.
-- `wechat_get_user_info_by_user_id`: use when the WeChat Channels / 视频号 creator user_id ending with `@finder` is already known.
+- `wechat_get_user_info_by_user_id`: use when the WeChat Channels / 视频号 creator `v2_...@finder` user_id is already known.
 
 ## Output Guidance
 

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

@@ -33,7 +33,7 @@ Current platform support:
 - Douyin / 抖音 creator short-drama series through the `douyin_get_user_series_by_*` tools.
 - Kuaishou / 快手 creator works through the `kuaishou_get_user_posted_videos_by_*` tools.
 - Weibo / 微博 creator posts through the `weibo_get_user_posts_by_*` tools.
-- WeChat Channels / 视频号 creator videos through the `wechat_get_user_posted_videos_by_*` tools.
+- WeChat Channels / 视频号 creator videos through the `wechat_get_user_posted_videos_by_*` tools; the user_id entrypoint requires a `v2_...@finder` user_id.
 
 ## API Key
 
@@ -111,11 +111,11 @@ npx -y socialdatax-skills@latest weibo user-posts \
   --source-skill media-user-posts
 
 npx -y socialdatax-skills@latest wechat user-posts \
-  --user-id "<finder_user_id>" --pretty --source-client socialdatax-skills \
+  --user-id "<v2_finder_user_id>" --pretty --source-client socialdatax-skills \
   --source-platform npm --source-skill media-user-posts
 
 npx -y socialdatax-skills@latest wechat user-posts \
-  --user-id "<finder_user_id>" --all --pretty --source-client socialdatax-skills \
+  --user-id "<v2_finder_user_id>" --all --pretty --source-client socialdatax-skills \
   --source-platform npm --source-skill media-user-posts
 
 npx -y socialdatax-skills@latest wechat user-posts \
@@ -140,7 +140,7 @@ Optional arguments:
 - Kuaishou `--profile-url <profile_url_or_share_text>`: use only for a profile URL, short link, or profile share text that resolves directly to a non-empty user_id. For live/fw-user profile shares, call Kuaishou creator profile first and use the returned non-empty user_id.
 - Weibo `--user-id <user_id>`: preferred when the creator user_id is already known.
 - Weibo `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text.
-- WeChat Channels / 视频号 `--user-id <finder_user_id>`: preferred when the creator user_id ending with `@finder` is already known.
+- WeChat Channels / 视频号 `--user-id <v2_finder_user_id>`: preferred when the creator `v2_...@finder` user_id is already known.
 - WeChat Channels / 视频号 `--url <wechat_video_url_or_share_text>`: use a video link or share text to resolve the author and list that creator's videos.
 - `--source-client socialdatax-skills --source-platform npm --source-skill media-user-posts`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.
 
@@ -185,7 +185,7 @@ Kuaishou creator work pagination uses opaque `page_token` values; pass the compl
 - `weibo_get_user_posts_by_user_id`: preferred when `user_id` is already known.
 - `weibo_get_user_posts_by_profile_url`: use for profile URLs, short links, or profile share text.
 Weibo creator post 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.
-- `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_user_id`: preferred when the WeChat Channels / 视频号 `v2_...@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.

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

@@ -54,13 +54,13 @@ Current platform support:
 - 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`.
+- WeChat Channels / 视频号 creators through `wechat_get_user_info_by_user_id` when a `v2_...@finder` user_id is already known.
 - Xiaohongshu / XHS / RedNote creator notes through the `xhs_get_user_posted_notes_by_*` tools.
 - Douyin / 抖音 creator works, including video and image/text posts, through the `douyin_get_user_posted_videos_by_*` tools.
 - Douyin / 抖音 creator short-drama series through the `douyin_get_user_series_by_*` tools.
 - Kuaishou / 快手 creator works through the `kuaishou_get_user_posted_videos_by_*` tools.
 - Weibo / 微博 creator posts through the `weibo_get_user_posts_by_*` tools.
-- WeChat Channels / 视频号 creator videos through the `wechat_get_user_posted_videos_by_*` tools.
+- WeChat Channels / 视频号 creator videos through the `wechat_get_user_posted_videos_by_*` tools; the user_id entrypoint requires a `v2_...@finder` user_id.
 
 ## API Key
 
@@ -252,15 +252,15 @@ npx -y socialdatax-skills@latest wechat comments \
   --source-skill socialdatax-content-research-assistant
 
 npx -y socialdatax-skills@latest wechat user-info \
-  --user-id "<finder_user_id>" --pretty --source-client socialdatax-skills \
+  --user-id "<v2_finder_user_id>" --pretty --source-client socialdatax-skills \
   --source-platform npm --source-skill socialdatax-content-research-assistant
 
 npx -y socialdatax-skills@latest wechat user-posts \
-  --user-id "<finder_user_id>" --pretty --source-client socialdatax-skills \
+  --user-id "<v2_finder_user_id>" --pretty --source-client socialdatax-skills \
   --source-platform npm --source-skill socialdatax-content-research-assistant
 
 npx -y socialdatax-skills@latest wechat user-posts \
-  --user-id "<finder_user_id>" --all --pretty --source-client socialdatax-skills \
+  --user-id "<v2_finder_user_id>" --all --pretty --source-client socialdatax-skills \
   --source-platform npm --source-skill socialdatax-content-research-assistant
 ```
 
@@ -473,6 +473,8 @@ MCP tools matching the direct CLI commands above:
 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. Use `page_token` for all new search continuation calls.
 
+XHS search parameter naming reminder: direct CLI uses `--sort-type`, `--publish-time-range`, and `--note-type`; the `xhs_search_notes` MCP tool uses `sort_type`, `publish_time_range`, and `note_type`. Do not pass `sortType`, `publishTimeRange`, or `noteType`.
+
 ## Output Guidance
 
 For broad research, summarize visible evidence separately from interpretation and organize findings by platform, content angles, audience needs, trend signals, comment themes, creator positioning, and practical next steps.
@@ -484,6 +486,7 @@ For hot-search, report ranking signals separately from keyword search results.
 
 ## Troubleshooting
 
-- For non-balance network or API errors, preserve the error message, check `SOCIALDATAX_API_KEY`, parameters, and link or ID format, then retry once when appropriate.
+- For non-balance, non-rate-limit network or API errors, preserve the error message, check `SOCIALDATAX_API_KEY`, parameters, and link or ID format, then retry once when appropriate.
 - If the response returns `insufficient_balance` or says the balance/credits are insufficient, do not retry repeatedly. Show the recharge URL from the error exactly as returned, then continue the same command after the user recharges.
 - If the user has recharged but still sees insufficient balance, confirm `SOCIALDATAX_API_KEY` belongs to the same account that was recharged; if needed, copy a fresh API Key from the official dashboard.
+- Batch processing: process items one by one as a queue by default; when the user explicitly needs batch efficiency, use at most 3 concurrent requests. As each item finishes, continue with the next one. Do not launch a large burst of requests. If `rate_limited` or a too-frequent-request error appears, do not abandon the task; stop starting new requests, wait for the returned wait time, or wait 2 seconds if none is provided, then continue the same queue from the unfinished position. Preserve completed results. If `insufficient_balance` or insufficient credits appears, stop remaining requests immediately, output the results already obtained, and ask the user to recharge or switch to an API Key with balance before continuing.