socialdatax-skills 0.2.19 → 0.2.21

package/README.md

@@ -2,7 +2,7 @@
 
 This public package provides the unified skill installer and direct CLI helper for SocialDataX services.
 
-The current public tools support 小红书 / Xiaohongshu / XHS / RedNote, 抖音 / Douyin, 快手 / Kuaishou / Kwai, 微博 / Weibo, 视频号 / WeChat Channels, and 微信公众号 / WeChat Official Account article content research and analysis workflows, plus SocialDataX 敏感检测 text checks. The public skill layer is intentionally named by capability so supported services can evolve without changing the installation model.
+The current public tools support 小红书 / Xiaohongshu / XHS / RedNote, 抖音 / Douyin, 快手 / Kuaishou / Kwai, 微博 / Weibo, 视频号 / WeChat Channels, and 微信公众号 / WeChat Official Account article content research and analysis workflows, plus 敏感词检测 / 违禁词检查 text checks. The public skill layer is intentionally named by capability so supported services can evolve without changing the installation model.
 
 - direct `npx` JSON commands for agents that can run shell commands
 - AgentSkills-compatible installers split by capability for OpenClaw, Hermes Agent, Codex, Claude Code, and general agent skill directories
@@ -42,7 +42,9 @@ Common search phrases for this skill package:
 - `mp.weixin.qq.com article detail`
 - `SocialDataX content research`
 - `content research assistant`
-- `敏感检测 SocialDataX`
+- `敏感词检测`
+- `违禁词检测`
+- `文案发布前检查`
 - `sensitive check skill`
 - `content safety skill`
 - `text safety check`
@@ -54,7 +56,7 @@ Common search phrases for this skill package:
 - Kuaishou hosted MCP endpoint: `https://mcp.socialdatax.com/kuaishou/mcp`
 - Weibo hosted MCP endpoint: `https://mcp.socialdatax.com/weibo/mcp`
 - WeChat / 微信 hosted MCP endpoint: `https://mcp.socialdatax.com/wechat/mcp`
-- Sensitive Check hosted MCP endpoint: `https://mcp.socialdatax.com/sensitive-check/mcp`
+- Sensitive Words 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,10 +70,10 @@ Common search phrases for this skill package:
 - Weibo future platform MCP registry name: `com.socialdatax/weibo-insights`
 - WeChat / 微信 current platform MCP registry name: `com.52choujiang/wechat-channels-insights`
 - WeChat / 微信 future platform MCP registry name: `com.socialdatax/wechat-channels-insights`
-- Sensitive Check MCP server name: `sensitive-check`
-- Sensitive Check future MCP registry name: `com.socialdatax/sensitive-check`
+- 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.19`
+- Current public capability version: `0.2.21`
 
 ## Direct CLI
 
@@ -90,6 +92,9 @@ npx -y socialdatax-skills@latest xhs sub-comments --note-id "<note_id>" --commen
 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 xhs transcript --url "<note_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest xhs transcript --note-id "<note_id>" --pretty
+npx -y socialdatax-skills@latest xhs transcript --job-id "<job_id>" --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
@@ -102,6 +107,9 @@ 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 douyin transcript --url "<douyin_content_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest douyin transcript --aweme-id "<aweme_id>" --pretty
+npx -y socialdatax-skills@latest douyin transcript --job-id "<job_id>" --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
@@ -114,6 +122,9 @@ npx -y socialdatax-skills@latest kuaishou user-info --user-id "<user_id>" --pret
 npx -y socialdatax-skills@latest kuaishou user-info --profile-url "<profile_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest kuaishou user-posts --user-id "<user_id>" --pretty
 npx -y socialdatax-skills@latest kuaishou user-posts --profile-url "<profile_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest kuaishou transcript --url "<kuaishou_content_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest kuaishou transcript --photo-id "<photo_id>" --pretty
+npx -y socialdatax-skills@latest kuaishou transcript --job-id "<job_id>" --pretty
 npx -y socialdatax-skills@latest weibo hot-search --pretty
 npx -y socialdatax-skills@latest weibo search --keyword "露营" --pretty
 npx -y socialdatax-skills@latest weibo detail --post-id "<post_id>" --pretty
@@ -128,6 +139,9 @@ 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
 npx -y socialdatax-skills@latest weibo user-posts --profile-url "<profile_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest weibo transcript --post-url "<weibo_post_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest weibo transcript --post-id "<post_id>" --pretty
+npx -y socialdatax-skills@latest weibo transcript --job-id "<job_id>" --pretty
 npx -y socialdatax-skills@latest wechat hot-search --pretty
 npx -y socialdatax-skills@latest wechat search --keyword "露营" --pretty
 npx -y socialdatax-skills@latest wechat detail --encrypted-object-id "<encrypted_object_id>" --pretty
@@ -140,6 +154,9 @@ npx -y socialdatax-skills@latest wechat replies --object-id "<object_id>" --obje
 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-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
+npx -y socialdatax-skills@latest wechat transcript --job-id "<job_id>" --pretty
 npx -y socialdatax-skills@latest sensitive-check text --text "<content>" --platform xhs --pretty
 ```
 
@@ -159,6 +176,8 @@ 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.
 
+Transcript commands submit a bounded video speech-to-text job or check an existing job. Pass exactly one entrypoint for each call: URL/share text, platform content ID, or `--job-id`. Completed get-job responses return transcript plus content context, not summary.
+
 Generated Agent Skill examples include `--source-client socialdatax-skills --source-platform <marketplace> --source-skill <skill-slug>` so SocialDataX can attribute direct CLI usage to the current marketplace Skill. Keep those values unchanged when running commands from a Skill; omit them for ad hoc CLI use. The direct CLI also accepts `SOCIALDATAX_SOURCE_CLIENT`, `SOCIALDATAX_SOURCE_PLATFORM`, and `SOCIALDATAX_SOURCE_SKILL` as environment-variable fallbacks.
 
 XHS, Douyin, Kuaishou, Weibo, and WeChat Channels search use `--keyword` and optional `--page-token`.
