socialdatax-skills 0.2.23 → 0.2.25

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, 抖音 / Douyin, 快手 / Kuaishou / Kwai, 微博 / Weibo, 视频号 / WeChat Channels, and 微信公众号 / WeChat Official Account article content research and analysis workflows, plus 敏感词检测 / 违禁词检查 text checks. The public skill layer is intentionally named by capability so supported services can evolve without changing the installation model.
+The current public tools support 小红书 / Xiaohongshu / XHS / RedNote, 抖音 / Douyin, 快手 / Kuaishou / Kwai, 微博 / Weibo, 视频号 / WeChat Channels, and 微信公众号 / WeChat Official Account article content research and analysis workflows, plus Bilibili / 哔哩哔哩 / B站 local video download and 敏感词检测 / 违禁词检查 text checks. The public skill layer is intentionally named by capability so supported services 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
@@ -33,6 +33,9 @@ Common search phrases for this skill package:
 - `Kuaishou skills`
 - `Kwai skills`
 - `快手 skills`
+- `Bilibili skills`
+- `B站视频下载`
+- `哔哩哔哩视频下载`
 - `Weibo skills`
 - `微博 skills`
 - `WeChat Channels skills`
@@ -54,6 +57,7 @@ Common search phrases for this skill package:
 - XHS hosted MCP endpoint: `https://mcp.socialdatax.com/xhs/mcp`
 - Douyin hosted MCP endpoint: `https://mcp.socialdatax.com/douyin/mcp`
 - Kuaishou hosted MCP endpoint: `https://mcp.socialdatax.com/kuaishou/mcp`
+- Bilibili hosted MCP endpoint: `https://mcp.socialdatax.com/bilibili/mcp`
 - Weibo hosted MCP endpoint: `https://mcp.socialdatax.com/weibo/mcp`
 - WeChat / 微信 hosted MCP endpoint: `https://mcp.socialdatax.com/wechat/mcp`
 - Sensitive Words Check hosted MCP endpoint: `https://mcp.socialdatax.com/sensitive-check/mcp`
@@ -66,6 +70,8 @@ Common search phrases for this skill package:
 - 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`
+- Bilibili current platform MCP registry name: `com.52choujiang/bilibili-insights`
+- Bilibili future platform MCP registry name: `com.socialdatax/bilibili-insights`
 - Weibo current platform MCP registry name: `com.52choujiang/weibo-insights`
 - Weibo future platform MCP registry name: `com.socialdatax/weibo-insights`
 - WeChat / 微信 current platform MCP registry name: `com.52choujiang/wechat-channels-insights`
@@ -73,7 +79,7 @@ Common search phrases for this skill package:
 - Sensitive Words Check MCP server name: `sensitive-check`
 - Sensitive Words Check future MCP registry name: `com.socialdatax/sensitive-check`
 - Unified MCP registry name: none; this package installs skills and calls explicit platform services.
-- Current public capability version: `0.2.23`
+- Current public capability version: `0.2.25`
 
 ## Direct CLI
 
@@ -87,6 +93,7 @@ npx -y socialdatax-skills@latest xhs search --keyword "露营" --since-days 7 --
 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>" --sort-type time_descending --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
@@ -126,6 +133,7 @@ npx -y socialdatax-skills@latest kuaishou user-posts --profile-url "<profile_url
 npx -y socialdatax-skills@latest kuaishou transcript --url "<kuaishou_content_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest kuaishou transcript --photo-id "<photo_id>" --pretty
 npx -y socialdatax-skills@latest kuaishou transcript --job-id "<job_id>" --pretty
+npx -y socialdatax-skills@latest bilibili download --url "<bilibili_video_url_or_share_text>" --output-dir ./downloads --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
@@ -164,6 +172,8 @@ npx -y socialdatax-skills@latest sensitive-check text --text "<content>" --platf
 
 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`.
 
+`bilibili download` calls SocialDataX once to fetch short-lived download links, then downloads video and audio tracks on the local machine and merges them with local `ffmpeg`. Set `SOCIALDATAX_API_KEY`, install `ffmpeg`, and pass either `--output <file>` or `--output-dir <directory>`. The download-links request consumes 10 credits; the local track download and merge do not consume additional SocialDataX credits. Use `--ffmpeg-path <path>` when `ffmpeg` is not on `PATH`, and `--keep-tracks` to retain the separate track files after merge.
+
 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.
@@ -186,6 +196,10 @@ XHS, Douyin, Kuaishou, Weibo, and WeChat Channels search use `--keyword` and opt
 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`.
 Weibo and WeChat Channels search use `--keyword` and optional `--page-token`.
 
+XHS comments accept optional `--sort-type` values: `default`,
+`time_descending`, and `like_count_descending`; omit it for the platform
+default comment order.
+
 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`,
