socialdatax-skills 0.2.7 → 0.2.9

package/README.md

@@ -2,13 +2,13 @@
 
 This public package provides the unified skill installer and direct CLI helper for SocialDataX services.
 
-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.
+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.
 
 - 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
 - links to platform-specific MCP docs when a client should use MCP directly
 
-The business implementation is privately hosted. This repository exposes only the public package, skill, and connection surface for read-only social media intelligence workflows. It is not a unified MCP server and does not include a registry server card; platform MCPs are published separately.
+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.
 
 ## Search Aliases
 
@@ -30,6 +30,10 @@ Common search phrases for this skill package:
 - `Kuaishou skills`
 - `Kwai skills`
 - `快手 skills`
+- `Weibo skills`
+- `微博 skills`
+- `WeChat Channels skills`
+- `视频号 skills`
 - `SocialDataX content research`
 - `content research assistant`
 
@@ -38,17 +42,23 @@ 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`
+- Weibo hosted MCP endpoint: `https://mcp.52choujiang.com/weibo/mcp`
+- WeChat Channels hosted MCP endpoint: `https://mcp.52choujiang.com/wechat/mcp`
 - Hosted transport: `streamable-http`
 - Authentication: `Authorization: Bearer <SOCIALDATAX_API_KEY>`
-- Website: <https://socialdatax.com>
+- Website: <https://socialdatax.52choujiang.com>
 - XHS current platform MCP registry name: `com.52choujiang/xhs-insights`
 - 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`
+- Weibo current platform MCP registry name: `com.52choujiang/weibo-insights`
+- Weibo future platform MCP registry name: `com.socialdatax/weibo-insights`
+- WeChat Channels current platform MCP registry name: `com.52choujiang/wechat-channels-insights`
+- WeChat Channels future platform MCP registry name: `com.socialdatax/wechat-channels-insights`
 - Unified MCP registry name: none; this package installs skills and calls explicit platform services.
-- Current public capability version: `0.2.7`
+- Current public capability version: `0.2.9`
 
 ## Direct CLI
 
@@ -89,10 +99,35 @@ npx -y socialdatax-skills@latest kuaishou user-info --user-id "<user_id>" --pret
 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
+npx -y socialdatax-skills@latest weibo hot-search --pretty
+npx -y socialdatax-skills@latest weibo search --keyword "露营桌" --pretty
+npx -y socialdatax-skills@latest weibo detail --post-id "<post_id>" --pretty
+npx -y socialdatax-skills@latest weibo detail --post-url "<weibo_post_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest weibo comments --post-id "<post_id>" --pretty
+npx -y socialdatax-skills@latest weibo comments --post-id "<post_id>" --all --include-replies --pretty
+npx -y socialdatax-skills@latest weibo comments --post-url "<weibo_post_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest weibo replies --post-id "<post_id>" --comment-id "<comment_id>" --pretty
+npx -y socialdatax-skills@latest weibo user-info --user-id "<user_id>" --pretty
+npx -y socialdatax-skills@latest weibo user-info --profile-url "<profile_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest weibo user-posts --user-id "<user_id>" --pretty
+npx -y socialdatax-skills@latest weibo user-posts --profile-url "<profile_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest wechat hot-search --pretty
+npx -y socialdatax-skills@latest wechat search --keyword "露营桌" --pretty
+npx -y socialdatax-skills@latest wechat detail --encrypted-object-id "<encrypted_object_id>" --pretty
+npx -y socialdatax-skills@latest wechat detail --url "<wechat_video_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest wechat comments --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --pretty
+npx -y socialdatax-skills@latest wechat comments --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --all --include-replies --pretty
+npx -y socialdatax-skills@latest wechat comments --url "<wechat_video_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest wechat replies --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --comment-id "<comment_id>" --pretty
+npx -y socialdatax-skills@latest wechat user-info --user-id "<finder_user_id>" --pretty
+npx -y socialdatax-skills@latest wechat user-posts --user-id "<finder_user_id>" --pretty
+npx -y socialdatax-skills@latest wechat user-posts --url "<wechat_video_url_or_share_text>" --pretty
 ```
 
 The direct CLI prints a JSON envelope with `platform`, `tool`, `arguments`, and `data`.
 