@@ -258,15 +277,20 @@ npx -y socialdatax-skills@latest install media-search --target claude-code
 npx -y socialdatax-skills@latest install media-search --target claude-code --scope workspace
 npx -y socialdatax-skills@latest xhs search --keyword "露营" --pretty
 npx -y socialdatax-skills@latest xhs hot-search --pretty
+npx -y socialdatax-skills@latest xhs transcript --url "<note_url_or_share_text>" --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 douyin transcript --aweme-id "<aweme_id>" --pretty
 npx -y socialdatax-skills@latest kuaishou search --keyword "露营" --pretty
+npx -y socialdatax-skills@latest kuaishou transcript --photo-id "<photo_id>" --pretty
 npx -y socialdatax-skills@latest weibo hot-search --pretty
 npx -y socialdatax-skills@latest weibo search --keyword "露营" --pretty
+npx -y socialdatax-skills@latest weibo transcript --post-id "<post_id>" --pretty
 npx -y socialdatax-skills@latest wechat hot-search --pretty
 npx -y socialdatax-skills@latest wechat search --keyword "露营" --pretty
 npx -y socialdatax-skills@latest wechat article --url "<mp_article_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest wechat transcript --encrypted-object-id "<encrypted_object_id>" --pretty
 npx -y socialdatax-skills@latest sensitive-check text --text "<content>" --platform xhs --pretty
 ```
 
@@ -276,10 +300,10 @@ Available skills:
 - `media-search`: search social media content by keyword; supports XHS notes, Douyin works, Kuaishou works, Weibo posts, and WeChat Channels videos.
 - `media-detail`: read structured content details and metrics; supports XHS notes, Douyin works, Kuaishou works, Weibo posts, WeChat Channels videos, and WeChat Official Account articles.
 - `media-comments`: fetch and analyze XHS comments/replies, Douyin comments/replies, Kuaishou comments/replies, Weibo comments/replies, and WeChat Channels comments/replies.
-- `media-transcript`: submit and check video 口播转文字 / speech-to-text transcript jobs through hosted MCP tools; supports XHS, Douyin, Kuaishou, Weibo, and WeChat Channels.
+- `media-transcript`: submit and check video 口播转文字 / speech-to-text transcript jobs through direct CLI commands or hosted MCP tools; supports XHS, Douyin, Kuaishou, Weibo, and WeChat Channels.
 - `media-user-info`: retrieve creator profile information; supports XHS, Douyin, Kuaishou, Weibo, and WeChat Channels creators.
 - `media-user-posts`: retrieve creator content lists; supports XHS notes, Douyin works, Kuaishou works, Weibo posts, WeChat Channels videos, and Douyin creator short-drama series.
-- `sensitive-check`: run 敏感检测 text checks; supports `generic`, `xhs`, `douyin`, and `kuaishou` platform contexts.
+- `sensitive-check`: run 敏感词检测 / 违禁词检查 text checks; supports `generic`, `xhs`, `douyin`, and `kuaishou` platform contexts.
 
 Default install locations:
 
@@ -297,7 +321,7 @@ If no skill name is provided, all skills are installed. If a destination already
 
 ## Workflow Scope
 
-The current platform MCP services are designed for social media content intelligence workflows. Some tools read public content directly; some submit bounded analysis jobs such as video speech-to-text transcript. They do not provide account login, posting, editing, liking, commenting, or other account actions.
+The current direct CLI and platform MCP services are designed for social media content intelligence workflows. Some commands read public content directly; some submit bounded analysis jobs such as video speech-to-text transcript. They do not provide account login, posting, editing, liking, commenting, or other account actions.
 
 Current XHS workflows include:
 
@@ -309,7 +333,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 提交完成后最多短等 15 秒.
+- Submit and check video note 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 15 秒.
 
 Current Kuaishou workflows include:
 
@@ -321,7 +345,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 提交完成后最多短等 15 秒.
+- Submit and check video work 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 15 秒.
 
 Current Douyin workflows include:
 
@@ -334,7 +358,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 提交完成后最多短等 15 秒.
+- Submit and check video work 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 15 秒.
 
 Current Weibo workflows include:
 
@@ -346,7 +370,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 提交完成后最多短等 15 秒.
+- Submit and check Weibo video 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 15 秒.
 
 Current WeChat / 微信 workflows include:
 
@@ -359,14 +383,14 @@ Current WeChat / 微信 workflows include:
 - 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 提交完成后最多短等 15 秒.
+- Submit and check WeChat Channels / 视频号 video 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 15 秒.
 
-Current Sensitive Check workflows include:
+Current Sensitive Words Check workflows include:
 
-- Check draft text for 敏感检测 / sensitive-content risks before publishing.
+- Check draft text for 敏感词检测 / 违禁词检查 / sensitive-content risks before publishing.
 - Choose a platform context with `--platform generic`, `--platform xhs`, `--platform douyin`, or `--platform kuaishou`.
 - Return structured fields such as `violation`, `risk_level`, `types`, `highlights`, `summary`, `platform`, and `suggestions` when available.
-- Text checks are read-only. Image sensitive detection is reserved for a future separate tool.
+- Text checks are read-only. The service records submitted text and structured detection results for history, billing, and troubleshooting. Image sensitive detection is reserved for a future separate tool.
 
 ## XHS Tools
 
@@ -385,7 +409,7 @@ Current Sensitive Check workflows include:
 | `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 15 seconds. |
 | `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 15 seconds. |
-| `xhs_get_video_speech_text_job` | Check an XHS speech-to-text transcript job by job_id without creating a new task. |
+| `xhs_get_video_speech_text_job` | Check an XHS speech-to-text transcript job by job_id without creating a new task. Returns transcript plus content context, not summary. |
 
 ## Douyin Tools
 
@@ -406,7 +430,7 @@ Current Sensitive Check workflows include:
 | `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 15 seconds. |
 | `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 15 seconds. |
-| `douyin_get_video_speech_text_job` | Check a Douyin speech-to-text transcript job by job_id without creating a new task. |
+| `douyin_get_video_speech_text_job` | Check a Douyin speech-to-text transcript job by job_id without creating a new task. Returns transcript plus content context, not summary. |
 
 ## Kuaishou Tools
 
@@ -425,7 +449,7 @@ Current Sensitive Check workflows include:
 | `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 15 seconds. |
 | `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 15 seconds. |
-| `kuaishou_get_video_speech_text_job` | Check a Kuaishou speech-to-text transcript job by job_id without creating a new task. |
+| `kuaishou_get_video_speech_text_job` | Check a Kuaishou speech-to-text transcript job by job_id without creating a new task. Returns transcript plus content context, not summary. |
 
 ## Weibo Tools
 
@@ -444,7 +468,7 @@ Current Sensitive Check workflows include:
 | `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 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. |
