socialdatax-skills 0.2.38 → 0.2.39

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CATALOG.md CHANGED
@@ -17,7 +17,7 @@ Run a direct CLI command:
17
17
  ```bash
18
18
  npx -y socialdatax-skills@latest xhs search \
19
19
  --keyword "露营" --sort-type like_count_descending --pages 2 --max-items 20 --pretty \
20
- --source-client socialdatax-skills --source-platform github --source-skill xhs-content-research
20
+ --source-client socialdatax-skills --source-platform github --source-skill media-search
21
21
  ```
22
22
 
23
23
  The CLI does not log in to user accounts, post content, like, comment, or change account settings.
@@ -28,14 +28,14 @@ This table is a curated marketplace catalog, not the complete platform support l
28
28
 
29
29
  | Skill | Use When | Primary Capability | Marketplace Slugs |
30
30
  | --- | --- | --- | --- |
31
- | 社媒内容研究助手 | Research supported SocialDataX public platforms including XHS, Douyin, Kuaishou, Bilibili, Zhihu, Instagram, X / Twitter, YouTube, TikTok, Weibo, and WeChat Channels, plus WeChat Official Account article details. | Cross-platform social content research | SkillHub: `socialdatax-content-research-assistant` |
32
- | 小红书内容研究 | Research popular XHS / Xiaohongshu / RedNote note samples, content angles, keywords, competitor content, and trend material. | XHS note search | SkillHub / ClawHub / ModelScope: `xhs-content-research` |
33
- | 小红书评论分析与需求挖掘 | Analyze comments from a provided XHS note URL or complete `note_id` for user feedback, pain points, purchase objections, FAQ, and demand signals. | XHS comments and replies | SkillHub / ClawHub / ModelScope: `xhs-comment-insights` |
34
- | 小红书热榜选题分析 | Turn current XHS hot-list signals and related popular note samples into actionable topic ideas. | XHS hot search plus note search | SkillHub / ClawHub / ModelScope: `xhs-hot-topic-selection` |
35
- | 小红书爆款笔记研究 | Study high-engagement XHS note samples from a keyword, niche, product, or scenario. | XHS note search | SkillHub / ModelScope: `xhs-viral-note-research` |
36
- | 小红书爆款文案拆解 | Break down XHS viral copy structure, title hooks, opening style, selling points, emotional wording, CTA, and reusable copy framework. | XHS search and note detail | SkillHub / ModelScope: `xhs-viral-copy-breakdown` |
31
+ | 社媒内容研究助手 | Research supported SocialDataX public platforms including XHS, Douyin, Kuaishou, Bilibili, Zhihu, Instagram, X / Twitter, YouTube, TikTok, Weibo, and WeChat Channels, plus WeChat Official Account article details. | Cross-platform social content research | SkillHub / ModelScope / GitHub: `socialdatax-content-research-assistant` |
32
+ | 小红书内容研究 | Research popular XHS / Xiaohongshu / RedNote note samples, content angles, keywords, competitor content, and trend material. | XHS note search | ClawHub / ModelScope: `xhs-content-research` |
33
+ | 小红书评论分析与需求挖掘 | Analyze comments from a provided XHS note URL or complete `note_id` for user feedback, pain points, purchase objections, FAQ, and demand signals. | XHS comments and replies | ClawHub / ModelScope: `xhs-comment-insights` |
34
+ | 小红书热榜选题分析 | Turn current XHS hot-list signals and related popular note samples into actionable topic ideas. | XHS hot search plus note search | ClawHub / ModelScope: `xhs-hot-topic-selection` |
35
+ | 小红书爆款笔记研究 | Study high-engagement XHS note samples from a keyword, niche, product, or scenario. | XHS note search | ClawHub / ModelScope: `xhs-viral-note-research` |
36
+ | 小红书爆款文案拆解 | Break down XHS viral copy structure, title hooks, opening style, selling points, emotional wording, CTA, and reusable copy framework. | XHS search and note detail | ClawHub / ModelScope: `xhs-viral-copy-breakdown` |
37
37
  | 抖音文案提取 | Extract Douyin video context, original description, spoken transcript, copy-ready version, and task status from a URL, share text, `aweme_id`, or transcript `job_id`. | Douyin transcript job | SkillHub / ClawHub / ModelScope: `douyin-video-copy-extract` |
38
- | 敏感词检测与违禁词检查 | Check copy before publishing for sensitive terms, platform risk hints, and safer rewrite suggestions. | Copy safety review | SkillHub / ClawHub: `socialdatax-sensitive-check` |
38
+ | 敏感词检测与违禁词检查 | Check copy before publishing for sensitive terms, platform risk hints, and safer rewrite suggestions. | Copy safety review | SkillHub / ClawHub / ModelScope: `socialdatax-sensitive-check` |
39
39
 
40
40
  ## Direct CLI Examples
41
41
 
@@ -44,7 +44,7 @@ This table is a curated marketplace catalog, not the complete platform support l
44
44
  ```bash
45
45
  npx -y socialdatax-skills@latest xhs search \
46
46
  --keyword "<keyword>" --sort-type like_count_descending --pages 2 --max-items 20 --pretty \
47
- --source-client socialdatax-skills --source-platform github --source-skill xhs-content-research
47
+ --source-client socialdatax-skills --source-platform github --source-skill media-search
48
48
  ```
49
49
 
50
50
  ### XHS Viral Note Research
@@ -52,7 +52,7 @@ npx -y socialdatax-skills@latest xhs search \
52
52
  ```bash
53
53
  npx -y socialdatax-skills@latest xhs search \
54
54
  --keyword "<keyword>" --sort-type like_count_descending --pages 2 --max-items 20 --pretty \
55
- --source-client socialdatax-skills --source-platform github --source-skill xhs-viral-note-research
55
+ --source-client socialdatax-skills --source-platform github --source-skill media-search
56
56
  ```
57
57
 
58
58
  ### XHS Viral Copy Breakdown
@@ -62,7 +62,7 @@ Find candidate notes:
62
62
  ```bash
63
63
  npx -y socialdatax-skills@latest xhs search \
64
64
  --keyword "<keyword>" --sort-type like_count_descending --pages 2 --max-items 20 --pretty \
65
- --source-client socialdatax-skills --source-platform github --source-skill xhs-viral-copy-breakdown
65
+ --source-client socialdatax-skills --source-platform github --source-skill socialdatax-content-research-assistant
66
66
  ```
67
67
 
68
68
  Read one selected note for copy breakdown:
@@ -70,7 +70,7 @@ Read one selected note for copy breakdown:
70
70
  ```bash
71
71
  npx -y socialdatax-skills@latest xhs detail \
72
72
  --url "<xhs_note_url_or_share_text>" --pretty \
73
- --source-client socialdatax-skills --source-platform github --source-skill xhs-viral-copy-breakdown
73
+ --source-client socialdatax-skills --source-platform github --source-skill socialdatax-content-research-assistant
74
74
  ```
75
75
 
76
76
  ### XHS Comment Analysis
@@ -78,7 +78,7 @@ npx -y socialdatax-skills@latest xhs detail \
78
78
  ```bash
79
79
  npx -y socialdatax-skills@latest xhs comments \
80
80
  --url "<xhs_note_url_or_share_text>" --pages 2 --max-items 20 --include-replies --pretty \
81
- --source-client socialdatax-skills --source-platform github --source-skill xhs-comment-insights
81
+ --source-client socialdatax-skills --source-platform github --source-skill media-comments
82
82
  ```
83
83
 
84
84
  ### XHS Hot Topic Planning
@@ -86,7 +86,7 @@ npx -y socialdatax-skills@latest xhs comments \
86
86
  ```bash
87
87
  npx -y socialdatax-skills@latest xhs hot-search \
88
88
  --pretty --source-client socialdatax-skills --source-platform github \
89
- --source-skill xhs-hot-topic-selection
89
+ --source-skill socialdatax-content-research-assistant
90
90
  ```
91
91
 
92
92
  Then search notes for one selected hot topic:
@@ -94,7 +94,7 @@ Then search notes for one selected hot topic:
94
94
  ```bash
95
95
  npx -y socialdatax-skills@latest xhs search \
96
96
  --keyword "<hot_topic_keyword>" --sort-type like_count_descending --pages 2 --max-items 20 --pretty \
97
- --source-client socialdatax-skills --source-platform github --source-skill xhs-hot-topic-selection
97
+ --source-client socialdatax-skills --source-platform github --source-skill socialdatax-content-research-assistant
98
98
  ```
99
99
 
100
100
  ### Douyin Copy Extraction
@@ -102,7 +102,7 @@ npx -y socialdatax-skills@latest xhs search \
102
102
  ```bash
103
103
  npx -y socialdatax-skills@latest douyin transcript \
104
104
  --url "<douyin_video_url_or_share_text>" --pretty \
105
- --source-client socialdatax-skills --source-platform github --source-skill douyin-video-copy-extract
105
+ --source-client socialdatax-skills --source-platform github --source-skill media-transcript
106
106
  ```
107
107
 
108
108
  If the transcript job is still pending, keep the returned `job_id` and query it again:
@@ -110,7 +110,7 @@ If the transcript job is still pending, keep the returned `job_id` and query it
110
110
  ```bash
111
111
  npx -y socialdatax-skills@latest douyin transcript \
112
112
  --job-id "<job_id>" --pretty \
113
- --source-client socialdatax-skills --source-platform github --source-skill douyin-video-copy-extract
113
+ --source-client socialdatax-skills --source-platform github --source-skill media-transcript
114
114
  ```
115
115
 
116
116
  ### Sensitive Term Check
@@ -118,7 +118,7 @@ npx -y socialdatax-skills@latest douyin transcript \
118
118
  ```bash
119
119
  npx -y socialdatax-skills@latest sensitive-check text \
120
120
  --text "<copy_to_check>" --platform xhs --pretty \
121
- --source-client socialdatax-skills --source-platform github --source-skill socialdatax-sensitive-check
121
+ --source-client socialdatax-skills --source-platform github --source-skill sensitive-check
122
122
  ```
123
123
 
124
124
  ## Output Principles
@@ -134,8 +134,9 @@ npx -y socialdatax-skills@latest sensitive-check text \
134
134
  Use the marketplace that matches your agent runtime:
135
135
 
136
136
  - ClawHub: search the Chinese skill title or slug shown above.
137
- - SkillHub: search the Chinese skill title or slug shown above.
137
+ - SkillHub: search the SkillHub slug shown above where one is listed. Rows without a SkillHub slug are not currently available through SkillHub.
138
138
  - ModelScope: search the Chinese skill title or slug shown above.
