socialdatax-skills 0.2.4 → 0.2.6

package/README.md

@@ -2,7 +2,7 @@
 
 This public package provides the unified skill installer and direct CLI helper for SocialDataX services.
 
-The current public tools support 小红书 / Xiaohongshu / XHS / RedNote and 抖音 / Douyin read-only research workflows. The public skill layer is intentionally named by media capability so supported platforms can evolve without changing the installation model.
+The current public tools support 小红书 / Xiaohongshu / XHS / RedNote, 抖音 / Douyin, and 快手 / Kuaishou / Kwai read-only research workflows. The public skill layer is intentionally named by media capability so supported platforms can evolve without changing the installation model.
 
 - direct `npx` JSON commands for agents that can run shell commands
 - AgentSkills-compatible installers split by capability for OpenClaw, Hermes Agent, Codex, Claude Code, and general agent skill directories
@@ -27,6 +27,9 @@ Common search phrases for this skill package:
 - `RedNote skills`
 - `Douyin skills`
 - `抖音 skills`
+- `Kuaishou skills`
+- `Kwai skills`
+- `快手 skills`
 - `SocialDataX content research`
 - `content research assistant`
 
@@ -34,6 +37,7 @@ Common search phrases for this skill package:
 
 - XHS hosted MCP endpoint: `https://mcp.52choujiang.com/xhs/mcp`
 - Douyin hosted MCP endpoint: `https://mcp.52choujiang.com/douyin/mcp`
+- Kuaishou hosted MCP endpoint: `https://mcp.52choujiang.com/kuaishou/mcp`
 - Hosted transport: `streamable-http`
 - Authentication: `Authorization: Bearer <SOCIALDATAX_API_KEY>`
 - Website: <https://socialdatax.com>
@@ -41,8 +45,10 @@ Common search phrases for this skill package:
 - XHS future platform MCP registry name: `com.socialdatax/xhs-insights`
 - Douyin current platform MCP registry name: `com.52choujiang/douyin-insights`
 - Douyin future platform MCP registry name: `com.socialdatax/douyin-insights`
+- Kuaishou current platform MCP registry name: `com.52choujiang/kuaishou-insights`
+- Kuaishou future platform MCP registry name: `com.socialdatax/kuaishou-insights`
 - Unified MCP registry name: none; this package installs skills and calls explicit platform services.
-- Current public capability version: `0.2.4`
+- Current public capability version: `0.2.6`
 
 ## Direct CLI
 
