socialdatax-skills 0.2.31 → 0.2.33

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.33`
 
 ## 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
@@ -183,7 +183,7 @@ npx -y socialdatax-skills@latest sensitive-check text --text "<content>" --platf
 
 Most direct CLI commands print a JSON envelope with `platform`, `tool`, `arguments`, and `data`. `sensitive-check` prints `platform`, `tool`, and `data` only; it does not echo the original text in CLI output. `wechat decrypt-media` is a local save command: pass the `video.video_url` returned by WeChat detail and an `--output` file path. It saves the media locally, decrypts when needed, and does not require `SOCIALDATAX_API_KEY`. `xhs/douyin/kuaishou/weibo download-media` is also local: pass one media URL returned by detail and either `--output <file>` or `--output-dir <directory>`. It writes through a `.part` file, resumes partial downloads when the server supports range requests, skips an already existing output file, and infers common image/video/audio extensions in `--output-dir` mode.
 
-For transcript commands, the direct CLI tries to deliver the final result in one run: submit may wait up to 210 seconds, and if `data.is_terminal` is not `true`, the CLI automatically continues matching get-job requests for up to 1200 seconds by default, with each get-job request waiting up to 240 seconds. Use positive `--max-wait-seconds <seconds>` to tune that follow-up window. Do not submit a duplicate transcript job just to poll status.
+For transcript commands, the direct CLI tries to deliver the final result in one run: submit may wait up to 240 seconds, and if `data.is_terminal` is not `true`, the CLI automatically continues matching get-job requests for up to 1200 seconds by default, with each get-job request waiting up to 240 seconds. Use positive `--max-wait-seconds <seconds>` to tune that follow-up window. Do not submit a duplicate transcript job just to poll status.
 
 `bilibili download` calls SocialDataX once to fetch short-lived download links, then downloads video and audio tracks on the local machine and merges them with local `ffmpeg`. Set `SOCIALDATAX_API_KEY`, install `ffmpeg`, and pass either `--output <file>` or `--output-dir <directory>`. The download-links request consumes 10 credits; the local track download and merge do not consume additional SocialDataX credits. Use `--ffmpeg-path <path>` when `ffmpeg` is not on `PATH`, and `--keep-tracks` to retain the separate track files after merge.
 
@@ -369,7 +369,7 @@ Current XHS workflows include:
 - Fetch paginated replies under a first-level comment.
 - Read creator profile data from a profile link, short link, share text, or user ID.
 - Fetch paginated creator note lists from a user ID, profile link, short link, or share text for content style and account research.
-- Submit and check video note 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 210 秒，未完成时继续查询同一个 job_id 直到终态.
+- Submit and check video note 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 240 秒，未完成时继续查询同一个 job_id 直到终态.
 - Save returned `image_items[].image_url`, `image_items[].live_photo.video_url`, or `video.video_url` media links locally with `xhs download-media`.
 
 Current Kuaishou workflows include:
@@ -383,7 +383,7 @@ Current Kuaishou workflows include:
 - Continue Kuaishou 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 non-empty user_id, profile link, short link, or share text. Live/fw-user profile shares are supported for profile data; successful results return a reusable non-empty user_id.
 - Fetch paginated creator work lists from a non-empty user_id, or from a profile link, short link, or share text that resolves directly to a non-empty user_id. For live/fw-user profile shares, call creator profile first and use the returned non-empty user_id.
-- Submit and check video work 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 210 秒，未完成时继续查询同一个 job_id 直到终态.
+- Submit and check video work 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 240 秒，未完成时继续查询同一个 job_id 直到终态.
 - Save returned `images[].url`, `video.play_url`, or `cover_image_url` media links locally with `kuaishou download-media`.
 
 Current Bilibili workflows include:
@@ -403,7 +403,7 @@ Current Douyin workflows include:
 - Read creator profile data from a profile link, short link, share text, or sec_user_id.
 - Fetch paginated creator work lists from a sec_user_id, profile link, short link, or share text.
 - Fetch paginated creator short-drama series lists from a sec_user_id, profile link, short link, or share text.
-- Submit and check video work 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 210 秒，未完成时继续查询同一个 job_id 直到终态.
+- Submit and check video work 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 240 秒，未完成时继续查询同一个 job_id 直到终态.
 - Save returned `images[].url`, `images[].live_photo.play_url`, `video.play_url`, `music.play_url`, or `cover_image_url` media links locally with `douyin download-media`.
 
 Current Weibo workflows include:
@@ -416,7 +416,7 @@ Current Weibo workflows include:
 - 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.
-- Submit and check Weibo video 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 210 秒，未完成时继续查询同一个 job_id 直到终态.
+- Submit and check Weibo video 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 240 秒，未完成时继续查询同一个 job_id 直到终态.
 - Save returned `image_urls[]` or `video.video_url` media links locally with `weibo download-media`.
 
 Current WeChat / 微信 workflows include:
@@ -429,9 +429,9 @@ 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.
-- Submit and check WeChat Channels / 视频号 video 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 210 秒，未完成时继续查询同一个 job_id 直到终态.
+- 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 提交后最多等待 240 秒，未完成时继续查询同一个 job_id 直到终态.
 
 Current Sensitive Words Check workflows include:
 
@@ -455,9 +455,9 @@ Current Sensitive Words Check workflows include:
 | `xhs_get_user_info_by_profile_url` | Resolve a profile link, short link, or share text into creator profile data. |
 | `xhs_get_user_posted_notes_by_user_id` | Fetch a paginated list of notes published by a creator when the caller already has a user ID. |
 | `xhs_get_user_posted_notes_by_profile_url` | Fetch a paginated list of notes published by a creator from a profile link, short link, or share text. |
-| `xhs_submit_video_speech_text_by_note_url` | Submit an XHS video note speech-to-text transcript job from a note link, short 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. |
-| `xhs_submit_video_speech_text_by_note_id` | Submit an XHS video note speech-to-text transcript job when the caller already has a note ID; 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. |
-| `xhs_get_video_speech_text_job` | Check an XHS speech-to-text transcript job by job_id without creating a new task; optional wait_seconds 0-240 can long-poll the same job in one request. Continue querying the same job_id until is_terminal is true. Returns transcript plus content context, not summary. |
+| `xhs_submit_video_speech_text_by_note_url` | Submit an XHS video note speech-to-text transcript job from a note link, short link, or share text; submit waits up to 240 seconds. If unfinished, continue checking the same job_id until is_terminal is true. |
+| `xhs_submit_video_speech_text_by_note_id` | Submit an XHS video note speech-to-text transcript job when the caller already has a note ID; submit waits up to 240 seconds. If unfinished, continue checking the same job_id until is_terminal is true. |
+| `xhs_get_video_speech_text_job` | Check an XHS speech-to-text transcript job by job_id without creating a new task. Each call waits up to 240 seconds for the same job. If unfinished, continue querying the same job_id until is_terminal is true. Returns transcript plus content context, not summary. |
 
 ## Douyin Tools
 
@@ -476,9 +476,9 @@ Current Sensitive Words Check workflows include:
 | `douyin_get_user_posted_videos_by_profile_url` | Fetch a paginated list of works published by a creator from a profile link, short link, or share text. |
 | `douyin_get_user_series_by_sec_user_id` | Fetch a paginated list of short-drama series by a creator when the caller already has a sec_user_id. |
 | `douyin_get_user_series_by_profile_url` | Fetch a paginated list of short-drama series by a creator from a profile link, short link, or share text. |
-| `douyin_submit_video_speech_text_by_video_url` | Submit a Douyin video speech-to-text transcript job from a content page link, short 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. |
-| `douyin_submit_video_speech_text_by_aweme_id` | Submit a Douyin video speech-to-text transcript job when the caller already has an aweme_id; 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. |
-| `douyin_get_video_speech_text_job` | Check a Douyin speech-to-text transcript job by job_id without creating a new task; optional wait_seconds 0-240 can long-poll the same job in one request. Continue querying the same job_id until is_terminal is true. Returns transcript plus content context, not summary. |
+| `douyin_submit_video_speech_text_by_video_url` | Submit a Douyin video speech-to-text transcript job from a content page link, short link, or share text; submit waits up to 240 seconds. If unfinished, continue checking the same job_id until is_terminal is true. |
+| `douyin_submit_video_speech_text_by_aweme_id` | Submit a Douyin video speech-to-text transcript job when the caller already has an aweme_id; submit waits up to 240 seconds. If unfinished, continue checking the same job_id until is_terminal is true. |
+| `douyin_get_video_speech_text_job` | Check a Douyin speech-to-text transcript job by job_id without creating a new task. Each call waits up to 240 seconds for the same job. If unfinished, continue querying the same job_id until is_terminal is true. Returns transcript plus content context, not summary. |
 
 ## Kuaishou Tools
 
@@ -496,9 +496,9 @@ Current Sensitive Words Check workflows include:
 | `kuaishou_get_user_info_by_profile_url` | Resolve a Kuaishou profile link, including live/fw-user profile shares, short link, or share text into creator profile data; successful results return a reusable non-empty user_id. |
 | `kuaishou_get_user_posted_videos_by_user_id` | Fetch a paginated list of works published by a creator when the caller already has a non-empty user_id. |
 | `kuaishou_get_user_posted_videos_by_profile_url` | Fetch a paginated list of works published by a creator from a profile link, short link, or share text that resolves directly to a non-empty user_id; for live/fw-user profile shares, call creator profile first and use the returned non-empty user_id. |
-| `kuaishou_submit_video_speech_text_by_video_url` | Submit a Kuaishou video speech-to-text transcript job from a work page link, short 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. |
-| `kuaishou_submit_video_speech_text_by_photo_id` | Submit a Kuaishou video speech-to-text transcript job when the caller already has a photo_id; 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. |
-| `kuaishou_get_video_speech_text_job` | Check a Kuaishou speech-to-text transcript job by job_id without creating a new task; optional wait_seconds 0-240 can long-poll the same job in one request. Continue querying the same job_id until is_terminal is true. Returns transcript plus content context, not summary. |
+| `kuaishou_submit_video_speech_text_by_video_url` | Submit a Kuaishou video speech-to-text transcript job from a work page link, short link, or share text; submit waits up to 240 seconds. If unfinished, continue checking the same job_id until is_terminal is true. |
+| `kuaishou_submit_video_speech_text_by_photo_id` | Submit a Kuaishou video speech-to-text transcript job when the caller already has a photo_id; submit waits up to 240 seconds. If unfinished, continue checking the same job_id until is_terminal is true. |
+| `kuaishou_get_video_speech_text_job` | Check a Kuaishou speech-to-text transcript job by job_id without creating a new task. Each call waits up to 240 seconds for the same job. If unfinished, continue querying the same job_id until is_terminal is true. Returns transcript plus content context, not summary. |
 
 ## Bilibili Tools
 
@@ -521,9 +521,9 @@ Current Sensitive Words Check workflows include:
 | `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_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 210 seconds. If unfinished, continue checking the same job_id with get-job wait_seconds up to 240 until is_terminal is true. |