+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`.
+
 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.
@@ -101,9 +136,9 @@ For first-level comments, add `--include-replies` to fetch the second-level repl
 
 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.
+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.
 
-Kuaishou search uses `--keyword` and optional `--page-token`; it does not accept Douyin semantic filters.
+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`.
 
 Douyin search filters use semantic values: `--sort-type` supports `general`,
 `time_descending`, and `like_count_descending`; `--publish-time-range` supports
@@ -111,6 +146,10 @@ Douyin search filters use semantic values: `--sort-type` supports `general`,
 `under_1_minute`, `one_to_five_minutes`, and `over_5_minutes`; `--content-type`
 supports `all`, `video`, and `image`.
 
+WeChat Channels search filters use semantic values: `--sort-type` supports
+`all`, `latest`, and `popular`; `--duration-range` supports `all`,
+`under_5_min`, `between_5_and_20_min`, and `over_20_min`.
+
 ### Runtime Requirements
 
 - Recommended: Node.js 22 LTS or newer.
@@ -131,11 +170,11 @@ npx -y socialdatax-skills@latest doctor
 npx -y socialdatax-skills@latest doctor --json
 ```
 
-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. Data calls are read-only, require `SOCIALDATAX_API_KEY` at runtime, and do not read local browser data.
+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.
 
 ## Platform Names
 
-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.
+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.
 
 ### Local Source Run
 
@@ -144,6 +183,8 @@ 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
+SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" node cli.mjs weibo search --keyword "露营桌" --pretty
+SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" node cli.mjs wechat search --keyword "露营桌" --pretty
 ```
 
 ### Docker Run
@@ -153,6 +194,8 @@ 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
+docker run --rm -i -e SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" socialdatax-skills weibo search --keyword "露营桌" --pretty
+docker run --rm -i -e SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" socialdatax-skills wechat 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:
@@ -190,16 +233,20 @@ 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
+npx -y socialdatax-skills@latest weibo hot-search --pretty
+npx -y socialdatax-skills@latest weibo search --keyword "露营桌" --pretty
+npx -y socialdatax-skills@latest wechat hot-search --pretty
+npx -y socialdatax-skills@latest wechat 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, 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.
+- `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.
+- `media-search`: search social media content by keyword; supports XHS notes, Douyin works, Kuaishou works, Weibo posts, and WeChat Channels videos.
+- `media-detail`: read structured content details and metrics; supports XHS notes, Douyin works, Kuaishou works, Weibo posts, and WeChat Channels videos.
+- `media-comments`: fetch and analyze XHS comments/replies, Douyin comments/replies, Kuaishou comments/replies, Weibo comments/replies, and WeChat Channels comments/replies.
+- `media-user-info`: retrieve creator profile information; supports XHS, Douyin, Kuaishou, Weibo, and WeChat Channels creators.
+- `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.
 
 Default install locations:
 
@@ -215,9 +262,9 @@ Default install locations:
 
 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.
 
-## Read-Only Scope
+## Workflow Scope
 
-The current platform MCP services are designed for read-only social media intelligence workflows. They do not provide account login, posting, editing, liking, commenting, or other account actions.
+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.
 
 Current XHS workflows include:
 
@@ -229,6 +276,7 @@ Current XHS workflows include:
 - 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.
+- Submit and check video note 口播转文字 / speech-to-text transcript jobs; submit tools 提交完成后最多短等 15 秒.
 
 Current Kuaishou workflows include:
 
@@ -240,6 +288,7 @@ Current Kuaishou workflows include:
 - 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.
+- Submit and check video work 口播转文字 / speech-to-text transcript jobs; submit tools 提交完成后最多短等 15 秒.
 
 Current Douyin workflows include:
 
@@ -252,6 +301,29 @@ Current Douyin workflows include:
 - Read creator profile data from a profile link, short link, share text, or sec_user_id.
 - Fetch paginated creator work lists from a sec_user_id, profile link, short link, or share text.
 - Fetch paginated creator short-drama series lists from a sec_user_id, profile link, short link, or share text.