@@ -52,8 +58,10 @@ Examples:
 
 ```bash
 npx -y socialdatax-skills@latest xhs search --keyword "露营桌" --pretty
+npx -y socialdatax-skills@latest xhs hot-search --pretty
 npx -y socialdatax-skills@latest xhs detail --note-id "<note_id>" --pretty
 npx -y socialdatax-skills@latest xhs comments --note-id "<note_id>" --pretty
+npx -y socialdatax-skills@latest xhs comments --note-id "<note_id>" --all --include-replies --pretty
 npx -y socialdatax-skills@latest xhs sub-comments --note-id "<note_id>" --comment-id "<comment_id>" --pretty
 npx -y socialdatax-skills@latest xhs user-info --user-id "<user_id>" --pretty
 npx -y socialdatax-skills@latest xhs user-posts --user-id "<user_id>" --pretty
@@ -61,6 +69,7 @@ npx -y socialdatax-skills@latest douyin hot-search --pretty
 npx -y socialdatax-skills@latest douyin search --keyword "露营桌" --pretty
 npx -y socialdatax-skills@latest douyin detail --aweme-id "<aweme_id>" --pretty
 npx -y socialdatax-skills@latest douyin comments --aweme-id "<aweme_id>" --pretty
+npx -y socialdatax-skills@latest douyin comments --aweme-id "<aweme_id>" --all --include-replies --pretty
 npx -y socialdatax-skills@latest douyin replies --aweme-id "<aweme_id>" --comment-id "<comment_id>" --pretty
 npx -y socialdatax-skills@latest douyin user-info --sec-user-id "<sec_user_id>" --pretty
 npx -y socialdatax-skills@latest douyin user-info --profile-url "<profile_url_or_share_text>" --pretty
@@ -68,10 +77,34 @@ npx -y socialdatax-skills@latest douyin user-posts --sec-user-id "<sec_user_id>"
 npx -y socialdatax-skills@latest douyin user-posts --profile-url "<profile_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest douyin user-series --sec-user-id "<sec_user_id>" --pretty
 npx -y socialdatax-skills@latest douyin user-series --profile-url "<profile_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest kuaishou hot-search --pretty
+npx -y socialdatax-skills@latest kuaishou search --keyword "露营桌" --pretty
+npx -y socialdatax-skills@latest kuaishou detail --photo-id "<photo_id>" --pretty
+npx -y socialdatax-skills@latest kuaishou detail --url "<kuaishou_content_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest kuaishou comments --photo-id "<photo_id>" --pretty
+npx -y socialdatax-skills@latest kuaishou comments --photo-id "<photo_id>" --all --include-replies --pretty
+npx -y socialdatax-skills@latest kuaishou comments --url "<kuaishou_content_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest kuaishou replies --photo-id "<photo_id>" --comment-id "<comment_id>" --pretty
+npx -y socialdatax-skills@latest kuaishou user-info --user-id "<user_id>" --pretty
+npx -y socialdatax-skills@latest kuaishou user-info --profile-url "<profile_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest kuaishou user-posts --user-id "<user_id>" --pretty
+npx -y socialdatax-skills@latest kuaishou user-posts --profile-url "<profile_url_or_share_text>" --pretty
 ```
 
 The direct CLI prints a JSON envelope with `platform`, `tool`, `arguments`, and `data`.
 
+For list-style commands, use `--pages <n>` to fetch N pages from the current starting point and `--max-items <n>` to cap the merged `data.items` output. Search commands support `--pages` but not `--all`, because search has no stable complete-result boundary.
+
+For comments, replies, creator content lists, and Douyin creator series, use `--all` to continue until the returned `next_page_token` is empty. `--all` has no default item or page cap; add `--max-items <n>` or use `--pages <n>` when you want a bounded run.
+
+For first-level comments, add `--include-replies` to fetch the second-level replies under each returned first-level comment. Multi-page output keeps `data.items` as the merged first-level list; each item gets `replies`, `replies_page_count`, and `replies_next_page_token`.
+
+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.
+
+XHS search uses numeric `--page`; Douyin and Kuaishou search do not accept `--page`. For Douyin and Kuaishou search, omit `--page-token` on the first request and pass the complete returned `next_page_token` only when continuing the same search chain.
+
+Kuaishou search uses `--keyword` and optional `--page-token`; it does not accept Douyin semantic filters.
+
 Douyin search filters use semantic values: `--sort-type` supports `general`,
 `time_descending`, and `like_count_descending`; `--publish-time-range` supports
 `all`, `day`, `week`, and `half_year`; `--duration-range` supports `all`,
@@ -102,7 +135,7 @@ The public package declares no npm lifecycle scripts such as `preinstall`, `inst
 
 ## Platform Names
 
-This project is not affiliated with, endorsed by, or sponsored by Xiaohongshu, RedNote, Douyin, or their affiliates. Platform names are used only to describe supported data sources.
+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.
 
 ### Local Source Run
 
@@ -110,6 +143,7 @@ This project is not affiliated with, endorsed by, or sponsored by Xiaohongshu, R
 npm install
 SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" node cli.mjs xhs search --keyword "露营桌" --pretty
 SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" node cli.mjs douyin search --keyword "露营桌" --pretty
+SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" node cli.mjs kuaishou search --keyword "露营桌" --pretty
 ```
 
 ### Docker Run
@@ -118,6 +152,7 @@ SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" node cli.mjs douyin search --keyword
 docker build -t socialdatax-skills .
 docker run --rm -i -e SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" socialdatax-skills xhs search --keyword "露营桌" --pretty
 docker run --rm -i -e SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" socialdatax-skills douyin search --keyword "露营桌" --pretty