-| `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 210 seconds. If unfinished, continue checking the same job_id with get-job wait_seconds up to 240 until is_terminal is true. |
-| `weibo_get_video_speech_text_job` | Check a Weibo speech-to-text transcript job by job_id without creating a new task; optional wait_seconds 0-240 can long-poll the same job in one request. Continue querying the same job_id until is_terminal is true. Returns transcript plus content context, not summary. |
+| `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 240 seconds. If unfinished, continue checking the same job_id until is_terminal is true. |
+| `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 240 seconds. If unfinished, continue checking the same job_id until is_terminal is true. |
+| `weibo_get_video_speech_text_job` | Check a Weibo speech-to-text transcript job by job_id without creating a new task. Each call waits up to 240 seconds for the same job. If unfinished, continue querying the same job_id until is_terminal is true. Returns transcript plus content context, not summary. |
 
 ## WeChat Tools
 
@@ -537,12 +537,12 @@ 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. |
-| `wechat_get_video_speech_text_job` | Check a WeChat Channels / 视频号 speech-to-text transcript job by job_id without creating a new task; optional wait_seconds 0-240 can long-poll the same job in one request. Continue querying the same job_id until is_terminal is true. Returns transcript plus content context, not summary. |
+| `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 240 seconds. If unfinished, continue checking the same job_id 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 240 seconds. If unfinished, continue checking the same job_id until is_terminal is true. |
+| `wechat_get_video_speech_text_job` | Check a WeChat Channels / 视频号 speech-to-text transcript job by job_id without creating a new task. Each call waits up to 240 seconds for the same job. If unfinished, continue querying the same job_id until is_terminal is true. Returns transcript plus content context, not summary. |
 
 ## Sensitive Words Check Tools
 

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.33";
 const PACKAGE_SPEC = `${PACKAGE_NAME}@latest`;
 const LOG_PREFIX = `[${PACKAGE_NAME}]`;
 const MIN_NODE_VERSION = "20.18.1";
