socialdatax-skills 0.2.8 → 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 +146 -19
- package/cli.mjs +933 -30
- package/package.json +15 -4
- package/skills/media-comments/SKILL.md +33 -4
- package/skills/media-comments/agents/openai.yaml +1 -1
- package/skills/media-detail/SKILL.md +24 -4
- package/skills/media-detail/agents/openai.yaml +1 -1
- package/skills/media-search/SKILL.md +49 -4
- 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/SKILL.md +18 -4
- package/skills/media-user-info/agents/openai.yaml +1 -1
- package/skills/media-user-posts/SKILL.md +28 -4
- package/skills/media-user-posts/agents/openai.yaml +1 -1
- package/skills/socialdatax-content-research-assistant/SKILL.md +63 -48
- package/skills/socialdatax-content-research-assistant/agents/openai.yaml +2 -2
package/README.md
CHANGED
|
@@ -2,13 +2,13 @@
|
|
|
2
2
|
|
|
3
3
|
This public package provides the unified skill installer and direct CLI helper for SocialDataX services.
|
|
4
4
|
|
|
5
|
-
The current public tools support 小红书 / Xiaohongshu / XHS / RedNote, 抖音 / Douyin,
|
|
5
|
+
The current public tools support 小红书 / Xiaohongshu / XHS / RedNote, 抖音 / Douyin, 快手 / Kuaishou / Kwai, 微博 / Weibo, and 视频号 / WeChat Channels content research and analysis workflows. The public skill layer is intentionally named by media capability so supported platforms can evolve without changing the installation model.
|
|
6
6
|
|
|
7
7
|
- direct `npx` JSON commands for agents that can run shell commands
|
|
8
8
|
- AgentSkills-compatible installers split by capability for OpenClaw, Hermes Agent, Codex, Claude Code, and general agent skill directories
|
|
9
9
|
- links to platform-specific MCP docs when a client should use MCP directly
|
|
10
10
|
|
|
11
|
-
The business implementation is privately hosted. This repository exposes only the public package, skill, and connection surface for
|
|
11
|
+
The business implementation is privately hosted. This repository exposes only the public package, skill, and connection surface for social media content intelligence workflows. It is not a unified MCP server and does not include a registry server card; platform MCPs are published separately.
|
|
12
12
|
|
|
13
13
|
## Search Aliases
|
|
14
14
|
|
|
@@ -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`
|
|
@@ -30,6 +33,10 @@ Common search phrases for this skill package:
|
|
|
30
33
|
- `Kuaishou skills`
|
|
31
34
|
- `Kwai skills`
|
|
32
35
|
- `快手 skills`
|
|
36
|
+
- `Weibo skills`
|
|
37
|
+
- `微博 skills`
|
|
38
|
+
- `WeChat Channels skills`
|
|
39
|
+
- `视频号 skills`
|
|
33
40
|
- `SocialDataX content research`
|
|
34
41
|
- `content research assistant`
|
|
35
42
|
|
|
@@ -38,17 +45,23 @@ Common search phrases for this skill package:
|
|
|
38
45
|
- XHS hosted MCP endpoint: `https://mcp.52choujiang.com/xhs/mcp`
|
|
39
46
|
- Douyin hosted MCP endpoint: `https://mcp.52choujiang.com/douyin/mcp`
|
|
40
47
|
- Kuaishou hosted MCP endpoint: `https://mcp.52choujiang.com/kuaishou/mcp`
|
|
48
|
+
- Weibo hosted MCP endpoint: `https://mcp.52choujiang.com/weibo/mcp`
|
|
49
|
+
- WeChat Channels hosted MCP endpoint: `https://mcp.52choujiang.com/wechat/mcp`
|
|
41
50
|
- Hosted transport: `streamable-http`
|
|
42
51
|
- Authentication: `Authorization: Bearer <SOCIALDATAX_API_KEY>`
|
|
43
|
-
- Website: <https://socialdatax.com>
|
|
52
|
+
- Website: <https://socialdatax.52choujiang.com>
|
|
44
53
|
- XHS current platform MCP registry name: `com.52choujiang/xhs-insights`
|
|
45
54
|
- XHS future platform MCP registry name: `com.socialdatax/xhs-insights`
|
|
46
55
|
- Douyin current platform MCP registry name: `com.52choujiang/douyin-insights`
|
|
47
56
|
- Douyin future platform MCP registry name: `com.socialdatax/douyin-insights`
|
|
48
57
|
- Kuaishou current platform MCP registry name: `com.52choujiang/kuaishou-insights`
|
|
49
58
|
- Kuaishou future platform MCP registry name: `com.socialdatax/kuaishou-insights`
|
|
59
|
+
- Weibo current platform MCP registry name: `com.52choujiang/weibo-insights`
|
|
60
|
+
- Weibo future platform MCP registry name: `com.socialdatax/weibo-insights`
|
|
61
|
+
- WeChat Channels current platform MCP registry name: `com.52choujiang/wechat-channels-insights`
|
|
62
|
+
- WeChat Channels future platform MCP registry name: `com.socialdatax/wechat-channels-insights`
|
|
50
63
|
- Unified MCP registry name: none; this package installs skills and calls explicit platform services.
|
|
51
|
-
- Current public capability version: `0.2.
|
|
64
|
+
- Current public capability version: `0.2.10`
|
|
52
65
|
|
|
53
66
|
## Direct CLI
|
|
54
67
|
|
|
@@ -89,6 +102,31 @@ npx -y socialdatax-skills@latest kuaishou user-info --user-id "<user_id>" --pret
|
|
|
89
102
|
npx -y socialdatax-skills@latest kuaishou user-info --profile-url "<profile_url_or_share_text>" --pretty
|
|
90
103
|
npx -y socialdatax-skills@latest kuaishou user-posts --user-id "<user_id>" --pretty
|
|
91
104
|
npx -y socialdatax-skills@latest kuaishou user-posts --profile-url "<profile_url_or_share_text>" --pretty
|
|
105
|
+
npx -y socialdatax-skills@latest weibo hot-search --pretty
|
|
106
|
+
npx -y socialdatax-skills@latest weibo search --keyword "露营桌" --pretty
|
|
107
|
+
npx -y socialdatax-skills@latest weibo detail --post-id "<post_id>" --pretty
|
|
108
|
+
npx -y socialdatax-skills@latest weibo detail --post-url "<weibo_post_url_or_share_text>" --pretty
|
|
109
|
+
npx -y socialdatax-skills@latest weibo comments --post-id "<post_id>" --pretty
|
|
110
|
+
npx -y socialdatax-skills@latest weibo comments --post-id "<post_id>" --all --include-replies --pretty
|
|
111
|
+
npx -y socialdatax-skills@latest weibo comments --post-url "<weibo_post_url_or_share_text>" --pretty
|
|
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
|
|
115
|
+
npx -y socialdatax-skills@latest weibo user-info --user-id "<user_id>" --pretty
|
|
116
|
+
npx -y socialdatax-skills@latest weibo user-info --profile-url "<profile_url_or_share_text>" --pretty
|
|
117
|
+
npx -y socialdatax-skills@latest weibo user-posts --user-id "<user_id>" --pretty
|
|
118
|
+
npx -y socialdatax-skills@latest weibo user-posts --profile-url "<profile_url_or_share_text>" --pretty
|
|
119
|
+
npx -y socialdatax-skills@latest wechat hot-search --pretty
|
|
120
|
+
npx -y socialdatax-skills@latest wechat search --keyword "露营桌" --pretty
|
|
121
|
+
npx -y socialdatax-skills@latest wechat detail --encrypted-object-id "<encrypted_object_id>" --pretty
|
|
122
|
+
npx -y socialdatax-skills@latest wechat detail --url "<wechat_video_url_or_share_text>" --pretty
|
|
123
|
+
npx -y socialdatax-skills@latest wechat comments --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --pretty
|
|
124
|
+
npx -y socialdatax-skills@latest wechat comments --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --all --include-replies --pretty
|
|
125
|
+
npx -y socialdatax-skills@latest wechat comments --url "<wechat_video_url_or_share_text>" --pretty
|
|
126
|
+
npx -y socialdatax-skills@latest wechat replies --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --comment-id "<comment_id>" --pretty
|
|
127
|
+
npx -y socialdatax-skills@latest wechat user-info --user-id "<finder_user_id>" --pretty
|
|
128
|
+
npx -y socialdatax-skills@latest wechat user-posts --user-id "<finder_user_id>" --pretty
|
|
129
|
+
npx -y socialdatax-skills@latest wechat user-posts --url "<wechat_video_url_or_share_text>" --pretty
|
|
92
130
|
```
|
|
93
131
|
|
|
94
132
|
The direct CLI prints a JSON envelope with `platform`, `tool`, `arguments`, and `data`.
|
|
@@ -103,9 +141,9 @@ For first-level comments, add `--include-replies` to fetch the second-level repl
|
|
|
103
141
|
|
|
104
142
|
For commands that accept `--page-token`, continue only with the complete returned `next_page_token` from the same pagination chain. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.
|
|
105
143
|
|
|
106
|
-
XHS search uses numeric `--page`; Douyin and
|
|
144
|
+
XHS search uses numeric `--page`; Douyin, Kuaishou, Weibo, and WeChat Channels search do not accept `--page`. For Douyin, Kuaishou, Weibo, and WeChat Channels search, omit `--page-token` on the first request and pass the complete returned `next_page_token` only when continuing the same search chain.
|
|
107
145
|
|
|
108
|
-
Kuaishou search uses `--keyword` and optional `--page-token`; it does not accept Douyin semantic filters.
|
|
146
|
+
Kuaishou search uses `--keyword` and optional `--page-token`; it does not accept Douyin semantic filters. Weibo and WeChat Channels search use `--keyword` and optional `--page-token`.
|
|
109
147
|
|
|
110
148
|
Douyin search filters use semantic values: `--sort-type` supports `general`,
|
|
111
149
|
`time_descending`, and `like_count_descending`; `--publish-time-range` supports
|
|
@@ -113,6 +151,10 @@ Douyin search filters use semantic values: `--sort-type` supports `general`,
|
|
|
113
151
|
`under_1_minute`, `one_to_five_minutes`, and `over_5_minutes`; `--content-type`
|
|
114
152
|
supports `all`, `video`, and `image`.
|
|
115
153
|
|
|
154
|
+
WeChat Channels search filters use semantic values: `--sort-type` supports
|
|
155
|
+
`all`, `latest`, and `popular`; `--duration-range` supports `all`,
|
|
156
|
+
`under_5_min`, `between_5_and_20_min`, and `over_20_min`.
|
|
157
|
+
|
|
116
158
|
### Runtime Requirements
|
|
117
159
|
|
|
118
160
|
- Recommended: Node.js 22 LTS or newer.
|
|
@@ -133,11 +175,11 @@ npx -y socialdatax-skills@latest doctor
|
|
|
133
175
|
npx -y socialdatax-skills@latest doctor --json
|
|
134
176
|
```
|
|
135
177
|
|
|
136
|
-
The public package declares no npm lifecycle scripts such as `preinstall`, `install`, or `postinstall`. The installer copies AgentSkills files only, does not save API keys, and does not change MCP server configuration.
|
|
178
|
+
The public package declares no npm lifecycle scripts such as `preinstall`, `install`, or `postinstall`. The installer copies AgentSkills files only, does not save API keys, and does not change MCP server configuration. Authenticated data calls require `SOCIALDATAX_API_KEY` at runtime, do not read local browser data, and do not perform account actions.
|
|
137
179
|
|
|
138
180
|
## Platform Names
|
|
139
181
|
|
|
140
|
-
This project is not affiliated with, endorsed by, or sponsored by Xiaohongshu, RedNote, Douyin, Kuaishou, Kwai, or their affiliates. Platform names are used only to describe supported data sources.
|
|
182
|
+
This project is not affiliated with, endorsed by, or sponsored by Xiaohongshu, RedNote, Douyin, Kuaishou, Kwai, Weibo, WeChat, WeChat Channels, or their affiliates. Platform names are used only to describe supported data sources.
|
|
141
183
|
|
|
142
184
|
### Local Source Run
|
|
143
185
|
|
|
@@ -146,6 +188,8 @@ npm install
|
|
|
146
188
|
SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" node cli.mjs xhs search --keyword "露营桌" --pretty
|
|
147
189
|
SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" node cli.mjs douyin search --keyword "露营桌" --pretty
|
|
148
190
|
SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" node cli.mjs kuaishou search --keyword "露营桌" --pretty
|
|
191
|
+
SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" node cli.mjs weibo search --keyword "露营桌" --pretty
|
|
192
|
+
SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" node cli.mjs wechat search --keyword "露营桌" --pretty
|
|
149
193
|
```
|
|
150
194
|
|
|
151
195
|
### Docker Run
|
|
@@ -155,6 +199,8 @@ docker build -t socialdatax-skills .
|
|
|
155
199
|
docker run --rm -i -e SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" socialdatax-skills xhs search --keyword "露营桌" --pretty
|
|
156
200
|
docker run --rm -i -e SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" socialdatax-skills douyin search --keyword "露营桌" --pretty
|
|
157
201
|
docker run --rm -i -e SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" socialdatax-skills kuaishou search --keyword "露营桌" --pretty
|
|
202
|
+
docker run --rm -i -e SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" socialdatax-skills weibo search --keyword "露营桌" --pretty
|
|
203
|
+
docker run --rm -i -e SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" socialdatax-skills wechat search --keyword "露营桌" --pretty
|
|
158
204
|
```
|
|
159
205
|
|
|
160
206
|
If Docker Hub is slow from your network, keep the default image unchanged for normal use and override only during local builds:
|
|
@@ -177,6 +223,7 @@ npx -y socialdatax-skills@latest install media-search --target openclaw
|
|
|
177
223
|
npx -y socialdatax-skills@latest install media-search --target openclaw --dry-run
|
|
178
224
|
npx -y socialdatax-skills@latest install media-user-info --target openclaw
|
|
179
225
|
npx -y socialdatax-skills@latest install media-comments media-detail --target openclaw
|
|
226
|
+
npx -y socialdatax-skills@latest install media-transcript --target openclaw
|
|
180
227
|
npx -y socialdatax-skills@latest install media-search --target openclaw --scope workspace
|
|
181
228
|
npx -y socialdatax-skills@latest install media-search --target hermes
|
|
182
229
|
npx -y socialdatax-skills@latest install media-search --target hermes --scope shared
|
|
@@ -192,16 +239,21 @@ npx -y socialdatax-skills@latest douyin search --keyword "露营桌" --pretty
|
|
|
192
239
|
npx -y socialdatax-skills@latest douyin user-series --sec-user-id "<sec_user_id>" --pretty
|
|
193
240
|
npx -y socialdatax-skills@latest kuaishou hot-search --pretty
|
|
194
241
|
npx -y socialdatax-skills@latest kuaishou search --keyword "露营桌" --pretty
|
|
242
|
+
npx -y socialdatax-skills@latest weibo hot-search --pretty
|
|
243
|
+
npx -y socialdatax-skills@latest weibo search --keyword "露营桌" --pretty
|
|
244
|
+
npx -y socialdatax-skills@latest wechat hot-search --pretty
|
|
245
|
+
npx -y socialdatax-skills@latest wechat search --keyword "露营桌" --pretty
|
|
195
246
|
```
|
|
196
247
|
|
|
197
248
|
Available skills:
|
|
198
249
|
|
|
199
|
-
- `socialdatax-content-research-assistant`: combine SocialDataX search, detail, comment, creator profile, and creator content workflows for cross-platform content research across XHS, Douyin, and
|
|
200
|
-
- `media-search`: search social media content by keyword; supports XHS notes, Douyin works, and
|
|
201
|
-
- `media-detail`: read structured content details and metrics; supports XHS notes, Douyin works, and
|
|
202
|
-
- `media-comments`: fetch and analyze XHS comments/replies, Douyin comments/replies, and
|
|
203
|
-
- `media-
|
|
204
|
-
- `media-user-
|
|
250
|
+
- `socialdatax-content-research-assistant`: combine SocialDataX search, detail, comment, creator profile, and creator content workflows for cross-platform content research across XHS, Douyin, Kuaishou, Weibo, and WeChat Channels.
|
|
251
|
+
- `media-search`: search social media content by keyword; supports XHS notes, Douyin works, Kuaishou works, Weibo posts, and WeChat Channels videos.
|
|
252
|
+
- `media-detail`: read structured content details and metrics; supports XHS notes, Douyin works, Kuaishou works, Weibo posts, and WeChat Channels videos.
|
|
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.
|
|
255
|
+
- `media-user-info`: retrieve creator profile information; supports XHS, Douyin, Kuaishou, Weibo, and WeChat Channels creators.
|
|
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.
|
|
205
257
|
|
|
206
258
|
Default install locations:
|
|
207
259
|
|
|
@@ -217,9 +269,9 @@ Default install locations:
|
|
|
217
269
|
|
|
218
270
|
If no skill name is provided, all skills are installed. If a destination already exists, re-run with `--force` to replace an existing directory for the same skill. Use `--path <directory>` to install one skill to a custom directory, or multiple skills under a custom parent directory. The `shared` scope is only meaningful for `--target hermes`; use `--target agents` for the shared AgentSkills directory directly.
|
|
219
271
|
|
|
220
|
-
##
|
|
272
|
+
## Workflow Scope
|
|
221
273
|
|
|
222
|
-
The current platform MCP services are designed for
|
|
274
|
+
The current platform MCP services are designed for social media content intelligence workflows. Some tools read public content directly; some submit bounded analysis jobs such as video speech-to-text transcript. They do not provide account login, posting, editing, liking, commenting, or other account actions.
|
|
223
275
|
|
|
224
276
|
Current XHS workflows include:
|
|
225
277
|
|
|
@@ -231,6 +283,7 @@ Current XHS workflows include:
|
|
|
231
283
|
- Fetch paginated replies under a first-level comment.
|
|
232
284
|
- Read creator profile data from a profile link, short link, share text, or user ID.
|
|
233
285
|
- Fetch paginated creator note lists from a user ID, profile link, short link, or share text for content style and account research.
|
|
286
|
+
- Submit and check video note 口播转文字 / speech-to-text transcript jobs; submit tools 提交完成后最多短等 15 秒.
|
|
234
287
|
|
|
235
288
|
Current Kuaishou workflows include:
|
|
236
289
|
|
|
@@ -242,6 +295,7 @@ Current Kuaishou workflows include:
|
|
|
242
295
|
- Continue Kuaishou list pagination only when `next_page_token` is non-empty; an empty string means there are no more results to request.
|
|
243
296
|
- Read creator profile data from a profile link, short link, share text, or user_id.
|
|
244
297
|
- Fetch paginated creator work lists from a user_id, profile link, short link, or share text.
|
|
298
|
+
- Submit and check video work 口播转文字 / speech-to-text transcript jobs; submit tools 提交完成后最多短等 15 秒.
|
|
245
299
|
|
|
246
300
|
Current Douyin workflows include:
|
|
247
301
|
|
|
@@ -254,6 +308,31 @@ Current Douyin workflows include:
|
|
|
254
308
|
- Read creator profile data from a profile link, short link, share text, or sec_user_id.
|
|
255
309
|
- Fetch paginated creator work lists from a sec_user_id, profile link, short link, or share text.
|
|
256
310
|
- Fetch paginated creator short-drama series lists from a sec_user_id, profile link, short link, or share text.
|
|
311
|
+
- Submit and check video work 口播转文字 / speech-to-text transcript jobs; submit tools 提交完成后最多短等 15 秒.
|
|
312
|
+
|
|
313
|
+
Current Weibo workflows include:
|
|
314
|
+
|
|
315
|
+
- Fetch the current Weibo / 微博 hot-search list.
|
|
316
|
+
- Search related Weibo posts by keyword.
|
|
317
|
+
- Resolve a Weibo post URL, short link, share text, or post_id into structured post details.
|
|
318
|
+
- Fetch paginated first-level comments for comment analysis.
|
|
319
|
+
- Fetch paginated replies under a first-level comment.
|
|
320
|
+
- Continue Weibo list pagination only when `next_page_token` is non-empty; an empty string means there are no more results to request.
|
|
321
|
+
- Read creator profile data from a profile link, short link, share text, or user_id.
|
|
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 秒.
|
|
324
|
+
|
|
325
|
+
Current WeChat Channels / 视频号 workflows include:
|
|
326
|
+
|
|
327
|
+
- Fetch the current WeChat Channels / 视频号 hot-search list.
|
|
328
|
+
- Search related WeChat Channels videos by keyword with optional sort and duration filters.
|
|
329
|
+
- Resolve a WeChat Channels video link, share text, or encrypted_object_id into structured video details.
|
|
330
|
+
- Fetch paginated first-level comments for comment analysis.
|
|
331
|
+
- Fetch paginated replies under a first-level comment; pass `object_id`, `object_nonce_id`, and `comment_id`.
|
|
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.
|
|
333
|
+
- Read creator profile data from a finder user_id.
|
|
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 秒.
|
|
257
336
|
|
|
258
337
|
## XHS Tools
|
|
259
338
|
|
|
@@ -270,6 +349,9 @@ Current Douyin workflows include:
|
|
|
270
349
|
| `xhs_get_user_info_by_profile_url` | Resolve a profile link, short link, or share text into creator profile data. |
|
|
271
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. |
|
|
272
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. |
|
|
273
355
|
|
|
274
356
|
## Douyin Tools
|
|
275
357
|
|
|
@@ -288,6 +370,9 @@ Current Douyin workflows include:
|
|
|
288
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. |
|
|
289
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. |
|
|
290
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. |
|
|
291
376
|
|
|
292
377
|
## Kuaishou Tools
|
|
293
378
|
|
|
@@ -304,6 +389,46 @@ Current Douyin workflows include:
|
|
|
304
389
|
| `kuaishou_get_user_info_by_profile_url` | Resolve a Kuaishou profile link, short link, or share text into creator profile data. |
|
|
305
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. |
|
|
306
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. |
|
|
395
|
+
|
|
396
|
+
## Weibo Tools
|
|
397
|
+
|
|
398
|
+
| Tool | Public purpose |
|
|
399
|
+
| --- | --- |
|
|
400
|
+
| `weibo_get_hot_search_list` | Fetch the current Weibo / 微博 hot-search list. |
|
|
401
|
+
| `weibo_search_posts` | Search Weibo posts by keyword with optional `page_token` continuation; do not pass `page`. |
|
|
402
|
+
| `weibo_get_post_detail_by_post_id` | Fetch structured Weibo post details when the caller already has a post_id. |
|
|
403
|
+
| `weibo_get_post_detail_by_post_url` | Resolve a Weibo post URL, short link, or share text into structured post details. |
|
|
404
|
+
| `weibo_get_post_comments_by_post_id` | Fetch paginated first-level comments when the caller already has a post_id. |
|
|
405
|
+
| `weibo_get_post_comments_by_post_url` | Fetch paginated first-level comments directly from a Weibo post URL, short link, or share text. |
|
|
406
|
+
| `weibo_get_post_comment_replies_by_comment_id` | Fetch paginated replies under a first-level comment by post_id and comment_id. |
|
|
407
|
+
| `weibo_get_user_info_by_user_id` | Fetch creator profile data when the caller already has a user_id. |
|
|
408
|
+
| `weibo_get_user_info_by_profile_url` | Resolve a Weibo profile link, short link, or share text into creator profile data. |
|
|
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. |
|
|
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. |
|
|
414
|
+
|
|
415
|
+
## WeChat Channels Tools
|
|
416
|
+
|
|
417
|
+
| Tool | Public purpose |
|
|
418
|
+
| --- | --- |
|
|
419
|
+
| `wechat_get_hot_search_list` | Fetch the current WeChat Channels / 视频号 hot-search list. |
|
|
420
|
+
| `wechat_search_videos` | Search WeChat Channels / 视频号 videos by keyword with optional `page_token` continuation and filters; do not pass `page`. |
|
|
421
|
+
| `wechat_get_video_detail_by_encrypted_object_id` | Fetch structured WeChat Channels video details when encrypted_object_id is already known. |
|
|
422
|
+
| `wechat_get_video_detail_by_url` | Resolve a WeChat Channels / 视频号 video link or share text into structured video details. |
|
|
423
|
+
| `wechat_get_video_comments_by_object_id` | Fetch paginated first-level comments when object_id and object_nonce_id are known. |
|
|
424
|
+
| `wechat_get_video_comments_by_url` | Fetch paginated first-level comments directly from a WeChat Channels / 视频号 video link or share text. |
|
|
425
|
+
| `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. |
|
|
426
|
+
| `wechat_get_user_info_by_user_id` | Fetch creator profile data when the finder user_id is already known. |
|
|
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. |
|
|
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. |
|
|
307
432
|
|
|
308
433
|
## Quick Start
|
|
309
434
|
|
|
@@ -314,9 +439,11 @@ export SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>"
|
|
|
314
439
|
npx -y socialdatax-skills@latest xhs search --keyword "露营桌" --pretty
|
|
315
440
|
npx -y socialdatax-skills@latest douyin search --keyword "露营桌" --pretty
|
|
316
441
|
npx -y socialdatax-skills@latest kuaishou search --keyword "露营桌" --pretty
|
|
442
|
+
npx -y socialdatax-skills@latest weibo search --keyword "露营桌" --pretty
|
|
443
|
+
npx -y socialdatax-skills@latest wechat search --keyword "露营桌" --pretty
|
|
317
444
|
```
|
|
318
445
|
|
|
319
|
-
MCP client configuration belongs to platform MCP listings. For XHS, use the `xhs-insights` docs; for Douyin, use the `douyin-insights` listing; for Kuaishou, use the `kuaishou-insights` listing.
|
|
446
|
+
MCP client configuration belongs to platform MCP listings. For XHS, use the `xhs-insights` docs; for Douyin, use the `douyin-insights` listing; for Kuaishou, use the `kuaishou-insights` listing; for Weibo, use the `weibo-insights` listing; for WeChat Channels / 视频号, use the `wechat-channels-insights` listing.
|
|
320
447
|
|
|
321
448
|
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.
|
|
322
449
|
|
|
@@ -324,7 +451,7 @@ Aily is treated as an OpenClaw / AgentSkills ecosystem channel for this package.
|
|
|
324
451
|
|
|
325
452
|
Request or manage API access from the product website:
|
|
326
453
|
|
|
327
|
-
<https://socialdatax.com/?from=npm>
|
|
454
|
+
<https://socialdatax.52choujiang.com/?from=npm>
|
|
328
455
|
|
|
329
456
|
Use the key as a Bearer token in the `Authorization` request header. Do not commit real API keys to code, docs, issues, or screenshots.
|
|
330
457
|
|
|
@@ -332,7 +459,7 @@ Use the key as a Bearer token in the `Authorization` request header. Do not comm
|
|
|
332
459
|
|
|
333
460
|
Public metadata files in this repository:
|
|
334
461
|
|
|
335
|
-
- [skills](skills): AgentSkills-compatible skills split by social media capability and currently backed by XHS, Douyin, and
|
|
462
|
+
- [skills](skills): AgentSkills-compatible skills split by social media capability and currently backed by XHS, Douyin, Kuaishou, Weibo, and WeChat Channels tools.
|
|
336
463
|
|
|
337
464
|
## License
|
|
338
465
|
|