+docker run --rm -i -e SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" socialdatax-skills kuaishou search --keyword "露营桌" --pretty
 ```
 
 If Docker Hub is slow from your network, keep the default image unchanged for normal use and override only during local builds:
@@ -149,19 +184,22 @@ npx -y socialdatax-skills@latest install media-search --target codex --scope wor
 npx -y socialdatax-skills@latest install media-search --target claude-code
 npx -y socialdatax-skills@latest install media-search --target claude-code --scope workspace
 npx -y socialdatax-skills@latest xhs search --keyword "露营桌" --pretty
+npx -y socialdatax-skills@latest xhs hot-search --pretty
 npx -y socialdatax-skills@latest douyin hot-search --pretty
 npx -y socialdatax-skills@latest douyin search --keyword "露营桌" --pretty
 npx -y socialdatax-skills@latest douyin user-series --sec-user-id "<sec_user_id>" --pretty
+npx -y socialdatax-skills@latest kuaishou hot-search --pretty
+npx -y socialdatax-skills@latest kuaishou search --keyword "露营桌" --pretty
 ```
 
 Available skills:
 
-- `socialdatax-content-research-assistant`: combine SocialDataX search, detail, comment, creator profile, and creator content workflows for cross-platform content research across XHS and Douyin.
-- `media-search`: search social media content by keyword; supports XHS notes and Douyin works.
-- `media-detail`: read structured content details and metrics; supports XHS notes and Douyin works.
-- `media-comments`: fetch and analyze XHS comments/replies and Douyin comments/replies.
-- `media-user-info`: retrieve creator profile information; supports XHS and Douyin creators.
-- `media-user-posts`: retrieve creator content lists; supports XHS notes, Douyin works, and Douyin creator short-drama series.
+- `socialdatax-content-research-assistant`: combine SocialDataX search, detail, comment, creator profile, and creator content workflows for cross-platform content research across XHS, Douyin, and Kuaishou.
+- `media-search`: search social media content by keyword; supports XHS notes, Douyin works, and Kuaishou works.
+- `media-detail`: read structured content details and metrics; supports XHS notes, Douyin works, and Kuaishou works.
+- `media-comments`: fetch and analyze XHS comments/replies, Douyin comments/replies, and Kuaishou comments/replies.
+- `media-user-info`: retrieve creator profile information; supports XHS, Douyin, and Kuaishou creators.
+- `media-user-posts`: retrieve creator content lists; supports XHS notes, Douyin works, Kuaishou works, and Douyin creator short-drama series.
 
 Default install locations:
 
@@ -183,14 +221,26 @@ The current platform MCP services are designed for read-only social media intell
 
 Current XHS workflows include:
 
+- Fetch the current Xiaohongshu / XHS / RedNote search hot list.
 - Search related Xiaohongshu notes by keyword, with optional sort, note type, and publish-time filters.
-- Resolve a shared note link, short link, share text, or note ID into structured note details.
+- Resolve a shared note link, short link, or share text into structured note details.
 - Read note details when the caller already has a note ID.
 - Fetch paginated first-level comments for comment analysis.
 - Fetch paginated replies under a first-level comment.
 - Read creator profile data from a profile link, short link, share text, or user ID.
 - Fetch paginated creator note lists from a user ID, profile link, short link, or share text for content style and account research.
 
+Current Kuaishou workflows include:
+
+- Fetch the current Kuaishou / 快手 short-video hot list.
+- Search related Kuaishou works by keyword.
+- Resolve a Kuaishou work page link, short link, share text, or photo_id into structured work details.
+- Fetch paginated first-level comments for comment analysis.
+- Fetch paginated replies under a first-level comment.
+- Continue Kuaishou list pagination only when `next_page_token` is non-empty; an empty string means there are no more results to request.
+- Read creator profile data from a profile link, short link, share text, or user_id.
+- Fetch paginated creator work lists from a user_id, profile link, short link, or share text.
+
 Current Douyin workflows include:
 
 - Fetch the current Douyin main hot search list.
@@ -207,8 +257,9 @@ Current Douyin workflows include:
 
 | Tool | Public purpose |
 | --- | --- |