+| `weibo_get_video_speech_text_job` | Check a Weibo speech-to-text transcript job by job_id without creating a new task. Returns transcript plus content context, not summary. |
 
 ## WeChat Tools
 
@@ -463,13 +487,13 @@ Current Sensitive Check workflows include:
 | `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 15 seconds. |
 | `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 15 seconds. |
-| `wechat_get_video_speech_text_job` | Check a WeChat Channels / 视频号 speech-to-text transcript job by job_id without creating a new task. |
+| `wechat_get_video_speech_text_job` | Check a WeChat Channels / 视频号 speech-to-text transcript job by job_id without creating a new task. Returns transcript plus content context, not summary. |
 
-## Sensitive Check Tools
+## Sensitive Words Check Tools
 
 | Tool | Public purpose |
 | --- | --- |
-| `check_sensitive_text` | Check text for 敏感检测 / sensitive-content risks with `generic`, `xhs`, `douyin`, or `kuaishou` context. |
+| `check_sensitive_text` | Check text for 敏感词检测 / 违禁词检查 / sensitive-content risks with `generic`, `xhs`, `douyin`, or `kuaishou` context. |
 
 ## Quick Start
 
@@ -485,7 +509,7 @@ npx -y socialdatax-skills@latest wechat search --keyword "露营" --pretty
 npx -y socialdatax-skills@latest sensitive-check text --text "<content>" --platform xhs --pretty
 ```
 
-MCP client configuration belongs to platform or capability MCP listings. For XHS, use the `xhs-insights` docs; for Douyin, use the `douyin-insights` listing; for Kuaishou, use the `kuaishou-insights` listing; for Weibo, use the `weibo-insights` listing; for WeChat / 微信, use the `wechat-channels-insights` listing; for 敏感检测, use the `sensitive-check` server.
+MCP client configuration belongs to platform or capability MCP listings. For XHS, use the `xhs-insights` docs; for Douyin, use the `douyin-insights` listing; for Kuaishou, use the `kuaishou-insights` listing; for Weibo, use the `weibo-insights` listing; for WeChat / 微信, use the `wechat-channels-insights` listing; for 敏感词检测 / 违禁词检查, use the `sensitive-check` server.
 
 Aily is treated as an OpenClaw / AgentSkills ecosystem channel for this package. Use the OpenClaw skill install flow for now; a dedicated `--target aily` will be added only after its official skill import or package format is confirmed.
 
@@ -501,7 +525,7 @@ Use the key as a Bearer token in the `Authorization` request header. Do not comm
 
 Public metadata files in this repository:
 
-- [skills](skills): AgentSkills-compatible skills split by capability and currently backed by XHS, Douyin, Kuaishou, Weibo, WeChat Channels, and Sensitive Check tools.
+- [skills](skills): AgentSkills-compatible skills split by capability and currently backed by XHS, Douyin, Kuaishou, Weibo, WeChat Channels, and Sensitive Words Check tools.
 
 ## License
 

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.19";
+const PACKAGE_VERSION = "0.2.21";
 const PACKAGE_SPEC = `${PACKAGE_NAME}@latest`;
 const LOG_PREFIX = `[${PACKAGE_NAME}]`;
 const MIN_NODE_VERSION = "20.18.1";
@@ -25,6 +25,13 @@ const SOURCE_CLIENT_HEADER = "X-SocialDataX-Client";
 const SOURCE_PLATFORM_HEADER = "X-SocialDataX-Source-Platform";
 const SOURCE_SKILL_HEADER = "X-SocialDataX-Source-Skill";
 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.";
+
+export function buildTranscriptJobDescription(subject) {
+  return `Check ${subject} by job_id without starting a new task. ${TRANSCRIPT_JOB_DESCRIPTION_SUFFIX}`;
+}
+
 const AVAILABLE_SKILLS = [
   {
     name: "socialdatax-content-research-assistant",
@@ -53,7 +60,7 @@ const AVAILABLE_SKILLS = [
   {
     name: "media-transcript",
     summary:
-      "Submit and check video speech-to-text transcript jobs for XHS, Douyin, Kuaishou, Weibo, and WeChat Channels through hosted MCP tools.",
+      "Submit and check video speech-to-text transcript jobs for XHS, Douyin, Kuaishou, Weibo, and WeChat Channels.",
     emoji: "🎙️",
   },
   {
@@ -134,6 +141,7 @@ const XHS_DIRECT_ACTION_OPTIONS = {
     "sinceDays",
     "pretty",
   ],
+  transcript: ["url", "noteId", "jobId", "pretty"],
 };
 const XHS_DIRECT_ACTION_NAMES = Object.keys(XHS_DIRECT_ACTION_OPTIONS).join(", ");
 const XHS_OPTION_DISPLAY_NAMES = {
@@ -152,6 +160,7 @@ const XHS_OPTION_DISPLAY_NAMES = {
   includeReplies: "--include-replies",
   profileUrl: "--profile-url",
   userId: "--user-id",
+  jobId: "--job-id",
 };
 const XHS_SEARCH_SORT_TYPES = [
   "general",
@@ -213,6 +222,7 @@ const DOUYIN_DIRECT_ACTION_OPTIONS = {
     "pretty",
   ],
   "user-series": ["secUserId", "profileUrl", "pageToken", "pages", "all", "maxItems", "pretty"],
+  transcript: ["url", "awemeId", "jobId", "pretty"],
 };
 const DOUYIN_DIRECT_ACTION_NAMES = Object.keys(DOUYIN_DIRECT_ACTION_OPTIONS).join(", ");
 const DOUYIN_SEARCH_SORT_TYPES = ["general", "time_descending", "like_count_descending"];
@@ -241,6 +251,7 @@ const DOUYIN_OPTION_DISPLAY_NAMES = {
   awemeId: "--aweme-id",
   commentId: "--comment-id",
   secUserId: "--sec-user-id",
+  jobId: "--job-id",
 };
 const KUAISHOU_DIRECT_ACTION_OPTIONS = {
   search: ["keyword", "pageToken", "pages", "all", "maxItems", "sinceDays", "pretty"],
@@ -277,6 +288,7 @@ const KUAISHOU_DIRECT_ACTION_OPTIONS = {
     "sinceDays",
     "pretty",
   ],
+  transcript: ["url", "photoId", "jobId", "pretty"],
 };
 const KUAISHOU_DIRECT_ACTION_NAMES = Object.keys(KUAISHOU_DIRECT_ACTION_OPTIONS).join(", ");
 const KUAISHOU_OPTION_DISPLAY_NAMES = {
@@ -292,6 +304,7 @@ const KUAISHOU_OPTION_DISPLAY_NAMES = {
   photoId: "--photo-id",
   commentId: "--comment-id",
   userId: "--user-id",
+  jobId: "--job-id",
 };
 const WEIBO_DIRECT_ACTION_OPTIONS = {
   "hot-search": ["pretty"],
@@ -330,6 +343,7 @@ const WEIBO_DIRECT_ACTION_OPTIONS = {
     "sinceDays",
     "pretty",
   ],
+  transcript: ["postUrl", "postId", "jobId", "pretty"],
 };
 const WEIBO_DIRECT_ACTION_NAMES = Object.keys(WEIBO_DIRECT_ACTION_OPTIONS).join(", ");
 const WEIBO_OPTION_DISPLAY_NAMES = {
@@ -345,6 +359,7 @@ const WEIBO_OPTION_DISPLAY_NAMES = {
   commentId: "--comment-id",
   profileUrl: "--profile-url",
   userId: "--user-id",
+  jobId: "--job-id",
 };
 const WECHAT_DIRECT_ACTION_OPTIONS = {
   "hot-search": ["pretty"],
@@ -394,6 +409,7 @@ const WECHAT_DIRECT_ACTION_OPTIONS = {
     "sinceDays",
     "pretty",
   ],
+  transcript: ["url", "encryptedObjectId", "jobId", "pretty"],
 };
 const WECHAT_DIRECT_ACTION_NAMES = Object.keys(WECHAT_DIRECT_ACTION_OPTIONS).join(", ");
 const WECHAT_SEARCH_SORT_TYPES = [
@@ -423,6 +439,7 @@ const WECHAT_OPTION_DISPLAY_NAMES = {
   objectNonceId: "--object-nonce-id",
   commentId: "--comment-id",
   userId: "--user-id",
+  jobId: "--job-id",
 };
 const SENSITIVE_CHECK_DIRECT_ACTION_OPTIONS = {
   text: ["text", "platform", "pretty"],
@@ -504,17 +521,17 @@ const PLATFORMS = {
       {
         name: "xhs_submit_video_speech_text_by_note_url",
         description:
-          "Submit a video note speech-to-text transcript task from a note link, short link, or share text; 提交完成后最多短等 15 秒.",
+          "Submit a video note speech-to-text transcript task from a note link, short link, or share text; 提交后最多等待 15 秒.",
       },
       {
         name: "xhs_submit_video_speech_text_by_note_id",
         description:
-          "Submit a video note speech-to-text transcript task from a note_id; 提交完成后最多短等 15 秒.",
+          "Submit a video note speech-to-text transcript task from a note_id; 提交后最多等待 15 秒.",
       },
       {
         name: "xhs_get_video_speech_text_job",
         description:
-          "Check a video note speech-to-text transcript job by job_id without starting a new task.",
+          buildTranscriptJobDescription("a video note speech-to-text transcript job"),
       },
     ],
   },
@@ -588,17 +605,17 @@ const PLATFORMS = {
       {
         name: "douyin_submit_video_speech_text_by_video_url",
         description:
-          "Submit a Douyin work video speech-to-text transcript task from a work page link, short link, or share text; 提交完成后最多短等 15 秒.",
+          "Submit a Douyin work video speech-to-text transcript task from a work page link, short link, or share text; 提交后最多等待 15 秒.",
       },
       {
         name: "douyin_submit_video_speech_text_by_aweme_id",
         description:
-          "Submit a Douyin work video speech-to-text transcript task from an aweme_id; 提交完成后最多短等 15 秒.",
+          "Submit a Douyin work video speech-to-text transcript task from an aweme_id; 提交后最多等待 15 秒.",
       },
       {
         name: "douyin_get_video_speech_text_job",
         description:
-          "Check a Douyin video speech-to-text transcript job by job_id without starting a new task.",
+          buildTranscriptJobDescription("a Douyin video speech-to-text transcript job"),
       },
     ],
   },
@@ -668,17 +685,17 @@ const PLATFORMS = {
       {
         name: "kuaishou_submit_video_speech_text_by_video_url",
         description:
-          "Submit a Kuaishou work video speech-to-text transcript task from a work page link, short link, or share text; 提交完成后最多短等 15 秒.",
+          "Submit a Kuaishou work video speech-to-text transcript task from a work page link, short link, or share text; 提交后最多等待 15 秒.",
       },
       {
         name: "kuaishou_submit_video_speech_text_by_photo_id",
         description:
-          "Submit a Kuaishou work video speech-to-text transcript task from a photo_id; 提交完成后最多短等 15 秒.",
+          "Submit a Kuaishou work video speech-to-text transcript task from a photo_id; 提交后最多等待 15 秒.",
       },
       {
         name: "kuaishou_get_video_speech_text_job",
         description:
-          "Check a Kuaishou video speech-to-text transcript job by job_id without starting a new task.",
+          buildTranscriptJobDescription("a Kuaishou video speech-to-text transcript job"),
       },
     ],
   },
@@ -752,17 +769,17 @@ const PLATFORMS = {
       {
         name: "weibo_submit_video_speech_text_by_post_url",
         description:
-          "Submit a Weibo video speech-to-text transcript task from a post URL, short link, or share text; 提交完成后最多短等 15 秒.",
+          "Submit a Weibo video speech-to-text transcript task from a post URL, short link, or share text; 提交后最多等待 15 秒.",
       },
       {
         name: "weibo_submit_video_speech_text_by_post_id",
         description:
-          "Submit a Weibo video speech-to-text transcript task from a post_id; 提交完成后最多短等 15 秒.",
+          "Submit a Weibo video speech-to-text transcript task from a post_id; 提交后最多等待 15 秒.",
       },
       {
         name: "weibo_get_video_speech_text_job",
         description:
-          "Check a Weibo video speech-to-text transcript job by job_id without starting a new task.",
+          buildTranscriptJobDescription("a Weibo video speech-to-text transcript job"),
       },
     ],
   },
@@ -829,23 +846,25 @@ const PLATFORMS = {
       {
         name: "wechat_submit_video_speech_text_by_video_url",
         description:
-          "Submit a WeChat Channels / 视频号 video speech-to-text transcript task from a video link or share text; 提交完成后最多短等 15 秒.",
+          "Submit a WeChat Channels / 视频号 video speech-to-text transcript task from a video link or share text; 提交后最多等待 15 秒.",
       },
       {
         name: "wechat_submit_video_speech_text_by_encrypted_object_id",
         description:
-          "Submit a WeChat Channels / 视频号 video speech-to-text transcript task from an encrypted_object_id; 提交完成后最多短等 15 秒.",
+          "Submit a WeChat Channels / 视频号 video speech-to-text transcript task from an encrypted_object_id; 提交后最多等待 15 秒.",
       },
       {
         name: "wechat_get_video_speech_text_job",
         description:
-          "Check a WeChat Channels / 视频号 video speech-to-text transcript job by job_id without starting a new task.",
+          buildTranscriptJobDescription(
+            "a WeChat Channels / 视频号 video speech-to-text transcript job"
+          ),
       },
     ],
   },
   "sensitive-check": {
     id: "sensitive-check",
-    displayName: "Sensitive Check / 敏感检测",
+    displayName: "Sensitive Words Check / 敏感词检测",
     status: "public",
     registryName: "sensitive-check",
     futureRegistryName: "com.socialdatax/sensitive-check",
@@ -1622,7 +1641,8 @@ function buildDoctorReport() {
     },
     security: {
       readOnly: false,
-      directCliReadOnly: true,
+      directCliReadOnly: false,
+      directCliMaySubmitAnalysisJobs: true,
       platformMcpMaySubmitAnalysisJobs: true,
       accountActions: false,
       readsLocalBrowserData: false,
@@ -1665,6 +1685,7 @@ function printDoctor(args) {
   console.log("");
   console.log("Runtime data calls:");
   console.log("- social media content intelligence workflows.");
+  console.log("- some commands submit bounded analysis jobs such as video speech-to-text transcript.");
   console.log("- no login, posting, editing, liking, commenting, or other account actions.");
   console.log("- no local browser data access.");
   console.log(`- requires ${PRIMARY_API_KEY_ENV} only when making authenticated data calls.`);
@@ -1721,6 +1742,9 @@ function printHelp() {
   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} xhs transcript --url "<xhs_note_url_or_share_text>" --pretty`);