@@ -43,15 +43,16 @@ const SOURCE_ATTRIBUTION_PATTERN = /^[a-z0-9][a-z0-9-]{0,99}$/;
 export const TRANSCRIPT_JOB_DESCRIPTION_SUFFIX =
   "Returns transcript plus content context, not summary.";
 const TRANSCRIPT_SUBMIT_WAIT_DESCRIPTION =
-  "提交后最多等待 210 秒；未完成时继续用对应 get-job 查询同一个 job_id 直到终态，不要重复提交.";
+  "提交后最多等待 240 秒；未完成时继续用对应 get-job 查询同一个 job_id 直到终态，不要重复提交.";
 const TRANSCRIPT_GET_JOB_WAIT_DESCRIPTION =
-  "Optional wait_seconds 0-240 can long-poll the same job in one request.";
+  "Each call waits up to 240 seconds for the same job. If unfinished, continue querying the same job_id until is_terminal is true.";
 const TRANSCRIPT_DEFAULT_MAX_WAIT_SECONDS = 1200;
-const TRANSCRIPT_GET_JOB_WAIT_SECONDS = 240;
 const TRANSCRIPT_FALLBACK_POLL_SECONDS = 2;
+const TRANSCRIPT_MCP_CALL_TIMEOUT_MS = 330_000;
+const MCP_REQUEST_TIMEOUT_ERROR_CODE = -32001;
 
 export function buildTranscriptJobDescription(subject) {
-  return `Check ${subject} by job_id without starting a new task. ${TRANSCRIPT_GET_JOB_WAIT_DESCRIPTION} Continue querying the same job_id until is_terminal is true. ${TRANSCRIPT_JOB_DESCRIPTION_SUFFIX}`;
+  return `Check ${subject} by job_id without starting a new task. ${TRANSCRIPT_GET_JOB_WAIT_DESCRIPTION} ${TRANSCRIPT_JOB_DESCRIPTION_SUFFIX}`;
 }
 
 const AVAILABLE_SKILLS = [
@@ -926,11 +927,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 +2130,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.");
@@ -3764,10 +3765,10 @@ function buildXhsSubCommentsCall(options) {
   };
 }
 