+| `xhs_get_search_hot_list` | Fetch the current Xiaohongshu / 小红书 search hot list with each item's title and heat value. |
 | `xhs_search_notes` | Search Xiaohongshu / 小红书 notes by keyword with optional sort, note type, and publish-time filters. |
-| `xhs_get_note_detail_by_note_url` | Resolve a shared XHS link, short link, share text, or note ID into structured note details. |
+| `xhs_get_note_detail_by_note_url` | Resolve a shared XHS link, short link, or share text into structured note details. |
 | `xhs_get_note_detail_by_note_id` | Fetch structured note details when the caller already has a note ID. |
 | `xhs_get_note_comments_by_note_id` | Fetch paginated first-level comments when the caller already has a note ID. |
 | `xhs_get_note_comments_by_note_url` | Fetch paginated first-level comments directly from a shared note URL, short link, or share text. |
@@ -223,7 +274,7 @@ Current Douyin workflows include:
 | Tool | Public purpose |
 | --- | --- |
 | `douyin_get_hot_search_list` | Fetch the current Douyin main hot search list. |
-| `douyin_search_videos` | Search Douyin works by keyword with optional paging and filters. |
+| `douyin_search_videos` | Search Douyin works by keyword with optional `page_token` continuation and filters; do not pass `page`. |
 | `douyin_get_video_detail_by_aweme_id` | Fetch structured Douyin work details when the caller already has an aweme_id. |
 | `douyin_get_video_detail_by_url` | Resolve a Douyin content page link, short link, or share text into structured Douyin work details. |
 | `douyin_get_video_comments_by_aweme_id` | Fetch paginated first-level comments when the caller already has an aweme_id. |
@@ -236,6 +287,22 @@ Current Douyin workflows include:
 | `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. |
 | `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. |
 
+## Kuaishou Tools
+
+| Tool | Public purpose |
+| --- | --- |
+| `kuaishou_get_hot_search_list` | Get the current Kuaishou / 快手 short-video hot list. |
+| `kuaishou_search_videos` | Search Kuaishou works by natural-language keyword with optional `page_token` continuation; do not pass `page`. |
+| `kuaishou_get_video_detail_by_photo_id` | Fetch structured work details when the caller already has a photo_id. |
+| `kuaishou_get_video_detail_by_url` | Resolve a Kuaishou work page link, short link, or share text into structured work details. |
+| `kuaishou_get_video_comments_by_photo_id` | Fetch paginated first-level comments when the caller already has a photo_id. |
+| `kuaishou_get_video_comments_by_url` | Fetch paginated first-level comments directly from a Kuaishou work page link, short link, or share text. |
+| `kuaishou_get_video_comment_replies_by_comment_id` | Fetch paginated replies under a first-level comment by photo_id and comment_id. |
+| `kuaishou_get_user_info_by_user_id` | Fetch creator profile data when the caller already has a user_id. |
+| `kuaishou_get_user_info_by_profile_url` | Resolve a Kuaishou profile link, short link, or share text into creator profile data. |
+| `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. |
+| `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. |
+
 ## Quick Start
 
 For agents that can execute shell commands, use the direct CLI. This is the recommended default for installed skills:
@@ -244,9 +311,10 @@ For agents that can execute shell commands, use the direct CLI. This is the reco
 export SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>"
 npx -y socialdatax-skills@latest xhs search --keyword "露营桌" --pretty
 npx -y socialdatax-skills@latest douyin search --keyword "露营桌" --pretty
+npx -y socialdatax-skills@latest kuaishou search --keyword "露营桌" --pretty
 ```
 
-MCP client configuration belongs to platform MCP listings. For XHS, use the `xhs-insights` docs; for Douyin, use the `douyin-insights` listing.
+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.
 
 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.
 
@@ -262,7 +330,7 @@ Use the key as a Bearer token in the `Authorization` request header. Do not comm
 
 Public metadata files in this repository:
 
-- [skills](skills): AgentSkills-compatible skills split by social media capability and currently backed by XHS and Douyin tools.
+- [skills](skills): AgentSkills-compatible skills split by social media capability and currently backed by XHS, Douyin, and Kuaishou tools.
 
 ## License