socialdatax-skills 0.2.1 → 0.2.3

package/README.md

@@ -1,6 +1,6 @@
 # SocialDataX Skills | 社媒数据助手 Skills
 
-This public repository provides the unified skill installer and direct CLI helper for SocialDataX services.
+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.
 
@@ -27,6 +27,8 @@ Common search phrases for this skill package:
 - `RedNote skills`
 - `Douyin skills`
 - `抖音 skills`
+- `SocialDataX content research`
+- `content research assistant`
 
 ## Platform MCPs
 
@@ -40,7 +42,7 @@ Common search phrases for this skill package:
 - Douyin current platform MCP registry name: `com.52choujiang/douyin-insights`
 - Douyin future platform MCP registry name: `com.socialdatax/douyin-insights`
 - Unified MCP registry name: none; this package installs skills and calls explicit platform services.
-- Current public capability version: `0.2.1`
+- Current public capability version: `0.2.3`
 
 ## Direct CLI
 
@@ -55,13 +57,17 @@ npx -y socialdatax-skills@latest xhs comments --note-id "<note_id>" --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
+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 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
 npx -y socialdatax-skills@latest douyin user-posts --sec-user-id "<sec_user_id>" --pretty
 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
 ```
 
 The direct CLI prints a JSON envelope with `platform`, `tool`, `arguments`, and `data`.
@@ -82,12 +88,6 @@ supports `all`, `video`, and `image`.
 
 - `SOCIALDATAX_API_KEY`
   Required for direct CLI data calls and hosted MCP calls. Local inspection commands such as `list`, `doctor`, and `install --dry-run` do not require a key.
-- `SOCIAL_MEDIA_MCP_UPSTREAM_URL`
-  Optional generic override for the selected platform MCP endpoint.
-- `SOCIAL_MEDIA_XHS_MCP_UPSTREAM_URL`
-  Optional XHS-specific endpoint override. Default: `https://mcp.52choujiang.com/xhs/mcp`
-- `SOCIAL_MEDIA_DOUYIN_MCP_UPSTREAM_URL`
-  Optional Douyin-specific endpoint override. Default: `https://mcp.52choujiang.com/douyin/mcp`
 
 ## Security & Privacy
 
@@ -135,6 +135,7 @@ npx -y socialdatax-skills@latest list
 npx -y socialdatax-skills@latest doctor
 npx -y socialdatax-skills@latest install --target openclaw
 npx -y socialdatax-skills@latest install --target openclaw --dry-run
+npx -y socialdatax-skills@latest install socialdatax-content-research-assistant --target openclaw
 npx -y socialdatax-skills@latest install media-search --target openclaw
 npx -y socialdatax-skills@latest install media-search --target openclaw --dry-run
 npx -y socialdatax-skills@latest install media-user-info --target openclaw
@@ -148,16 +149,19 @@ 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 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
 ```
 
 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 first-level comments.
+- `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 and Douyin works.
+- `media-user-posts`: retrieve creator content lists; supports XHS notes, Douyin works, and Douyin creator short-drama series.
 
 Default install locations:
 
@@ -189,11 +193,15 @@ Current XHS workflows include:
 
 Current Douyin workflows include:
 
+- Fetch the current Douyin main hot search list.
 - Search related Douyin works by keyword.
 - Resolve a Douyin content page link, short link, share text, or aweme_id into structured work details.
 - Fetch paginated first-level comments for comment analysis.
+- Fetch paginated replies under a first-level comment.
+- Continue Douyin comment and reply pagination only when `next_page_token` is non-empty; an empty string means there are no more comments or replies to request.
 - 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.
 
 ## XHS Tools
 
@@ -214,15 +222,19 @@ 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_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. |
 | `douyin_get_video_comments_by_url` | Fetch paginated first-level comments directly from a Douyin content page URL, short link, or share text. |
