socialdatax-skills 0.2.21 → 0.2.22
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 +9 -3
- package/cli.mjs +596 -6
- package/package.json +1 -1
- package/skills/media-comments/SKILL.md +93 -20
- package/skills/media-detail/SKILL.md +45 -12
- package/skills/media-search/SKILL.md +39 -10
- package/skills/media-transcript/SKILL.md +63 -15
- package/skills/media-user-info/SKILL.md +43 -10
- package/skills/media-user-posts/SKILL.md +76 -18
- package/skills/sensitive-check/SKILL.md +3 -1
- package/skills/socialdatax-content-research-assistant/SKILL.md +337 -78
package/README.md
CHANGED
|
@@ -73,7 +73,7 @@ Common search phrases for this skill package:
|
|
|
73
73
|
- Sensitive Words Check MCP server name: `sensitive-check`
|
|
74
74
|
- Sensitive Words Check future MCP registry name: `com.socialdatax/sensitive-check`
|
|
75
75
|
- Unified MCP registry name: none; this package installs skills and calls explicit platform services.
|
|
76
|
-
- Current public capability version: `0.2.
|
|
76
|
+
- Current public capability version: `0.2.22`
|
|
77
77
|
|
|
78
78
|
## Direct CLI
|
|
79
79
|
|
|
@@ -110,6 +110,7 @@ npx -y socialdatax-skills@latest douyin user-series --profile-url "<profile_url_
|
|
|
110
110
|
npx -y socialdatax-skills@latest douyin transcript --url "<douyin_content_url_or_share_text>" --pretty
|
|
111
111
|
npx -y socialdatax-skills@latest douyin transcript --aweme-id "<aweme_id>" --pretty
|
|
112
112
|
npx -y socialdatax-skills@latest douyin transcript --job-id "<job_id>" --pretty
|
|
113
|
+
npx -y socialdatax-skills@latest kuaishou hot-search --pretty
|
|
113
114
|
npx -y socialdatax-skills@latest kuaishou search --keyword "露营" --pretty
|
|
114
115
|
npx -y socialdatax-skills@latest kuaishou user-search --keyword "露营" --pretty
|
|
115
116
|
npx -y socialdatax-skills@latest kuaishou detail --photo-id "<photo_id>" --pretty
|
|
@@ -146,6 +147,7 @@ npx -y socialdatax-skills@latest wechat hot-search --pretty
|
|
|
146
147
|
npx -y socialdatax-skills@latest wechat search --keyword "露营" --pretty
|
|
147
148
|
npx -y socialdatax-skills@latest wechat detail --encrypted-object-id "<encrypted_object_id>" --pretty
|
|
148
149
|
npx -y socialdatax-skills@latest wechat detail --url "<wechat_video_url_or_share_text>" --pretty
|
|
150
|
+
npx -y socialdatax-skills@latest wechat decrypt-media --media-url "<video.video_url>" --output video.mp4
|
|
149
151
|
npx -y socialdatax-skills@latest wechat article --url "<mp_article_url_or_share_text>" --pretty
|
|
150
152
|
npx -y socialdatax-skills@latest wechat comments --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --pretty
|
|
151
153
|
npx -y socialdatax-skills@latest wechat comments --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --all --include-replies --pretty
|
|
@@ -160,7 +162,7 @@ npx -y socialdatax-skills@latest wechat transcript --job-id "<job_id>" --pretty
|
|
|
160
162
|
npx -y socialdatax-skills@latest sensitive-check text --text "<content>" --platform xhs --pretty
|
|
161
163
|
```
|
|
162
164
|
|
|
163
|
-
Most direct CLI commands print a JSON envelope with `platform`, `tool`, `arguments`, and `data`. `sensitive-check` prints `platform`, `tool`, and `data` only; it does not echo the original text in CLI output.
|
|
165
|
+
Most direct CLI commands print a JSON envelope with `platform`, `tool`, `arguments`, and `data`. `sensitive-check` prints `platform`, `tool`, and `data` only; it does not echo the original text in CLI output. `wechat decrypt-media` is a local save command: pass the `video.video_url` returned by WeChat detail and an `--output` file path. It saves the media locally, decrypts when needed, and does not require `SOCIALDATAX_API_KEY`.
|
|
164
166
|
|
|
165
167
|
For XHS outputs with a returned `note_url` field, when `note_url` is non-null, preserve it exactly as the full URL, including `xsec_token` query parameters, such as in final answers or display. Do not modify, truncate, redact, normalize, rebuild, or replace it with a link assembled from `note_id`. If `note_url` is null, do not synthesize a public link from `note_id`.
|
|
166
168
|
|
|
@@ -178,7 +180,7 @@ Search pagination uses `--page-token` when continuing with a returned `next_page
|
|
|
178
180
|
|
|
179
181
|
Transcript commands submit a bounded video speech-to-text job or check an existing job. Pass exactly one entrypoint for each call: URL/share text, platform content ID, or `--job-id`. Completed get-job responses return transcript plus content context, not summary.
|
|
180
182
|
|
|
181
|
-
Generated Agent Skill examples include `--source-client socialdatax-skills --source-platform <marketplace> --source-skill <skill-slug>` so SocialDataX can attribute direct CLI usage to the current marketplace Skill. Keep those values unchanged when running commands from a Skill; omit them for ad hoc CLI use.
|
|
183
|
+
Generated Agent Skill examples include `--source-client socialdatax-skills --source-platform <marketplace> --source-skill <skill-slug>` so SocialDataX can attribute authenticated direct data CLI usage to the current marketplace Skill. Keep those values unchanged when running commands from a Skill; omit them for ad hoc CLI use. Authenticated direct data CLI commands also accept `SOCIALDATAX_SOURCE_CLIENT`, `SOCIALDATAX_SOURCE_PLATFORM`, and `SOCIALDATAX_SOURCE_SKILL` as environment-variable fallbacks.
|
|
182
184
|
|
|
183
185
|
XHS, Douyin, Kuaishou, Weibo, and WeChat Channels search use `--keyword` and optional `--page-token`.
|
|
184
186
|
Kuaishou work search uses `kuaishou search --keyword` and optional `--page-token`; Kuaishou creator search uses `kuaishou user-search --keyword` and optional `--page-token`. Kuaishou search does not accept Douyin semantic filters, and `kuaishou user-search` does not support `--since-days`.
|
|
@@ -282,6 +284,7 @@ npx -y socialdatax-skills@latest douyin hot-search --pretty
|
|
|
282
284
|
npx -y socialdatax-skills@latest douyin search --keyword "露营" --pretty
|
|
283
285
|
npx -y socialdatax-skills@latest douyin user-series --sec-user-id "<sec_user_id>" --pretty
|
|
284
286
|
npx -y socialdatax-skills@latest douyin transcript --aweme-id "<aweme_id>" --pretty
|
|
287
|
+
npx -y socialdatax-skills@latest kuaishou hot-search --pretty
|
|
285
288
|
npx -y socialdatax-skills@latest kuaishou search --keyword "露营" --pretty
|
|
286
289
|
npx -y socialdatax-skills@latest kuaishou transcript --photo-id "<photo_id>" --pretty
|
|
287
290
|
npx -y socialdatax-skills@latest weibo hot-search --pretty
|
|
@@ -337,6 +340,7 @@ Current XHS workflows include:
|
|
|
337
340
|
|
|
338
341
|
Current Kuaishou workflows include:
|
|
339
342
|
|
|
343
|
+
- Fetch the current Kuaishou / 快手 hot-search list.
|
|
340
344
|
- Search related Kuaishou works by keyword.
|
|
341
345
|
- Search Kuaishou creator or account candidates by keyword before profile lookup.
|
|
342
346
|
- Resolve a Kuaishou work page link, short link, share text, or photo_id into structured work details.
|
|
@@ -377,6 +381,7 @@ Current WeChat / 微信 workflows include:
|
|
|
377
381
|
- Fetch the current WeChat Channels / 视频号 hot-search list.
|
|
378
382
|
- Search related WeChat Channels videos by keyword with optional sort and duration filters.
|
|
379
383
|
- Resolve a WeChat Channels video link, share text, or encrypted_object_id into structured video details.
|
|
384
|
+
- Save the `video.video_url` returned by WeChat Channels video detail locally and decrypt when needed.
|
|
380
385
|
- Resolve a WeChat Official Account / 微信公众号 article link or share text into article detail and body text.
|
|
381
386
|
- Fetch paginated first-level comments for comment analysis.
|
|
382
387
|
- Fetch paginated replies under a first-level comment; pass `object_id`, `object_nonce_id`, and `comment_id`.
|
|
@@ -436,6 +441,7 @@ Current Sensitive Words Check workflows include:
|
|
|
436
441
|
|
|
437
442
|
| Tool | Public purpose |
|
|
438
443
|
| --- | --- |
|
|
444
|
+
| `kuaishou_get_hot_search_list` | Fetch the current Kuaishou / 快手 hot-search list. |
|
|
439
445
|
| `kuaishou_search_videos` | Search Kuaishou works by natural-language keyword with optional `page_token` continuation; do not pass `page`. |
|
|
440
446
|
| `kuaishou_search_users` | Search Kuaishou creators by keyword with optional `page_token` continuation; do not pass `page`. |
|
|
441
447
|
| `kuaishou_get_video_detail_by_photo_id` | Fetch structured work details when the caller already has a photo_id. |
|