-async function callDirectOperation(operation) {
+async function callDirectOperation(operation, requestOptions) {
   switch (operation.backend) {
     case "mcp":
-      return callMcpBackend(operation);
+      return callMcpBackend(operation, requestOptions);
     default:
       throw new Error(`Unsupported direct CLI backend: ${operation.backend}.`);
   }
@@ -3785,7 +3786,7 @@ async function callDirectOperationWithOptions(operation, options) {
 
 async function callTranscriptDirectOperation(operation, options) {
   const maxWaitSeconds = parseTranscriptMaxWaitSeconds(options);
-  let currentOperation = transcriptInitialOperation(operation, maxWaitSeconds);
+  let currentOperation = transcriptInitialOperation(operation);
   let data = await callDirectOperation(currentOperation);
   if (maxWaitSeconds <= 0 || isTerminalTranscriptData(data)) {
     return data;
@@ -3822,12 +3823,18 @@ async function callTranscriptDirectOperation(operation, options) {
       break;
     }
 
-    currentOperation = transcriptGetJobOperation(
-      operation,
-      jobId,
-      transcriptWaitSecondsForCall(remainingSeconds)
-    );
-    data = await callDirectOperation(currentOperation);
+    currentOperation = transcriptGetJobOperation(operation, jobId);
+    try {
+      data = await callDirectOperation(currentOperation, {
+        requestDeadlineMs: Date.now() + remainingSeconds * 1000,
+        preserveRequestTimeout: true,
+      });
+    } catch (error) {
+      if (isMcpRequestTimeoutError(error)) {
+        break;
+      }
+      throw error;
+    }
     jobId = readTranscriptJobId(data, operation) || jobId;
   }
 
@@ -3844,38 +3851,21 @@ function parseTranscriptMaxWaitSeconds(options) {
   return TRANSCRIPT_DEFAULT_MAX_WAIT_SECONDS;
 }
 
-function transcriptInitialOperation(operation, maxWaitSeconds) {
-  const initialOperation = cloneDirectOperation(operation);
-  const isJobLookup =
-    operation.transcriptIsJobLookup ||
-    operation.tool === operation.transcriptJobTool ||
-    Object.hasOwn(operation.arguments, "job_id");
-  if (isJobLookup && maxWaitSeconds > 0) {
-    initialOperation.arguments.wait_seconds =
-      transcriptWaitSecondsForCall(maxWaitSeconds);
-  }
-  return initialOperation;
+function transcriptInitialOperation(operation) {
+  return cloneDirectOperation(operation);
 }
 
-function transcriptGetJobOperation(operation, jobId, waitSeconds) {
+function transcriptGetJobOperation(operation, jobId) {
   const jobArgument = operation.transcriptJobArgument || "job_id";
   return {
     ...operation,
     tool: operation.transcriptJobTool,
     arguments: {
       [jobArgument]: jobId,
-      wait_seconds: waitSeconds,
     },
   };
 }
 
-function transcriptWaitSecondsForCall(remainingSeconds) {
-  return Math.min(
-    TRANSCRIPT_GET_JOB_WAIT_SECONDS,
-    Math.max(1, Math.ceil(remainingSeconds))
-  );
-}
-
 function transcriptRemainingWaitSeconds(startedAtMs, maxWaitSeconds) {
   return maxWaitSeconds - (Date.now() - startedAtMs) / 1000;
 }
@@ -4490,7 +4480,10 @@ function buildRepliesOperationForComment(platform, comment, parentArguments, par
   }
 }
 
-async function callMcpBackend(operation) {
+async function callMcpBackend(
+  operation,
+  { requestDeadlineMs, requestTimeoutMs, preserveRequestTimeout = false } = {}
+) {
   ensureSupportedNodeVersion();
   const { platform, tool } = operation;
   const apiKey = readDirectApiKey(platform);
@@ -4520,11 +4513,22 @@ async function callMcpBackend(operation) {
   });
 
   try {
-    await client.connect(transport);
-    const result = await client.callTool({
-      name: tool,
-      arguments: operation.arguments,
+    const transcriptConnectOptions = transcriptMcpRequestOptions(operation, {
+      requestDeadlineMs,
+      requestTimeoutMs,
     });
+    await connectMcpClient(client, transport, transcriptConnectOptions);
+    const result = await client.callTool(
+      {
+        name: tool,
+        arguments: operation.arguments,
+      },
+      undefined,
+      transcriptMcpRequestOptions(operation, {
+        requestDeadlineMs,
+        requestTimeoutMs,
+      })
+    );
     if (result.isError) {
       const errorMessage =
         result.structuredContent?.message ||
@@ -4536,12 +4540,70 @@ async function callMcpBackend(operation) {
     }
     return result.structuredContent ?? result;
   } catch (error) {
+    if (preserveRequestTimeout && isMcpRequestTimeoutError(error)) {
+      throw error;
+    }
     throw formatDirectCallError({ error, operation, upstreamUrl });
   } finally {
     await client.close().catch(() => {});
   }
 }
 
+function isMcpRequestTimeoutError(error) {
+  return error?.code === MCP_REQUEST_TIMEOUT_ERROR_CODE;
+}
+
+async function connectMcpClient(client, transport, requestOptions) {
+  if (requestOptions?.timeout === undefined) {
+    await client.connect(transport, requestOptions);
+    return;
+  }
+  await withMcpRequestTimeout(
+    client.connect(transport, requestOptions),
+    requestOptions.timeout,
+    () => client.close().catch(() => {})
+  );
+}
+
+function transcriptMcpRequestOptions(
+  operation,
+  { requestDeadlineMs, requestTimeoutMs }
+) {
+  if (operation.operation !== "transcript") {
+    return undefined;
+  }
+  if (requestDeadlineMs !== undefined) {
+    return {
+      timeout: Math.max(Math.ceil(requestDeadlineMs - Date.now()), 1),
+    };
+  }
+  return {
+    timeout: requestTimeoutMs ?? TRANSCRIPT_MCP_CALL_TIMEOUT_MS,
+  };
+}
+
+async function withMcpRequestTimeout(promise, timeoutMs, onTimeout) {
+  let timeoutId;
+  const timeoutPromise = new Promise((_, reject) => {
+    timeoutId = setTimeout(() => {
+      reject(mcpRequestTimeoutError(timeoutMs));
+      Promise.resolve(onTimeout?.()).catch(() => {});
+    }, timeoutMs);
+  });
+  try {
+    return await Promise.race([promise, timeoutPromise]);
+  } finally {
+    clearTimeout(timeoutId);
+  }
+}
+
+function mcpRequestTimeoutError(timeoutMs) {
+  const error = new Error("Request timed out");
+  error.code = MCP_REQUEST_TIMEOUT_ERROR_CODE;
+  error.data = { timeout: timeoutMs };
+  return error;
+}
+
 function readDirectApiKey(platform) {
   const apiKey = readFirstEnv(platform.apiKeyEnv);
   if (!apiKey) {

package/package.json

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

package/skills/media-transcript/SKILL.md

@@ -122,7 +122,7 @@ Optional arguments:
 - `--source-client socialdatax-skills --source-platform npm --source-skill media-transcript`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.
 
 Use the direct CLI first when the agent can run shell commands. These video speech-to-text transcript / 口播转文字 workflows submit a bounded analysis job or check an existing job.
-Direct CLI transcript commands try to deliver the final result in one run: submit waits server-side up to 210 seconds, then the CLI keeps querying the same `job_id` with get-job long polling of up to 240 seconds per request for a bounded follow-up window. Do not start a second submit job just to poll status.
+Direct CLI transcript commands try to deliver the final result in one run: submit waits server-side up to 240 seconds, then the CLI keeps querying the same `job_id`; each get-job call also waits up to 240 seconds for that job. Do not start a second submit job just to poll status.
 If the direct CLI returns a non-terminal job because the command was interrupted or reached `--max-wait-seconds`, keep the returned `job_id` and continue with the matching `transcript --job-id <job_id>` command.
 
 ## Safety Boundary
@@ -155,7 +155,7 @@ If MCP tools are already available in the current agent, choose the platform-spe
 - Kuaishou: `kuaishou_submit_video_speech_text_by_video_url`, `kuaishou_submit_video_speech_text_by_photo_id`, `kuaishou_get_video_speech_text_job`.
 - Weibo: `weibo_submit_video_speech_text_by_post_url`, `weibo_submit_video_speech_text_by_post_id`, `weibo_get_video_speech_text_job`.
 - WeChat Channels / 视频号: `wechat_submit_video_speech_text_by_video_url`, `wechat_submit_video_speech_text_by_encrypted_object_id`, `wechat_get_video_speech_text_job`.
-Do not start a duplicate transcript job only to poll status. If an MCP response is non-terminal, call `data.next_action.tool_name` with `data.next_action.arguments` exactly as returned; those arguments include the same `job_id` and a bounded `wait_seconds` value. Continue until `is_terminal` is `true`.
+Do not start a duplicate transcript job only to poll status. If an MCP response is non-terminal, you must call `data.next_action.tool_name` with `data.next_action.arguments` exactly as returned; those arguments include the same `job_id`. The next response may still be non-terminal. Continue until `is_terminal` is `true`.
 
 ## Output Guidance
 

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
 ```