socialdatax-skills 0.2.9 → 0.2.10
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/README.md +25 -1
- package/cli.mjs +81 -1
- package/package.json +5 -1
- package/skills/media-comments/agents/openai.yaml +1 -1
- package/skills/media-detail/agents/openai.yaml +1 -1
- package/skills/media-search/agents/openai.yaml +1 -1
- package/skills/media-transcript/SKILL.md +83 -0
- package/skills/media-transcript/agents/openai.yaml +7 -0
- package/skills/media-user-info/agents/openai.yaml +1 -1
- package/skills/media-user-posts/agents/openai.yaml +1 -1
- package/skills/socialdatax-content-research-assistant/SKILL.md +4 -2
- package/skills/socialdatax-content-research-assistant/agents/openai.yaml +2 -2
package/README.md
CHANGED
|
@@ -21,6 +21,9 @@ Common search phrases for this skill package:
|
|
|
21
21
|
- `Hermes Agent social media skills`
|
|
22
22
|
- `media search skill`
|
|
23
23
|
- `media comments skill`
|
|
24
|
+
- `media transcript skill`
|
|
25
|
+
- `speech-to-text transcript skill`
|
|
26
|
+
- `口播转文字 skill`
|
|
24
27
|
- `creator profile skill`
|
|
25
28
|
- `Xiaohongshu skills`
|
|
26
29
|
- `XHS skills`
|
|
@@ -58,7 +61,7 @@ Common search phrases for this skill package:
|
|
|
58
61
|
- WeChat Channels current platform MCP registry name: `com.52choujiang/wechat-channels-insights`
|
|
59
62
|
- WeChat Channels future platform MCP registry name: `com.socialdatax/wechat-channels-insights`
|
|
60
63
|
- Unified MCP registry name: none; this package installs skills and calls explicit platform services.
|
|
61
|
-
- Current public capability version: `0.2.
|
|
64
|
+
- Current public capability version: `0.2.10`
|
|
62
65
|
|
|
63
66
|
## Direct CLI
|
|
64
67
|
|
|
@@ -107,6 +110,8 @@ npx -y socialdatax-skills@latest weibo comments --post-id "<post_id>" --pretty
|
|
|
107
110
|
npx -y socialdatax-skills@latest weibo comments --post-id "<post_id>" --all --include-replies --pretty
|
|
108
111
|
npx -y socialdatax-skills@latest weibo comments --post-url "<weibo_post_url_or_share_text>" --pretty
|
|
109
112
|
npx -y socialdatax-skills@latest weibo replies --post-id "<post_id>" --comment-id "<comment_id>" --pretty
|
|
113
|
+
npx -y socialdatax-skills@latest weibo likers --post-id "<post_id>" --pretty
|
|
114
|
+
npx -y socialdatax-skills@latest weibo reposts --post-id "<post_id>" --pretty
|
|
110
115
|
npx -y socialdatax-skills@latest weibo user-info --user-id "<user_id>" --pretty
|
|
111
116
|
npx -y socialdatax-skills@latest weibo user-info --profile-url "<profile_url_or_share_text>" --pretty
|
|
112
117
|
npx -y socialdatax-skills@latest weibo user-posts --user-id "<user_id>" --pretty
|
|
@@ -218,6 +223,7 @@ npx -y socialdatax-skills@latest install media-search --target openclaw
|
|
|
218
223
|
npx -y socialdatax-skills@latest install media-search --target openclaw --dry-run
|
|
219
224
|
npx -y socialdatax-skills@latest install media-user-info --target openclaw
|
|
220
225
|
npx -y socialdatax-skills@latest install media-comments media-detail --target openclaw
|
|
226
|
+
npx -y socialdatax-skills@latest install media-transcript --target openclaw
|
|
221
227
|
npx -y socialdatax-skills@latest install media-search --target openclaw --scope workspace
|
|
222
228
|
npx -y socialdatax-skills@latest install media-search --target hermes
|
|
223
229
|
npx -y socialdatax-skills@latest install media-search --target hermes --scope shared
|
|
@@ -245,6 +251,7 @@ Available skills:
|
|
|
245
251
|
- `media-search`: search social media content by keyword; supports XHS notes, Douyin works, Kuaishou works, Weibo posts, and WeChat Channels videos.
|
|
246
252
|
- `media-detail`: read structured content details and metrics; supports XHS notes, Douyin works, Kuaishou works, Weibo posts, and WeChat Channels videos.
|
|
247
253
|
- `media-comments`: fetch and analyze XHS comments/replies, Douyin comments/replies, Kuaishou comments/replies, Weibo comments/replies, and WeChat Channels comments/replies.
|
|
254
|
+
- `media-transcript`: submit and check video 口播转文字 / speech-to-text transcript jobs through hosted MCP tools; supports XHS, Douyin, Kuaishou, Weibo, and WeChat Channels.
|
|
248
255
|
- `media-user-info`: retrieve creator profile information; supports XHS, Douyin, Kuaishou, Weibo, and WeChat Channels creators.
|
|
249
256
|
- `media-user-posts`: retrieve creator content lists; supports XHS notes, Douyin works, Kuaishou works, Weibo posts, WeChat Channels videos, and Douyin creator short-drama series.
|
|
250
257
|
|
|
@@ -313,6 +320,7 @@ Current Weibo workflows include:
|
|
|
313
320
|
- Continue Weibo list pagination only when `next_page_token` is non-empty; an empty string means there are no more results to request.
|
|
314
321
|
- Read creator profile data from a profile link, short link, share text, or user_id.
|
|
315
322
|
- Fetch paginated creator post lists from a user_id, profile link, short link, or share text.
|
|
323
|
+
- Submit and check Weibo video 口播转文字 / speech-to-text transcript jobs; submit tools 提交完成后最多短等 15 秒.
|
|
316
324
|
|
|
317
325
|
Current WeChat Channels / 视频号 workflows include:
|
|
318
326
|
|
|
@@ -324,6 +332,7 @@ Current WeChat Channels / 视频号 workflows include:
|
|
|
324
332
|
- Continue WeChat Channels list pagination only when `next_page_token` is non-empty; an empty string means there are no more results to request.
|
|
325
333
|
- Read creator profile data from a finder user_id.
|
|
326
334
|
- Fetch paginated creator video lists from a finder user_id or a video link/share text.
|
|
335
|
+
- Submit and check WeChat Channels / 视频号 video 口播转文字 / speech-to-text transcript jobs; submit tools 提交完成后最多短等 15 秒.
|
|
327
336
|
|
|
328
337
|
## XHS Tools
|
|
329
338
|
|
|
@@ -340,6 +349,9 @@ Current WeChat Channels / 视频号 workflows include:
|
|
|
340
349
|
| `xhs_get_user_info_by_profile_url` | Resolve a profile link, short link, or share text into creator profile data. |
|
|
341
350
|
| `xhs_get_user_posted_notes_by_user_id` | Fetch a paginated list of notes published by a creator when the caller already has a user ID. |
|
|
342
351
|
| `xhs_get_user_posted_notes_by_profile_url` | Fetch a paginated list of notes published by a creator from a profile link, short link, or share text. |
|
|
352
|
+
| `xhs_submit_video_speech_text_by_note_url` | Submit an XHS video note speech-to-text transcript job from a note link, short link, or share text; submit waits up to 15 seconds. |
|
|
353
|
+
| `xhs_submit_video_speech_text_by_note_id` | Submit an XHS video note speech-to-text transcript job when the caller already has a note ID; submit waits up to 15 seconds. |
|
|
354
|
+
| `xhs_get_video_speech_text_job` | Check an XHS speech-to-text transcript job by job_id without creating a new task. |
|
|
343
355
|
|
|
344
356
|
## Douyin Tools
|
|
345
357
|
|
|
@@ -358,6 +370,9 @@ Current WeChat Channels / 视频号 workflows include:
|
|
|
358
370
|
| `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. |
|
|
359
371
|
| `douyin_get_user_series_by_sec_user_id` | Fetch a paginated list of short-drama series by a creator when the caller already has a sec_user_id. |
|
|
360
372
|
| `douyin_get_user_series_by_profile_url` | Fetch a paginated list of short-drama series by a creator from a profile link, short link, or share text. |
|
|
373
|
+
| `douyin_submit_video_speech_text_by_video_url` | Submit a Douyin video speech-to-text transcript job from a content page link, short link, or share text; submit waits up to 15 seconds. |
|
|
374
|
+
| `douyin_submit_video_speech_text_by_aweme_id` | Submit a Douyin video speech-to-text transcript job when the caller already has an aweme_id; submit waits up to 15 seconds. |
|
|
375
|
+
| `douyin_get_video_speech_text_job` | Check a Douyin speech-to-text transcript job by job_id without creating a new task. |
|
|
361
376
|
|
|
362
377
|
## Kuaishou Tools
|
|
363
378
|
|
|
@@ -374,6 +389,9 @@ Current WeChat Channels / 视频号 workflows include:
|
|
|
374
389
|
| `kuaishou_get_user_info_by_profile_url` | Resolve a Kuaishou profile link, short link, or share text into creator profile data. |
|
|
375
390
|
| `kuaishou_get_user_posted_videos_by_user_id` | Fetch a paginated list of works published by a creator when the caller already has a user_id. |
|
|
376
391
|
| `kuaishou_get_user_posted_videos_by_profile_url` | Fetch a paginated list of works published by a creator from a profile link, short link, or share text. |
|
|
392
|
+
| `kuaishou_submit_video_speech_text_by_video_url` | Submit a Kuaishou video speech-to-text transcript job from a work page link, short link, or share text; submit waits up to 15 seconds. |
|
|
393
|
+
| `kuaishou_submit_video_speech_text_by_photo_id` | Submit a Kuaishou video speech-to-text transcript job when the caller already has a photo_id; submit waits up to 15 seconds. |
|
|
394
|
+
| `kuaishou_get_video_speech_text_job` | Check a Kuaishou speech-to-text transcript job by job_id without creating a new task. |
|
|
377
395
|
|
|
378
396
|
## Weibo Tools
|
|
379
397
|
|
|
@@ -390,6 +408,9 @@ Current WeChat Channels / 视频号 workflows include:
|
|
|
390
408
|
| `weibo_get_user_info_by_profile_url` | Resolve a Weibo profile link, short link, or share text into creator profile data. |
|
|
391
409
|
| `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. |
|
|
392
410
|
| `weibo_get_user_posts_by_profile_url` | Fetch a paginated list of posts published by a creator from a profile link, short link, or share text. |
|
|
411
|
+
| `weibo_submit_video_speech_text_by_post_url` | Submit a Weibo video speech-to-text transcript job from a post URL, short link, or share text; submit waits up to 15 seconds. |
|
|
412
|
+
| `weibo_submit_video_speech_text_by_post_id` | Submit a Weibo video speech-to-text transcript job when the caller already has a post_id; submit waits up to 15 seconds. |
|
|
413
|
+
| `weibo_get_video_speech_text_job` | Check a Weibo speech-to-text transcript job by job_id without creating a new task. |
|
|
393
414
|
|
|
394
415
|
## WeChat Channels Tools
|
|
395
416
|
|
|
@@ -405,6 +426,9 @@ Current WeChat Channels / 视频号 workflows include:
|
|
|
405
426
|
| `wechat_get_user_info_by_user_id` | Fetch creator profile data when the finder user_id is already known. |
|
|
406
427
|
| `wechat_get_user_posted_videos_by_user_id` | Fetch a paginated list of videos published by a creator when the finder user_id is already known. |
|
|
407
428
|
| `wechat_get_user_posted_videos_by_url` | Fetch a paginated list of videos published by a creator from a video link or share text. |
|
|
429
|
+
| `wechat_submit_video_speech_text_by_video_url` | Submit a WeChat Channels / 视频号 video speech-to-text transcript job from a video link or share text; submit waits up to 15 seconds. |
|
|
430
|
+
| `wechat_submit_video_speech_text_by_encrypted_object_id` | Submit a WeChat Channels / 视频号 video speech-to-text transcript job when encrypted_object_id is already known; submit waits up to 15 seconds. |
|
|
431
|
+
| `wechat_get_video_speech_text_job` | Check a WeChat Channels / 视频号 speech-to-text transcript job by job_id without creating a new task. |
|
|
408
432
|
|
|
409
433
|
## Quick Start
|
|
410
434
|
|
package/cli.mjs
CHANGED
|
@@ -7,7 +7,7 @@ import { dirname, join, resolve } from "node:path";
|
|
|
7
7
|
import { fileURLToPath } from "node:url";
|
|
8
8
|
|
|
9
9
|
const PACKAGE_NAME = "socialdatax-skills";
|
|
10
|
-
const PACKAGE_VERSION = "0.2.
|
|
10
|
+
const PACKAGE_VERSION = "0.2.10";
|
|
11
11
|
const PACKAGE_SPEC = `${PACKAGE_NAME}@latest`;
|
|
12
12
|
const LOG_PREFIX = `[${PACKAGE_NAME}]`;
|
|
13
13
|
const MIN_NODE_VERSION = "20.18.1";
|
|
@@ -40,6 +40,12 @@ const AVAILABLE_SKILLS = [
|
|
|
40
40
|
"Fetch and analyze XHS, Douyin, Kuaishou, Weibo, and WeChat Channels comments/replies.",
|
|
41
41
|
emoji: "💬",
|
|
42
42
|
},
|
|
43
|
+
{
|
|
44
|
+
name: "media-transcript",
|
|
45
|
+
summary:
|
|
46
|
+
"Submit and check video speech-to-text transcript jobs for XHS, Douyin, Kuaishou, Weibo, and WeChat Channels through hosted MCP tools.",
|
|
47
|
+
emoji: "🎙️",
|
|
48
|
+
},
|
|
43
49
|
{
|
|
44
50
|
name: "media-user-info",
|
|
45
51
|
summary:
|
|
@@ -263,6 +269,8 @@ const WEIBO_DIRECT_ACTION_OPTIONS = {
|
|
|
263
269
|
"includeReplies",
|
|
264
270
|
"pretty",
|
|
265
271
|
],
|
|
272
|
+
likers: ["postId", "pageToken", "pages", "all", "maxItems", "pretty"],
|
|
273
|
+
reposts: ["postId", "pageToken", "pages", "all", "maxItems", "pretty"],
|
|
266
274
|
"user-info": ["userId", "profileUrl", "pretty"],
|
|
267
275
|
"user-posts": ["userId", "profileUrl", "pageToken", "pages", "all", "maxItems", "pretty"],
|
|
268
276
|
};
|
|
@@ -628,6 +636,14 @@ const PLATFORMS = {
|
|
|
628
636
|
name: "weibo_get_post_comment_replies_by_comment_id",
|
|
629
637
|
description: "Fetch paginated replies under a first-level comment by post_id and comment_id.",
|
|
630
638
|
},
|
|
639
|
+
{
|
|
640
|
+
name: "weibo_get_post_liker_list_by_post_id",
|
|
641
|
+
description: "Fetch a paginated list of users who liked a Weibo post by post_id.",
|
|
642
|
+
},
|
|
643
|
+
{
|
|
644
|
+
name: "weibo_get_post_repost_list_by_post_id",
|
|
645
|
+
description: "Fetch a paginated repost list for a Weibo post by post_id.",
|
|
646
|
+
},
|
|
631
647
|
{
|
|
632
648
|
name: "weibo_get_user_info_by_user_id",
|
|
633
649
|
description: "Fetch creator profile data when the caller already has a user_id.",
|
|
@@ -644,6 +660,21 @@ const PLATFORMS = {
|
|
|
644
660
|
name: "weibo_get_user_posts_by_profile_url",
|
|
645
661
|
description: "Fetch creator posts from a profile URL, short link, or profile share text.",
|
|
646
662
|
},
|
|
663
|
+
{
|
|
664
|
+
name: "weibo_submit_video_speech_text_by_post_url",
|
|
665
|
+
description:
|
|
666
|
+
"Submit a Weibo video speech-to-text transcript task from a post URL, short link, or share text; 提交完成后最多短等 15 秒.",
|
|
667
|
+
},
|
|
668
|
+
{
|
|
669
|
+
name: "weibo_submit_video_speech_text_by_post_id",
|
|
670
|
+
description:
|
|
671
|
+
"Submit a Weibo video speech-to-text transcript task from a post_id; 提交完成后最多短等 15 秒.",
|
|
672
|
+
},
|
|
673
|
+
{
|
|
674
|
+
name: "weibo_get_video_speech_text_job",
|
|
675
|
+
description:
|
|
676
|
+
"Check a Weibo video speech-to-text transcript job by job_id without starting a new task.",
|
|
677
|
+
},
|
|
647
678
|
],
|
|
648
679
|
},
|
|
649
680
|
wechat: {
|
|
@@ -701,6 +732,21 @@ const PLATFORMS = {
|
|
|
701
732
|
name: "wechat_get_user_posted_videos_by_url",
|
|
702
733
|
description: "Fetch creator videos from a WeChat Channels / 视频号 video link or share text.",
|
|
703
734
|
},
|
|
735
|
+
{
|
|
736
|
+
name: "wechat_submit_video_speech_text_by_video_url",
|
|
737
|
+
description:
|
|
738
|
+
"Submit a WeChat Channels / 视频号 video speech-to-text transcript task from a video link or share text; 提交完成后最多短等 15 秒.",
|
|
739
|
+
},
|
|
740
|
+
{
|
|
741
|
+
name: "wechat_submit_video_speech_text_by_encrypted_object_id",
|
|
742
|
+
description:
|
|
743
|
+
"Submit a WeChat Channels / 视频号 video speech-to-text transcript task from an encrypted_object_id; 提交完成后最多短等 15 秒.",
|
|
744
|
+
},
|
|
745
|
+
{
|
|
746
|
+
name: "wechat_get_video_speech_text_job",
|
|
747
|
+
description:
|
|
748
|
+
"Check a WeChat Channels / 视频号 video speech-to-text transcript job by job_id without starting a new task.",
|
|
749
|
+
},
|
|
704
750
|
],
|
|
705
751
|
},
|
|
706
752
|
};
|
|
@@ -1520,6 +1566,12 @@ function printHelp() {
|
|
|
1520
1566
|
console.log(` npx -y ${PACKAGE_SPEC} weibo replies --post-id "<post_id>" --comment-id "<comment_id>" --pretty`);
|
|
1521
1567
|
console.log(" Call the Weibo comment replies tool directly and print JSON.");
|
|
1522
1568
|
console.log("");
|
|
1569
|
+
console.log(` npx -y ${PACKAGE_SPEC} weibo likers --post-id "<post_id>" --pretty`);
|
|
1570
|
+
console.log(" Call the Weibo post liker list tool directly and print JSON.");
|
|
1571
|
+
console.log("");
|
|
1572
|
+
console.log(` npx -y ${PACKAGE_SPEC} weibo reposts --post-id "<post_id>" --pretty`);
|
|
1573
|
+
console.log(" Call the Weibo post repost list tool directly and print JSON.");
|
|
1574
|
+
console.log("");
|
|
1523
1575
|
console.log(` npx -y ${PACKAGE_SPEC} weibo user-info --user-id "<user_id>" --pretty`);
|
|
1524
1576
|
console.log(" Call the Weibo creator profile tool directly and print JSON.");
|
|
1525
1577
|
console.log("");
|
|
@@ -2182,6 +2234,18 @@ function buildWeiboOperation(action, options) {
|
|
|
2182
2234
|
buildWeiboRepliesCall(options),
|
|
2183
2235
|
PLATFORMS.weibo
|
|
2184
2236
|
);
|
|
2237
|
+
case "likers":
|
|
2238
|
+
return buildDirectOperation(
|
|
2239
|
+
"likers",
|
|
2240
|
+
buildWeiboPostListByPostIdCall(options, "likers", "weibo_get_post_liker_list_by_post_id"),
|
|
2241
|
+
PLATFORMS.weibo
|
|
2242
|
+
);
|
|
2243
|
+
case "reposts":
|
|
2244
|
+
return buildDirectOperation(
|
|
2245
|
+
"reposts",
|
|
2246
|
+
buildWeiboPostListByPostIdCall(options, "reposts", "weibo_get_post_repost_list_by_post_id"),
|
|
2247
|
+
PLATFORMS.weibo
|
|
2248
|
+
);
|
|
2185
2249
|
case "user-info":
|
|
2186
2250
|
return buildDirectOperation(
|
|
2187
2251
|
"user-info",
|
|
@@ -2584,6 +2648,22 @@ function buildWeiboRepliesCall(options) {
|
|
|
2584
2648
|
};
|
|
2585
2649
|
}
|
|
2586
2650
|
|
|
2651
|
+
function buildWeiboPostListByPostIdCall(options, action, tool) {
|
|
2652
|
+
if (!options.postId) {
|
|
2653
|
+
throw new Error(`Missing --post-id for weibo ${action}.`);
|
|
2654
|
+
}
|
|
2655
|
+
const toolArguments = {
|
|
2656
|
+
post_id: options.postId,
|
|
2657
|
+
};
|
|
2658
|
+
if (options.pageToken) {
|
|
2659
|
+
toolArguments.page_token = options.pageToken;
|
|
2660
|
+
}
|
|
2661
|
+
return {
|
|
2662
|
+
tool,
|
|
2663
|
+
toolArguments,
|
|
2664
|
+
};
|
|
2665
|
+
}
|
|
2666
|
+
|
|
2587
2667
|
function buildWechatCommentsCall(options) {
|
|
2588
2668
|
const hasObjectInput = Boolean(options.objectId || options.objectNonceId);
|
|
2589
2669
|
const hasUrlInput = Boolean(options.url);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "socialdatax-skills",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.10",
|
|
4
4
|
"description": "SocialDataX / 社媒数据助手 skill installer and direct CLI helper for hosted platform social media MCP services.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -39,6 +39,10 @@
|
|
|
39
39
|
"social-insights",
|
|
40
40
|
"social-media",
|
|
41
41
|
"media-search",
|
|
42
|
+
"media-transcript",
|
|
43
|
+
"speech-to-text",
|
|
44
|
+
"transcript",
|
|
45
|
+
"video-transcript",
|
|
42
46
|
"content-analysis",
|
|
43
47
|
"creator-analytics",
|
|
44
48
|
"kuaishou",
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "Media Comments"
|
|
3
3
|
short_description: "Fetch social comments"
|
|
4
|
-
default_prompt: "Use $media-comments to fetch and analyze XHS
|
|
4
|
+
default_prompt: "Use $media-comments to fetch and analyze XHS, Douyin, Kuaishou, Weibo, or WeChat Channels comments and replies."
|
|
5
5
|
|
|
6
6
|
policy:
|
|
7
7
|
allow_implicit_invocation: true
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "Media Detail"
|
|
3
3
|
short_description: "Read content details"
|
|
4
|
-
default_prompt: "Use $media-detail to read structured details and metrics for supported
|
|
4
|
+
default_prompt: "Use $media-detail to read structured details and metrics for supported XHS, Douyin, Kuaishou, Weibo, or WeChat Channels content."
|
|
5
5
|
|
|
6
6
|
policy:
|
|
7
7
|
allow_implicit_invocation: true
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "Media Search"
|
|
3
3
|
short_description: "Search content by keyword"
|
|
4
|
-
default_prompt: "Use $media-search to search supported social media content by keyword
|
|
4
|
+
default_prompt: "Use $media-search to search supported social media content by keyword across XHS, Douyin, Kuaishou, Weibo, and WeChat Channels."
|
|
5
5
|
|
|
6
6
|
policy:
|
|
7
7
|
allow_implicit_invocation: true
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: "media-transcript"
|
|
3
|
+
description: "Submit and check video speech-to-text transcript / 口播转文字 jobs for XHS, Douyin, Kuaishou, Weibo, and WeChat Channels through hosted platform MCP tools."
|
|
4
|
+
metadata:
|
|
5
|
+
openclaw:
|
|
6
|
+
requires:
|
|
7
|
+
env:
|
|
8
|
+
- "SOCIALDATAX_API_KEY"
|
|
9
|
+
bins:
|
|
10
|
+
- "node"
|
|
11
|
+
- "npm"
|
|
12
|
+
primaryEnv: "SOCIALDATAX_API_KEY"
|
|
13
|
+
install:
|
|
14
|
+
- kind: "node"
|
|
15
|
+
package: "socialdatax-skills"
|
|
16
|
+
bins: []
|
|
17
|
+
emoji: "🎙️"
|
|
18
|
+
homepage: "https://socialdatax.52choujiang.com/?from=npm"
|
|
19
|
+
---
|
|
20
|
+
<!-- AUTO-GENERATED from socialdatax-skill-source. Do not edit directly; run `node scripts/generate_socialdatax_skills.mjs`. -->
|
|
21
|
+
|
|
22
|
+
# Media Transcript
|
|
23
|
+
|
|
24
|
+
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.
|
|
25
|
+
|
|
26
|
+
Current platform support:
|
|
27
|
+
|
|
28
|
+
- Xiaohongshu / XHS / RedNote video note speech-to-text transcript jobs through the `xhs_*video_speech_text*` tools.
|
|
29
|
+
- Douyin / 抖音 video work speech-to-text transcript jobs through the `douyin_*video_speech_text*` tools.
|
|
30
|
+
- Kuaishou / 快手 video work speech-to-text transcript jobs through the `kuaishou_*video_speech_text*` tools.
|
|
31
|
+
- Weibo / 微博 video post speech-to-text transcript jobs through the `weibo_*video_speech_text*` tools.
|
|
32
|
+
- WeChat Channels / 视频号 video speech-to-text transcript jobs through the `wechat_*video_speech_text*` tools.
|
|
33
|
+
|
|
34
|
+
## API Key
|
|
35
|
+
|
|
36
|
+
Use `SOCIALDATAX_API_KEY` for SocialDataX requests. The only official website for requesting or managing API access is <https://socialdatax.52choujiang.com/?from=npm>. If a user asks where to get a key, provide only this URL; do not infer alternate domains.
|
|
37
|
+
获取或管理 API Key:访问 <https://socialdatax.52choujiang.com/?from=npm>,按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`;不要引导用户使用其他域名。
|
|
38
|
+
|
|
39
|
+
Required arguments:
|
|
40
|
+
|
|
41
|
+
- Use a submit-by-URL tool when the user provides a content link, short link, or share text.
|
|
42
|
+
- Use a submit-by-ID tool only when the platform content ID is already known: XHS `note_id`, Douyin `aweme_id`, Kuaishou `photo_id`, Weibo `post_id`, or WeChat Channels / 视频号 `encrypted_object_id`.
|
|
43
|
+
- Use the matching get-job tool with `job_id` when continuing or checking an existing transcript job.
|
|
44
|
+
|
|
45
|
+
These video speech-to-text transcript / 口播转文字 workflows are MCP-only and not available through the direct CLI.
|
|
46
|
+
Submit tools may wait briefly after creating the job. If the transcript is not ready, return the `job_id` and next action instead of starting a second job.
|
|
47
|
+
|
|
48
|
+
## Safety Boundary
|
|
49
|
+
|
|
50
|
+
This skill can submit bounded analysis jobs through hosted MCP tools. It does not read local browser data, does not save API keys, and does not perform login, posting, liking, commenting, or account changes. Use hosted MCP tools only when the current agent already supports authenticated streamable HTTP MCP.
|
|
51
|
+
|
|
52
|
+
## MCP Tools
|
|
53
|
+
|
|
54
|
+
If MCP tools are already available in the current agent, choose the platform-specific submit tool by entrypoint:
|
|
55
|
+
- XHS: `xhs_submit_video_speech_text_by_note_url`, `xhs_submit_video_speech_text_by_note_id`, `xhs_get_video_speech_text_job`.
|
|
56
|
+
- Douyin: `douyin_submit_video_speech_text_by_video_url`, `douyin_submit_video_speech_text_by_aweme_id`, `douyin_get_video_speech_text_job`.
|
|
57
|
+
- Kuaishou: `kuaishou_submit_video_speech_text_by_video_url`, `kuaishou_submit_video_speech_text_by_photo_id`, `kuaishou_get_video_speech_text_job`.
|
|
58
|
+
- Weibo: `weibo_submit_video_speech_text_by_post_url`, `weibo_submit_video_speech_text_by_post_id`, `weibo_get_video_speech_text_job`.
|
|
59
|
+
- 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`.
|
|
60
|
+
Do not start a duplicate transcript job only to poll status. Use the platform get-job tool with the returned `job_id`.
|
|
61
|
+
|
|
62
|
+
MCP-only tools not available through the direct CLI:
|
|
63
|
+
|
|
64
|
+
- `xhs_submit_video_speech_text_by_note_url`
|
|
65
|
+
- `xhs_submit_video_speech_text_by_note_id`
|
|
66
|
+
- `xhs_get_video_speech_text_job`
|
|
67
|
+
- `douyin_submit_video_speech_text_by_video_url`
|
|
68
|
+
- `douyin_submit_video_speech_text_by_aweme_id`
|
|
69
|
+
- `douyin_get_video_speech_text_job`
|
|
70
|
+
- `kuaishou_submit_video_speech_text_by_video_url`
|
|
71
|
+
- `kuaishou_submit_video_speech_text_by_photo_id`
|
|
72
|
+
- `kuaishou_get_video_speech_text_job`
|
|
73
|
+
- `weibo_submit_video_speech_text_by_post_url`
|
|
74
|
+
- `weibo_submit_video_speech_text_by_post_id`
|
|
75
|
+
- `weibo_get_video_speech_text_job`
|
|
76
|
+
- `wechat_submit_video_speech_text_by_video_url`
|
|
77
|
+
- `wechat_submit_video_speech_text_by_encrypted_object_id`
|
|
78
|
+
- `wechat_get_video_speech_text_job`
|
|
79
|
+
|
|
80
|
+
## Output Guidance
|
|
81
|
+
|
|
82
|
+
Return the transcript text when available. When a job is still running, include the `job_id`, status, and next action so the user or agent can check later.
|
|
83
|
+
If the result says no processable video resource is available or the job failed, report that as the observed job result instead of retrying with another platform.
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
interface:
|
|
2
|
+
display_name: "Media Transcript"
|
|
3
|
+
short_description: "Submit video transcripts"
|
|
4
|
+
default_prompt: "Use $media-transcript to submit and check video speech-to-text transcript jobs for XHS, Douyin, Kuaishou, Weibo, and WeChat Channels content."
|
|
5
|
+
|
|
6
|
+
policy:
|
|
7
|
+
allow_implicit_invocation: true
|
|
@@ -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
|
|
4
|
+
default_prompt: "Use $media-user-info to retrieve creator profile information from supported XHS, Douyin, Kuaishou, Weibo, or WeChat Channels user IDs, profile URLs, short links, or share text."
|
|
5
5
|
|
|
6
6
|
policy:
|
|
7
7
|
allow_implicit_invocation: true
|
|
@@ -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
|
|
4
|
+
default_prompt: "Use $media-user-posts to retrieve supported XHS, Douyin, Kuaishou, Weibo, or WeChat Channels creator content lists from a platform user ID, profile URL, short link, or share text."
|
|
5
5
|
|
|
6
6
|
policy:
|
|
7
7
|
allow_implicit_invocation: true
|
|
@@ -137,6 +137,8 @@ npx -y socialdatax-skills@latest kuaishou user-posts --profile-url "<profile_url
|
|
|
137
137
|
npx -y socialdatax-skills@latest kuaishou replies --photo-id "<photo_id>" --comment-id "<comment_id>" --pretty
|
|
138
138
|
npx -y socialdatax-skills@latest weibo detail --post-url "<weibo_post_url_or_share_text>" --pretty
|
|
139
139
|
npx -y socialdatax-skills@latest weibo comments --post-url "<weibo_post_url_or_share_text>" --pretty
|
|
140
|
+
npx -y socialdatax-skills@latest weibo likers --post-id "<post_id>" --pretty
|
|
141
|
+
npx -y socialdatax-skills@latest weibo reposts --post-id "<post_id>" --pretty
|
|
140
142
|
npx -y socialdatax-skills@latest weibo user-info --profile-url "<profile_url_or_share_text>" --pretty
|
|
141
143
|
npx -y socialdatax-skills@latest weibo user-posts --profile-url "<profile_url_or_share_text>" --pretty
|
|
142
144
|
npx -y socialdatax-skills@latest weibo replies --post-id "<post_id>" --comment-id "<comment_id>" --pretty
|
|
@@ -146,7 +148,7 @@ npx -y socialdatax-skills@latest wechat user-posts --url "<wechat_video_url_or_s
|
|
|
146
148
|
npx -y socialdatax-skills@latest wechat replies --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --comment-id "<comment_id>" --pretty
|
|
147
149
|
```
|
|
148
150
|
|
|
149
|
-
For hot topics, content URLs, profile URLs, comment review, creator facts, creator content lists, or short-drama series, call the matching `socialdatax-skills` platform subcommand instead of forcing every request through keyword research.
|
|
151
|
+
For hot topics, content URLs, profile URLs, comment review, Weibo liker/repost review, creator facts, creator content lists, or short-drama series, call the matching `socialdatax-skills` platform subcommand instead of forcing every request through keyword research.
|
|
150
152
|
|
|
151
153
|
Required arguments:
|
|
152
154
|
|
|
@@ -195,7 +197,7 @@ MCP tools matching the direct CLI commands above:
|
|
|
195
197
|
- XHS: `xhs_get_search_hot_list`, `xhs_search_notes`, `xhs_get_note_detail_by_note_id`, `xhs_get_note_comments_by_note_id`, `xhs_get_user_info_by_user_id`, `xhs_get_user_posted_notes_by_user_id`, `xhs_get_note_detail_by_note_url`, `xhs_get_note_comments_by_note_url`, `xhs_get_user_info_by_profile_url`, `xhs_get_user_posted_notes_by_profile_url`, `xhs_get_note_sub_comments_by_comment_id`
|
|
196
198
|
- DOUYIN: `douyin_get_hot_search_list`, `douyin_search_videos`, `douyin_get_video_detail_by_aweme_id`, `douyin_get_video_comments_by_aweme_id`, `douyin_get_user_info_by_sec_user_id`, `douyin_get_user_posted_videos_by_sec_user_id`, `douyin_get_video_detail_by_url`, `douyin_get_video_comments_by_url`, `douyin_get_user_info_by_profile_url`, `douyin_get_user_posted_videos_by_profile_url`, `douyin_get_user_series_by_sec_user_id`, `douyin_get_user_series_by_profile_url`, `douyin_get_video_comment_replies_by_comment_id`
|
|
197
199
|
- KUAISHOU: `kuaishou_get_hot_search_list`, `kuaishou_search_videos`, `kuaishou_get_video_detail_by_photo_id`, `kuaishou_get_video_comments_by_photo_id`, `kuaishou_get_user_info_by_user_id`, `kuaishou_get_user_posted_videos_by_user_id`, `kuaishou_get_video_detail_by_url`, `kuaishou_get_video_comments_by_url`, `kuaishou_get_user_info_by_profile_url`, `kuaishou_get_user_posted_videos_by_profile_url`, `kuaishou_get_video_comment_replies_by_comment_id`
|
|
198
|
-
- 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_user_info_by_profile_url`, `weibo_get_user_posts_by_profile_url`, `weibo_get_post_comment_replies_by_comment_id`
|
|
200
|
+
- 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`
|
|
199
201
|
- 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_video_comments_by_url`, `wechat_get_user_posted_videos_by_url`, `wechat_get_video_comment_replies_by_comment_id`
|
|
200
202
|
|
|
201
203
|
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.
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
interface:
|
|
2
2
|
display_name: "SocialDataX Content Research"
|
|
3
|
-
short_description: "Research
|
|
4
|
-
default_prompt: "Use $socialdatax-content-research-assistant to research Xiaohongshu
|
|
3
|
+
short_description: "Research cross-platform social content"
|
|
4
|
+
default_prompt: "Use $socialdatax-content-research-assistant to research Xiaohongshu / XHS / RedNote, Douyin, Kuaishou, Weibo, and WeChat Channels content across search, details, comments, and creators."
|
|
5
5
|
|
|
6
6
|
policy:
|
|
7
7
|
allow_implicit_invocation: true
|