+- Submit and check video work 口播转文字 / speech-to-text transcript jobs; submit tools 提交完成后最多短等 15 秒.
+
+Current Weibo workflows include:
+
+- Fetch the current Weibo / 微博 hot-search list.
+- Search related Weibo posts by keyword.
+- Resolve a Weibo post URL, short link, share text, or post_id into structured post details.
+- Fetch paginated first-level comments for comment analysis.
+- Fetch paginated replies under a first-level comment.
+- Continue Weibo 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 post lists from a user_id, profile link, short link, or share text.
+
+Current WeChat Channels / 视频号 workflows include:
+
+- Fetch the current WeChat Channels / 视频号 hot-search list.
+- Search related WeChat Channels videos by keyword with optional sort and duration filters.
+- Resolve a WeChat Channels video link, share text, or encrypted_object_id into structured video details.
+- Fetch paginated first-level comments for comment analysis.
+- Fetch paginated replies under a first-level comment; pass `object_id`, `object_nonce_id`, and `comment_id`.
+- Continue WeChat Channels 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 finder user_id.
+- Fetch paginated creator video lists from a finder user_id or a video link/share text.
 
 ## XHS Tools
 
@@ -303,6 +375,37 @@ Current Douyin workflows include:
 | `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. |
 
+## Weibo Tools
+
+| Tool | Public purpose |
+| --- | --- |
+| `weibo_get_hot_search_list` | Fetch the current Weibo / 微博 hot-search list. |
+| `weibo_search_posts` | Search Weibo posts by keyword with optional `page_token` continuation; do not pass `page`. |
+| `weibo_get_post_detail_by_post_id` | Fetch structured Weibo post details when the caller already has a post_id. |
+| `weibo_get_post_detail_by_post_url` | Resolve a Weibo post URL, short link, or share text into structured post details. |
+| `weibo_get_post_comments_by_post_id` | Fetch paginated first-level comments when the caller already has a post_id. |
+| `weibo_get_post_comments_by_post_url` | Fetch paginated first-level comments directly from a Weibo post URL, short link, or share text. |
+| `weibo_get_post_comment_replies_by_comment_id` | Fetch paginated replies under a first-level comment by post_id and comment_id. |
+| `weibo_get_user_info_by_user_id` | Fetch creator profile data when the caller already has a user_id. |
+| `weibo_get_user_info_by_profile_url` | Resolve a Weibo profile link, short link, or share text into creator profile data. |
+| `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. |
+| `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. |
+
+## WeChat Channels Tools
+
+| Tool | Public purpose |
+| --- | --- |
+| `wechat_get_hot_search_list` | Fetch the current WeChat Channels / 视频号 hot-search list. |
+| `wechat_search_videos` | Search WeChat Channels / 视频号 videos by keyword with optional `page_token` continuation and filters; do not pass `page`. |
+| `wechat_get_video_detail_by_encrypted_object_id` | Fetch structured WeChat Channels video details when encrypted_object_id is already known. |
+| `wechat_get_video_detail_by_url` | Resolve a WeChat Channels / 视频号 video link or share text into structured video details. |
+| `wechat_get_video_comments_by_object_id` | Fetch paginated first-level comments when object_id and object_nonce_id are known. |
+| `wechat_get_video_comments_by_url` | Fetch paginated first-level comments directly from a WeChat Channels / 视频号 video link or share text. |
+| `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. |
+| `wechat_get_user_info_by_user_id` | Fetch creator profile data when the finder user_id is already known. |
+| `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. |
+| `wechat_get_user_posted_videos_by_url` | Fetch a paginated list of videos published by a creator from a video 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:
@@ -312,9 +415,11 @@ 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
+npx -y socialdatax-skills@latest weibo search --keyword "露营桌" --pretty
+npx -y socialdatax-skills@latest wechat 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; for Kuaishou, use the `kuaishou-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; for Weibo, use the `weibo-insights` listing; for WeChat Channels / 视频号, use the `wechat-channels-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.
 
@@ -322,7 +427,7 @@ Aily is treated as an OpenClaw / AgentSkills ecosystem channel for this package.
 
 Request or manage API access from the product website:
 
-<https://socialdatax.com/?from=npm>
+<https://socialdatax.52choujiang.com/?from=npm>
 
 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,7 +435,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, Douyin, and Kuaishou tools.
+- [skills](skills): AgentSkills-compatible skills split by social media capability and currently backed by XHS, Douyin, Kuaishou, Weibo, and WeChat Channels tools.
 
 ## License