+| `douyin_get_video_comment_replies_by_comment_id` | Fetch paginated replies under a first-level Douyin comment by aweme_id and comment_id. |
 | `douyin_get_user_info_by_sec_user_id` | Fetch creator profile data when the caller already has a sec_user_id. |
 | `douyin_get_user_info_by_profile_url` | Resolve a profile link, short link, or share text into creator profile data. |
 | `douyin_get_user_posted_videos_by_sec_user_id` | Fetch a paginated list of works published by a creator when the caller already has a sec_user_id. |
 | `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. |
+| `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. |
 
 ## Quick Start
 

package/cli.mjs

@@ -7,7 +7,7 @@ import { dirname, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
 const PACKAGE_NAME = "socialdatax-skills";
-const PACKAGE_VERSION = "0.2.1";
+const PACKAGE_VERSION = "0.2.3";
 const PACKAGE_SPEC = `${PACKAGE_NAME}@latest`;
 const LOG_PREFIX = `[${PACKAGE_NAME}]`;
 const MIN_NODE_VERSION = "20.18.1";
@@ -16,6 +16,12 @@ const PRIMARY_API_KEY_ENV = "SOCIALDATAX_API_KEY";
 const LEGACY_API_KEY_ENV = "SOCIAL_MEDIA_MCP_API_KEY";
 const API_KEY_ENV_NAMES = [PRIMARY_API_KEY_ENV, LEGACY_API_KEY_ENV];
 const AVAILABLE_SKILLS = [
+  {
+    name: "socialdatax-content-research-assistant",
+    summary:
+      "Coordinate cross-platform content research across XHS and Douyin.",
+    emoji: "🔎",
+  },
   {
     name: "media-search",
     summary: "Search XHS notes and Douyin works by keyword with optional filters.",
@@ -28,7 +34,7 @@ const AVAILABLE_SKILLS = [
   },
   {
     name: "media-comments",
-    summary: "Fetch and analyze XHS comments/replies and Douyin first-level comments.",
+    summary: "Fetch and analyze XHS comments/replies and Douyin comments/replies.",
     emoji: "💬",
   },
   {
@@ -38,7 +44,8 @@ const AVAILABLE_SKILLS = [
   },
   {
     name: "media-user-posts",
-    summary: "Retrieve creator content lists for XHS and Douyin.",
+    summary:
+      "Retrieve creator content lists for XHS and Douyin, including Douyin creator short-drama series.",
     emoji: "🗂️",
   },
 ];
@@ -80,6 +87,7 @@ const XHS_LEGACY_SEARCH_SORT_TYPE_ALIASES = {
   collect_descending: "collect_count_descending",
 };
 const DOUYIN_DIRECT_ACTION_OPTIONS = {
+  "hot-search": ["pretty"],
   search: [
     "keyword",
     "pageToken",
@@ -91,9 +99,12 @@ const DOUYIN_DIRECT_ACTION_OPTIONS = {
   ],
   detail: ["awemeId", "url", "pretty"],
   comments: ["awemeId", "url", "pageToken", "pretty"],
+  replies: ["awemeId", "commentId", "pageToken", "pretty"],
   "user-info": ["secUserId", "profileUrl", "pretty"],
   "user-posts": ["secUserId", "profileUrl", "pageToken", "pretty"],
+  "user-series": ["secUserId", "profileUrl", "pageToken", "pretty"],
 };
+const DOUYIN_DIRECT_ACTION_NAMES = Object.keys(DOUYIN_DIRECT_ACTION_OPTIONS).join(", ");
 const DOUYIN_SEARCH_SORT_TYPES = ["general", "time_descending", "like_count_descending"];
 const DOUYIN_SEARCH_PUBLISH_TIME_RANGES = ["all", "day", "week", "half_year"];
 const DOUYIN_SEARCH_DURATION_RANGES = [
@@ -193,6 +204,10 @@ const PLATFORMS = {
       "DOUYIN_MCP_UPSTREAM_URL",
     ],
     tools: [
+      {
+        name: "douyin_get_hot_search_list",
+        description: "Fetch the current Douyin main hot search list.",
+      },
       {
         name: "douyin_get_video_detail_by_aweme_id",
         description: "Fetch structured Douyin work details by aweme_id.",
@@ -209,6 +224,10 @@ const PLATFORMS = {
         name: "douyin_get_video_comments_by_url",
         description: "Fetch paginated first-level comments from a Douyin content page link, short link, or share text.",
       },
+      {
+        name: "douyin_get_video_comment_replies_by_comment_id",
+        description: "Fetch paginated replies under a first-level Douyin comment by aweme_id and comment_id.",
+      },
       {
         name: "douyin_get_user_info_by_sec_user_id",
         description: "Fetch creator profile data by sec_user_id.",
@@ -225,6 +244,14 @@ const PLATFORMS = {
         name: "douyin_get_user_posted_videos_by_profile_url",
         description: "Fetch creator works from a profile link, short link, or share text.",
       },
+      {
+        name: "douyin_get_user_series_by_sec_user_id",
+        description: "Fetch a paginated list of short-drama series published by a creator.",
+      },
+      {
+        name: "douyin_get_user_series_by_profile_url",
+        description: "Fetch creator short-drama series from a profile link, short link, or share text.",
+      },
       {
         name: "douyin_search_videos",
         description: "Search Douyin works by keyword with optional paging and filters.",
@@ -870,6 +897,9 @@ function printHelp() {
   console.log(`  npx -y ${PACKAGE_SPEC} xhs user-posts --user-id "<user_id>" --pretty`);
   console.log("      Call the XHS creator posts tool directly and print JSON.");
   console.log("");
+  console.log(`  npx -y ${PACKAGE_SPEC} douyin hot-search --pretty`);
+  console.log("      Call the Douyin main hot search list tool directly and print JSON.");
+  console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} douyin search --keyword "露营桌" --pretty`);
   console.log("      Call the Douyin work search tool directly and print JSON.");
   console.log("");
@@ -879,6 +909,11 @@ function printHelp() {
   console.log(`  npx -y ${PACKAGE_SPEC} douyin comments --aweme-id "<aweme_id>" --pretty`);
   console.log("      Call the Douyin work comments tool directly and print JSON.");
   console.log("");
+  console.log(
+    `  npx -y ${PACKAGE_SPEC} douyin replies --aweme-id "<aweme_id>" --comment-id "<comment_id>" --pretty`
+  );
+  console.log("      Call the Douyin comment replies tool directly and print JSON.");
+  console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} douyin user-info --sec-user-id "<sec_user_id>" --pretty`);
   console.log("      Call the Douyin creator profile tool directly and print JSON.");
   console.log("");
@@ -891,6 +926,12 @@ function printHelp() {
   console.log(`  npx -y ${PACKAGE_SPEC} douyin user-posts --profile-url "<profile_url_or_share_text>" --pretty`);
   console.log("      Call the Douyin creator works tool from a profile link or share text.");
   console.log("");
+  console.log(`  npx -y ${PACKAGE_SPEC} douyin user-series --sec-user-id "<sec_user_id>" --pretty`);
+  console.log("      Call the Douyin creator short-drama series tool directly and print JSON.");
+  console.log("");
+  console.log(`  npx -y ${PACKAGE_SPEC} douyin user-series --profile-url "<profile_url_or_share_text>" --pretty`);
+  console.log("      Call the Douyin creator short-drama series tool from a profile link or share text.");
+  console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} list`);
   console.log("      List available skills.");
   console.log("");
@@ -1039,7 +1080,7 @@ async function runDouyinDirectCommand(args) {
   const action = positional[0];
   if (!action) {
     throw new Error(
-      `Missing Douyin command. Use search, detail, comments, user-info, or user-posts.`
+      `Missing Douyin command. Use ${DOUYIN_DIRECT_ACTION_NAMES}.`
     );
   }
   if (positional.length > 1) {
@@ -1135,6 +1176,15 @@ function buildXhsOperation(action, options) {
 
 function buildDouyinOperation(action, options) {
   switch (action) {
+    case "hot-search":
+      return buildDirectOperation(
+        "hot-search",
+        {
+          tool: "douyin_get_hot_search_list",
+          toolArguments: {},
+        },
+        PLATFORMS.douyin
+      );
     case "search":
       return buildDirectOperation(
         "search",
@@ -1172,6 +1222,12 @@ function buildDouyinOperation(action, options) {
         }),
         PLATFORMS.douyin
       );
+    case "replies":
+      return buildDirectOperation(
+        "replies",
+        buildDouyinRepliesCall(options),
+        PLATFORMS.douyin
+      );
     case "user-info":
       return buildDirectOperation(
         "user-info",
@@ -1203,9 +1259,25 @@ function buildDouyinOperation(action, options) {
         }),
         PLATFORMS.douyin
       );
+    case "user-series":
+      return buildDirectOperation(
+        "user-series",
+        buildOneOfCall(options, {
+          idOption: "secUserId",
+          urlOption: "profileUrl",
+          idTool: "douyin_get_user_series_by_sec_user_id",
+          urlTool: "douyin_get_user_series_by_profile_url",
+          idArgument: "sec_user_id",
+          urlArgument: "profile_url",
+          idDisplay: "--sec-user-id",
+          urlDisplay: "--profile-url",
+          pageToken: options.pageToken,
+        }),
+        PLATFORMS.douyin
+      );
     default:
       throw new Error(
-        `Unsupported Douyin command "${action}". Use search, detail, comments, user-info, or user-posts.`
+        `Unsupported Douyin command "${action}". Use ${DOUYIN_DIRECT_ACTION_NAMES}.`
       );
   }
 }
@@ -1347,6 +1419,26 @@ function buildDouyinSearchCall(options) {
   };
 }
 
+function buildDouyinRepliesCall(options) {
+  if (!options.awemeId) {
+    throw new Error("Missing --aweme-id for douyin replies.");
+  }
+  if (!options.commentId) {
+    throw new Error("Missing --comment-id for douyin replies.");
+  }
+  const toolArguments = {
+    aweme_id: options.awemeId,
+    comment_id: options.commentId,
+  };
+  if (options.pageToken) {
+    toolArguments.page_token = options.pageToken;
+  }
+  return {
+    tool: "douyin_get_video_comment_replies_by_comment_id",
+    toolArguments,
+  };
+}
+
 
 function buildXhsSubCommentsCall(options) {
   if (!options.noteId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "socialdatax-skills",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "SocialDataX / 社媒数据助手 skill installer and direct CLI helper for hosted platform social media MCP services.",
   "license": "MIT",
   "type": "module",
@@ -46,6 +46,10 @@
   "bugs": {
     "url": "https://socialdatax.com"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DevinChen2014/socialdatax-skills.git"
+  },
   "engines": {
     "node": ">=20.18.1"
   },

package/skills/media-comments/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: media-comments
-description: Fetch and analyze XHS comments/replies and Douyin first-level comments. This version is backed by hosted platform MCP services and supports Xiaohongshu, 小红书, XHS, RedNote, and Douyin / 抖音.
+description: Fetch and analyze XHS comments/replies and Douyin comments/replies. This version is backed by hosted platform MCP services and supports Xiaohongshu, 小红书, XHS, RedNote, and Douyin / 抖音.
 metadata:
   openclaw:
     requires:
@@ -25,7 +25,12 @@ Use this skill when the user wants comment mining, audience feedback, sentiment
 Current platform support:
 
 - Xiaohongshu / XHS / RedNote notes through the `xhs_get_note_comments_by_*` and `xhs_get_note_sub_comments_by_comment_id` tools.
-- Douyin / 抖音 works, including video and image/text posts, through the `douyin_get_video_comments_by_*` tools.
+- Douyin / 抖音 works, including video and image/text posts, through the `douyin_get_video_comments_by_*` and `douyin_get_video_comment_replies_by_comment_id` tools.
+
+## API Key
+
+Use `SOCIALDATAX_API_KEY` for SocialDataX requests. To get or manage an API Key, open <https://socialdatax.com> and follow the website API Key access flow. If a user asks where to get a key, provide only this URL; do not infer alternate domains.
+获取或管理 API Key：访问 <https://socialdatax.com>，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。
 
 ## Preferred Direct CLI
 
@@ -37,16 +42,17 @@ npx -y socialdatax-skills@latest xhs comments --url "<note_url_or_share_text>" -
 npx -y socialdatax-skills@latest xhs sub-comments --note-id "<note_id>" --comment-id "<comment_id>" --pretty
 npx -y socialdatax-skills@latest douyin comments --aweme-id "<aweme_id>" --pretty
 npx -y socialdatax-skills@latest douyin comments --url "<douyin_content_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest douyin replies --aweme-id "<aweme_id>" --comment-id "<comment_id>" --pretty
 ```
 
 - XHS `--note-id <note_id>`: preferred when the note ID is already known and should anchor the comment thread.
 - Douyin `--aweme-id <aweme_id>`: preferred when the video ID is already known and should anchor the comment thread.
 - `--url <url_or_share_text>`: use for a content page URL, short link, or share text for first-level comments; for Douyin, do not pass `video.play_url`.
-- `--comment-id <comment_id>`: required only for XHS reply commands; use the first-level comment ID under the same content item.
+- `--comment-id <comment_id>`: required for XHS and Douyin reply commands; use the first-level comment ID under the same content item.
 - `--page-token <next_page_token>`: opaque pagination token; pass back exactly the token returned by the previous page and do not reuse it across content items or comments.
 - `--pretty`: output formatting only.
 
-For XHS `comments`, use either `--note-id` or `--url`, not both. For Douyin `comments`, use either `--aweme-id` or `--url`, not both. For XHS reply commands, use the content ID together with `--comment-id`.
+For XHS `comments`, use either `--note-id` or `--url`, not both. For Douyin `comments`, use either `--aweme-id` or `--url`, not both. For reply commands, use the content ID together with `--comment-id`.
 
 The command prints JSON with `platform`, `tool`, `arguments`, and `data`.
 
@@ -63,8 +69,9 @@ If MCP tools are already available in the current agent, use one of these tools:
 - `xhs_get_note_sub_comments_by_comment_id`: use when the note ID and first-level comment ID are known.
 - `douyin_get_video_comments_by_aweme_id`: use when the aweme_id is known.
 - `douyin_get_video_comments_by_url`: use for Douyin content page URLs, short links, or share text; do not pass playback URLs such as `video.play_url`.
+- `douyin_get_video_comment_replies_by_comment_id`: use when the aweme_id and first-level comment ID are known.
 
-Comment pagination uses `page_token`. Pass back exactly the returned `next_page_token`; tokens are bound to the current content item and should not be reused across objects. XHS reply pagination also uses `page_token` and is bound to the current comment.
+Comment pagination uses `page_token`. Pass back exactly the returned `next_page_token`; tokens are bound to the current content item and should not be reused across objects. For Douyin comments and replies, continue only when `next_page_token` is non-empty; an empty string means there are no more comments or replies to request. XHS reply pagination also uses `page_token` and is bound to the current comment.
 
 ## Output Guidance
 

package/skills/media-comments/agents/openai.yaml

@@ -1,7 +1,7 @@
 interface:
   display_name: "Media Comments"
   short_description: "Fetch social comments"
-  default_prompt: "Use $media-comments to fetch and analyze XHS comments/replies or Douyin first-level comments."
+  default_prompt: "Use $media-comments to fetch and analyze XHS comments/replies or Douyin comments/replies."
 
 policy:
   allow_implicit_invocation: true

package/skills/media-detail/SKILL.md

@@ -27,6 +27,11 @@ Current platform support:
 - Xiaohongshu / XHS / RedNote notes through the `xhs_get_note_detail_by_*` tools.
 - Douyin / 抖音 works, including video and image/text posts, through the `douyin_get_video_detail_by_*` tools.
 
+## API Key
+
+Use `SOCIALDATAX_API_KEY` for SocialDataX requests. To get or manage an API Key, open <https://socialdatax.com> and follow the website API Key access flow. If a user asks where to get a key, provide only this URL; do not infer alternate domains.
+获取或管理 API Key：访问 <https://socialdatax.com>，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。
+
 ## Preferred Direct CLI
 
 Prefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:

package/skills/media-search/SKILL.md

@@ -27,6 +27,11 @@ Current platform support:
 - Xiaohongshu / XHS / RedNote notes through `xhs_search_notes`.
 - Douyin / 抖音 works, including video and image/text posts, through `douyin_search_videos`.
 
+## API Key
+
+Use `SOCIALDATAX_API_KEY` for SocialDataX requests. To get or manage an API Key, open <https://socialdatax.com> and follow the website API Key access flow. If a user asks where to get a key, provide only this URL; do not infer alternate domains.
+获取或管理 API Key：访问 <https://socialdatax.com>，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。
+
 ## Preferred Direct CLI
 
 Prefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:

package/skills/media-user-info/SKILL.md

@@ -27,6 +27,11 @@ Current platform support:
 - Xiaohongshu / XHS / RedNote creators through the `xhs_get_user_info_by_*` tools.
 - Douyin / 抖音 creators through the `douyin_get_user_info_by_*` tools.
 
+## API Key
+
+Use `SOCIALDATAX_API_KEY` for SocialDataX requests. To get or manage an API Key, open <https://socialdatax.com> and follow the website API Key access flow. If a user asks where to get a key, provide only this URL; do not infer alternate domains.
+获取或管理 API Key：访问 <https://socialdatax.com>，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。
+
 ## Preferred Direct CLI
 
 Prefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:

package/skills/media-user-posts/SKILL.md

@@ -26,6 +26,12 @@ Current platform support:
 
 - Xiaohongshu / XHS / RedNote creator notes through the `xhs_get_user_posted_notes_by_*` tools.
 - Douyin / 抖音 creator works, including video and image/text posts, through the `douyin_get_user_posted_videos_by_*` tools.
+- Douyin / 抖音 creator short-drama series through the `douyin_get_user_series_by_*` tools.
+
+## API Key
+
+Use `SOCIALDATAX_API_KEY` for SocialDataX requests. To get or manage an API Key, open <https://socialdatax.com> and follow the website API Key access flow. If a user asks where to get a key, provide only this URL; do not infer alternate domains.
+获取或管理 API Key：访问 <https://socialdatax.com>，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`；不要引导用户使用其他域名。
 
 ## Preferred Direct CLI
 
@@ -36,12 +42,15 @@ npx -y socialdatax-skills@latest xhs user-posts --user-id "<user_id>" --pretty
 npx -y socialdatax-skills@latest xhs user-posts --profile-url "<profile_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest douyin user-posts --sec-user-id "<sec_user_id>" --pretty
 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
 ```
 
 - XHS `--user-id <user_id>`: preferred when the creator ID is already known.
 - XHS `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text.
 - Douyin `--sec-user-id <sec_user_id>`: preferred when the creator sec_user_id is already known.
 - Douyin `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text.
+- Douyin `user-series`: use for a creator's short-drama series list instead of regular published works.
 - `--page-token <next_page_token>`: opaque pagination token; pass back exactly the token returned by the previous page and do not reuse it across users.
 - `--pretty`: output formatting only.
 
@@ -61,9 +70,11 @@ If MCP tools are already available in the current agent, use one of these tools:
 - `xhs_get_user_posted_notes_by_profile_url`: use for profile URLs, short links, or profile share text.
 - `douyin_get_user_posted_videos_by_sec_user_id`: preferred when `sec_user_id` is already known.
 - `douyin_get_user_posted_videos_by_profile_url`: use for profile URLs, short links, or profile share text.
+- `douyin_get_user_series_by_sec_user_id`: preferred for creator short-drama series when `sec_user_id` is already known.
+- `douyin_get_user_series_by_profile_url`: use for creator short-drama series from profile URLs, short links, or profile share text.
 
-Creator content-list pagination uses `page_token`. Pass back exactly the returned `next_page_token`; tokens are bound to the current user and should not be reused across users.
+Creator content-list and series pagination use `page_token`. Pass back exactly the returned `next_page_token`; tokens are bound to the current user and command family and should not be reused across users.
 
 ## Output Guidance
 
-Summarize content-list evidence by title or description, summary, publish time, interaction counts, media links, and content type when present. For Douyin image/text posts, use `image_urls` rather than assuming a video playback URL exists. Use returned content IDs to chain into detail or comment analysis when needed.
+Summarize content-list evidence by title or description, summary, publish time, interaction counts, media links, and content type when present. For Douyin image/text posts, use `image_urls` rather than assuming a video playback URL exists. For short-drama series, report series IDs, titles, descriptions, covers, prices, and author facts when present. Use returned content IDs to chain into detail or comment analysis when needed.

package/skills/socialdatax-content-research-assistant/SKILL.md

@@ -0,0 +1,79 @@
+---
+name: socialdatax-content-research-assistant
+description: Use when doing cross-platform content research, topic planning, competitor research, trend insight, comment insight, or creator research across Xiaohongshu, 小红书, XHS, RedNote, Douyin, and 抖音.
+metadata:
+  openclaw:
+    requires:
+      env:
+        - SOCIALDATAX_API_KEY
+      bins:
+        - node
+        - npm
+    primaryEnv: SOCIALDATAX_API_KEY
+    emoji: "🔎"
+    homepage: https://socialdatax.com
+    install:
+      - kind: node
+        package: "socialdatax-skills"
+        bins: []
+---
+
+# SocialDataX Content Research Assistant
+
+Use this skill to combine SocialDataX read-only research commands for Xiaohongshu / 小红书 / XHS / RedNote and Douyin / 抖音.
+
+## API Key
+
+Use `SOCIALDATAX_API_KEY` for SocialDataX requests. To get or manage an API Key, open <https://socialdatax.com> and follow the website API Key access flow.
+获取或管理 API Key：访问 <https://socialdatax.com>，按官网的 API Key 申请/管理入口操作。环境变量名固定使用 `SOCIALDATAX_API_KEY`。
+
+## Research Workflow
+
+1. Start broad with keyword search or Douyin hot search.
+2. Pick representative content IDs or URLs from the results.
+3. Read details for factual context and metrics.
+4. Read comments when the task needs audience language, objections, FAQs, sentiment themes, or demand signals.
+5. Read creator profiles and creator content lists when the task needs account positioning, benchmarking, or content style analysis.
+6. Report observed evidence separately from interpretation, and mention when results cover only one page.
+
+## Direct CLI
+
+Prefer direct CLI commands when the agent can run shell commands:
+
+```bash
+npx -y socialdatax-skills@latest xhs search --keyword "<keyword>" --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 user-info --user-id "<user_id>" --pretty
+npx -y socialdatax-skills@latest xhs user-posts --user-id "<user_id>" --pretty
+npx -y socialdatax-skills@latest douyin hot-search --pretty
+npx -y socialdatax-skills@latest douyin search --keyword "<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 user-info --sec-user-id "<sec_user_id>" --pretty
+npx -y socialdatax-skills@latest douyin user-posts --sec-user-id "<sec_user_id>" --pretty
+```
+
+Use URL or share-text entrypoints when the user provides links instead of IDs:
+
+```bash
+npx -y socialdatax-skills@latest xhs detail --url "<note_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest xhs comments --url "<note_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest xhs user-info --profile-url "<profile_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest xhs user-posts --profile-url "<profile_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest douyin detail --url "<douyin_content_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest douyin comments --url "<douyin_content_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest douyin user-info --profile-url "<profile_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest douyin user-posts --profile-url "<profile_url_or_share_text>" --pretty
+```
+
+For reply analysis:
+
+```bash
+npx -y socialdatax-skills@latest xhs sub-comments --note-id "<note_id>" --comment-id "<comment_id>" --pretty
+npx -y socialdatax-skills@latest douyin replies --aweme-id "<aweme_id>" --comment-id "<comment_id>" --pretty
+```
+
+## Safety Boundary
+
+This skill is read-only. It does not read local browser data, does not save API keys, and does not perform login, posting, liking, commenting, or account changes. It wraps the public `socialdatax-skills` CLI and does not contain the hosted service implementation.

package/skills/socialdatax-content-research-assistant/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "SocialDataX Content Research"
+  short_description: "Research XHS and Douyin content"
+  default_prompt: "Use $socialdatax-content-research-assistant to research Xiaohongshu, XHS, RedNote, and Douyin content across search, details, comments, and creators."
+
+policy:
+  allow_implicit_invocation: true