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 +20 -19
- package/README.md +48 -25
- package/cli.mjs +64 -24
- package/package.json +1 -1
- package/skills/media-comments/SKILL.md +11 -11
- package/skills/media-detail/SKILL.md +7 -7
- package/skills/media-search/SKILL.md +1 -1
- package/skills/media-transcript/SKILL.md +24 -2
- package/skills/media-transcript/agents/openai.yaml +1 -1
- package/skills/media-user-info/SKILL.md +9 -9
- package/skills/media-user-info/agents/openai.yaml +1 -1
- package/skills/media-user-posts/SKILL.md +12 -13
- package/skills/media-user-posts/agents/openai.yaml +1 -1
- package/skills/socialdatax-content-research-assistant/SKILL.md +11 -11
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
|
|
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 |
|
|
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 |
|
|
34
|
-
| 小红书热榜选题分析 | Turn current XHS hot-list signals and related popular note samples into actionable topic ideas. | XHS hot search plus note search |
|
|
35
|
-
| 小红书爆款笔记研究 | Study high-engagement XHS note samples from a keyword, niche, product, or scenario. | XHS note search |
|
|
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 |
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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`,
|
|
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`,
|
|
90
|
-
- Hosted
|
|
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.
|
|
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 "<
|
|
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 "<
|
|
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 "<
|
|
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 "<
|
|
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
|
|
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
|
|
533
|
-
- Fetch paginated creator post lists from a
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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` |
|
|
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
|
|
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` |
|
|
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
|
|
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.
|
|
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
|
|
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
|
|
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
|
-
|
|
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:
|
|
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:
|
|
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
|
-
|
|
1387
|
-
|
|
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
|
|
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 "<
|
|
3004
|
-
console.log(" Call the Weibo creator profile tool from a profile
|
|
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 "<
|
|
3010
|
-
console.log(" Call the Weibo creator posts tool from a profile
|
|
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 "<
|
|
3028
|
-
console.log(" Call the WeChat Channels / 视频号
|
|
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 "<
|
|
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("
|
|
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
|
@@ -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
|
|
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
|
-
-
|
|
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
|
|
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
|
|
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
|
|
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 / 视频号
|
|
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 "<
|
|
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
|
|
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 <
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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,
|
|
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 "<
|
|
140
|
-
--source-
|
|
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 <
|
|
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
|
|
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 "<
|
|
205
|
-
--source-
|
|
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 "<
|
|
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 <
|
|
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 <
|
|
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
|
|
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
|
|
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`
|
|
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
|
|
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
|
|
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 / 视频号
|
|
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 "<
|
|
252
|
-
npx -y socialdatax-skills@latest weibo user-posts --profile-url "<
|
|
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 "<
|
|
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 "<
|
|
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
|
|
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
|
|
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
|
|
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
|