@@ -203,6 +217,7 @@ WeChat Channels search filters use semantic values: `--sort-type` supports
 - Recommended: Node.js 22 LTS or newer.
 - Minimum: Node.js 20.18.1.
 - Node.js 18 and older are not supported.
+- Local Bilibili download merge requires `ffmpeg` on `PATH` or `--ffmpeg-path <path>`.
 
 ### Environment
 
@@ -222,7 +237,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, Kuaishou, Kwai, Weibo, WeChat, WeChat Channels, 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, Bilibili, Weibo, WeChat, WeChat Channels, or their affiliates. Platform names are used only to describe supported data sources.
 
 ### Local Source Run
 
@@ -231,6 +246,7 @@ 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 bilibili download --url "<bilibili_video_url_or_share_text>" --output-dir ./downloads --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
 SOCIALDATAX_API_KEY="<SOCIALDATAX_API_KEY>" node cli.mjs sensitive-check text --text "<content>" --platform xhs --pretty
@@ -287,6 +303,7 @@ npx -y socialdatax-skills@latest douyin transcript --aweme-id "<aweme_id>" --pre
 npx -y socialdatax-skills@latest kuaishou hot-search --pretty
 npx -y socialdatax-skills@latest kuaishou search --keyword "露营" --pretty
 npx -y socialdatax-skills@latest kuaishou transcript --photo-id "<photo_id>" --pretty
+npx -y socialdatax-skills@latest bilibili download --url "<bilibili_video_url_or_share_text>" --output-dir ./downloads --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 transcript --post-id "<post_id>" --pretty
@@ -351,6 +368,12 @@ Current Kuaishou workflows include:
 - Fetch paginated creator work lists from a non-empty user_id, or from a profile link, short link, or share text that resolves directly to a non-empty user_id. For live/fw-user profile shares, call creator profile first and use the returned non-empty user_id.
 - Submit and check video work 口播转文字 / speech-to-text transcript jobs; submit tools 提交后最多等待 15 秒.
 
+Current Bilibili workflows include:
+
+- Resolve a Bilibili video page link or share text into short-lived DASH download links.
+- Download the selected video and audio tracks locally.
+- Merge the local tracks with `ffmpeg -c copy`.
+
 Current Douyin workflows include:
 
 - Fetch the current Douyin main hot search list.
@@ -405,8 +428,8 @@ Current Sensitive Words Check workflows include:
 | `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, 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. |
+| `xhs_get_note_comments_by_note_id` | Fetch paginated first-level comments when the caller already has a note ID; accepts optional comment `sort_type`. |
+| `xhs_get_note_comments_by_note_url` | Fetch paginated first-level comments directly from a shared note URL, short link, or share text; accepts optional comment `sort_type`. |
 | `xhs_get_note_sub_comments_by_comment_id` | Fetch paginated replies under a first-level comment by note ID and comment ID. |
 | `xhs_get_user_info_by_user_id` | Fetch creator profile data when the caller already has a user ID. |
 | `xhs_get_user_info_by_profile_url` | Resolve a profile link, short link, or share text into creator profile data. |
@@ -457,6 +480,12 @@ Current Sensitive Words Check workflows include:
 | `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. |
 | `kuaishou_get_video_speech_text_job` | Check a Kuaishou speech-to-text transcript job by job_id without creating a new task. Returns transcript plus content context, not summary. |
 
+## Bilibili Tools
+
+| Tool | Public purpose |
+| --- | --- |
+| `bilibili_get_video_download_links` | Fetch short-lived DASH video/audio download links and merge guidance for a Bilibili video URL or share text. |
+
 ## Weibo Tools
 
 | Tool | Public purpose |
@@ -510,12 +539,13 @@ 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 bilibili download --url "<bilibili_video_url_or_share_text>" --output-dir ./downloads --pretty
 npx -y socialdatax-skills@latest weibo search --keyword "露营" --pretty
 npx -y socialdatax-skills@latest wechat search --keyword "露营" --pretty
 npx -y socialdatax-skills@latest sensitive-check text --text "<content>" --platform xhs --pretty
 ```
 
-MCP client configuration belongs to platform or capability 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 / 微信, use the `wechat-channels-insights` listing; for 敏感词检测 / 违禁词检查, use the `sensitive-check` server.
+MCP client configuration belongs to platform or capability MCP listings. For XHS, use the `xhs-insights` docs; for Douyin, use the `douyin-insights` listing; for Kuaishou, use the `kuaishou-insights` listing; for Bilibili, use the `bilibili-insights` listing; for Weibo, use the `weibo-insights` listing; for WeChat / 微信, use the `wechat-channels-insights` listing; for 敏感词检测 / 违禁词检查, use the `sensitive-check` server.
 
 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.