+  console.log("      Submit or check an XHS video note speech-to-text transcript job.");
+  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("");
@@ -1759,6 +1783,9 @@ 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} douyin transcript --aweme-id "<aweme_id>" --pretty`);
+  console.log("      Submit or check a Douyin video speech-to-text transcript job.");
+  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("");
@@ -1799,6 +1826,9 @@ function printHelp() {
     "      Call the Kuaishou creator works tool from a profile link or share text that resolves directly to a non-empty user_id."
   );
   console.log("");
+  console.log(`  npx -y ${PACKAGE_SPEC} kuaishou transcript --photo-id "<photo_id>" --pretty`);
+  console.log("      Submit or check a Kuaishou video speech-to-text transcript job.");
+  console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} weibo hot-search --pretty`);
   console.log("      Call the Weibo hot-search list tool directly and print JSON.");
   console.log("");
@@ -1838,6 +1868,9 @@ function printHelp() {
   console.log(`  npx -y ${PACKAGE_SPEC} weibo user-posts --profile-url "<profile_url_or_share_text>" --pretty`);
   console.log("      Call the Weibo creator posts tool from a profile link or share text.");
   console.log("");
+  console.log(`  npx -y ${PACKAGE_SPEC} weibo transcript --post-url "<weibo_post_url_or_share_text>" --pretty`);
+  console.log("      Submit or check a Weibo video speech-to-text transcript job.");
+  console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} wechat hot-search --pretty`);
   console.log("      Call the WeChat Channels / 视频号 hot-search list tool directly and print JSON.");
   console.log("");
@@ -1873,8 +1906,11 @@ function printHelp() {
   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.");
   console.log("");
+  console.log(`  npx -y ${PACKAGE_SPEC} wechat transcript --encrypted-object-id "<encrypted_object_id>" --pretty`);
+  console.log("      Submit or check a WeChat Channels / 视频号 video speech-to-text transcript job.");
+  console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} sensitive-check text --text "<content>" --platform xhs --pretty`);
-  console.log("      Call the SocialDataX 敏感检测 text tool directly and print JSON.");
+  console.log("      Call the SocialDataX 敏感词检测 / 违禁词检查 text tool directly and print JSON.");
   console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} list`);
   console.log("      List available skills.");
@@ -1950,6 +1986,7 @@ function printHelp() {
   console.log("  --post-id <post_id>");
   console.log("  --post-url <weibo-post-url-or-share-text>");
   console.log("  --encrypted-object-id <encrypted_object_id>");
+  console.log("  --job-id <job_id>");
   console.log("  --object-id <object_id>");
   console.log("  --object-nonce-id <object_nonce_id>");
   console.log("  --comment-id <comment_id>");
@@ -2295,6 +2332,24 @@ function buildXhsOperation(action, options) {
           pageToken: options.pageToken,
         })
       );
+    case "transcript":
+      return buildDirectOperation(
+        "transcript",
+        buildTranscriptCall(options, {
+          urlOption: "url",
+          idOption: "noteId",
+          jobOption: "jobId",
+          urlTool: "xhs_submit_video_speech_text_by_note_url",
+          idTool: "xhs_submit_video_speech_text_by_note_id",
+          jobTool: "xhs_get_video_speech_text_job",
+          urlArgument: "note_url",
+          idArgument: "note_id",
+          jobArgument: "job_id",
+          urlDisplay: "--url",
+          idDisplay: "--note-id",
+          jobDisplay: "--job-id",
+        })
+      );
     default:
       throw new Error(
         `Unsupported XHS command "${action}". Use ${XHS_DIRECT_ACTION_NAMES}.`
@@ -2403,6 +2458,25 @@ function buildDouyinOperation(action, options) {
         }),
         PLATFORMS.douyin
       );
+    case "transcript":
+      return buildDirectOperation(
+        "transcript",
+        buildTranscriptCall(options, {
+          urlOption: "url",
+          idOption: "awemeId",
+          jobOption: "jobId",
+          urlTool: "douyin_submit_video_speech_text_by_video_url",
+          idTool: "douyin_submit_video_speech_text_by_aweme_id",
+          jobTool: "douyin_get_video_speech_text_job",
+          urlArgument: "video_url",
+          idArgument: "aweme_id",
+          jobArgument: "job_id",
+          urlDisplay: "--url",
+          idDisplay: "--aweme-id",
+          jobDisplay: "--job-id",
+        }),
+        PLATFORMS.douyin
+      );
     default:
       throw new Error(
         `Unsupported Douyin command "${action}". Use ${DOUYIN_DIRECT_ACTION_NAMES}.`
@@ -2492,6 +2566,25 @@ function buildKuaishouOperation(action, options) {
         }),
         PLATFORMS.kuaishou
       );
+    case "transcript":
+      return buildDirectOperation(
+        "transcript",
+        buildTranscriptCall(options, {
+          urlOption: "url",
+          idOption: "photoId",
+          jobOption: "jobId",
+          urlTool: "kuaishou_submit_video_speech_text_by_video_url",
+          idTool: "kuaishou_submit_video_speech_text_by_photo_id",
+          jobTool: "kuaishou_get_video_speech_text_job",
+          urlArgument: "video_url",
+          idArgument: "photo_id",
+          jobArgument: "job_id",
+          urlDisplay: "--url",
+          idDisplay: "--photo-id",
+          jobDisplay: "--job-id",
+        }),
+        PLATFORMS.kuaishou
+      );
     default:
       throw new Error(
         `Unsupported Kuaishou command "${action}". Use ${KUAISHOU_DIRECT_ACTION_NAMES}.`
@@ -2596,6 +2689,25 @@ function buildWeiboOperation(action, options) {
         }),
         PLATFORMS.weibo
       );
+    case "transcript":
+      return buildDirectOperation(
+        "transcript",
+        buildTranscriptCall(options, {
+          urlOption: "postUrl",
+          idOption: "postId",
+          jobOption: "jobId",
+          urlTool: "weibo_submit_video_speech_text_by_post_url",
+          idTool: "weibo_submit_video_speech_text_by_post_id",
+          jobTool: "weibo_get_video_speech_text_job",
+          urlArgument: "post_url",
+          idArgument: "post_id",
+          jobArgument: "job_id",
+          urlDisplay: "--post-url",
+          idDisplay: "--post-id",
+          jobDisplay: "--job-id",
+        }),
+        PLATFORMS.weibo
+      );
     default:
       throw new Error(
         `Unsupported Weibo command "${action}". Use ${WEIBO_DIRECT_ACTION_NAMES}.`
@@ -2681,6 +2793,25 @@ function buildWechatOperation(action, options) {
         }),
         PLATFORMS.wechat
       );
+    case "transcript":
+      return buildDirectOperation(
+        "transcript",
+        buildTranscriptCall(options, {
+          urlOption: "url",
+          idOption: "encryptedObjectId",
+          jobOption: "jobId",
+          urlTool: "wechat_submit_video_speech_text_by_video_url",
+          idTool: "wechat_submit_video_speech_text_by_encrypted_object_id",
+          jobTool: "wechat_get_video_speech_text_job",
+          urlArgument: "video_url",
+          idArgument: "encrypted_object_id",
+          jobArgument: "job_id",
+          urlDisplay: "--url",
+          idDisplay: "--encrypted-object-id",
+          jobDisplay: "--job-id",
+        }),
+        PLATFORMS.wechat
+      );
     default:
       throw new Error(
         `Unsupported WeChat command "${action}". Use ${WECHAT_DIRECT_ACTION_NAMES}.`
@@ -2802,6 +2933,58 @@ function buildOneOfCall(
   return { tool, toolArguments };
 }
 
+function buildTranscriptCall(
+  options,
+  {
+    urlOption,
+    idOption,
+    jobOption,
+    urlTool,
+    idTool,
+    jobTool,
+    urlArgument,
+    idArgument,
+    jobArgument,
+    urlDisplay,
+    idDisplay,
+    jobDisplay,
+  }
+) {
+  const choices = [
+    {
+      value: options[urlOption],
+      tool: urlTool,
+      argument: urlArgument,
+    },
+    {
+      value: options[idOption],
+      tool: idTool,
+      argument: idArgument,
+    },
+    {
+      value: options[jobOption],
+      tool: jobTool,
+      argument: jobArgument,
+    },
+  ].filter((choice) => Boolean(choice.value));
+  const displays = `${urlDisplay}, ${idDisplay}, or ${jobDisplay}`;
+
+  if (choices.length === 0) {
+    throw new Error(`Missing input. Use exactly one of ${displays}.`);
+  }
+  if (choices.length > 1) {
+    throw new Error(`Use exactly one of ${displays}.`);
+  }
+
+  const choice = choices[0];
+  return {
+    tool: choice.tool,
+    toolArguments: {
+      [choice.argument]: choice.value,
+    },
+  };
+}
+
 function buildRequiredIdCall(
   options,
   {

package/package.json

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

@@ -1,6 +1,6 @@
 ---
 name: "media-transcript"
-description: "Submit and check video speech-to-text transcript / 口播转文字 jobs for XHS, Douyin, Kuaishou, Weibo, and WeChat Channels through hosted platform MCP tools."
+description: "Submit and check video speech-to-text transcript / 口播转文字 jobs for XHS, Douyin, Kuaishou, Weibo, and WeChat Channels through direct CLI commands or hosted platform MCP tools."
 source_client: "socialdatax-skills"
 source_platform: "npm"
 source_skill: "media-transcript"
@@ -39,30 +39,49 @@ Current platform support:
 Use `SOCIALDATAX_API_KEY` for SocialDataX requests. The only official website for requesting or managing API access is <https://socialdatax.com/?from=npm>. If a user asks where to get a key, provide only this URL; do not infer alternate domains.
 获取或管理 API Key：访问 <https://socialdatax.com/?from=npm>，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。
 
+## Preferred Direct CLI
+
+Prefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:
+
+```bash
+npx -y socialdatax-skills@latest xhs transcript --url "<note_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-transcript
+npx -y socialdatax-skills@latest xhs transcript --note-id "<note_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-transcript
+npx -y socialdatax-skills@latest xhs transcript --job-id "<job_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-transcript
+npx -y socialdatax-skills@latest douyin transcript --url "<douyin_content_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-transcript
+npx -y socialdatax-skills@latest douyin transcript --aweme-id "<aweme_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-transcript
+npx -y socialdatax-skills@latest douyin transcript --job-id "<job_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-transcript
+npx -y socialdatax-skills@latest kuaishou transcript --url "<kuaishou_content_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-transcript
+npx -y socialdatax-skills@latest kuaishou transcript --photo-id "<photo_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-transcript
+npx -y socialdatax-skills@latest kuaishou transcript --job-id "<job_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-transcript
+npx -y socialdatax-skills@latest weibo transcript --post-url "<weibo_post_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-transcript
+npx -y socialdatax-skills@latest weibo transcript --post-id "<post_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-transcript
+npx -y socialdatax-skills@latest weibo transcript --job-id "<job_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-transcript
+npx -y socialdatax-skills@latest wechat transcript --url "<wechat_video_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-transcript
+npx -y socialdatax-skills@latest wechat transcript --encrypted-object-id "<encrypted_object_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-transcript
+npx -y socialdatax-skills@latest wechat transcript --job-id "<job_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-transcript
+```
+
 Required arguments:
 
-- Use a submit-by-URL tool when the user provides a content link, short link, or share text.
-- Use a submit-by-ID tool only when the platform content ID is already known: XHS `note_id`, Douyin `aweme_id`, Kuaishou `photo_id`, Weibo `post_id`, or WeChat Channels / 视频号 `encrypted_object_id`.
-- Use the matching get-job tool with `job_id` when continuing or checking an existing transcript job.
+- Use a submit-by-URL command when the user provides a content link, short link, or share text.
+- Use a submit-by-ID command only when the platform content ID is already known: XHS `note_id`, Douyin `aweme_id`, Kuaishou `photo_id`, Weibo `post_id`, or WeChat Channels / 视频号 `encrypted_object_id`.
+- Use the matching `transcript --job-id <job_id>` command when continuing or checking an existing transcript job.
+- For one transcript command, pass exactly one entrypoint: URL/share text, platform content ID, or `job_id`.
+
+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.
 
-These video speech-to-text transcript / 口播转文字 workflows are MCP-only and not available through the direct CLI.
-Submit tools may wait briefly after creating the job. If the transcript is not ready, return the `job_id` and next action instead of starting a second job.
+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.
+Submit commands may wait briefly after creating the job. If the transcript is not ready, return the `job_id` and next action instead of starting a second job.
 
 ## Safety Boundary
 
-This skill can submit bounded analysis jobs through hosted MCP tools. It uses authenticated MCP access from the current agent at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes. Use hosted MCP tools only when the current agent already supports authenticated streamable HTTP MCP.
+This skill can submit bounded video speech-to-text analysis jobs through the direct CLI or hosted MCP tools. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes. Prefer the direct CLI; hosted MCP tools are optional when the current agent already supports authenticated streamable HTTP MCP.
 
 ## MCP Tools
 
-If MCP tools are already available in the current agent, choose the platform-specific submit tool by entrypoint:
-- XHS: `xhs_submit_video_speech_text_by_note_url`, `xhs_submit_video_speech_text_by_note_id`, `xhs_get_video_speech_text_job`.
-- Douyin: `douyin_submit_video_speech_text_by_video_url`, `douyin_submit_video_speech_text_by_aweme_id`, `douyin_get_video_speech_text_job`.
-- 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. Use the platform get-job tool with the returned `job_id`.
-
-MCP-only tools not available through the direct CLI:
+MCP tools matching the direct CLI commands above:
 
 - `xhs_submit_video_speech_text_by_note_url`
 - `xhs_submit_video_speech_text_by_note_id`
@@ -80,7 +99,17 @@ MCP-only tools not available through the direct CLI:
 - `wechat_submit_video_speech_text_by_encrypted_object_id`
 - `wechat_get_video_speech_text_job`
 
+If MCP tools are already available in the current agent, choose the platform-specific submit tool by entrypoint:
+- XHS: `xhs_submit_video_speech_text_by_note_url`, `xhs_submit_video_speech_text_by_note_id`, `xhs_get_video_speech_text_job`.
+- Douyin: `douyin_submit_video_speech_text_by_video_url`, `douyin_submit_video_speech_text_by_aweme_id`, `douyin_get_video_speech_text_job`.
+- 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. Use the platform get-job tool with the returned `job_id`.
+
 ## Output Guidance
 
-Return the transcript text when available. When a job is still running, include the `job_id`, status, and next action so the user or agent can check later.
+Return the transcript text and content context when available; include content IDs, titles or descriptions, author facts, and duration when the response provides them.
+This v1 surface does not return summary.
+When a job is still running, include the `job_id`, status, and next action so the user or agent can check later.
 If the result says no processable video resource is available or the job failed, report that as the observed job result instead of retrying with another platform.

package/skills/sensitive-check/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: "sensitive-check"
-description: "Check draft text for sensitive-content risks before publishing. Supports generic, xhs, douyin, and kuaishou contexts through SocialDataX."
+description: "Check draft text for 敏感词检测, 违禁词检查, content safety, copy compliance, and safer rewrite suggestions before publishing. Supports generic, xhs, douyin, and kuaishou contexts through SocialDataX."
 source_client: "socialdatax-skills"
 source_platform: "npm"
 source_skill: "sensitive-check"
@@ -22,9 +22,9 @@ metadata:
 ---
 <!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. -->
 
-# 敏感检测 SocialDataX
+# 敏感词检测与违禁词检查
 
-Use this skill when the user wants 敏感检测, sensitive check, content safety review, or platform-aware review for text drafts before publishing.
+Use this skill when the user wants 敏感词检测, 违禁词检查, 敏感检测, 文案合规, 发布前检查, 能不能发, sensitive words, prohibited words, content safety review, or platform-aware review for text drafts before publishing.
 
 Current platform support:
 
@@ -53,8 +53,9 @@ Optional arguments:
 - `--pretty`: output formatting only.
 - `--source-client socialdatax-skills --source-platform npm --source-skill sensitive-check`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.
 
-适用于文本敏感检测、content safety review、发布前风险检查和 safer rewrite suggestions for draft text.
+适用于敏感词检测、违禁词检查、文案发布前检查、content safety review、文案合规审核、能不能发判断和 safer rewrite suggestions for draft text.
 The command prints JSON with `platform`, `tool`, and `data`; it does not echo the original text back in CLI arguments. The service returns `violation`, `risk_level`, `types`, `highlights`, `summary`, `platform`, and `suggestions` when available.
+Service note: SocialDataX service records the submitted text and structured detection result for history, billing, and troubleshooting; the local CLI does not write API keys to local files or write local text copies.
 This v1 skill checks text only. Image sensitive detection is intentionally out of scope until a separate image tool is published.
 
 ## Safety Boundary

package/skills/sensitive-check/agents/openai.yaml

@@ -1,7 +1,7 @@
 interface:
-  display_name: "Sensitive Check"
-  short_description: "Check draft text risks"
-  default_prompt: "Use $sensitive-check to check text drafts for sensitive-content risks with SocialDataX."
+  display_name: "敏感词检测"
+  short_description: "Check sensitive words"
+  default_prompt: "Use $sensitive-check to check draft text for sensitive words, prohibited words, and publishing risks with SocialDataX."
 
 policy:
   allow_implicit_invocation: true