139
+ - GitHub / skills.sh: install the currently published Skills from [`DevinChen2014/socialdatax-skills`](https://github.com/DevinChen2014/socialdatax-skills); skills.sh reads the repository's `skills/` directory.
139
140
  - npm/direct CLI: use `npx -y socialdatax-skills@latest ...`.
140
141
 
141
142
  ## Safety Boundary
package/README.md CHANGED
@@ -84,12 +84,12 @@ Common search phrases for this skill package:
84
84
  - Hosted transport: `streamable-http`
85
85
  - Authentication: `Authorization: Bearer <SOCIALDATAX_API_KEY>`
86
86
  - Website: <https://socialdatax.com>
87
- - Repo-tracked platform MCP listings: `com.52choujiang/xhs-insights`, `com.52choujiang/douyin-insights`, `com.52choujiang/kuaishou-insights`, `com.52choujiang/weibo-insights`, `com.52choujiang/wechat-channels-insights`, and `com.52choujiang/instagram-insights`.
87
+ - Repo-tracked platform MCP listings: `com.52choujiang/xhs-insights`, `com.52choujiang/douyin-insights`, `com.52choujiang/kuaishou-insights`, `com.52choujiang/bilibili-insights`, `com.52choujiang/weibo-insights`, `com.52choujiang/wechat-channels-insights`, `com.52choujiang/zhihu-insights`, `com.52choujiang/instagram-insights`, `com.52choujiang/x-insights`, `com.52choujiang/youtube-insights`, and `com.52choujiang/tiktok-insights`.
88
88
  - Repo-tracked future SocialDataX namespace draft files exist for XHS and Douyin: `com.socialdatax/xhs-insights` and `com.socialdatax/douyin-insights`.
89
- - Reserved future SocialDataX namespace names for existing platform listings without draft files yet: `com.socialdatax/kuaishou-insights`, `com.socialdatax/weibo-insights`, `com.socialdatax/wechat-channels-insights`, and `com.socialdatax/instagram-insights`.
90
- - Hosted endpoints without repo-tracked standalone listing materials yet: Bilibili, Zhihu, X / Twitter, YouTube, TikTok, and Sensitive Words Check.
89
+ - Reserved future SocialDataX namespace names for existing platform listings without draft files yet: `com.socialdatax/kuaishou-insights`, `com.socialdatax/bilibili-insights`, `com.socialdatax/weibo-insights`, `com.socialdatax/wechat-channels-insights`, `com.socialdatax/zhihu-insights`, `com.socialdatax/instagram-insights`, `com.socialdatax/x-insights`, `com.socialdatax/youtube-insights`, and `com.socialdatax/tiktok-insights`.
90
+ - Hosted endpoint without a repo-tracked standalone listing: Sensitive Words Check.
91
91
  - Unified MCP registry name: none; this package installs skills and calls explicit hosted MCP entries.
92
- - Current public capability version: `0.2.38`
92
+ - Current public capability version: `0.2.39`
93
93
 
94
94
  ## Direct CLI
95
95
 
@@ -175,9 +175,9 @@ npx -y socialdatax-skills@latest weibo replies --post-id "<post_id>" --comment-i
175
175
  npx -y socialdatax-skills@latest weibo likers --post-id "<post_id>" --pretty
176
176
  npx -y socialdatax-skills@latest weibo reposts --post-id "<post_id>" --pretty
177
177
  npx -y socialdatax-skills@latest weibo user-info --user-id "<user_id>" --pretty
178
- npx -y socialdatax-skills@latest weibo user-info --profile-url "<profile_url_or_share_text>" --pretty
178
+ npx -y socialdatax-skills@latest weibo user-info --profile-url "<profile_url>" --pretty
179
179
  npx -y socialdatax-skills@latest weibo user-posts --user-id "<user_id>" --pretty
180
- npx -y socialdatax-skills@latest weibo user-posts --profile-url "<profile_url_or_share_text>" --pretty
180
+ npx -y socialdatax-skills@latest weibo user-posts --profile-url "<profile_url>" --pretty
181
181
  npx -y socialdatax-skills@latest weibo transcript --post-url "<weibo_post_url_or_share_text>" --pretty
182
182
  npx -y socialdatax-skills@latest weibo transcript --post-id "<post_id>" --pretty
183
183
  npx -y socialdatax-skills@latest weibo transcript --job-id "<job_id>" --pretty
@@ -185,7 +185,7 @@ npx -y socialdatax-skills@latest weibo download-media --url "<weibo_media_url>"
185
185
  npx -y socialdatax-skills@latest wechat hot-search --pretty
186
186
  npx -y socialdatax-skills@latest wechat search --keyword "露营" --pretty
187
187
  npx -y socialdatax-skills@latest wechat detail --encrypted-object-id "<encrypted_object_id>" --pretty
188
- npx -y socialdatax-skills@latest wechat detail --url "<wechat_video_url_or_share_text>" --pretty
188
+ npx -y socialdatax-skills@latest wechat detail --url "<wechat_work_url_or_share_text>" --pretty
189
189
  npx -y socialdatax-skills@latest wechat decrypt-media --media-url "<video.video_url>" --output video.mp4
190
190
  npx -y socialdatax-skills@latest wechat article --url "<mp_article_url_or_share_text>" --pretty
191
191
  npx -y socialdatax-skills@latest wechat comments --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --pretty
@@ -194,7 +194,7 @@ npx -y socialdatax-skills@latest wechat comments --url "<wechat_video_url_or_sha
194
194
  npx -y socialdatax-skills@latest wechat replies --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --comment-id "<comment_id>" --pretty
195
195
  npx -y socialdatax-skills@latest wechat user-info --user-id "<v2_finder_user_id>" --pretty
196
196
  npx -y socialdatax-skills@latest wechat user-posts --user-id "<v2_finder_user_id>" --pretty
197
- npx -y socialdatax-skills@latest wechat user-posts --url "<wechat_video_url_or_share_text>" --pretty
197
+ npx -y socialdatax-skills@latest wechat user-posts --url "<wechat_work_url_or_share_text>" --pretty
198
198
  npx -y socialdatax-skills@latest wechat transcript --url "<wechat_video_url_or_share_text>" --pretty
199
199
  npx -y socialdatax-skills@latest wechat transcript --encrypted-object-id "<encrypted_object_id>" --pretty
200
200
  npx -y socialdatax-skills@latest wechat transcript --job-id "<job_id>" --pretty
@@ -437,15 +437,17 @@ npx -y socialdatax-skills@latest tiktok search --keyword "camping" --pretty
437
437
  npx -y socialdatax-skills@latest sensitive-check text --text "<content>" --platform xhs --pretty
438
438
  ```
439
439
 
440
+ Use `--path` for clients that expect a direct Skills directory. When installing all skills, `--path` is the parent directory; when installing one skill, `--path` is that skill's destination directory.
441
+
440
442
  Available skills:
441
443
 
442
444
  - `socialdatax-content-research-assistant`: combine SocialDataX search, detail, comment, creator profile, and creator content workflows for cross-platform content research across XHS, Douyin, Kuaishou, Bilibili, Weibo, WeChat Channels, Zhihu, Instagram, X / Twitter, YouTube, and TikTok; also reads WeChat Official Account article link details.
443
445
  - `media-search`: search social media content by keyword; supports XHS notes, Douyin works, Kuaishou works, Bilibili videos/articles, Weibo posts, WeChat Channels videos, Zhihu content, Instagram posts, X / Twitter posts, YouTube videos, and TikTok posts.
444
- - `media-detail`: read WeChat Official Account article details and body text from article links. Read structured content details and metrics for XHS notes, Douyin works, Kuaishou works, Bilibili content, Weibo posts, WeChat Channels videos, Zhihu content, Instagram posts, X / Twitter posts, YouTube videos, and TikTok posts.
446
+ - `media-detail`: read WeChat Official Account article details and body text from article links. Read structured content details and metrics for XHS notes, Douyin works, Kuaishou works, Bilibili content, Weibo posts, WeChat Channels videos and image posts, Zhihu content, Instagram posts, X / Twitter posts, YouTube videos, and TikTok posts.
445
447
  - `media-comments`: fetch and analyze comments/replies for XHS, Douyin, Kuaishou, Bilibili, Weibo, WeChat Channels, Zhihu, Instagram, X / Twitter, YouTube, and TikTok.
446
- - `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.
448
+ - `media-transcript`: submit and check video 口播转文字 / speech-to-text transcript jobs; supports XHS, Douyin, Kuaishou, Weibo, and WeChat Channels through direct CLI commands or hosted MCP tools, plus Bilibili, Zhihu independent videos and video answers, Instagram regular video posts/Reels, X / Twitter video posts, TikTok, and YouTube through hosted MCP tools. Instagram photo and carousel posts and Zhihu plain answers without video are not processable.
447
449
  - `media-user-info`: retrieve creator profile information; supports XHS, Douyin, Kuaishou, Bilibili, Weibo, WeChat Channels, Zhihu, Instagram, X / Twitter, YouTube channels, and TikTok creators.
448
- - `media-user-posts`: retrieve creator content lists; supports XHS notes, Douyin works, Kuaishou works, Bilibili videos/articles/dynamics, Weibo posts, WeChat Channels videos, Zhihu creator articles, Instagram posts, X / Twitter posts, YouTube channel videos/Shorts, TikTok posts, and Douyin creator short-drama series.
450
+ - `media-user-posts`: retrieve creator content lists; supports XHS notes, Douyin works, Kuaishou works, Bilibili videos/articles/dynamics, Weibo posts, WeChat Channels videos and image posts, Zhihu creator articles, Instagram posts, X / Twitter posts, YouTube channel videos/Shorts, TikTok posts, and Douyin creator short-drama series.
449
451
  - `sensitive-check`: run 敏感词检测 / 违禁词检查 text checks; supports `generic`, `xhs`, `douyin`, and `kuaishou` platform contexts.
450
452
 
451
453
  Default install locations:
@@ -504,6 +506,7 @@ Current Bilibili workflows include:
504
506
  - Fetch paginated likes and reposts for Bilibili opus/dynamic content by post_id or opus/dynamic URL/share text. If starting from a `/read/cv...` article URL, call `bilibili detail` first and use the returned `post.post_id` or `post.share_url`.
505
507
  - Read creator profile data from a user_id, profile link, short link, or share text.
506
508
  - Fetch paginated creator videos, articles, and dynamics.
509
+ - Submit and check Bilibili video 口播转文字 / speech-to-text transcript jobs through hosted MCP tools. Submit by video URL, short link, share text, or BV number; each job processes one video part. Submit tools 提交后最多等待 240 秒,未完成时继续查询同一个 job_id 直到终态.
507
510
  - Resolve a Bilibili video page link or share text into short-lived DASH download links.
508
511
  - Download the selected video and audio tracks locally and merge them with `ffmpeg -c copy`.
509
512
 
@@ -529,8 +532,8 @@ Current Weibo workflows include:
529
532
  - Fetch paginated first-level comments for comment analysis.
530
533
  - Fetch paginated replies under a first-level comment.
531
534
  - Continue Weibo list pagination only when `next_page_token` is non-empty; an empty string means there are no more results to request.
532
- - Read creator profile data from a profile link, short link, share text, or user_id.
533
- - Fetch paginated creator post lists from a user_id, profile link, short link, or share text.
535
+ - Read Weibo creator profile data from a user profile link or user_id.
536
+ - Fetch paginated Weibo creator post lists from a user profile link or user_id.
534
537
  - Submit and check Weibo video 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 240 秒,未完成时继续查询同一个 job_id 直到终态.
535
538
  - Save returned `image_urls[]` or `video.video_url` media links locally with `weibo download-media`.
536
539
 
@@ -538,14 +541,14 @@ Current WeChat Content / 微信内容 workflows include:
538
541
 
539
542
  - Fetch the current WeChat Channels / 视频号 hot-search list.
540
543
  - Search related WeChat Channels videos by keyword with optional sort and duration filters.
541
- - Resolve a WeChat Channels video link, share text, or encrypted_object_id into structured video details.
544
+ - Resolve a WeChat Channels video or image-post link, share text, or encrypted_object_id into structured work details.
542
545
  - Save the `video.video_url` returned by WeChat Channels video detail locally and decrypt when needed.
543
546
  - Resolve a WeChat Official Account / 微信公众号 article link or share text into article detail and body text.
544
547
  - Fetch paginated WeChat Channels / 视频号 first-level comments for comment analysis.
545
548
  - Fetch paginated WeChat Channels / 视频号 replies under a first-level comment; pass `object_id`, `object_nonce_id`, and `comment_id`.
546
549
  - Continue WeChat Channels list pagination only when `next_page_token` is non-empty; an empty string means there are no more results to request.
547
- - Read WeChat Channels / 视频号 creator profile data from a `v2_...@finder` user_id; hosted MCP can also resolve creator profile data from a video link or share text.
548
- - Fetch paginated creator video lists from a `v2_...@finder` user_id or a video link/share text.
550
+ - Read WeChat Channels / 视频号 creator profile data from a `v2_...@finder` user_id; hosted MCP can also resolve creator profile data from a video or image-post link or share text.
551
+ - Fetch paginated creator video and image-post lists from a `v2_...@finder` user_id or a video/image-post link or share text.
549
552
  - Submit and check WeChat Channels / 视频号 video 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 240 秒,未完成时继续查询同一个 job_id 直到终态.
550
553
 
551
554
  Current Zhihu / 知乎 workflows include:
@@ -557,6 +560,7 @@ Current Zhihu / 知乎 workflows include:
557
560
  - Fetch paginated replies under a first-level comment by content URL and comment_id.
558
561
  - Read creator profile data from a profile URL.
559
562
  - Fetch paginated creator article lists from a profile URL.
563
+ - Submit and check independent `/zvideo/{zvideo_id}` or video-answer `/question/{question_id}/answer/{answer_id}` 口播转文字 / speech-to-text transcript jobs through hosted MCP tools. Numeric `zvideo_id` remains independent-video only; submit tools 提交后最多等待 240 秒,未完成时继续查询同一个 job_id 直到终态.
560
564
 
561
565
  Current Instagram workflows include:
562
566
 
@@ -566,6 +570,7 @@ Current Instagram workflows include:
566
570
  - Fetch paginated replies under a first-level comment by post_id and comment_id.
567
571
  - Read creator profile data by username or profile URL/share text.
568
572
  - Fetch paginated public posts by creator username or profile URL/share text.
573
+ - Submit and check speech-to-text transcript jobs for regular video posts and Reels through hosted MCP tools; photo and carousel posts are not supported.
569
574
 
570
575
  Current X / Twitter workflows include:
571
576
 
@@ -595,6 +600,7 @@ Current TikTok workflows include:
595
600
  - Fetch paginated replies under a first-level comment by post_id and comment_id.
596
601
  - Read creator profile data by tiktok_id or profile URL/share text.
597
602
  - Fetch paginated creator posts by tiktok_id or profile URL/share text.
603
+ - Submit TikTok video speech-to-text transcript jobs through hosted MCP using a video URL or aweme_id, or query an existing valid job_id directly; reuse the same job_id until the task is terminal.
598
604
 
599
605
  Current Sensitive Words Check workflows include:
600
606
 
@@ -628,12 +634,14 @@ Current Sensitive Words Check workflows include:
628
634
  | --- | --- |
629
635
  | `douyin_get_hot_search_list` | Fetch the current Douyin main hot search list. |
630
636
  | `douyin_search_videos` | Search Douyin works by keyword with optional `page_token` continuation and filters; do not pass `page`. |
637
+ | `douyin_search_users` | Search Douyin creators/accounts by keyword with optional `page_token` continuation and filters; do not pass `page`. |
631
638
  | `douyin_get_video_detail_by_aweme_id` | Fetch structured Douyin work details when the caller already has an aweme_id. |
632
639
  | `douyin_get_video_detail_by_url` | Resolve a Douyin content page link, short link, or share text into structured Douyin work details. |
633
640
  | `douyin_get_video_comments_by_aweme_id` | Fetch paginated first-level comments when the caller already has an aweme_id. |
634
641
  | `douyin_get_video_comments_by_url` | Fetch paginated first-level comments directly from a Douyin content page URL, short link, or share text. |
635
642
  | `douyin_get_video_comment_replies_by_comment_id` | Fetch paginated replies under a first-level Douyin comment; pass both aweme_id and comment_id, and use page_token to continue pagination. |
636
643
  | `douyin_get_user_info_by_sec_user_id` | Fetch creator profile data when the caller already has a sec_user_id. |
644
+ | `douyin_get_user_info_by_douyin_id` | Fetch creator profile data when the caller has the public Douyin account ID / douyin_id. |
637
645
  | `douyin_get_user_info_by_profile_url` | Resolve a profile link, short link, or share text into creator profile data. |
638
646
  | `douyin_get_user_posted_videos_by_sec_user_id` | Fetch a paginated list of works published by a creator when the caller already has a sec_user_id. |
639
647
  | `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. |
@@ -685,6 +693,9 @@ Current Sensitive Words Check workflows include:
685
693
  | `bilibili_get_user_posted_articles_by_profile_url` | Fetch creator articles from a Bilibili profile link, short link, or share text. |
686
694
  | `bilibili_get_user_posted_dynamics_by_user_id` | Fetch a paginated list of dynamics published by a Bilibili creator by user_id. |
687
695
  | `bilibili_get_user_posted_dynamics_by_profile_url` | Fetch creator dynamics from a Bilibili profile link, short link, or share text. |
696
+ | `bilibili_submit_video_speech_text_by_video_url` | Submit a Bilibili video speech-to-text transcript job from a video URL, short link, or share text. Each job processes one video part and waits up to 240 seconds. |
697
+ | `bilibili_submit_video_speech_text_by_bvid` | Submit a Bilibili video P1 speech-to-text transcript job by BV number; use the URL tool with a `p` parameter for later video parts. Submit waits up to 240 seconds. |
698
+ | `bilibili_get_video_speech_text_job` | Check a Bilibili speech-to-text transcript job by job_id without creating a new task. Each call waits up to 240 seconds; if unfinished, continue querying the same job_id until is_terminal is true. |
688
699
 
689
700
  ## Weibo Tools
690
701
 
@@ -702,12 +713,12 @@ Current Sensitive Words Check workflows include:
702
713
  | `weibo_get_post_repost_list_by_post_id` | Fetch paginated reposts for a Weibo post by post_id. |
703
714
  | `weibo_get_post_repost_list_by_post_url` | Fetch paginated reposts for a Weibo post from a post page link, short link, or share text. |
704
715
  | `weibo_get_user_info_by_user_id` | Fetch creator profile data when the caller already has a user_id. |
705
- | `weibo_get_user_info_by_profile_url` | Resolve a Weibo profile link, short link, or share text into creator profile data. |
716
+ | `weibo_get_user_info_by_profile_url` | Resolve a Weibo user profile link into creator profile data. |
706
717
  | `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. |
707
- | `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. |
718
+ | `weibo_get_user_posts_by_profile_url` | Fetch a paginated list of posts published by a creator from a Weibo user profile link. |
708
719
  | `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. |
709
720
  | `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. |
710
- | `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. |
721
+ | `weibo_get_video_speech_text_job` | Continue checking a Weibo speech-to-text transcript job using a valid job_id supplied by the user, or a job_id returned by a submit tool, 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. |
711
722
 
712
723
  ## WeChat Tools
713
724
 
@@ -716,18 +727,18 @@ Current Sensitive Words Check workflows include:
716
727
  | `wechat_get_hot_search_list` | Fetch the current WeChat Channels / 视频号 hot-search list. |
717
728
  | `wechat_search_videos` | Search WeChat Channels / 视频号 videos by keyword with optional `page_token` continuation and filters; do not pass `page`. |
718
729
  | `wechat_get_video_detail_by_encrypted_object_id` | Fetch structured WeChat Channels video details when encrypted_object_id is already known. |
719
- | `wechat_get_video_detail_by_url` | Resolve a WeChat Channels / 视频号 video link or share text into structured video details. |
730
+ | `wechat_get_video_detail_by_url` | Resolve a WeChat Channels / 视频号 video or image-post link or share text into structured work details. |
720
731
  | `wechat_get_mp_article_detail_by_url` | Fetch WeChat Official Account / 微信公众号 article detail and body text from an article link or share text. |
721
732
  | `wechat_get_video_comments_by_object_id` | Fetch paginated first-level comments when object_id and object_nonce_id are known. |
722
733
  | `wechat_get_video_comments_by_url` | Fetch paginated first-level comments directly from a WeChat Channels / 视频号 video link or share text. |
723
734
  | `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. |
724
735
  | `wechat_get_user_info_by_user_id` | Fetch creator profile data when the `v2_...@finder` user_id is already known. |
725
- | `wechat_get_user_info_by_url` | Resolve a WeChat Channels / 视频号 video link or share text into creator profile data. |
726
- | `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. |
727
- | `wechat_get_user_posted_videos_by_url` | Fetch a paginated list of videos published by a creator from a video link or share text. |
736
+ | `wechat_get_user_info_by_url` | Resolve a WeChat Channels / 视频号 video or image-post link or share text into creator profile data. |
737
+ | `wechat_get_user_posted_videos_by_user_id` | Fetch a paginated list of videos and image posts published by a creator when the `v2_...@finder` user_id is already known. |
738
+ | `wechat_get_user_posted_videos_by_url` | Fetch a paginated list of videos and image posts published by a creator from a video or image-post link or share text. |
728
739
  | `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. |
729
740
  | `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. |
730
- | `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. |
741
+ | `wechat_get_video_speech_text_job` | Continue checking a WeChat Channels / 视频号 speech-to-text transcript job using a valid job_id supplied by the user, or a job_id returned by a submit tool, 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. |
731
742
 
732
743
  ## Zhihu Tools
733
744
 
@@ -740,6 +751,9 @@ Current Sensitive Words Check workflows include:
740
751
  | `zhihu_get_comment_replies_by_url` | Fetch paginated replies under a first-level Zhihu comment by content URL and comment_id. |
741
752
  | `zhihu_get_user_info_by_profile_url` | Fetch Zhihu creator profile data from a profile URL. |
742
753
  | `zhihu_get_user_posted_articles_by_profile_url` | Fetch a paginated list of articles published by a Zhihu creator from a profile URL. |
754
+ | `zhihu_submit_video_speech_text_by_video_url` | Submit a Zhihu speech-to-text transcript job from an independent `/zvideo/{zvideo_id}` URL or a video-answer page URL. |
755
+ | `zhihu_submit_video_speech_text_by_zvideo_id` | Submit a Zhihu independent-video speech-to-text transcript job from a numeric `zvideo_id`. |
756
+ | `zhihu_get_video_speech_text_job` | Check a Zhihu independent-video or video-answer speech-to-text transcript job by `job_id`. |
743
757
 
744
758
  ## Instagram Tools
745
759
 
@@ -754,6 +768,9 @@ Current Sensitive Words Check workflows include:
754
768
  | `instagram_get_user_info_by_profile_url` | Fetch Instagram creator profile data from a profile URL. |
755
769
  | `instagram_get_user_posts_by_username` | Fetch a paginated list of public posts by an Instagram creator username. |
756
770
  | `instagram_get_user_posts_by_profile_url` | Fetch a paginated list of public posts by an Instagram creator profile URL. |
771
+ | `instagram_submit_video_speech_text_by_post_url` | Submit a speech-to-text transcript job for an Instagram regular video post or Reels URL. Photo and carousel posts are not supported. |
772
+ | `instagram_submit_video_speech_text_by_post_id` | Submit a speech-to-text transcript job for an Instagram regular video post or Reels post_id. Photo and carousel posts are not supported. |
773
+ | `instagram_get_video_speech_text_job` | Continue checking an Instagram speech-to-text transcript job using a valid job_id supplied by the user, or a job_id returned by a submit tool, 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. |
757
774
 
758
775
  ## X Tools
759
776
 
@@ -782,6 +799,9 @@ Current Sensitive Words Check workflows include:
782
799
  | `youtube_get_user_posted_videos_by_channel_url` | Fetch a paginated list of videos or Shorts published by a YouTube channel URL. |
783
800
  | `youtube_get_video_comments_by_url` | Fetch paginated first-level comments from a YouTube video URL. |
784
801
  | `youtube_get_video_comment_replies` | Fetch paginated YouTube comment replies by the first-level comment reply_token. |
802
+ | `youtube_submit_video_speech_text_by_url` | Submit a YouTube video speech-to-text transcript job from a video URL. |
803
+ | `youtube_submit_video_speech_text_by_video_id` | Submit a YouTube video speech-to-text transcript job from an 11-character video_id. |
804
+ | `youtube_get_video_speech_text_job` | Check a YouTube video speech-to-text transcript job by `job_id`. |
785
805
 
786
806
  ## TikTok Tools
787
807
 
@@ -796,6 +816,9 @@ Current Sensitive Words Check workflows include:
796
816
  | `tiktok_get_user_info_by_profile_url` | Fetch TikTok creator profile data from a profile URL. |
797
817
  | `tiktok_get_user_posts_by_tiktok_id` | Fetch a paginated list of posts by a TikTok creator tiktok_id. |
798
818
  | `tiktok_get_user_posts_by_profile_url` | Fetch a paginated list of posts by a TikTok creator profile URL. |
819
+ | `tiktok_submit_video_speech_text_by_url` | Submit a TikTok video speech-to-text transcript job from a video URL. |
820
+ | `tiktok_submit_video_speech_text_by_aweme_id` | Submit a TikTok video speech-to-text transcript job from an aweme_id. |
821
+ | `tiktok_get_video_speech_text_job` | Check a TikTok video speech-to-text transcript job by `job_id`. |
799
822
 
800
823
  ## Sensitive Words Check Tools
801
824
 
@@ -825,7 +848,7 @@ npx -y socialdatax-skills@latest tiktok search --keyword "camping" --pretty
825
848
  npx -y socialdatax-skills@latest sensitive-check text --text "<content>" --platform xhs --pretty
826
849
  ```
827
850
 
828
- MCP client configuration belongs to repo-tracked platform MCP listings when those materials exist. Current repo-tracked standalone listings cover XHS, Douyin, Kuaishou, Weibo, WeChat Content / 微信内容 under the historical `wechat-channels-insights` Registry name, and Instagram. WeChat Official Account article details are included in the WeChat endpoint and skills package, not a separate standalone listing. For Bilibili, Zhihu, X / Twitter, YouTube, TikTok, and 敏感词检测 / 违禁词检查, use the hosted endpoints above or `mcp-remote` until standalone listing and registry materials are created.
851
+ MCP client configuration belongs to repo-tracked platform MCP listings when those materials exist. Current repo-tracked standalone listings cover XHS, Douyin, Kuaishou, Bilibili, Weibo, WeChat Content / 微信内容 under the historical `wechat-channels-insights` Registry name, Zhihu, Instagram, X / Twitter, YouTube, and TikTok. WeChat Official Account article details are included in the WeChat endpoint and skills package, not a separate standalone listing. Sensitive Words Check remains hosted-only; use its hosted endpoint above or `mcp-remote`.
829
852
 
830
853
  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.
831
854
 
package/cli.mjs CHANGED
@@ -22,7 +22,7 @@ import { decryptWechatMediaCommand } from "./lib/media/wechat-decrypt.mjs";
22
22
  export { decryptWechatMediaCommand };
23
23
 
24
24
  const PACKAGE_NAME = "socialdatax-skills";
25
- const PACKAGE_VERSION = "0.2.38";
25
+ const PACKAGE_VERSION = "0.2.39";
26
26
  const PACKAGE_SPEC = `${PACKAGE_NAME}@latest`;
27
27
  const LOG_PREFIX = `[${PACKAGE_NAME}]`;
28
28
  const MIN_NODE_VERSION = "20.18.1";
@@ -83,7 +83,7 @@ const AVAILABLE_SKILLS = [
83
83
  {
84
84
  name: "media-transcript",
85
85
  summary:
86
- "Submit and check video speech-to-text transcript jobs for XHS, Douyin, Kuaishou, Weibo, and WeChat Channels.",
86
+ "Submit and check video speech-to-text transcript jobs for XHS, Douyin, Kuaishou, Weibo, and WeChat Channels, plus Bilibili, Instagram, X / Twitter, TikTok, and YouTube through hosted MCP tools.",
87
87
  emoji: "🎙️",
88
88
  },
89
89
  {
@@ -851,9 +851,14 @@ const REPO_TRACKED_PLATFORM_LISTINGS = new Set([
851
851
  "xhs",
852
852
  "douyin",
853
853
  "kuaishou",
854
+ "bilibili",
854
855
  "weibo",
855
856
  "wechat",
857
+ "zhihu",
856
858
  "instagram",
859
+ "x",
860
+ "youtube",
861
+ "tiktok",
857
862
  ]);
858
863
  const REPO_TRACKED_FUTURE_REGISTRY_DRAFTS = new Set(["xhs", "douyin"]);
859
864
  const PLATFORMS = {
@@ -1112,6 +1117,8 @@ const PLATFORMS = {
1112
1117
  id: "bilibili",
1113
1118
  displayName: "Bilibili / 哔哩哔哩 / B站",
1114
1119
  status: "public",
1120
+ registryName: "com.52choujiang/bilibili-insights",
1121
+ futureRegistryName: "com.socialdatax/bilibili-insights",
1115
1122
  endpoint: "https://mcp.socialdatax.com/bilibili/mcp",
1116
1123
  apiKeyEnv: API_KEY_ENV_NAMES,
1117
1124
  upstreamEnv: [
@@ -1278,7 +1285,7 @@ const PLATFORMS = {
1278
1285
  },
1279
1286
  {
1280
1287
  name: "weibo_get_user_info_by_profile_url",
1281
- description: "Resolve a Weibo profile URL, short link, or share text into creator profile data.",
1288
+ description: "Resolve a Weibo user profile URL into creator profile data.",
1282
1289
  },
1283
1290
  {
1284
1291
  name: "weibo_get_user_posts_by_user_id",
@@ -1286,7 +1293,7 @@ const PLATFORMS = {
1286
1293
  },
1287
1294
  {
1288
1295
  name: "weibo_get_user_posts_by_profile_url",
1289
- description: "Fetch creator posts from a profile URL, short link, or profile share text.",
1296
+ description: "Fetch creator posts from a Weibo user profile URL.",
1290
1297
  },
1291
1298
  {
1292
1299
  name: "weibo_submit_video_speech_text_by_post_url",
@@ -1301,7 +1308,8 @@ const PLATFORMS = {
1301
1308
  {
1302
1309
  name: "weibo_get_video_speech_text_job",
1303
1310
  description:
1304
- buildTranscriptJobDescription("a Weibo video speech-to-text transcript job"),
1311
+ "Continue checking a Weibo video speech-to-text transcript job using a valid job_id supplied by the user, or a job_id returned from a submit tool, without creating a new task. " +
1312
+ `${TRANSCRIPT_GET_JOB_WAIT_DESCRIPTION} ${TRANSCRIPT_JOB_DESCRIPTION_SUFFIX}`,
1305
1313
  },
1306
1314
  ],
1307
1315
  },
@@ -1334,7 +1342,8 @@ const PLATFORMS = {
1334
1342
  },
1335
1343
  {
1336
1344
  name: "wechat_get_video_detail_by_url",
1337
- description: "Resolve a WeChat Channels / 视频号 video link or share text into structured video details.",
1345
+ description:
1346
+ "Resolve a WeChat Channels / 视频号 video or image-post link or share text into structured work details.",
1338
1347
  },
1339
1348
  {
1340
1349
  name: "wechat_get_mp_article_detail_by_url",
@@ -1360,15 +1369,16 @@ const PLATFORMS = {
1360
1369
  {
1361
1370
  name: "wechat_get_user_info_by_url",
1362
1371
  description:
1363
- "Resolve a WeChat Channels / 视频号 video link or share text into creator profile data.",
1372
+ "Resolve a WeChat Channels / 视频号 video or image-post link or share text into creator profile data.",
1364
1373
  },
1365
1374
  {
1366
1375
  name: "wechat_get_user_posted_videos_by_user_id",
1367
- description: "Fetch a paginated list of videos published by a creator when the v2_...@finder user_id is already known.",
1376
+ description: "Fetch a paginated list of videos and image posts published by a creator when the v2_...@finder user_id is already known.",
1368
1377
  },
1369
1378
  {
1370
1379
  name: "wechat_get_user_posted_videos_by_url",
1371
- description: "Fetch creator videos from a WeChat Channels / 视频号 video link or share text.",
1380
+ description:
1381
+ "Fetch creator videos and image posts from a WeChat Channels / 视频号 video or image-post link or share text.",
1372
1382
  },
1373
1383
  {
1374
1384
  name: "wechat_submit_video_speech_text_by_video_url",
@@ -1383,9 +1393,8 @@ const PLATFORMS = {
1383
1393
  {
1384
1394
  name: "wechat_get_video_speech_text_job",
1385
1395
  description:
1386
- buildTranscriptJobDescription(
1387
- "a WeChat Channels / 视频号 video speech-to-text transcript job"
1388
- ),
1396
+ "Continue checking a WeChat Channels / 视频号 video speech-to-text transcript job using a valid job_id supplied by the user, or a job_id returned from a submit tool, without creating a new task. " +
1397
+ `${TRANSCRIPT_GET_JOB_WAIT_DESCRIPTION} ${TRANSCRIPT_JOB_DESCRIPTION_SUFFIX}`,
1389
1398
  },
1390
1399
  ],
1391
1400
  },
@@ -1393,6 +1402,8 @@ const PLATFORMS = {
1393
1402
  id: "zhihu",
1394
1403
  displayName: "Zhihu / 知乎",
1395
1404
  status: "public",
1405
+ registryName: "com.52choujiang/zhihu-insights",
1406
+ futureRegistryName: "com.socialdatax/zhihu-insights",
1396
1407
  endpoint: "https://mcp.socialdatax.com/zhihu/mcp",
1397
1408
  apiKeyEnv: API_KEY_ENV_NAMES,
1398
1409
  upstreamEnv: [
@@ -1499,6 +1510,8 @@ const PLATFORMS = {
1499
1510
  id: "x",
1500
1511
  displayName: "X / Twitter",
1501
1512
  status: "public",
1513
+ registryName: "com.52choujiang/x-insights",
1514
+ futureRegistryName: "com.socialdatax/x-insights",
1502
1515
  endpoint: "https://mcp.socialdatax.com/x/mcp",
1503
1516
  apiKeyEnv: API_KEY_ENV_NAMES,
1504
1517
  upstreamEnv: [
@@ -1566,6 +1579,8 @@ const PLATFORMS = {
1566
1579
  id: "youtube",
1567
1580
  displayName: "YouTube",
1568
1581
  status: "public",
1582
+ registryName: "com.52choujiang/youtube-insights",
1583
+ futureRegistryName: "com.socialdatax/youtube-insights",
1569
1584
  endpoint: "https://mcp.socialdatax.com/youtube/mcp",
1570
1585
  apiKeyEnv: API_KEY_ENV_NAMES,
1571
1586
  upstreamEnv: [
@@ -1608,6 +1623,8 @@ const PLATFORMS = {
1608
1623
  id: "tiktok",
1609
1624
  displayName: "TikTok",
1610
1625
  status: "public",
1626
+ registryName: "com.52choujiang/tiktok-insights",
1627
+ futureRegistryName: "com.socialdatax/tiktok-insights",
1611
1628
  endpoint: "https://mcp.socialdatax.com/tiktok/mcp",
1612
1629
  apiKeyEnv: API_KEY_ENV_NAMES,
1613
1630
  upstreamEnv: [
@@ -1658,6 +1675,20 @@ const PLATFORMS = {
1658
1675
  description:
1659
1676
  "Fetch a paginated list of posts by a TikTok creator profile URL.",
1660
1677
  },
1678
+ {
1679
+ name: "tiktok_submit_video_speech_text_by_url",
1680
+ description:
1681
+ "Submit a TikTok video speech-to-text transcript job from a video URL.",
1682
+ },
1683
+ {
1684
+ name: "tiktok_submit_video_speech_text_by_aweme_id",
1685
+ description:
1686
+ "Submit a TikTok video speech-to-text transcript job from an aweme_id.",
1687
+ },
1688
+ {
1689
+ name: "tiktok_get_video_speech_text_job",
1690
+ description: "Check a TikTok video speech-to-text transcript job by job_id.",
1691
+ },
1661
1692
  ],
1662
1693
  },
1663
1694
  "sensitive-check": {
@@ -1805,7 +1836,6 @@ function isMissingNodeDependencyError(message) {
1805
1836
  /Require stack:[\s\S]*(?:cli\.mjs|socialdatax-skills)/i.test(message))
1806
1837
  );
1807
1838
  }
1808
-
1809
1839
  function parseCommandArgs(args) {
1810
1840
  const options = {};
1811
1841
  const positional = [];
@@ -2785,7 +2815,7 @@ function printDoctor(args) {
2785
2815
  if (platform.repoTrackedStandaloneListing) {
2786
2816
  console.log(` registry: ${platform.registryName}`);
2787
2817
  } else {
2788
- console.log(" listing: hosted endpoint only; standalone listing materials pending");
2818
+ console.log(" listing: hosted-only; no standalone Registry listing");
2789
2819
  }
2790
2820
  if (platform.futureRegistryName) {
2791
2821
  const futureLabel = REPO_TRACKED_FUTURE_REGISTRY_DRAFTS.has(platform.id)
@@ -3000,14 +3030,14 @@ function printHelp() {
3000
3030
  console.log(` npx -y ${PACKAGE_SPEC} weibo user-info --user-id "<user_id>" --pretty`);
3001
3031
  console.log(" Call the Weibo creator profile tool directly and print JSON.");
3002
3032
  console.log("");
3003
- console.log(` npx -y ${PACKAGE_SPEC} weibo user-info --profile-url "<profile_url_or_share_text>" --pretty`);
3004
- console.log(" Call the Weibo creator profile tool from a profile link or share text.");
3033
+ console.log(` npx -y ${PACKAGE_SPEC} weibo user-info --profile-url "<profile_url>" --pretty`);
3034
+ console.log(" Call the Weibo creator profile tool from a user profile URL.");
3005
3035
  console.log("");
3006
3036
  console.log(` npx -y ${PACKAGE_SPEC} weibo user-posts --user-id "<user_id>" --pretty`);
3007
3037
  console.log(" Call the Weibo creator posts tool directly and print JSON.");
3008
3038
  console.log("");
3009
- console.log(` npx -y ${PACKAGE_SPEC} weibo user-posts --profile-url "<profile_url_or_share_text>" --pretty`);
3010
- console.log(" Call the Weibo creator posts tool from a profile link or share text.");
3039
+ console.log(` npx -y ${PACKAGE_SPEC} weibo user-posts --profile-url "<profile_url>" --pretty`);
3040
+ console.log(" Call the Weibo creator posts tool from a user profile URL.");
3011
3041
  console.log("");
3012
3042
  console.log(` npx -y ${PACKAGE_SPEC} weibo transcript --post-url "<weibo_post_url_or_share_text>" --pretty`);
3013
3043
  console.log(" Submit or check a Weibo video speech-to-text transcript job.");
@@ -3024,8 +3054,8 @@ function printHelp() {
3024
3054
  console.log(` npx -y ${PACKAGE_SPEC} wechat detail --encrypted-object-id "<encrypted_object_id>" --pretty`);
3025
3055
  console.log(" Call the WeChat Channels / 视频号 video detail tool directly and print JSON.");
3026
3056
  console.log("");
3027
- console.log(` npx -y ${PACKAGE_SPEC} wechat detail --url "<wechat_video_url_or_share_text>" --pretty`);
3028
- console.log(" Call the WeChat Channels / 视频号 video detail tool from a video link or share text.");
3057
+ console.log(` npx -y ${PACKAGE_SPEC} wechat detail --url "<wechat_work_url_or_share_text>" --pretty`);
3058
+ console.log(" Call the WeChat Channels / 视频号 work detail tool from a video or image-post link or share text.");
3029
3059
  console.log("");
3030
3060
  console.log(` npx -y ${PACKAGE_SPEC} wechat decrypt-media --media-url "<video.video_url>" --output video.mp4`);
3031
3061
  console.log(" Save the WeChat Channels / 视频号 media URL returned by detail and locally decrypt when needed.");
@@ -3048,10 +3078,10 @@ function printHelp() {
3048
3078
  console.log(" Call the WeChat Channels / 视频号 creator profile tool with a v2_...@finder user_id.");
3049
3079
  console.log("");
3050
3080
  console.log(` npx -y ${PACKAGE_SPEC} wechat user-posts --user-id "<v2_finder_user_id>" --pretty`);
3051
- console.log(" Call the WeChat Channels / 视频号 creator videos tool with a v2_...@finder user_id.");
3081
+ console.log(" Call the WeChat Channels / 视频号 creator videos and image posts tool with a v2_...@finder user_id.");
3052
3082
  console.log("");
3053
- console.log(` npx -y ${PACKAGE_SPEC} wechat user-posts --url "<wechat_video_url_or_share_text>" --pretty`);
3054
- console.log(" Call the WeChat Channels / 视频号 creator videos tool from a video link or share text.");
3083
+ console.log(` npx -y ${PACKAGE_SPEC} wechat user-posts --url "<wechat_work_url_or_share_text>" --pretty`);
3084
+ console.log(" Call the WeChat Channels / 视频号 creator videos and image posts tool from a video or image-post link or share text.");
3055
3085
  console.log("");
3056
3086
  console.log(` npx -y ${PACKAGE_SPEC} wechat transcript --encrypted-object-id "<encrypted_object_id>" --pretty`);
3057
3087
  console.log(" Submit or check a WeChat Channels / 视频号 video speech-to-text transcript job.");
@@ -3371,6 +3401,11 @@ function printRemovedMcpConfigHelp(command) {
3371
3401
  console.error(" com.52choujiang/weibo-insights");
3372
3402
  console.error(" com.52choujiang/wechat-channels-insights");
3373
3403
  console.error(" com.52choujiang/instagram-insights");
3404
+ console.error(" com.52choujiang/bilibili-insights");
3405
+ console.error(" com.52choujiang/zhihu-insights");
3406
+ console.error(" com.52choujiang/x-insights");
3407
+ console.error(" com.52choujiang/youtube-insights");
3408
+ console.error(" com.52choujiang/tiktok-insights");
3374
3409
  console.error("Repo-tracked future SocialDataX namespace draft files exist for:");
3375
3410
  console.error(" com.socialdatax/xhs-insights");
3376
3411
  console.error(" com.socialdatax/douyin-insights");
@@ -3379,7 +3414,12 @@ function printRemovedMcpConfigHelp(command) {
3379
3414
  console.error(" com.socialdatax/weibo-insights");
3380
3415
  console.error(" com.socialdatax/wechat-channels-insights");
3381
3416
  console.error(" com.socialdatax/instagram-insights");
3382
- console.error("Additional hosted endpoints for Bilibili, Zhihu, X / Twitter, YouTube, TikTok, and Sensitive Words Check do not yet have repo-tracked standalone listing materials in this repository.");
3417
+ console.error(" com.socialdatax/bilibili-insights");
3418
+ console.error(" com.socialdatax/zhihu-insights");
3419
+ console.error(" com.socialdatax/x-insights");
3420
+ console.error(" com.socialdatax/youtube-insights");
3421
+ console.error(" com.socialdatax/tiktok-insights");
3422
+ console.error("Sensitive Words Check is hosted-only and does not have a standalone Registry listing.");
3383
3423
  console.error("");
3384
3424
  console.error("Use hosted streamable HTTP when your client supports remote MCP:");
3385
3425
  console.error(" https://mcp.socialdatax.com/xhs/mcp");
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "socialdatax-skills",
3
- "version": "0.2.38",
3
+ "version": "0.2.39",
4
4
  "description": "SocialDataX / 社媒数据助手 skill installer and direct CLI helper for hosted MCP services.",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -216,10 +216,10 @@ npx -y socialdatax-skills@latest wechat replies \
216
216
 
217
217
  Optional arguments:
218
218
 
219
- - XHS `--note-id <note_id>`: use the complete 24-character lowercase hexadecimal `note_id` returned from search, detail, comments, or creator note lists; do not pass only a prefix.
219
+ - XHS `--note-id <note_id>`: use the entire `note_id` returned from search, detail, comments, or creator note lists; do not pass only a prefix.
220
220
  - XHS comments `--sort-type <default|time_descending|like_count_descending>`: optional first-level comment sort order; omit it for the platform default order.
221
221
  - Douyin `--aweme-id <aweme_id>`: preferred when the video ID is already known and should anchor the comment thread.
222
- - `--url <url_or_share_text>`: use for a content page URL, short link, or share text for first-level comments.
222
+ - Use the URL entrypoint shown in the CLI example for a content page URL, short link, or share text for first-level comments.
223
223
  - Douyin URL safety: do not pass `video.play_url`; use a Douyin content page URL, short link, or share text instead.
224
224
  - `--comment-id <comment_id>`: required only for reply commands whose CLI example uses comment IDs; YouTube replies require the returned `--reply-token <reply_token>` instead.
225
225
  - `--page-token <next_page_token>`: opaque pagination token; pass the complete returned `next_page_token` back unchanged for the same content item or comment chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.
@@ -246,7 +246,7 @@ Optional arguments:
246
246
  - WeChat Channels / 视频号 `--url <wechat_video_url_or_share_text>`: use for a WeChat Channels video link or share text for first-level comments.
247
247
  - `--source-client socialdatax-skills --source-platform npm --source-skill media-comments`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.
248
248
 
249
- Use either the platform content ID option or the URL option for first-level comments, not both. For reply commands, use the platform-specific reply identifiers shown in the CLI example.
249
+ Use one first-level comment entrypoint shown in the CLI example at a time; do not mix multiple content identifiers in one command. For reply commands, use the platform-specific reply identifiers shown in the CLI example.
250
250
 
251
251
  The command prints JSON with `platform`, `tool`, `arguments`, and `data`. Multi-page output keeps merged primary comments in `data.items` and adds `page_count`, `item_count`, and the next-page marker. On platforms that support `--include-replies`, each first-level comment includes `replies`, `replies_page_count`, and `replies_next_page_token`.
252
252
 
@@ -271,20 +271,20 @@ MCP tools matching the direct CLI commands above:
271
271
  - WECHAT: `wechat_get_video_comments_by_object_id`, `wechat_get_video_comments_by_url`, `wechat_get_video_comment_replies_by_comment_id`
272
272
 
273
273
  If MCP tools are already available in the current agent, use one of these tools:
274
- - `xhs_get_note_comments_by_note_id`: use when the complete 24-character lowercase hexadecimal `note_id` is known; do not pass only a prefix; optional `sort_type` accepts `default`, `time_descending`, or `like_count_descending`.
274
+ - `xhs_get_note_comments_by_note_id`: use when the full `note_id` is known; do not pass only a prefix; optional `sort_type` accepts `default`, `time_descending`, or `like_count_descending`.
275
275
  - `xhs_get_note_comments_by_note_url`: use for note URLs, short links, or share text; optional `sort_type` accepts `default`, `time_descending`, or `like_count_descending`.
276
- - `xhs_get_note_sub_comments_by_comment_id`: use when the complete 24-character lowercase hexadecimal `note_id` and first-level comment ID are known; do not pass only a note ID prefix.
276
+ - `xhs_get_note_sub_comments_by_comment_id`: use when the full `note_id` and first-level comment ID are known; do not pass only a note ID prefix.
277
277
  - `douyin_get_video_comments_by_aweme_id`: use when the aweme_id is known.
278
278
  - `douyin_get_video_comments_by_url`: use for Douyin content page URLs, short links, or share text; do not pass playback URLs such as `video.play_url`.
279
279
  - `douyin_get_video_comment_replies_by_comment_id`: use when both aweme_id and first-level comment ID are known; use page_token to continue pagination.
280
280
 
281
- Comment pagination uses opaque `page_token` values. Pass the complete returned `next_page_token` back unchanged for the same content item or comment chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses. Prefer CLI `--pages` and `--all` for multiple comment pages; use `--include-replies` only on XHS, Douyin, Kuaishou, Weibo, and WeChat Channels / 视频号 when the user asks for a full first-level plus second-level comment tree.
282
- For Douyin comments and replies, continue only when `next_page_token` is non-empty; an empty string means there are no more comments or replies to request.
283
- XHS reply pagination also uses `page_token` and is bound to the current comment.
281
+ - Comment pagination uses opaque `page_token` values. Pass the complete returned `next_page_token` back unchanged for the same content item or comment chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses. Prefer CLI `--pages` and `--all` for multiple comment pages; use `--include-replies` only on XHS, Douyin, Kuaishou, Weibo, and WeChat Channels / 视频号 when the user asks for a full first-level plus second-level comment tree.
282
+ - For Douyin comments and replies, continue only when `next_page_token` is non-empty; an empty string means there are no more comments or replies to request.
283
+ - XHS reply pagination also uses `page_token` and is bound to the current comment.
284
284
  - `kuaishou_get_video_comments_by_photo_id`: use when the photo_id is known.
285
285
  - `kuaishou_get_video_comments_by_url`: use for Kuaishou work page URLs, short links, or share text.
286
286
  - `kuaishou_get_video_comment_replies_by_comment_id`: use when the photo_id and first-level comment ID are known.
287
- For Kuaishou comments and replies, continue only when `next_page_token` is non-empty; an empty string means there are no more comments or replies to request.
287
+ - For Kuaishou comments and replies, continue only when `next_page_token` is non-empty; an empty string means there are no more comments or replies to request.
288
288
  - `bilibili_get_content_comments_by_id`: use when the Bilibili content_id is known; optional `sort_type` accepts `hot` or `time_descending`.
289
289
  - `bilibili_get_content_comments_by_url`: use for Bilibili video, article, dynamic, short link, or share text; optional `sort_type` accepts `hot` or `time_descending`.
290
290
  - `bilibili_get_content_comment_replies_by_comment_id`: use when comment_object_id, comment_object_type, and first-level comment ID are known.
@@ -303,11 +303,11 @@ For Kuaishou comments and replies, continue only when `next_page_token` is non-e
303
303
  - `weibo_get_post_comments_by_post_id`: use when the post_id is known.
304
304
  - `weibo_get_post_comments_by_post_url`: use for Weibo post URLs, short links, or share text.
305
305
  - `weibo_get_post_comment_replies_by_comment_id`: use when the post_id and first-level comment ID are known.
306
- For Weibo comments and replies, continue only when `next_page_token` is non-empty; an empty string means there are no more comments or replies to request.
306
+ - For Weibo comments and replies, continue only when `next_page_token` is non-empty; an empty string means there are no more comments or replies to request.
307
307
  - `wechat_get_video_comments_by_object_id`: use when both object_id and object_nonce_id are known.
308
308
  - `wechat_get_video_comments_by_url`: use for WeChat Channels / 视频号 video links or share text.
309
309
  - `wechat_get_video_comment_replies_by_comment_id`: use when object_id, object_nonce_id, and first-level comment ID are known.
310
- For WeChat Channels / 视频号 comments and replies, continue only when `next_page_token` is non-empty; an empty string means there are no more comments or replies to request.
310
+ - For WeChat Channels / 视频号 comments and replies, continue only when `next_page_token` is non-empty; an empty string means there are no more comments or replies to request.
311
311
 
312
312
  ## Output Guidance
313
313
 
@@ -38,7 +38,7 @@ Current platform support:
38
38
  - YouTube videos through `youtube_get_video_detail_by_url`.
39
39
  - TikTok videos and image posts through `tiktok_get_post_detail_by_url`.
40
40
  - Weibo / 微博 posts through the `weibo_get_post_detail_by_*` tools.
41
- - WeChat Channels / 视频号 videos through the `wechat_get_video_detail_by_*` tools.
41
+ - WeChat Channels / 视频号 video and image-post details through the `wechat_get_video_detail_by_*` tools.
42
42
  - WeChat Official Account / 微信公众号 articles through `wechat_get_mp_article_detail_by_url`.
43
43
 
44
44
  ## API Key
@@ -124,7 +124,7 @@ npx -y socialdatax-skills@latest wechat detail \
124
124
  --source-client socialdatax-skills --source-platform npm --source-skill media-detail
125
125
 
126
126
  npx -y socialdatax-skills@latest wechat detail \
127
- --url "<wechat_video_url_or_share_text>" --pretty --source-client socialdatax-skills \
127
+ --url "<wechat_work_url_or_share_text>" --pretty --source-client socialdatax-skills \
128
128
  --source-platform npm --source-skill media-detail
129
129
 
130
130
  npx -y socialdatax-skills@latest wechat article \
@@ -134,7 +134,7 @@ npx -y socialdatax-skills@latest wechat article \
134
134
 
135
135
  Optional arguments:
136
136
 
137
- - XHS `--note-id <note_id>`: use the complete 24-character lowercase hexadecimal `note_id` returned from search, comments, creator note lists, or a previous detail result; do not pass only a prefix.
137
+ - XHS `--note-id <note_id>`: use the entire `note_id` returned from search, comments, creator note lists, or a previous detail result; do not pass only a prefix.
138
138
  - XHS `--url <note_url_or_share_text>`: use for a note link, short link, or share text.
139
139
  - Douyin `--aweme-id <aweme_id>`: preferred when the Douyin work ID is already known.
140
140
  - Douyin `--url <douyin_content_url_or_share_text>`: use for a Douyin content page URL, short link, or share text; do not pass `video.play_url`.
@@ -153,7 +153,7 @@ Optional arguments:
153
153
  - Weibo `--post-id <post_id>`: preferred when the Weibo post ID is already known.
154
154
  - Weibo `--post-url <weibo_post_url_or_share_text>`: use for a Weibo post URL, short link, or share text.
155
155
  - WeChat Channels / 视频号 `--encrypted-object-id <encrypted_object_id>`: use when the encrypted_object_id from search is already known.
156
- - WeChat Channels / 视频号 `--url <wechat_video_url_or_share_text>`: use for a WeChat Channels video link or share text.
156
+ - WeChat Channels / 视频号 `--url <wechat_work_url_or_share_text>`: use for a WeChat Channels video or image-post link or share text.
157
157
  - WeChat Official Account / 微信公众号 `article --url <mp_article_url_or_share_text>`: use for an mp.weixin.qq.com article link or share text.
158
158
  - `--source-client socialdatax-skills --source-platform npm --source-skill media-detail`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.
159
159
 
@@ -191,7 +191,7 @@ MCP tools matching the direct CLI commands above:
191
191
  - `wechat_get_mp_article_detail_by_url`
192
192
 
193
193
  If MCP tools are already available in the current agent, use one of these tools:
194
- - `xhs_get_note_detail_by_note_id`: use when the complete 24-character lowercase hexadecimal `note_id` is already known; do not pass only a prefix.
194
+ - `xhs_get_note_detail_by_note_id`: use when the full `note_id` is already known; do not pass only a prefix.
195
195
  - `xhs_get_note_detail_by_note_url`: use for note URLs, short links, or share text.
196
196
  - `douyin_get_video_detail_by_aweme_id`: use when an aweme_id is already known.
197
197
  - `douyin_get_video_detail_by_url`: use for Douyin content page URLs, short links, or share text; do not pass playback URLs such as `video.play_url`.
@@ -209,14 +209,14 @@ If MCP tools are already available in the current agent, use one of these tools:
209
209
  - `weibo_get_post_detail_by_post_id`: use when a post_id is already known.
210
210
  - `weibo_get_post_detail_by_post_url`: use for Weibo post URLs, short links, or share text.
211
211
  - `wechat_get_video_detail_by_encrypted_object_id`: use when encrypted_object_id from search is already known.
212
- - `wechat_get_video_detail_by_url`: use for WeChat Channels / 视频号 video links or share text.
212
+ - `wechat_get_video_detail_by_url`: use for a WeChat Channels / 视频号 video or image-post link or share text.
213
213
  - `wechat_get_mp_article_detail_by_url`: use for WeChat Official Account / 微信公众号 article links or share text.
214
214
 
215
215
  ## Output Guidance
216
216
 
217
217
  Return factual fields such as title or description, content, author, publish time, interaction counts, images, and media summary when available.
218
218
  For XHS detail results, in every use of a returned `note_url`, such as final answers, display, references, storage, output, or forwarding, preserve it exactly as the full URL, including `xsec_token` query parameters. Do not modify, truncate, redact, mask, normalize, rebuild, or synthesize the URL from `note_id`; if `note_url` is null, show the `note_id` or say that no directly openable full link is available.
219
- For XHS `note_id`, copy the complete 24-character lowercase hexadecimal ID exactly; do not pass or display only a prefix.
219
+ For XHS `note_id`, copy the entire returned `note_id` exactly; do not pass or display only a prefix.
220
220
  When the user wants to save XHS images or videos after detail, pass each returned `image_items[].image_url`, `image_items[].live_photo.video_url`, or `video.video_url` to `npx -y socialdatax-skills@latest xhs download-media --url "<media_url>" --output-dir <directory> --pretty`; this local save command does not require `SOCIALDATAX_API_KEY`.
221
221
  For Douyin detail, include `content_type` when available.
222
222
  For Douyin detail, use `images` for image/text posts; `video` is the platform player resource and may be audio for image/text posts; `music` is the bound music or original-sound asset.
@@ -344,7 +344,7 @@ XHS search parameter naming reminder: direct CLI uses `--sort-type`, `--publish-
344
344
 
345
345
  Summarize visible evidence separately from interpretation. Include useful content IDs, URLs, titles or descriptions, authors, counts, and publish time when the user needs traceability.
346
346
  For XHS search results, in every use of a returned `note_url`, such as final answers, display, references, storage, output, or forwarding, preserve it exactly as the full URL, including `xsec_token` query parameters. Do not modify, truncate, redact, mask, normalize, rebuild, or synthesize the URL from `note_id`.
347
- For XHS `note_id`, copy the complete 24-character lowercase hexadecimal ID exactly; do not pass or display only a prefix.
347
+ For XHS `note_id`, copy the entire returned `note_id` exactly; do not pass or display only a prefix.
348
348
  For Douyin search results, include `content_type` when the user needs traceability.
349
349
  For Douyin image/text search results, use returned `images` and treat `video.media_type="audio"` as an audio player resource rather than a video post.
350
350
  For Kuaishou search results, include `photo_id`, `share_url`, author facts, and visible interaction counts when the user needs traceability.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: "media-transcript"
3
- 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."
3
+ 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; Bilibili, Zhihu, Instagram, X / Twitter, TikTok, and YouTube through hosted MCP tools."
4
4
  source_client: "socialdatax-skills"
5
5
  source_platform: "npm"
6
6
  source_skill: "media-transcript"
@@ -24,7 +24,7 @@ metadata:
24
24
 
25
25
  # Media Transcript
26
26
 
27
- Use this skill when the user wants video speech-to-text, 口播转文字, transcript extraction, spoken-word extraction, or to check an existing transcript job for supported social media content.
27
+ Use this skill when the user wants video speech-to-text, 口播转文字, transcript extraction, spoken-word extraction, or to check an existing transcript job for supported social media content. TikTok video speech-to-text transcript jobs are available through hosted TikTok MCP tools; use a video URL or numeric `aweme_id`, or query an existing valid `job_id` directly. X / Twitter transcript jobs are available through hosted X MCP tools; use a post URL or numeric `post_id`, or query an existing valid `job_id` directly. YouTube transcript jobs are available through hosted YouTube MCP tools; use a video URL or 11-character `video_id`, or query an existing valid `job_id` directly. Zhihu / 知乎 independent-video and video-answer transcript jobs are available through hosted Zhihu MCP tools; use a `/zvideo/{zvideo_id}` or `/question/{question_id}/answer/{answer_id}` URL, use numeric `zvideo_id` only for independent videos, or query an existing valid `job_id` directly.
28
28
 
29
29
  Current platform support:
30
30
 
@@ -33,6 +33,12 @@ Current platform support:
33
33
  - Kuaishou / 快手 video work speech-to-text transcript jobs through the `kuaishou_*video_speech_text*` tools.
34
34
  - Weibo / 微博 video post speech-to-text transcript jobs through the `weibo_*video_speech_text*` tools.
35
35
  - WeChat Channels / 视频号 video speech-to-text transcript jobs through the `wechat_*video_speech_text*` tools.
36
+ - TikTok video speech-to-text transcript jobs through hosted TikTok MCP tools; use the video URL or numeric aweme_id entrypoint, or query an existing valid job_id directly.
37
+ - Bilibili / 哔哩哔哩 / B站 single-part video speech-to-text transcript jobs through hosted `bilibili_*video_speech_text*` MCP tools; URLs with `?p=N` select one part, b23 short links follow their resolved target part, and plain Bilibili URLs and BV IDs default to P1.
38
+ - Instagram regular video posts and Reels speech-to-text transcript jobs through hosted Instagram MCP tools; photo and carousel posts are not supported.
39
+ - X / Twitter video post speech-to-text transcript jobs through hosted X MCP tools; use a post URL or numeric post_id, and only the current post's first video with an available MP4 variant is processed.
40
+ - Zhihu / 知乎 independent-video and video-answer speech-to-text transcript jobs through hosted Zhihu MCP tools; use a `/zvideo/{zvideo_id}` or `/question/{question_id}/answer/{answer_id}` URL, and use numeric zvideo_id only for independent videos. Plain answers without video are not processable.
41
+ - YouTube video speech-to-text transcript jobs through hosted YouTube MCP tools; use a video URL or 11-character video_id, or query an existing valid job_id directly.
36
42
 
37
43
  ## API Key
38
44
 
@@ -124,6 +130,7 @@ Optional arguments:
124
130
  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.
125
131
  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.
126
132
  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.
133
+ 平台边界:direct CLI 入口仅覆盖 XHS、抖音、快手、微博和视频号;Bilibili、Zhihu、Instagram、X / Twitter、TikTok、YouTube 走 hosted MCP;不要为这些平台拼接不存在的 direct CLI 命令。
127
134
 
128
135
  ## Safety Boundary
129
136
 
@@ -149,12 +156,27 @@ MCP tools matching the direct CLI commands above:
149
156
  - `wechat_submit_video_speech_text_by_encrypted_object_id`
150
157
  - `wechat_get_video_speech_text_job`
151
158
 
159
+ MCP-only tools not available through the direct CLI: `bilibili_submit_video_speech_text_by_video_url`, `bilibili_submit_video_speech_text_by_bvid`, `bilibili_get_video_speech_text_job`, `instagram_submit_video_speech_text_by_post_url`, `instagram_submit_video_speech_text_by_post_id`, `instagram_get_video_speech_text_job`, `x_submit_video_speech_text_by_post_url`, `x_submit_video_speech_text_by_post_id`, `x_get_video_speech_text_job`, `zhihu_submit_video_speech_text_by_video_url`, `zhihu_submit_video_speech_text_by_zvideo_id`, `zhihu_get_video_speech_text_job`, `tiktok_submit_video_speech_text_by_url`, `tiktok_submit_video_speech_text_by_aweme_id`, `tiktok_get_video_speech_text_job`, `youtube_submit_video_speech_text_by_url`, `youtube_submit_video_speech_text_by_video_id`, `youtube_get_video_speech_text_job`
160
+
152
161
  If MCP tools are already available in the current agent, choose the platform-specific submit tool by entrypoint:
153
162
  - XHS: `xhs_submit_video_speech_text_by_note_url`, `xhs_submit_video_speech_text_by_note_id`, `xhs_get_video_speech_text_job`.
154
163
  - Douyin: `douyin_submit_video_speech_text_by_video_url`, `douyin_submit_video_speech_text_by_aweme_id`, `douyin_get_video_speech_text_job`.
155
164
  - Kuaishou: `kuaishou_submit_video_speech_text_by_video_url`, `kuaishou_submit_video_speech_text_by_photo_id`, `kuaishou_get_video_speech_text_job`.
156
165
  - Weibo: `weibo_submit_video_speech_text_by_post_url`, `weibo_submit_video_speech_text_by_post_id`, `weibo_get_video_speech_text_job`.
157
166
  - 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`.
167
+ - Bilibili / 哔哩哔哩 / B站: `bilibili_submit_video_speech_text_by_video_url`, `bilibili_submit_video_speech_text_by_bvid`, `bilibili_get_video_speech_text_job`.
168
+ - Instagram: `instagram_submit_video_speech_text_by_post_url`, `instagram_submit_video_speech_text_by_post_id`, `instagram_get_video_speech_text_job`.
169
+ - X / Twitter: `x_submit_video_speech_text_by_post_url`, `x_submit_video_speech_text_by_post_id`, `x_get_video_speech_text_job`.
170
+ - Zhihu / 知乎: `zhihu_submit_video_speech_text_by_video_url`, `zhihu_submit_video_speech_text_by_zvideo_id`, `zhihu_get_video_speech_text_job`.
171
+ - TikTok: `tiktok_submit_video_speech_text_by_url`, `tiktok_submit_video_speech_text_by_aweme_id`, `tiktok_get_video_speech_text_job`.
172
+ - YouTube: `youtube_submit_video_speech_text_by_url`, `youtube_submit_video_speech_text_by_video_id`, `youtube_get_video_speech_text_job`.
173
+ If the user already provides a valid platform-specific `job_id`, call the matching get-job tool directly; do not submit a duplicate job just to obtain another `job_id`.
174
+ For `wechat_get_video_speech_text_job`, pass only a `job_id`; do not pass `encrypted_object_id`, `object_id`, or a content link.
175
+ For Bilibili, use the URL tool with `?p=N` to select one part; b23 short links follow their resolved target part, while plain Bilibili URLs and the BV-ID tool process P1. Pass only a `job_id` to `bilibili_get_video_speech_text_job`.
176
+ For Instagram, use the URL tool for a regular video post or Reels link and the post-ID tool for a numeric `post_id`; photo and carousel posts are unsupported. Pass only a `job_id` to `instagram_get_video_speech_text_job`.
177
+ For X / Twitter, use the URL tool for a video post link and the post-ID tool for a numeric `post_id`; only the current post's first video with an available MP4 variant is processed, not quoted or reposted post media. Pass only a `job_id` to `x_get_video_speech_text_job`.
178
+ For Zhihu, use the URL tool for an independent `/zvideo/{zvideo_id}` page or a video-answer `/question/{question_id}/answer/{answer_id}` page. The numeric `zvideo_id` tool remains independent-video only; do not pass an answer ID or temporary `video.play_url`. Plain answers without video return no processable media. Pass only a `job_id` to `zhihu_get_video_speech_text_job`.
179
+ For YouTube, use the URL tool for a video, youtu.be, or Shorts link and the video-ID tool for an 11-character `video_id`. Pass only a `job_id` to `youtube_get_video_speech_text_job`.
158
180
  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`.
159
181
 
160
182
  ## Output Guidance
@@ -1,7 +1,7 @@
1
1
  interface:
2
2
  display_name: "Media Transcript"
3
3
  short_description: "Submit video transcripts"
4
- default_prompt: "Use $media-transcript to submit and check video speech-to-text transcript jobs for XHS, Douyin, Kuaishou, Weibo, and WeChat Channels content."
4
+ default_prompt: "Use $media-transcript to submit and check video speech-to-text transcript jobs for XHS, Douyin, Kuaishou, Weibo, WeChat Channels, Bilibili, Zhihu, Instagram, X / Twitter, TikTok, or YouTube content; route Bilibili, Zhihu, Instagram, X / Twitter, TikTok, and YouTube through hosted MCP tools."
5
5
 
6
6
  policy:
7
7
  allow_implicit_invocation: true
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: "media-user-info"
3
- description: "Retrieve social media creator profile information from platform user IDs, usernames, channel URLs, profile URLs, short links, or share text. This version is backed by hosted platform MCP services and supports Xiaohongshu / XHS / RedNote, Douyin, Kuaishou, Bilibili, Zhihu, Instagram, X / Twitter, YouTube, TikTok, Weibo, and WeChat Channels creators."
3
+ description: "Retrieve social media creator profile information from platform-supported user IDs, usernames, channel URLs, profile URLs, short links, or share text. Supported input forms vary by platform. This version is backed by hosted platform MCP services and supports Xiaohongshu / XHS / RedNote, Douyin, Kuaishou, Bilibili, Zhihu, Instagram, X / Twitter, YouTube, TikTok, Weibo, and WeChat Channels creators."
4
4
  source_client: "socialdatax-skills"
5
5
  source_platform: "npm"
6
6
  source_skill: "media-user-info"
@@ -39,7 +39,7 @@ Current platform support:
39
39
  - YouTube channels through `youtube_get_channel_info_by_url`.
40
40
  - TikTok creators through the `tiktok_get_user_info_by_*` tools.
41
41
  - Weibo / 微博 creators through the `weibo_get_user_info_by_*` tools.
42
- - WeChat Channels / 视频号 creators through `wechat_get_user_info_by_url` for video links or share text, or `wechat_get_user_info_by_user_id` when a `v2_...@finder` user_id is already known.
42
+ - WeChat Channels / 视频号 creators through `wechat_get_user_info_by_url` for video or image-post links or share text, or `wechat_get_user_info_by_user_id` when a `v2_...@finder` user_id is already known.
43
43
 
44
44
  ## API Key
45
45
 
@@ -136,9 +136,8 @@ npx -y socialdatax-skills@latest weibo user-info \
136
136
  --source-platform npm --source-skill media-user-info
137
137
 
138
138
  npx -y socialdatax-skills@latest weibo user-info \
139
- --profile-url "<profile_url_or_share_text>" --pretty \
140
- --source-client socialdatax-skills --source-platform npm \
141
- --source-skill media-user-info
139
+ --profile-url "<profile_url>" --pretty --source-client socialdatax-skills \
140
+ --source-platform npm --source-skill media-user-info
142
141
 
143
142
  npx -y socialdatax-skills@latest wechat user-info \
144
143
  --user-id "<v2_finder_user_id>" --pretty --source-client socialdatax-skills \
@@ -165,7 +164,7 @@ Optional arguments:
165
164
  - YouTube `--channel-url <youtube_channel_url>`: use for a YouTube channel profile URL.
166
165
  - TikTok `--tiktok-id <tiktok_id>` or `--profile-url <profile_url_or_share_text>`: use exactly one creator profile entrypoint.
167
166
  - Weibo `--user-id <user_id>`: preferred when the creator user_id is already known.
168
- - Weibo `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text.
167
+ - Weibo `--profile-url <profile_url>`: use for a Weibo user profile URL.
169
168
  - WeChat Channels / 视频号 `--user-id <v2_finder_user_id>`: use when the creator `v2_...@finder` user_id is already known.
170
169
  - `--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.
171
170
 
@@ -193,11 +192,12 @@ MCP tools matching the direct CLI commands above:
193
192
  - WEIBO: `weibo_get_user_info_by_user_id`, `weibo_get_user_info_by_profile_url`
194
193
  - WECHAT: `wechat_get_user_info_by_user_id`
195
194
 
196
- MCP-only tools not available through the direct CLI: `wechat_get_user_info_by_url`
195
+ MCP-only tools not available through the direct CLI: `douyin_get_user_info_by_douyin_id`, `wechat_get_user_info_by_url`
197
196
 
198
197
  If MCP tools are already available in the current agent, use one of these tools:
199
198
  - `xhs_get_user_info_by_user_id`: preferred when `user_id` is already known from search, detail, comments, or creator note lists.
200
199
  - `xhs_get_user_info_by_profile_url`: use for profile URLs, short links, or profile share text.
200
+ - `douyin_get_user_info_by_douyin_id`: use when the user provides the public Douyin account ID / 抖音号, not a nickname, search keyword, sec_user_id, or profile URL.
201
201
  - `douyin_get_user_info_by_sec_user_id`: preferred when `sec_user_id` is already known from search, detail, comments, or creator work lists.
202
202
  - `douyin_get_user_info_by_profile_url`: use for profile URLs, short links, or profile share text.
203
203
  - `kuaishou_search_users`: use when the user only has a creator keyword and needs possible Kuaishou user_id candidates. Pass `keyword`; pass `page_token` only for continuation. Do not pass `page`.
@@ -215,9 +215,9 @@ If MCP tools are already available in the current agent, use one of these tools:
215
215
  - `tiktok_get_user_info_by_tiktok_id`: use when the TikTok tiktok_id is known.
216
216
  - `tiktok_get_user_info_by_profile_url`: use for TikTok profile URLs.
217
217
  - `weibo_get_user_info_by_user_id`: preferred when `user_id` is already known.
218
- - `weibo_get_user_info_by_profile_url`: use for profile URLs, short links, or profile share text.
218
+ - `weibo_get_user_info_by_profile_url`: use for Weibo user profile URLs.
219
219
  - `wechat_get_user_info_by_user_id`: use when the WeChat Channels / 视频号 creator `v2_...@finder` user_id is already known.
220
- - `wechat_get_user_info_by_url`: use for a WeChat Channels / 视频号 video link or share text to resolve the creator profile.
220
+ - `wechat_get_user_info_by_url`: use for a WeChat Channels / 视频号 video or image-post link or share text to resolve the creator profile.
221
221
 
222
222
  ## Output Guidance
223
223
 
@@ -1,7 +1,7 @@
1
1
  interface:
2
2
  display_name: "Media User Info"
3
3
  short_description: "Retrieve creator profiles"
4
- default_prompt: "Use $media-user-info to retrieve creator profile information from supported XHS, Douyin, Kuaishou, Bilibili, Zhihu, Instagram, X / Twitter, YouTube, TikTok, Weibo, or WeChat Channels user IDs, usernames, channel URLs, profile URLs, short links, or share text."
4
+ default_prompt: "Use $media-user-info to retrieve creator profile information from platform-supported XHS, Douyin, Kuaishou, Bilibili, Zhihu, Instagram, X / Twitter, YouTube, TikTok, Weibo, or WeChat Channels user IDs, usernames, channel URLs, profile URLs, short links, or share text. Supported input forms vary by platform."
5
5
 
6
6
  policy:
7
7
  allow_implicit_invocation: true
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: "media-user-posts"
3
- description: "Retrieve social media creator content lists from platform user IDs, usernames, channel URLs, profile URLs, short links, or share text for account research and content style analysis. This version is backed by hosted platform MCP services and supports Xiaohongshu / XHS / RedNote, Douyin, Kuaishou, Bilibili, Zhihu, Instagram, X / Twitter, YouTube, TikTok, Weibo, and WeChat Channels creators."
3
+ description: "Retrieve social media creator content lists from platform-supported user IDs, usernames, channel URLs, profile URLs, short links, or share text for account research and content style analysis. Supported input forms vary by platform. This version is backed by hosted platform MCP services and supports Xiaohongshu / XHS / RedNote, Douyin, Kuaishou, Bilibili, Zhihu, Instagram, X / Twitter, YouTube, TikTok, Weibo, and WeChat Channels creators."
4
4
  source_client: "socialdatax-skills"
5
5
  source_platform: "npm"
6
6
  source_skill: "media-user-posts"
@@ -39,7 +39,7 @@ Current platform support:
39
39
  - YouTube channel videos and Shorts through `youtube_get_user_posted_videos_by_channel_url`.
40
40
  - TikTok creator posts through the `tiktok_get_user_posts_by_*` tools.
41
41
  - Weibo / 微博 creator posts through the `weibo_get_user_posts_by_*` tools.
42
- - WeChat Channels / 视频号 creator videos through the `wechat_get_user_posted_videos_by_*` tools; the user_id entrypoint requires a `v2_...@finder` user_id.
42
+ - WeChat Channels / 视频号 creator videos and image posts through the `wechat_get_user_posted_videos_by_*` tools; the user_id entrypoint requires a `v2_...@finder` user_id.
43
43
 
44
44
  ## API Key
45
45
 
@@ -201,9 +201,8 @@ npx -y socialdatax-skills@latest weibo user-posts \
201
201
  --source-platform npm --source-skill media-user-posts
202
202
 
203
203
  npx -y socialdatax-skills@latest weibo user-posts \
204
- --profile-url "<profile_url_or_share_text>" --pretty \
205
- --source-client socialdatax-skills --source-platform npm \
206
- --source-skill media-user-posts
204
+ --profile-url "<profile_url>" --pretty --source-client socialdatax-skills \
205
+ --source-platform npm --source-skill media-user-posts
207
206
 
208
207
  npx -y socialdatax-skills@latest wechat user-posts \
209
208
  --user-id "<v2_finder_user_id>" --pretty --source-client socialdatax-skills \
@@ -214,7 +213,7 @@ npx -y socialdatax-skills@latest wechat user-posts \
214
213
  --source-platform npm --source-skill media-user-posts
215
214
 
216
215
  npx -y socialdatax-skills@latest wechat user-posts \
217
- --url "<wechat_video_url_or_share_text>" --pretty --source-client socialdatax-skills \
216
+ --url "<wechat_work_url_or_share_text>" --pretty --source-client socialdatax-skills \
218
217
  --source-platform npm --source-skill media-user-posts
219
218
  ```
220
219
 
@@ -242,9 +241,9 @@ Optional arguments:
242
241
  - YouTube `user-posts --video-type <video|short>`: optional channel video-list filter; omit it for default channel videos.
243
242
  - TikTok `--tiktok-id <tiktok_id>` or `--profile-url <profile_url_or_share_text>`: use exactly one creator post-list entrypoint.
244
243
  - Weibo `--user-id <user_id>`: preferred when the creator user_id is already known.
245
- - Weibo `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text.
244
+ - Weibo `--profile-url <profile_url>`: use for a Weibo user profile URL.
246
245
  - WeChat Channels / 视频号 `--user-id <v2_finder_user_id>`: preferred when the creator `v2_...@finder` user_id is already known.
247
- - 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.
246
+ - WeChat Channels / 视频号 `--url <wechat_work_url_or_share_text>`: use a video or image-post link or share text to resolve the author and list that creator's videos and image posts.
248
247
  - `--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.
249
248
 
250
249
  Use either the ID option or the profile URL option for a single command, not both.
@@ -293,17 +292,17 @@ Kuaishou creator work pagination uses opaque `page_token` values; pass the compl
293
292
  - `youtube_get_user_posted_videos_by_channel_url`: use for YouTube channel videos and Shorts; optional `video_type` accepts `video` or `short`.
294
293
  - `tiktok_get_user_posts_by_tiktok_id` and `tiktok_get_user_posts_by_profile_url`: use for TikTok creator post lists.
295
294
  - `weibo_get_user_posts_by_user_id`: preferred when `user_id` is already known.
296
- - `weibo_get_user_posts_by_profile_url`: use for profile URLs, short links, or profile share text.
295
+ - `weibo_get_user_posts_by_profile_url`: use for Weibo user profile URLs.
297
296
  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.
298
297
  - `wechat_get_user_posted_videos_by_user_id`: preferred when the WeChat Channels / 视频号 `v2_...@finder` user_id is already known.
299
- - `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.
300
- 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.
298
+ - `wechat_get_user_posted_videos_by_url`: use a WeChat Channels / 视频号 video or image-post link or share text to resolve the author and list that creator's videos and image posts.
299
+ WeChat Channels / 视频号 creator work 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.
301
300
  `--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.
302
301
 
303
302
  ## Output Guidance
304
303
 
305
304
  Summarize content-list evidence by title or description, summary, publish time, interaction counts, media links, and content type when present.
306
- For XHS creator note-list results, copy each returned `note_id` as the complete 24-character lowercase hexadecimal ID exactly; do not pass or display only a prefix.
305
+ For XHS creator note-list results, copy each returned `note_id` exactly; do not pass or display only a prefix.
307
306
  For Douyin image/text posts, use `image_urls` rather than assuming a video playback URL exists.
308
307
  For Douyin short-drama series, report series IDs, titles, descriptions, covers, prices, and author facts when present.
309
308
  Use returned content IDs to chain into detail or comment analysis when needed.
@@ -311,7 +310,7 @@ For Bilibili creator lists, keep videos, articles, and dynamics separate when mo
311
310
  For YouTube creator lists, distinguish regular videos and Shorts when the returned data provides that signal.
312
311
  For Zhihu, Instagram, X / Twitter, and TikTok creator lists, preserve returned public content IDs and URLs for follow-up detail or comment analysis.
313
312
  For Weibo creator posts, report post IDs, content, media, publish time, interaction counts, and author facts when present.
314
- For WeChat Channels / 视频号 creator videos, report object IDs, descriptions, media, publish time, interaction counts, and author facts when present.
313
+ For WeChat Channels / 视频号 creator works, report object IDs, descriptions, media, publish time, interaction counts, and author facts when present.
315
314
 
316
315
  ## Troubleshooting
317
316
 
@@ -1,7 +1,7 @@
1
1
  interface:
2
2
  display_name: "Media User Posts"
3
3
  short_description: "Retrieve creator content"
4
- default_prompt: "Use $media-user-posts to retrieve supported XHS, Douyin, Kuaishou, Bilibili, Zhihu, Instagram, X / Twitter, YouTube, TikTok, Weibo, or WeChat Channels creator content lists from a platform user ID, username, channel URL, profile URL, short link, or share text."
4
+ default_prompt: "Use $media-user-posts to retrieve supported XHS, Douyin, Kuaishou, Bilibili, Zhihu, Instagram, X / Twitter, YouTube, TikTok, Weibo, or WeChat Channels creator content lists from platform-supported user IDs, usernames, channel URLs, profile URLs, short links, or share text. Supported input forms vary by platform."
5
5
 
6
6
  policy:
7
7
  allow_implicit_invocation: true
@@ -55,7 +55,7 @@ Current platform support:
55
55
  - YouTube videos through `youtube_get_video_detail_by_url`.
56
56
  - TikTok videos and image posts through `tiktok_get_post_detail_by_url`.
57
57
  - Weibo / 微博 posts through the `weibo_get_post_detail_by_*` tools.
58
- - WeChat Channels / 视频号 videos through the `wechat_get_video_detail_by_*` tools.
58
+ - WeChat Channels / 视频号 video and image-post details through the `wechat_get_video_detail_by_*` tools.
59
59
  - WeChat Official Account / 微信公众号 articles through `wechat_get_mp_article_detail_by_url`.
60
60
  - Xiaohongshu / XHS / RedNote notes through the `xhs_get_note_comments_by_*` and `xhs_get_note_sub_comments_by_comment_id` tools.
61
61
  - Douyin / 抖音 works, including video and image/text posts, through the `douyin_get_video_comments_by_*` and `douyin_get_video_comment_replies_by_comment_id` tools.
@@ -79,7 +79,7 @@ Current platform support:
79
79
  - YouTube channels through `youtube_get_channel_info_by_url`.
80
80
  - TikTok creators through the `tiktok_get_user_info_by_*` tools.
81
81
  - Weibo / 微博 creators through the `weibo_get_user_info_by_*` tools.
82
- - WeChat Channels / 视频号 creators through `wechat_get_user_info_by_url` for video links or share text, or `wechat_get_user_info_by_user_id` when a `v2_...@finder` user_id is already known.
82
+ - WeChat Channels / 视频号 creators through `wechat_get_user_info_by_url` for video or image-post links or share text, or `wechat_get_user_info_by_user_id` when a `v2_...@finder` user_id is already known.
83
83
  - Xiaohongshu / XHS / RedNote creator notes through the `xhs_get_user_posted_notes_by_*` tools.
84
84
  - Douyin / 抖音 creator works, including video and image/text posts, through the `douyin_get_user_posted_videos_by_*` tools.
85
85
  - Douyin / 抖音 creator short-drama series through the `douyin_get_user_series_by_*` tools.
@@ -91,7 +91,7 @@ Current platform support:
91
91
  - YouTube channel videos and Shorts through `youtube_get_user_posted_videos_by_channel_url`.
92
92
  - TikTok creator posts through the `tiktok_get_user_posts_by_*` tools.
93
93
  - Weibo / 微博 creator posts through the `weibo_get_user_posts_by_*` tools.
94
- - WeChat Channels / 视频号 creator videos through the `wechat_get_user_posted_videos_by_*` tools; the user_id entrypoint requires a `v2_...@finder` user_id.
94
+ - WeChat Channels / 视频号 creator videos and image posts through the `wechat_get_user_posted_videos_by_*` tools; the user_id entrypoint requires a `v2_...@finder` user_id.
95
95
 
96
96
  ## API Key
97
97
 
@@ -248,13 +248,13 @@ npx -y socialdatax-skills@latest weibo detail --post-url "<weibo_post_url_or_sha
248
248
  npx -y socialdatax-skills@latest weibo comments --post-url "<weibo_post_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
249
249
  npx -y socialdatax-skills@latest weibo likers --post-id "<post_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
250
250
  npx -y socialdatax-skills@latest weibo reposts --post-id "<post_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
251
- npx -y socialdatax-skills@latest weibo user-info --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
252
- npx -y socialdatax-skills@latest weibo user-posts --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
251
+ npx -y socialdatax-skills@latest weibo user-info --profile-url "<profile_url>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
252
+ npx -y socialdatax-skills@latest weibo user-posts --profile-url "<profile_url>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
253
253
  npx -y socialdatax-skills@latest weibo replies --post-id "<post_id>" --comment-id "<comment_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
254
- npx -y socialdatax-skills@latest wechat detail --url "<wechat_video_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
254
+ npx -y socialdatax-skills@latest wechat detail --url "<wechat_work_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
255
255
  npx -y socialdatax-skills@latest wechat article --url "<mp_article_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
256
256
  npx -y socialdatax-skills@latest wechat comments --url "<wechat_video_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
257
- npx -y socialdatax-skills@latest wechat user-posts --url "<wechat_video_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
257
+ npx -y socialdatax-skills@latest wechat user-posts --url "<wechat_work_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
258
258
  npx -y socialdatax-skills@latest wechat replies --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --comment-id "<comment_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
259
259
  ```
260
260
 
@@ -301,7 +301,7 @@ Optional arguments:
301
301
  - Use YouTube commands for YouTube videos, comments, channel profiles, and channel video lists.
302
302
  - Use TikTok commands for TikTok videos or image posts, comments, creators, and creator posts.
303
303
  - Use Weibo commands for Weibo / 微博 posts, comments, creators, creator posts, and hot topics.
304
- - Use WeChat Channels / 视频号 commands for videos, comments, creators, creator videos, and hot topics; use `wechat article` only for WeChat Official Account / 微信公众号 article links/details.
304
+ - Use WeChat Channels / 视频号 commands for videos, comments, creators, creator works, and hot topics; use `wechat article` only for WeChat Official Account / 微信公众号 article links/details.
305
305
  - If the user asks for both platforms, keep findings separated by platform before comparing patterns.
306
306
 
307
307
  ## Choose The Narrowest Entry
@@ -328,7 +328,7 @@ MCP tools matching the direct CLI commands above:
328
328
  - WEIBO: `weibo_get_hot_search_list`, `weibo_search_posts`, `weibo_get_post_detail_by_post_id`, `weibo_get_post_comments_by_post_id`, `weibo_get_user_info_by_user_id`, `weibo_get_user_posts_by_user_id`, `weibo_get_post_detail_by_post_url`, `weibo_get_post_comments_by_post_url`, `weibo_get_post_liker_list_by_post_id`, `weibo_get_post_repost_list_by_post_id`, `weibo_get_user_info_by_profile_url`, `weibo_get_user_posts_by_profile_url`, `weibo_get_post_comment_replies_by_comment_id`
329
329
  - WECHAT: `wechat_get_hot_search_list`, `wechat_search_videos`, `wechat_get_video_detail_by_encrypted_object_id`, `wechat_get_video_comments_by_object_id`, `wechat_get_user_info_by_user_id`, `wechat_get_user_posted_videos_by_user_id`, `wechat_get_video_detail_by_url`, `wechat_get_mp_article_detail_by_url`, `wechat_get_video_comments_by_url`, `wechat_get_user_posted_videos_by_url`, `wechat_get_video_comment_replies_by_comment_id`
330
330
 
331
- MCP-only tools not available through the direct CLI: `weibo_get_post_liker_list_by_post_url`, `weibo_get_post_repost_list_by_post_url`, `wechat_get_user_info_by_url`
331
+ MCP-only tools not available through the direct CLI: `douyin_search_users`, `douyin_get_user_info_by_douyin_id`, `weibo_get_post_liker_list_by_post_url`, `weibo_get_post_repost_list_by_post_url`, `wechat_get_user_info_by_url`
332
332
 
333
333
  Use the automatically listed MCP tools above as the source of truth for tool names. Pick the narrowest tool for the user's platform and task. For search pagination, omit `page_token` on the first request and pass only the complete returned `next_page_token` when continuing the same chain.
334
334
 
@@ -338,9 +338,9 @@ XHS search parameter naming reminder: direct CLI uses `--sort-type`, `--publish-
338
338
 
339
339
  For broad research, summarize visible evidence separately from interpretation and organize findings by platform, content angles, audience needs, trend signals, comment themes, creator positioning, and practical next steps.
340
340
  For XHS search or detail results, in every use of a returned `note_url`, such as final answers, display, references, storage, output, or forwarding, preserve it exactly as the full URL, including `xsec_token` query parameters. Do not modify, truncate, redact, mask, normalize, rebuild, or synthesize the URL from `note_id`; if detail `note_url` is null, show the `note_id` or say that no directly openable full link is available.
341
- For XHS `note_id`, copy the complete 24-character lowercase hexadecimal ID exactly; do not pass or display only a prefix.
341
+ For XHS `note_id`, copy the entire returned `note_id` exactly; do not pass or display only a prefix.
342
342
  For comments, group observed themes before inferring sentiment or demand.
343
- For creators, separate profile facts from content-list evidence; include Douyin short-drama series facts when the series command is used, Kuaishou work-list evidence when Kuaishou commands are used, Bilibili video/article/dynamic evidence when Bilibili creator commands are used, YouTube channel video-list evidence when YouTube commands are used, Weibo post-list evidence when Weibo commands are used, and 视频号 video-list evidence when WeChat Channels commands are used.
343
+ For creators, separate profile facts from content-list evidence; include Douyin short-drama series facts when the series command is used, Kuaishou work-list evidence when Kuaishou commands are used, Bilibili video/article/dynamic evidence when Bilibili creator commands are used, YouTube channel video-list evidence when YouTube commands are used, Weibo post-list evidence when Weibo commands are used, and WeChat Channels work-list evidence when WeChat Channels commands are used.
344
344
  For hot-search, report ranking signals separately from keyword search results.
345
345
 
346
346
  ## Troubleshooting