socialdatax-skills 0.2.15 → 0.2.17

package/README.md

@@ -68,7 +68,7 @@ Common search phrases for this skill package:
 - Sensitive Check MCP server name: `sensitive-check`
 - Sensitive 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.15`
+- Current public capability version: `0.2.17`
 
 ## Direct CLI
 
@@ -120,9 +120,7 @@ npx -y socialdatax-skills@latest weibo comments --post-id "<post_id>" --all --in
 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 likers --post-id "<post_id>" --pretty
-npx -y socialdatax-skills@latest weibo likers --post-url "<weibo_post_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest weibo reposts --post-id "<post_id>" --pretty
-npx -y socialdatax-skills@latest weibo reposts --post-url "<weibo_post_url_or_share_text>" --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
@@ -157,6 +155,8 @@ For commands that accept `--page-token`, continue only with the complete returne
 
 Search pagination uses `--page-token` when continuing with a returned `next_page_token`. Omit `--page-token` on the first search request and pass the complete returned `next_page_token` only when continuing the same search chain.
 
+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. The direct CLI also accepts `SOCIALDATAX_SOURCE_CLIENT`, `SOCIALDATAX_SOURCE_PLATFORM`, and `SOCIALDATAX_SOURCE_SKILL` as environment-variable fallbacks.
+
 XHS, Douyin, Kuaishou, Weibo, and WeChat Channels search use `--keyword` and optional `--page-token`.
 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`.
@@ -314,8 +314,8 @@ Current Kuaishou workflows include:
 - 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.
+- Read creator profile data from a non-empty user_id, profile link, short link, or share text. Live/fw-user profile shares are supported for profile data; successful results return a reusable non-empty user_id.
+- 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 Douyin workflows include:
@@ -338,10 +338,9 @@ Current Weibo workflows include:
 - 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.
-- Fetch paginated liker and repost lists from a post_id, post URL, short link, or share text.
 - Continue Weibo list pagination only when `next_page_token` is non-empty; an empty string means there are no more results to request.
-- Read user profile data from a profile link, short link, share text, or user_id.
-- Fetch paginated user post lists from a user_id, profile link, short link, or share text.
+- 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.
 - Submit and check Weibo video 口播转文字 / speech-to-text transcript jobs; submit tools 提交完成后最多短等 15 秒.
 
 Current WeChat Channels / 视频号 workflows include:
@@ -414,10 +413,10 @@ Current Sensitive Check workflows include:
 | `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. |
+| `kuaishou_get_user_info_by_user_id` | Fetch creator profile data when the caller already has a non-empty user_id. |
+| `kuaishou_get_user_info_by_profile_url` | Resolve a Kuaishou profile link, including live/fw-user profile shares, short link, or share text into creator profile data; successful results return a reusable non-empty user_id. |
+| `kuaishou_get_user_posted_videos_by_user_id` | Fetch a paginated list of works published by a creator when the caller already has a non-empty 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 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. |
 | `kuaishou_submit_video_speech_text_by_video_url` | Submit a Kuaishou video speech-to-text transcript job from a work page link, short link, or share text; submit waits up to 15 seconds. |
 | `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. |
@@ -433,14 +432,10 @@ Current Sensitive Check workflows include:
 | `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_post_liker_list_by_post_id` | Fetch paginated users who liked a Weibo post by post_id. |
-| `weibo_get_post_liker_list_by_post_url` | Fetch paginated users who liked a Weibo post from a post URL, short link, or share text. |
-| `weibo_get_post_repost_list_by_post_id` | Fetch paginated reposts for a Weibo post by post_id. |
-| `weibo_get_post_repost_list_by_post_url` | Fetch paginated reposts for a Weibo post from a post URL, short link, or share text. |
-| `weibo_get_user_info_by_user_id` | Fetch user 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 user profile data. |
-| `weibo_get_user_posts_by_user_id` | Fetch a paginated list of posts published by a user when the caller already has a user_id. |
-| `weibo_get_user_posts_by_profile_url` | Fetch a paginated list of posts published by a user from a profile link, short link, or share text. |
+| `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. |
 | `weibo_submit_video_speech_text_by_post_url` | Submit a Weibo video speech-to-text transcript job from a post URL, short link, or share text; submit waits up to 15 seconds. |
 | `weibo_submit_video_speech_text_by_post_id` | Submit a Weibo video speech-to-text transcript job when the caller already has a post_id; submit waits up to 15 seconds. |
 | `weibo_get_video_speech_text_job` | Check a Weibo speech-to-text transcript job by job_id without creating a new task. |

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.15";
+const PACKAGE_VERSION = "0.2.17";
 const PACKAGE_SPEC = `${PACKAGE_NAME}@latest`;
 const LOG_PREFIX = `[${PACKAGE_NAME}]`;
 const MIN_NODE_VERSION = "20.18.1";
@@ -15,6 +15,16 @@ const HOMEPAGE_URL = "https://socialdatax.com";
 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 SOURCE_CLIENT_ENV = "SOCIALDATAX_SOURCE_CLIENT";
+const SOURCE_PLATFORM_ENV = "SOCIALDATAX_SOURCE_PLATFORM";
+const SOURCE_SKILL_ENV = "SOCIALDATAX_SOURCE_SKILL";
+const SOURCE_CLIENT_ENV_NAMES = [SOURCE_CLIENT_ENV];
+const SOURCE_PLATFORM_ENV_NAMES = [SOURCE_PLATFORM_ENV];
+const SOURCE_SKILL_ENV_NAMES = [SOURCE_SKILL_ENV];
+const SOURCE_CLIENT_HEADER = "X-SocialDataX-Client";
+const SOURCE_PLATFORM_HEADER = "X-SocialDataX-Source-Platform";
+const SOURCE_SKILL_HEADER = "X-SocialDataX-Source-Skill";
+const SOURCE_ATTRIBUTION_PATTERN = /^[a-z0-9][a-z0-9-]{0,99}$/;
 const AVAILABLE_SKILLS = [
   {
     name: "socialdatax-content-research-assistant",
@@ -75,6 +85,7 @@ const BOOLEAN_OPTIONS = new Set([
   "pretty",
 ]);
 const DIRECT_BOOLEAN_OPTIONS = new Set(["all", "includeReplies", "pretty"]);
+const DIRECT_META_OPTIONS = ["sourceClient", "sourcePlatform", "sourceSkill"];
 const INSTALL_TARGETS = ["openclaw", "hermes", "agents", "codex", "claude-code", "claude"];
 const VALID_SCOPES = ["user", "workspace", "shared"];
 const XHS_DIRECT_ACTION_OPTIONS = {
@@ -306,8 +317,8 @@ const WEIBO_DIRECT_ACTION_OPTIONS = {
     "includeReplies",
     "pretty",
   ],
-  likers: ["postId", "postUrl", "pageToken", "pages", "all", "maxItems", "pretty"],
-  reposts: ["postId", "postUrl", "pageToken", "pages", "all", "maxItems", "pretty"],
+  likers: ["postId", "pageToken", "pages", "all", "maxItems", "pretty"],
+  reposts: ["postId", "pageToken", "pages", "all", "maxItems", "pretty"],
   "user-info": ["userId", "profileUrl", "pretty"],
   "user-posts": [
     "userId",
@@ -636,19 +647,22 @@ const PLATFORMS = {
       },
       {
         name: "kuaishou_get_user_info_by_user_id",
-        description: "Fetch creator profile data when the caller already has a user_id.",
+        description: "Fetch creator profile data when the caller already has a non-empty user_id.",
       },
       {
         name: "kuaishou_get_user_info_by_profile_url",
-        description: "Resolve a Kuaishou profile link, short link, or share text into creator profile data.",
+        description:
+          "Resolve a Kuaishou profile link, including live/fw-user profile shares, short link, or share text into creator profile data; successful results return a reusable non-empty user_id.",
       },
       {
         name: "kuaishou_get_user_posted_videos_by_user_id",
-        description: "Fetch a paginated list of works published by a creator when the caller already has a user_id.",
+        description:
+          "Fetch a paginated list of works published by a creator when the caller already has a non-empty user_id.",
       },
       {
         name: "kuaishou_get_user_posted_videos_by_profile_url",
-        description: "Fetch a paginated list of works published by a creator from a profile link, short link, or share text.",
+        description:
+          "Fetch a paginated list of works published by a creator 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.",
       },
       {
         name: "kuaishou_submit_video_speech_text_by_video_url",
@@ -714,20 +728,10 @@ const PLATFORMS = {
         name: "weibo_get_post_liker_list_by_post_id",
         description: "Fetch a paginated list of users who liked a Weibo post by post_id.",
       },
-      {
-        name: "weibo_get_post_liker_list_by_post_url",
-        description:
-          "Fetch a paginated list of users who liked a Weibo post from a post URL, short link, or share text.",
-      },
       {
         name: "weibo_get_post_repost_list_by_post_id",
         description: "Fetch a paginated repost list for a Weibo post by post_id.",
       },
-      {
-        name: "weibo_get_post_repost_list_by_post_url",
-        description:
-          "Fetch a paginated repost list for a Weibo post from a post URL, short link, or share text.",
-      },
       {
         name: "weibo_get_user_info_by_user_id",
         description: "Fetch creator profile data when the caller already has a user_id.",
@@ -968,6 +972,10 @@ function validateKnownOptions(options, allowedOptions) {
   }
 }
 
+function allowedDirectOptions(allowedOptions) {
+  return [...allowedOptions, ...DIRECT_META_OPTIONS];
+}
+
 function requireOptionValue(options, key, displayName) {
   if (options[key] === true || options[key] === "") {
     throw new Error(`Missing value for ${displayName}.`);
@@ -986,7 +994,8 @@ function validateXhsDirectActionOptions(action, options) {
     return;
   }
 
-  validateKnownOptions(options, allowedOptions);
+  validateKnownOptions(options, allowedDirectOptions(allowedOptions));
+  validateDirectMetaOptions(options);
   validateDirectPaginationOptions("xhs", action, options);
   for (const key of allowedOptions) {
     if (!DIRECT_BOOLEAN_OPTIONS.has(key)) {
@@ -1001,7 +1010,8 @@ function validateDouyinDirectActionOptions(action, options) {
     return;
   }
 
-  validateKnownOptions(options, allowedOptions);
+  validateKnownOptions(options, allowedDirectOptions(allowedOptions));
+  validateDirectMetaOptions(options);
   validateDirectPaginationOptions("douyin", action, options);
   for (const key of allowedOptions) {
     if (!DIRECT_BOOLEAN_OPTIONS.has(key)) {
@@ -1016,7 +1026,8 @@ function validateKuaishouDirectActionOptions(action, options) {
     return;
   }
 
-  validateKnownOptions(options, allowedOptions);
+  validateKnownOptions(options, allowedDirectOptions(allowedOptions));
+  validateDirectMetaOptions(options);
   validateDirectPaginationOptions("kuaishou", action, options);
   for (const key of allowedOptions) {
     if (!DIRECT_BOOLEAN_OPTIONS.has(key)) {
@@ -1031,7 +1042,8 @@ function validateWeiboDirectActionOptions(action, options) {
     return;
   }
 
-  validateKnownOptions(options, allowedOptions);
+  validateKnownOptions(options, allowedDirectOptions(allowedOptions));
+  validateDirectMetaOptions(options);
   validateDirectPaginationOptions("weibo", action, options);
   for (const key of allowedOptions) {
     if (!DIRECT_BOOLEAN_OPTIONS.has(key)) {
@@ -1046,7 +1058,8 @@ function validateWechatDirectActionOptions(action, options) {
     return;
   }
 
-  validateKnownOptions(options, allowedOptions);
+  validateKnownOptions(options, allowedDirectOptions(allowedOptions));
+  validateDirectMetaOptions(options);
   validateDirectPaginationOptions("wechat", action, options);
   for (const key of allowedOptions) {
     if (!DIRECT_BOOLEAN_OPTIONS.has(key)) {
@@ -1061,7 +1074,8 @@ function validateSensitiveCheckDirectActionOptions(action, options) {
     return;
   }
 
-  validateKnownOptions(options, allowedOptions);
+  validateKnownOptions(options, allowedDirectOptions(allowedOptions));
+  validateDirectMetaOptions(options);
   validateFlagOption(options, "pretty", "--pretty");
   for (const key of allowedOptions) {
     if (!DIRECT_BOOLEAN_OPTIONS.has(key)) {
@@ -1070,6 +1084,21 @@ function validateSensitiveCheckDirectActionOptions(action, options) {
   }
 }
 
+function validateDirectMetaOptions(options) {
+  if (options.sourceClient !== undefined) {
+    requireOptionValue(options, "sourceClient", "--source-client");
+    normalizeSourceAttribution(options.sourceClient, "--source-client");
+  }
+  if (options.sourcePlatform !== undefined) {
+    requireOptionValue(options, "sourcePlatform", "--source-platform");
+    normalizeSourceAttribution(options.sourcePlatform, "--source-platform");
+  }
+  if (options.sourceSkill !== undefined) {
+    requireOptionValue(options, "sourceSkill", "--source-skill");
+    normalizeSourceAttribution(options.sourceSkill, "--source-skill");
+  }
+}
+
 function validateDirectPaginationOptions(platformId, action, options) {
   validateFlagOption(options, "pretty", "--pretty");
   validateFlagOption(options, "all", "--all");
@@ -1219,6 +1248,47 @@ function readFirstEnv(names) {
   return undefined;
 }
 
+function normalizeSourceAttribution(value, displayName) {
+  const text = String(value || "").trim().toLowerCase();
+  if (!text) {
+    return "";
+  }
+  if (!SOURCE_ATTRIBUTION_PATTERN.test(text)) {
+    throw new Error(
+      `${displayName} must be a lowercase skill slug using letters, numbers, and hyphens.`
+    );
+  }
+  return text;
+}
+
+function resolveSourceAttribution(options = {}) {
+  return {
+    sourceClient:
+      options.sourceClient !== undefined
+        ? normalizeSourceAttribution(options.sourceClient, "--source-client")
+        : normalizeSourceAttribution(
+            readFirstEnv(SOURCE_CLIENT_ENV_NAMES) || PACKAGE_NAME,
+            SOURCE_CLIENT_ENV
+          ),
+    sourcePlatform:
+      options.sourcePlatform !== undefined
+        ? normalizeSourceAttribution(options.sourcePlatform, "--source-platform")
+        : normalizeSourceAttribution(
+            readFirstEnv(SOURCE_PLATFORM_ENV_NAMES),
+            SOURCE_PLATFORM_ENV
+          ),
+    sourceSkill:
+      options.sourceSkill !== undefined
+        ? normalizeSourceAttribution(options.sourceSkill, "--source-skill")
+        : normalizeSourceAttribution(readFirstEnv(SOURCE_SKILL_ENV_NAMES), SOURCE_SKILL_ENV),
+  };
+}
+
+function attachDirectMetadata(operation, options) {
+  operation.sourceAttribution = resolveSourceAttribution(options);
+  return operation;
+}
+
 function resolveUpstreamUrl(platform) {
   return readFirstEnv(platform.upstreamEnv) || platform.endpoint;
 }
@@ -1380,10 +1450,15 @@ async function installSkills(args) {
   console.log("Data calls do not perform login, posting, editing, liking, commenting, or account actions.");
   console.log("Configure your API Key before making authenticated calls:");
   console.log(`  export ${PRIMARY_API_KEY_ENV}="<${PRIMARY_API_KEY_ENV}>"`);
+  printInstalledSkillAttributionNote();
+}
+
+function printInstalledSkillAttributionNote() {
   console.log("");
-  console.log("Direct CLI examples:");
-  console.log(`  npx -y ${PACKAGE_SPEC} xhs search --keyword "露营" --pretty`);
-  console.log(`  npx -y ${PACKAGE_SPEC} xhs detail --note-id "<note_id>" --pretty`);
+  console.log(
+    "Direct CLI examples in installed SKILL.md files already include source attribution for agents."
+  );
+  console.log("No extra source attribution setup is required.");
 }
 
 function resolveInstallDestination({
@@ -1705,7 +1780,9 @@ function printHelp() {
   console.log("      Call the Kuaishou creator works tool directly and print JSON.");
   console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} kuaishou user-posts --profile-url "<profile_url_or_share_text>" --pretty`);
-  console.log("      Call the Kuaishou creator works tool from a profile link or share text.");
+  console.log(
+    "      Call the Kuaishou creator works tool from a profile link or share text that resolves directly to a non-empty user_id."
+  );
   console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} weibo hot-search --pretty`);
   console.log("      Call the Weibo hot-search list tool directly and print JSON.");
@@ -1731,15 +1808,9 @@ function printHelp() {
   console.log(`  npx -y ${PACKAGE_SPEC} weibo likers --post-id "<post_id>" --pretty`);
   console.log("      Call the Weibo post liker list tool directly and print JSON.");
   console.log("");
-  console.log(`  npx -y ${PACKAGE_SPEC} weibo likers --post-url "<weibo_post_url_or_share_text>" --pretty`);
-  console.log("      Call the Weibo post liker list tool from a post link or share text.");
-  console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} weibo reposts --post-id "<post_id>" --pretty`);
   console.log("      Call the Weibo post repost list tool directly and print JSON.");
   console.log("");
-  console.log(`  npx -y ${PACKAGE_SPEC} weibo reposts --post-url "<weibo_post_url_or_share_text>" --pretty`);
-  console.log("      Call the Weibo post repost list tool from a post link or share text.");
-  console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} weibo user-info --user-id "<user_id>" --pretty`);
   console.log("      Call the Weibo creator profile tool directly and print JSON.");
   console.log("");
@@ -1895,6 +1966,12 @@ function printHelp() {
   console.log("      Douyin content type filter; omit for all content types.");
   console.log("  --page-token <token>");
   console.log("      Continue token-paginated commands with the complete returned next_page_token. For search, omit it on the first request.");
+  console.log("  --source-client <slug>");
+  console.log("      Attribution client slug for authenticated direct CLI calls; defaults to socialdatax-skills.");
+  console.log("  --source-platform <slug>");
+  console.log("      Attribution marketplace/platform slug for the current Agent Skill, such as modelscope or skillhub.");
+  console.log("  --source-skill <slug>");
+  console.log("      Attribute authenticated direct CLI calls to the current Agent Skill usage slug.");
   console.log("  --sort-type <all|time_descending|collect_count_descending>");
   console.log("      WeChat Channels / 视频号 search sort; collect_count_descending means hottest first / most collected first; omit for default sort.");
   console.log("  --duration-range <all|under_5_min|between_5_and_20_min|over_20_min>");
@@ -1954,7 +2031,7 @@ async function runXhsDirectCommand(args) {
   }
   validateXhsDirectActionOptions(action, options);
 
-  const operation = buildXhsOperation(action, options);
+  const operation = attachDirectMetadata(buildXhsOperation(action, options), options);
   const data = shouldUsePaginatedDirectOutput(options)
     ? await callPaginatedDirectOperation(operation, options)
     : await callDirectOperation(operation);
@@ -1981,7 +2058,7 @@ async function runDouyinDirectCommand(args) {
   }
   validateDouyinDirectActionOptions(action, options);
 
-  const operation = buildDouyinOperation(action, options);
+  const operation = attachDirectMetadata(buildDouyinOperation(action, options), options);
   const data = shouldUsePaginatedDirectOutput(options)
     ? await callPaginatedDirectOperation(operation, options)
     : await callDirectOperation(operation);
@@ -2008,7 +2085,7 @@ async function runKuaishouDirectCommand(args) {
   }
   validateKuaishouDirectActionOptions(action, options);
 
-  const operation = buildKuaishouOperation(action, options);
+  const operation = attachDirectMetadata(buildKuaishouOperation(action, options), options);
   const data = shouldUsePaginatedDirectOutput(options)
     ? await callPaginatedDirectOperation(operation, options)
     : await callDirectOperation(operation);
@@ -2035,7 +2112,7 @@ async function runWeiboDirectCommand(args) {
   }
   validateWeiboDirectActionOptions(action, options);
 
-  const operation = buildWeiboOperation(action, options);
+  const operation = attachDirectMetadata(buildWeiboOperation(action, options), options);
   const data = shouldUsePaginatedDirectOutput(options)
     ? await callPaginatedDirectOperation(operation, options)
     : await callDirectOperation(operation);
@@ -2062,7 +2139,7 @@ async function runWechatDirectCommand(args) {
   }
   validateWechatDirectActionOptions(action, options);
 
-  const operation = buildWechatOperation(action, options);
+  const operation = attachDirectMetadata(buildWechatOperation(action, options), options);
   const data = shouldUsePaginatedDirectOutput(options)
     ? await callPaginatedDirectOperation(operation, options)
     : await callDirectOperation(operation);
@@ -2089,7 +2166,10 @@ async function runSensitiveCheckDirectCommand(args) {
   }
   validateSensitiveCheckDirectActionOptions(action, options);
 
-  const operation = buildSensitiveCheckOperation(action, options);
+  const operation = attachDirectMetadata(
+    buildSensitiveCheckOperation(action, options),
+    options
+  );
   const data = await callDirectOperation(operation);
   const envelope = {
     platform: operation.platform.id,
@@ -2433,33 +2513,13 @@ function buildWeiboOperation(action, options) {
     case "likers":
       return buildDirectOperation(
         "likers",
-        buildOneOfCall(options, {
-          idOption: "postId",
-          urlOption: "postUrl",
-          idTool: "weibo_get_post_liker_list_by_post_id",
-          urlTool: "weibo_get_post_liker_list_by_post_url",
-          idArgument: "post_id",
-          urlArgument: "post_url",
-          idDisplay: "--post-id",
-          urlDisplay: "--post-url",
-          pageToken: options.pageToken,
-        }),
+        buildWeiboPostListByPostIdCall(options, "likers", "weibo_get_post_liker_list_by_post_id"),
         PLATFORMS.weibo
       );
     case "reposts":
       return buildDirectOperation(
         "reposts",
-        buildOneOfCall(options, {
-          idOption: "postId",
-          urlOption: "postUrl",
-          idTool: "weibo_get_post_repost_list_by_post_id",
-          urlTool: "weibo_get_post_repost_list_by_post_url",
-          idArgument: "post_id",
-          urlArgument: "post_url",
-          idDisplay: "--post-id",
-          urlDisplay: "--post-url",
-          pageToken: options.pageToken,
-        }),
+        buildWeiboPostListByPostIdCall(options, "reposts", "weibo_get_post_repost_list_by_post_id"),
         PLATFORMS.weibo
       );
     case "user-info":
@@ -2935,6 +2995,22 @@ function buildWeiboRepliesCall(options) {
   };
 }
 
+function buildWeiboPostListByPostIdCall(options, action, tool) {
+  if (!options.postId) {
+    throw new Error(`Missing --post-id for weibo ${action}.`);
+  }
+  const toolArguments = {
+    post_id: options.postId,
+  };
+  if (options.pageToken) {
+    toolArguments.page_token = options.pageToken;
+  }
+  return {
+    tool,
+    toolArguments,
+  };
+}
+
 function buildWechatCommentsCall(options) {
   const hasObjectInput = Boolean(options.objectId || options.objectNonceId);
   const hasUrlInput = Boolean(options.url);
@@ -3456,6 +3532,9 @@ async function attachRepliesToCommentItems(operation, items, pageData) {
         operation.arguments,
         pageData
       );
+      repliesOperation.sourceAttribution = operation.sourceAttribution
+        ? { ...operation.sourceAttribution }
+        : undefined;
       const repliesData = await collectPaginatedDirectData(
         repliesOperation,
         { all: true, pages: undefined, maxItems: undefined },
@@ -3618,11 +3697,22 @@ async function callMcpBackend(operation) {
     { name: PACKAGE_NAME, version: PACKAGE_VERSION },
     { capabilities: {} }
   );
+  const headers = {
+    Authorization: `Bearer ${apiKey}`,
+  };
+  const sourceAttribution = operation.sourceAttribution || {};
+  if (sourceAttribution.sourceClient) {
+    headers[SOURCE_CLIENT_HEADER] = sourceAttribution.sourceClient;
+  }
+  if (sourceAttribution.sourcePlatform) {
+    headers[SOURCE_PLATFORM_HEADER] = sourceAttribution.sourcePlatform;
+  }
+  if (sourceAttribution.sourceSkill) {
+    headers[SOURCE_SKILL_HEADER] = sourceAttribution.sourceSkill;
+  }
   const transport = new StreamableHTTPClientTransport(new URL(upstreamUrl), {
     requestInit: {
-      headers: {
-        Authorization: `Bearer ${apiKey}`,
-      },
+      headers,
     },
   });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "socialdatax-skills",
-  "version": "0.2.15",
+  "version": "0.2.17",
   "description": "SocialDataX / 社媒数据助手 skill installer and direct CLI helper for hosted platform social media MCP services.",
   "license": "MIT",
   "type": "module",

package/skills/media-comments/SKILL.md

@@ -1,6 +1,9 @@
 ---
 name: "media-comments"
 description: "Fetch and analyze XHS comments/replies, Douyin comments/replies, Kuaishou comments/replies, Weibo comments/replies, and WeChat Channels / 视频号 comments/replies. This version is backed by hosted platform MCP services and supports Xiaohongshu, 小红书, XHS, RedNote, Douyin / 抖音, Kuaishou / 快手 / Kwai, Weibo / 微博, and WeChat Channels / 视频号."
+source_client: "socialdatax-skills"
+source_platform: "npm"
+source_skill: "media-comments"
 metadata:
   openclaw:
     requires:
@@ -41,26 +44,26 @@ Use `SOCIALDATAX_API_KEY` for SocialDataX requests. The only official website fo
 Prefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:
 
 ```bash
-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 comments --url "<note_url_or_share_text>" --pretty
-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 --aweme-id "<aweme_id>" --all --include-replies --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
-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 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 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 xhs comments --note-id "<note_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest xhs comments --note-id "<note_id>" --all --include-replies --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest xhs comments --url "<note_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest xhs sub-comments --note-id "<note_id>" --comment-id "<comment_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest douyin comments --aweme-id "<aweme_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest douyin comments --aweme-id "<aweme_id>" --all --include-replies --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest douyin comments --url "<douyin_content_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest douyin replies --aweme-id "<aweme_id>" --comment-id "<comment_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest kuaishou comments --photo-id "<photo_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest kuaishou comments --photo-id "<photo_id>" --all --include-replies --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest kuaishou comments --url "<kuaishou_content_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest kuaishou replies --photo-id "<photo_id>" --comment-id "<comment_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest weibo comments --post-id "<post_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest weibo comments --post-id "<post_id>" --all --include-replies --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest weibo comments --post-url "<weibo_post_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest weibo replies --post-id "<post_id>" --comment-id "<comment_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest wechat comments --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest wechat comments --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --all --include-replies --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest wechat comments --url "<wechat_video_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
+npx -y socialdatax-skills@latest wechat replies --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --comment-id "<comment_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-comments
 ```
 
 Optional arguments:
@@ -81,6 +84,7 @@ Optional arguments:
 - Weibo `--post-url <weibo_post_url_or_share_text>`: use for a Weibo post URL, short link, or share text for first-level comments.
 - WeChat Channels / 视频号 `--object-id <object_id>` and `--object-nonce-id <object_nonce_id>`: use together when both values are already known and should anchor the comment thread.
 - WeChat Channels / 视频号 `--url <wechat_video_url_or_share_text>`: use for a WeChat Channels video link or share text for first-level comments.
+- `--source-client socialdatax-skills --source-platform npm --source-skill media-comments`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.
 
 Use either the content ID option or the URL option for first-level comments, not both. For reply commands, use the content ID together with `--comment-id`.
 
@@ -88,7 +92,7 @@ The command prints JSON with `platform`, `tool`, `arguments`, and `data`. Multi-
 
 ## 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. Prefer the direct CLI; hosted MCP tools are optional when the current agent already supports authenticated streamable HTTP MCP.
+This skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes. Prefer the direct CLI; hosted MCP tools are optional when the current agent already supports authenticated streamable HTTP MCP.
 
 ## MCP Tools
 

package/skills/media-detail/SKILL.md

@@ -1,6 +1,9 @@
 ---
 name: "media-detail"
 description: "Read structured social media content details and metrics from content IDs, URLs, short links, or share text. This version is backed by hosted platform MCP services and supports Xiaohongshu, 小红书, XHS, RedNote, Douyin / 抖音, Kuaishou / 快手 / Kwai, Weibo / 微博, and WeChat Channels / 视频号."
+source_client: "socialdatax-skills"
+source_platform: "npm"
+source_skill: "media-detail"
 metadata:
   openclaw:
     requires:
@@ -41,16 +44,16 @@ Use `SOCIALDATAX_API_KEY` for SocialDataX requests. The only official website fo
 Prefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:
 
 ```bash
-npx -y socialdatax-skills@latest xhs detail --note-id "<note_id>" --pretty
-npx -y socialdatax-skills@latest xhs detail --url "<note_url_or_share_text>" --pretty
-npx -y socialdatax-skills@latest douyin detail --aweme-id "<aweme_id>" --pretty
-npx -y socialdatax-skills@latest douyin detail --url "<douyin_content_url_or_share_text>" --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 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 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 xhs detail --note-id "<note_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-detail
+npx -y socialdatax-skills@latest xhs detail --url "<note_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-detail
+npx -y socialdatax-skills@latest douyin detail --aweme-id "<aweme_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-detail
+npx -y socialdatax-skills@latest douyin detail --url "<douyin_content_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-detail
+npx -y socialdatax-skills@latest kuaishou detail --photo-id "<photo_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-detail
+npx -y socialdatax-skills@latest kuaishou detail --url "<kuaishou_content_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-detail
+npx -y socialdatax-skills@latest weibo detail --post-id "<post_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-detail
+npx -y socialdatax-skills@latest weibo detail --post-url "<weibo_post_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-detail
+npx -y socialdatax-skills@latest wechat detail --encrypted-object-id "<encrypted_object_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-detail
+npx -y socialdatax-skills@latest wechat detail --url "<wechat_video_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-detail
 ```
 
 Optional arguments:
@@ -66,6 +69,7 @@ Optional arguments:
 - Weibo `--post-url <weibo_post_url_or_share_text>`: use for a Weibo post URL, short link, or share text.
 - WeChat Channels / 视频号 `--encrypted-object-id <encrypted_object_id>`: use when the encrypted_object_id from search is already known.
 - WeChat Channels / 视频号 `--url <wechat_video_url_or_share_text>`: use for a WeChat Channels video link or share text.
+- `--source-client socialdatax-skills --source-platform npm --source-skill media-detail`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.
 
 Use either the ID option or the URL option for detail commands, not both.
 
@@ -73,7 +77,7 @@ The command prints JSON with `platform`, `tool`, `arguments`, and `data`.
 
 ## 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. Prefer the direct CLI; hosted MCP tools are optional when the current agent already supports authenticated streamable HTTP MCP.
+This skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes. Prefer the direct CLI; hosted MCP tools are optional when the current agent already supports authenticated streamable HTTP MCP.
 
 ## MCP Tools
 

package/skills/media-search/SKILL.md

@@ -1,6 +1,9 @@
 ---
 name: "media-search"
 description: "Search social media content by keyword for social research, competitor research, topic discovery, content planning, market observation, and trend scanning. This version is backed by hosted platform MCP services and supports Xiaohongshu, 小红书, XHS, RedNote, Douyin / 抖音, Kuaishou / 快手 / Kwai, Weibo / 微博, and WeChat Channels / 视频号."
+source_client: "socialdatax-skills"
+source_platform: "npm"
+source_skill: "media-search"
 metadata:
   openclaw:
     requires:
@@ -41,16 +44,16 @@ Use `SOCIALDATAX_API_KEY` for SocialDataX requests. The only official website fo
 Prefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:
 
 ```bash
-npx -y socialdatax-skills@latest xhs search --keyword "<keyword>" --pretty
-npx -y socialdatax-skills@latest xhs search --keyword "<keyword>" --pages 3 --pretty
-npx -y socialdatax-skills@latest douyin search --keyword "<keyword>" --pretty
-npx -y socialdatax-skills@latest douyin search --keyword "<keyword>" --pages 3 --pretty
-npx -y socialdatax-skills@latest kuaishou search --keyword "<keyword>" --pretty
-npx -y socialdatax-skills@latest kuaishou search --keyword "<keyword>" --pages 3 --pretty
-npx -y socialdatax-skills@latest weibo search --keyword "<keyword>" --pretty
-npx -y socialdatax-skills@latest weibo search --keyword "<keyword>" --pages 3 --pretty
-npx -y socialdatax-skills@latest wechat search --keyword "<keyword>" --pretty
-npx -y socialdatax-skills@latest wechat search --keyword "<keyword>" --pages 3 --pretty
+npx -y socialdatax-skills@latest xhs search --keyword "<keyword>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-search
+npx -y socialdatax-skills@latest xhs search --keyword "<keyword>" --pages 3 --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-search
+npx -y socialdatax-skills@latest douyin search --keyword "<keyword>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-search
+npx -y socialdatax-skills@latest douyin search --keyword "<keyword>" --pages 3 --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-search
+npx -y socialdatax-skills@latest kuaishou search --keyword "<keyword>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-search
+npx -y socialdatax-skills@latest kuaishou search --keyword "<keyword>" --pages 3 --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-search
+npx -y socialdatax-skills@latest weibo search --keyword "<keyword>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-search
+npx -y socialdatax-skills@latest weibo search --keyword "<keyword>" --pages 3 --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-search
+npx -y socialdatax-skills@latest wechat search --keyword "<keyword>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-search
+npx -y socialdatax-skills@latest wechat search --keyword "<keyword>" --pages 3 --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-search
 ```
 
 Required arguments:
@@ -85,6 +88,7 @@ Optional arguments:
 - WeChat Channels / 视频号 `--duration-range <all|under_5_min|between_5_and_20_min|over_20_min>`: optional duration filter; omit it for no duration filter.
 - Weibo `--pages <n>`: fetch and merge N search pages from the current starting point; continue with returned `next_page_token`.
 - WeChat Channels / 视频号 `--pages <n>`: fetch and merge N search pages from the current starting point; continue with returned `next_page_token`.
+- `--source-client socialdatax-skills --source-platform npm --source-skill media-search`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.
 
 XHS sort values:
 - `general`: default sorting.
@@ -149,7 +153,7 @@ Weibo and WeChat Channels search pagination:
 
 ## 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. Prefer the direct CLI; hosted MCP tools are optional when the current agent already supports authenticated streamable HTTP MCP.
+This skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes. Prefer the direct CLI; hosted MCP tools are optional when the current agent already supports authenticated streamable HTTP MCP.
 
 ## MCP Tools
 

package/skills/media-transcript/SKILL.md

@@ -1,6 +1,9 @@
 ---
 name: "media-transcript"
 description: "Submit and check video speech-to-text transcript / 口播转文字 jobs for XHS, Douyin, Kuaishou, Weibo, and WeChat Channels through hosted platform MCP tools."
+source_client: "socialdatax-skills"
+source_platform: "npm"
+source_skill: "media-transcript"
 metadata:
   openclaw:
     requires:
@@ -47,7 +50,7 @@ Submit tools may wait briefly after creating the job. If the transcript is not r
 
 ## Safety Boundary
 
-This skill can submit bounded analysis jobs through hosted MCP tools. It does not read local browser data, does not save API keys, and does not perform login, posting, liking, commenting, or account changes. Use hosted MCP tools only when the current agent already supports authenticated streamable HTTP MCP.
+This skill can submit bounded analysis jobs through hosted MCP tools. It uses authenticated MCP access from the current agent at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes. Use hosted MCP tools only when the current agent already supports authenticated streamable HTTP MCP.
 
 ## MCP Tools
 

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

@@ -1,6 +1,9 @@
 ---
 name: "media-user-info"
 description: "Retrieve social media creator profile information from platform user IDs, profile URLs, short links, or share text. This version is backed by hosted platform MCP services and supports Xiaohongshu, 小红书, XHS, RedNote, Douyin / 抖音, Kuaishou / 快手, Weibo / 微博, and WeChat Channels / 视频号 creators."
+source_client: "socialdatax-skills"
+source_platform: "npm"
+source_skill: "media-user-info"
 metadata:
   openclaw:
     requires:
@@ -42,16 +45,16 @@ Use `SOCIALDATAX_API_KEY` for SocialDataX requests. The only official website fo
 Prefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:
 
 ```bash
-npx -y socialdatax-skills@latest xhs user-info --user-id "<user_id>" --pretty
-npx -y socialdatax-skills@latest xhs user-info --profile-url "<profile_url_or_share_text>" --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 kuaishou user-search --keyword "<creator_keyword>" --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 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 wechat user-info --user-id "<finder_user_id>" --pretty
+npx -y socialdatax-skills@latest xhs user-info --user-id "<user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-info
+npx -y socialdatax-skills@latest xhs user-info --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-info
+npx -y socialdatax-skills@latest douyin user-info --sec-user-id "<sec_user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-info
+npx -y socialdatax-skills@latest douyin user-info --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-info
+npx -y socialdatax-skills@latest kuaishou user-search --keyword "<creator_keyword>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-info
+npx -y socialdatax-skills@latest kuaishou user-info --user-id "<user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-info
+npx -y socialdatax-skills@latest kuaishou user-info --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-info
+npx -y socialdatax-skills@latest weibo user-info --user-id "<user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-info
+npx -y socialdatax-skills@latest weibo user-info --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-info
+npx -y socialdatax-skills@latest wechat user-info --user-id "<finder_user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-info
 ```
 
 Optional arguments:
@@ -64,11 +67,12 @@ Optional arguments:
 - Kuaishou `user-search --keyword <creator_keyword>`: use when the user only has a creator name, account keyword, or niche and needs possible Kuaishou user_id candidates before profile lookup.
 - Kuaishou user-search `--page-token <next_page_token>`: opaque pagination token; omit it on the first request and continue only with the complete returned `next_page_token` from the same creator-search chain.
 - Kuaishou user-search `--pages <n>` and `--max-items <n>`: fetch and merge bounded creator-search pages; user-search does not support `--since-days` because creator search results are accounts, not published content items.
-- Kuaishou `--user-id <user_id>`: preferred when the creator user_id is already known.
-- Kuaishou `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text.
+- Kuaishou `--user-id <user_id>`: use only when a non-empty creator user_id is already known.
+- Kuaishou `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text. Live/fw-user profile shares are supported; successful profile results return a reusable non-empty user_id.
 - Weibo `--user-id <user_id>`: preferred when the creator user_id is already known.
 - Weibo `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text.
 - WeChat Channels / 视频号 `--user-id <finder_user_id>`: use when the creator user_id ending with `@finder` is already known.
+- `--source-client socialdatax-skills --source-platform npm --source-skill media-user-info`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.
 
 Use either the ID option or the profile URL option for a single command, not both.
 
@@ -76,7 +80,7 @@ The command prints JSON with `platform`, `tool`, `arguments`, and `data`.
 
 ## 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. Prefer the direct CLI; hosted MCP tools are optional when the current agent already supports authenticated streamable HTTP MCP.
+This skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes. Prefer the direct CLI; hosted MCP tools are optional when the current agent already supports authenticated streamable HTTP MCP.
 
 ## MCP Tools
 
@@ -99,8 +103,8 @@ If MCP tools are already available in the current agent, use one of these tools:
 - `douyin_get_user_info_by_sec_user_id`: preferred when `sec_user_id` is already known from search, detail, comments, or creator work lists.
 - `douyin_get_user_info_by_profile_url`: use for profile URLs, short links, or profile share text.
 - `kuaishou_search_users`: use when the user only has a creator keyword and needs possible Kuaishou user_id candidates. Pass `keyword`; pass `page_token` only for continuation. Do not pass `page`.
-- `kuaishou_get_user_info_by_user_id`: preferred when `user_id` is already known from search, detail, comments, or creator work lists.
-- `kuaishou_get_user_info_by_profile_url`: use for profile URLs, short links, or profile share text.
+- `kuaishou_get_user_info_by_user_id`: preferred when a non-empty `user_id` is already known from search, detail, comments, or creator work lists.
+- `kuaishou_get_user_info_by_profile_url`: use for profile URLs, short links, or profile share text, including live/fw-user profile shares; successful results return a reusable non-empty `user_id`.
 - `weibo_get_user_info_by_user_id`: preferred when `user_id` is already known.
 - `weibo_get_user_info_by_profile_url`: use for profile URLs, short links, or profile share text.
 - `wechat_get_user_info_by_user_id`: use when the WeChat Channels / 视频号 creator user_id ending with `@finder` is already known.

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

@@ -1,6 +1,9 @@
 ---
 name: "media-user-posts"
 description: "Retrieve social media creator content lists from platform user IDs, profile URLs, short links, or share text for account research and content style analysis. This version is backed by hosted platform MCP services and supports Xiaohongshu, 小红书, XHS, RedNote, Douyin / 抖音, Kuaishou / 快手, Weibo / 微博, and WeChat Channels / 视频号 creators."
+source_client: "socialdatax-skills"
+source_platform: "npm"
+source_skill: "media-user-posts"
 metadata:
   openclaw:
     requires:
@@ -42,24 +45,24 @@ Use `SOCIALDATAX_API_KEY` for SocialDataX requests. The only official website fo
 Prefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:
 
 ```bash
-npx -y socialdatax-skills@latest xhs user-posts --user-id "<user_id>" --pretty
-npx -y socialdatax-skills@latest xhs user-posts --user-id "<user_id>" --all --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 --sec-user-id "<sec_user_id>" --all --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 --sec-user-id "<sec_user_id>" --all --pretty
-npx -y socialdatax-skills@latest douyin user-series --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 --user-id "<user_id>" --all --pretty
-npx -y socialdatax-skills@latest kuaishou user-posts --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 --user-id "<user_id>" --all --pretty
-npx -y socialdatax-skills@latest weibo user-posts --profile-url "<profile_url_or_share_text>" --pretty
-npx -y socialdatax-skills@latest wechat user-posts --user-id "<finder_user_id>" --pretty
-npx -y socialdatax-skills@latest wechat user-posts --user-id "<finder_user_id>" --all --pretty
-npx -y socialdatax-skills@latest wechat user-posts --url "<wechat_video_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest xhs user-posts --user-id "<user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
+npx -y socialdatax-skills@latest xhs user-posts --user-id "<user_id>" --all --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
+npx -y socialdatax-skills@latest xhs user-posts --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
+npx -y socialdatax-skills@latest douyin user-posts --sec-user-id "<sec_user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
+npx -y socialdatax-skills@latest douyin user-posts --sec-user-id "<sec_user_id>" --all --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
+npx -y socialdatax-skills@latest douyin user-posts --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
+npx -y socialdatax-skills@latest douyin user-series --sec-user-id "<sec_user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
+npx -y socialdatax-skills@latest douyin user-series --sec-user-id "<sec_user_id>" --all --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
+npx -y socialdatax-skills@latest douyin user-series --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
+npx -y socialdatax-skills@latest kuaishou user-posts --user-id "<user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
+npx -y socialdatax-skills@latest kuaishou user-posts --user-id "<user_id>" --all --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
+npx -y socialdatax-skills@latest kuaishou user-posts --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
+npx -y socialdatax-skills@latest weibo user-posts --user-id "<user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
+npx -y socialdatax-skills@latest weibo user-posts --user-id "<user_id>" --all --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
+npx -y socialdatax-skills@latest weibo user-posts --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
+npx -y socialdatax-skills@latest wechat user-posts --user-id "<finder_user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
+npx -y socialdatax-skills@latest wechat user-posts --user-id "<finder_user_id>" --all --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
+npx -y socialdatax-skills@latest wechat user-posts --url "<wechat_video_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill media-user-posts
 ```
 
 Optional arguments:
@@ -75,12 +78,13 @@ Optional arguments:
 - `--max-items <n>`: stop after collecting N creator content or series items.
 - `--since-days <1-365>`: keep only creator content whose public `publish_time` is within the last N days. When `--pages` is omitted, the CLI continues creator content lists until the publish-time boundary is reached.
 - `--pretty`: output formatting only.
-- Kuaishou `--user-id <user_id>`: preferred when the creator user_id is already known.
-- Kuaishou `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text.
+- Kuaishou `--user-id <user_id>`: use only when a non-empty creator user_id is already known.
+- Kuaishou `--profile-url <profile_url_or_share_text>`: use only for a profile URL, short link, or profile share text that resolves directly to a non-empty user_id. For live/fw-user profile shares, call Kuaishou creator profile first and use the returned non-empty user_id.
 - Weibo `--user-id <user_id>`: preferred when the creator user_id is already known.
 - Weibo `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text.
 - WeChat Channels / 视频号 `--user-id <finder_user_id>`: preferred when the creator user_id ending with `@finder` is already known.
 - WeChat Channels / 视频号 `--url <wechat_video_url_or_share_text>`: use a video link or share text to resolve the author and list that creator's videos.
+- `--source-client socialdatax-skills --source-platform npm --source-skill media-user-posts`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.
 
 Use either the ID option or the profile URL option for a single command, not both.
 
@@ -89,7 +93,7 @@ For recent creator research, prefer CLI `--since-days 30` or another user-specif
 
 ## 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. Prefer the direct CLI; hosted MCP tools are optional when the current agent already supports authenticated streamable HTTP MCP.
+This skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes. Prefer the direct CLI; hosted MCP tools are optional when the current agent already supports authenticated streamable HTTP MCP.
 
 ## MCP Tools
 
@@ -117,8 +121,8 @@ If MCP tools are already available in the current agent, use one of these tools:
 - `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 and series pagination use opaque `page_token` values. Pass the complete returned `next_page_token` back unchanged for the same user and command family. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses. Prefer CLI `--pages`, `--all`, and `--max-items` when the user asks for multiple pages or all available creator content.
-- `kuaishou_get_user_posted_videos_by_user_id`: preferred when `user_id` is already known.
-- `kuaishou_get_user_posted_videos_by_profile_url`: use for profile URLs, short links, or profile share text.
+- `kuaishou_get_user_posted_videos_by_user_id`: preferred when a non-empty `user_id` is already known.
+- `kuaishou_get_user_posted_videos_by_profile_url`: use only for profile URLs, short links, or profile share text that resolves directly to a non-empty `user_id`; for live/fw-user profile shares, call Kuaishou creator profile first and use the returned non-empty `user_id`.
 Kuaishou creator work pagination uses opaque `page_token` values; pass the complete returned `next_page_token` back unchanged for the same user. Do not modify, truncate, redact, mask, omit, normalize, rebuild, generate, or replace the middle with ellipses.
 - `weibo_get_user_posts_by_user_id`: preferred when `user_id` is already known.
 - `weibo_get_user_posts_by_profile_url`: use for profile URLs, short links, or profile share text.

package/skills/sensitive-check/SKILL.md

@@ -1,6 +1,9 @@
 ---
 name: "sensitive-check"
 description: "Check draft text for sensitive-content risks before publishing. Supports generic, xhs, douyin, and kuaishou contexts through SocialDataX."
+source_client: "socialdatax-skills"
+source_platform: "npm"
+source_skill: "sensitive-check"
 metadata:
   openclaw:
     requires:
@@ -37,7 +40,7 @@ Use `SOCIALDATAX_API_KEY` for SocialDataX requests. The only official website fo
 Prefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:
 
 ```bash
-npx -y socialdatax-skills@latest sensitive-check text --text "<content>" --platform xhs --pretty
+npx -y socialdatax-skills@latest sensitive-check text --text "<content>" --platform xhs --pretty --source-client socialdatax-skills --source-platform npm --source-skill sensitive-check
 ```
 
 Required arguments:
@@ -48,14 +51,15 @@ Optional arguments:
 
 - `--platform <generic|xhs|douyin|kuaishou>`: platform context; default is `generic`.
 - `--pretty`: output formatting only.
+- `--source-client socialdatax-skills --source-platform npm --source-skill sensitive-check`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.
 
-Use this skill when the user wants 敏感检测, sensitive check, content safety review, or platform-aware preflight review for draft text.
+适用于文本敏感检测、content safety review、发布前风险检查和 safer rewrite suggestions for draft text.
 The command prints JSON with `platform`, `tool`, and `data`; it does not echo the original text back in CLI arguments. The service returns `violation`, `risk_level`, `types`, `highlights`, `summary`, `platform`, and `suggestions` when available.
 This v1 skill checks text only. Image sensitive detection is intentionally out of scope until a separate image tool is published.
 
 ## 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. Prefer the direct CLI; hosted MCP tools are optional when the current agent already supports authenticated streamable HTTP MCP.
+This skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes. Prefer the direct CLI; hosted MCP tools are optional when the current agent already supports authenticated streamable HTTP MCP.
 
 ## MCP Tools
 

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

@@ -1,6 +1,9 @@
 ---
 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, 快手 / Kuaishou / Kwai, 微博 / Weibo, and 视频号 / WeChat Channels."
+source_client: "socialdatax-skills"
+source_platform: "npm"
+source_skill: "socialdatax-content-research-assistant"
 metadata:
   openclaw:
     requires:
@@ -67,87 +70,86 @@ Use `SOCIALDATAX_API_KEY` for SocialDataX requests. The only official website fo
 Prefer the direct CLI when the agent can run shell commands. It does not require MCP server configuration:
 
 ```bash
-npx -y socialdatax-skills@latest xhs hot-search --pretty
-npx -y socialdatax-skills@latest xhs search --keyword "<keyword>" --pretty
-npx -y socialdatax-skills@latest xhs search --keyword "<keyword>" --pages 3 --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 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 xhs user-posts --user-id "<user_id>" --all --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 search --keyword "<keyword>" --pages 3 --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 user-info --sec-user-id "<sec_user_id>" --pretty
-npx -y socialdatax-skills@latest douyin user-posts --sec-user-id "<sec_user_id>" --pretty
-npx -y socialdatax-skills@latest douyin user-posts --sec-user-id "<sec_user_id>" --all --pretty
-npx -y socialdatax-skills@latest kuaishou search --keyword "<keyword>" --pretty
-npx -y socialdatax-skills@latest kuaishou search --keyword "<keyword>" --pages 3 --pretty
-npx -y socialdatax-skills@latest kuaishou user-search --keyword "<creator_keyword>" --pretty
-npx -y socialdatax-skills@latest kuaishou detail --photo-id "<photo_id>" --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 user-info --user-id "<user_id>" --pretty
-npx -y socialdatax-skills@latest kuaishou user-posts --user-id "<user_id>" --pretty
-npx -y socialdatax-skills@latest kuaishou user-posts --user-id "<user_id>" --all --pretty
-npx -y socialdatax-skills@latest weibo hot-search --pretty
-npx -y socialdatax-skills@latest weibo search --keyword "<keyword>" --pretty
-npx -y socialdatax-skills@latest weibo search --keyword "<keyword>" --pages 3 --pretty
-npx -y socialdatax-skills@latest weibo detail --post-id "<post_id>" --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 user-info --user-id "<user_id>" --pretty
-npx -y socialdatax-skills@latest weibo user-posts --user-id "<user_id>" --pretty
-npx -y socialdatax-skills@latest weibo user-posts --user-id "<user_id>" --all --pretty
-npx -y socialdatax-skills@latest wechat hot-search --pretty
-npx -y socialdatax-skills@latest wechat search --keyword "<keyword>" --pretty
-npx -y socialdatax-skills@latest wechat search --keyword "<keyword>" --pages 3 --pretty
-npx -y socialdatax-skills@latest wechat detail --encrypted-object-id "<encrypted_object_id>" --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 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 --user-id "<finder_user_id>" --all --pretty
+npx -y socialdatax-skills@latest xhs hot-search --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest xhs search --keyword "<keyword>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest xhs search --keyword "<keyword>" --pages 3 --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest xhs detail --note-id "<note_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest xhs comments --note-id "<note_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest xhs comments --note-id "<note_id>" --all --include-replies --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest xhs user-info --user-id "<user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest xhs user-posts --user-id "<user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest xhs user-posts --user-id "<user_id>" --all --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest douyin hot-search --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest douyin search --keyword "<keyword>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest douyin search --keyword "<keyword>" --pages 3 --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest douyin detail --aweme-id "<aweme_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest douyin comments --aweme-id "<aweme_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest douyin comments --aweme-id "<aweme_id>" --all --include-replies --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest douyin user-info --sec-user-id "<sec_user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest douyin user-posts --sec-user-id "<sec_user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest douyin user-posts --sec-user-id "<sec_user_id>" --all --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest kuaishou search --keyword "<keyword>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest kuaishou search --keyword "<keyword>" --pages 3 --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest kuaishou user-search --keyword "<creator_keyword>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest kuaishou detail --photo-id "<photo_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest kuaishou comments --photo-id "<photo_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest kuaishou comments --photo-id "<photo_id>" --all --include-replies --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest kuaishou user-info --user-id "<user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest kuaishou user-posts --user-id "<user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest kuaishou user-posts --user-id "<user_id>" --all --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest weibo hot-search --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest weibo search --keyword "<keyword>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest weibo search --keyword "<keyword>" --pages 3 --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest weibo detail --post-id "<post_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest weibo comments --post-id "<post_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest weibo comments --post-id "<post_id>" --all --include-replies --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest weibo user-info --user-id "<user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest weibo user-posts --user-id "<user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest weibo user-posts --user-id "<user_id>" --all --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest wechat hot-search --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest wechat search --keyword "<keyword>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest wechat search --keyword "<keyword>" --pages 3 --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest wechat detail --encrypted-object-id "<encrypted_object_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest wechat comments --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest wechat comments --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --all --include-replies --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest wechat user-info --user-id "<finder_user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest wechat user-posts --user-id "<finder_user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest wechat user-posts --user-id "<finder_user_id>" --all --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
 ```
 
 Additional direct CLI entrypoints:
+
 ```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
-npx -y socialdatax-skills@latest douyin user-series --sec-user-id "<sec_user_id>" --pretty
-npx -y socialdatax-skills@latest douyin user-series --sec-user-id "<sec_user_id>" --all --pretty
-npx -y socialdatax-skills@latest douyin user-series --profile-url "<profile_url_or_share_text>" --pretty
-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
-npx -y socialdatax-skills@latest kuaishou user-search --keyword "<creator_keyword>" --pages 3 --pretty
-npx -y socialdatax-skills@latest kuaishou detail --url "<kuaishou_content_url_or_share_text>" --pretty
-npx -y socialdatax-skills@latest kuaishou comments --url "<kuaishou_content_url_or_share_text>" --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 --profile-url "<profile_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 weibo detail --post-url "<weibo_post_url_or_share_text>" --pretty
-npx -y socialdatax-skills@latest weibo comments --post-url "<weibo_post_url_or_share_text>" --pretty
-npx -y socialdatax-skills@latest weibo likers --post-id "<post_id>" --pretty
-npx -y socialdatax-skills@latest weibo likers --post-url "<weibo_post_url_or_share_text>" --pretty
-npx -y socialdatax-skills@latest weibo reposts --post-id "<post_id>" --pretty
-npx -y socialdatax-skills@latest weibo reposts --post-url "<weibo_post_url_or_share_text>" --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 --profile-url "<profile_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 wechat detail --url "<wechat_video_url_or_share_text>" --pretty
-npx -y socialdatax-skills@latest wechat comments --url "<wechat_video_url_or_share_text>" --pretty
-npx -y socialdatax-skills@latest wechat user-posts --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 xhs detail --url "<note_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest xhs comments --url "<note_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest xhs user-info --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest xhs user-posts --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest douyin detail --url "<douyin_content_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest douyin comments --url "<douyin_content_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest douyin user-info --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest douyin user-posts --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest douyin user-series --sec-user-id "<sec_user_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest douyin user-series --sec-user-id "<sec_user_id>" --all --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest douyin user-series --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest xhs sub-comments --note-id "<note_id>" --comment-id "<comment_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest douyin replies --aweme-id "<aweme_id>" --comment-id "<comment_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest kuaishou user-search --keyword "<creator_keyword>" --pages 3 --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest kuaishou detail --url "<kuaishou_content_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest kuaishou comments --url "<kuaishou_content_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest kuaishou user-info --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest kuaishou user-posts --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest kuaishou replies --photo-id "<photo_id>" --comment-id "<comment_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest weibo detail --post-url "<weibo_post_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest weibo comments --post-url "<weibo_post_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest weibo likers --post-id "<post_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest weibo reposts --post-id "<post_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest weibo user-info --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest weibo user-posts --profile-url "<profile_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest weibo replies --post-id "<post_id>" --comment-id "<comment_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest wechat detail --url "<wechat_video_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest wechat comments --url "<wechat_video_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest wechat user-posts --url "<wechat_video_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
+npx -y socialdatax-skills@latest wechat replies --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --comment-id "<comment_id>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
 ```
 
 For hot topics, content URLs, profile URLs, comment review, Weibo liker/repost review, creator facts, creator content lists, or short-drama series, call the matching `socialdatax-skills` platform subcommand instead of forcing every request through keyword research.
@@ -159,6 +161,8 @@ Required arguments:
 - Use `xhs search --keyword <text>`, `douyin search --keyword <text>`, `kuaishou search --keyword <text>`, `weibo search --keyword <text>`, or `wechat search --keyword <text>` for keyword research.
 - Use `kuaishou user-search --keyword <creator_keyword>` when the user wants to discover Kuaishou creator or account candidates by name, keyword, or niche before profile lookup.
 - For detail, comments, replies, creator profile, creator posts, and creator series commands, use the ID argument shown in the CLI example or the matching URL/profile-url entrypoint, not both.
+- Use `kuaishou search --keyword <text>` for Kuaishou keyword research.
+- Use `weibo hot-search` without keyword when the user asks for current Weibo / 微博 hot topics.
 - Use `wechat hot-search` without keyword when the user asks for current WeChat Channels / 视频号 hot topics.
 
 Optional arguments:
@@ -174,6 +178,7 @@ Optional arguments:
 - `--sort-type`, `--note-type`, `--publish-time-range`, `--duration-range`, and `--content-type`: apply only to XHS, Douyin, or WeChat Channels keyword research commands when the user asks for filtering; Kuaishou and Weibo search currently use `--keyword` and optional `--page-token`.
 - `--comment-id`: required for reply/sub-comment commands together with the content ID.
 - `--pretty`: output formatting only.
+- `--source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant`: usage attribution for this Agent Skill; keep these values unchanged when running examples from this Skill.
 
 ## Choose The Platform
 
@@ -191,7 +196,7 @@ When the user asks for recent content, pass CLI `--since-days <n>` with bounded
 
 ## 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. Prefer the direct CLI; hosted MCP tools are optional when the current agent already supports authenticated streamable HTTP MCP.
+This skill is read-only. It uses `SOCIALDATAX_API_KEY` from the user's environment at runtime. Generated Skill files do not contain API keys. It does not read local browser data or perform login, posting, liking, commenting, or account changes. Prefer the direct CLI; hosted MCP tools are optional when the current agent already supports authenticated streamable HTTP MCP.
 
 ## MCP Tools
 
@@ -200,7 +205,7 @@ MCP tools matching the direct CLI commands above:
 - XHS: `xhs_get_search_hot_list`, `xhs_search_notes`, `xhs_get_note_detail_by_note_id`, `xhs_get_note_comments_by_note_id`, `xhs_get_user_info_by_user_id`, `xhs_get_user_posted_notes_by_user_id`, `xhs_get_note_detail_by_note_url`, `xhs_get_note_comments_by_note_url`, `xhs_get_user_info_by_profile_url`, `xhs_get_user_posted_notes_by_profile_url`, `xhs_get_note_sub_comments_by_comment_id`
 - DOUYIN: `douyin_get_hot_search_list`, `douyin_search_videos`, `douyin_get_video_detail_by_aweme_id`, `douyin_get_video_comments_by_aweme_id`, `douyin_get_user_info_by_sec_user_id`, `douyin_get_user_posted_videos_by_sec_user_id`, `douyin_get_video_detail_by_url`, `douyin_get_video_comments_by_url`, `douyin_get_user_info_by_profile_url`, `douyin_get_user_posted_videos_by_profile_url`, `douyin_get_user_series_by_sec_user_id`, `douyin_get_user_series_by_profile_url`, `douyin_get_video_comment_replies_by_comment_id`
 - KUAISHOU: `kuaishou_search_videos`, `kuaishou_search_users`, `kuaishou_get_video_detail_by_photo_id`, `kuaishou_get_video_comments_by_photo_id`, `kuaishou_get_user_info_by_user_id`, `kuaishou_get_user_posted_videos_by_user_id`, `kuaishou_get_video_detail_by_url`, `kuaishou_get_video_comments_by_url`, `kuaishou_get_user_info_by_profile_url`, `kuaishou_get_user_posted_videos_by_profile_url`, `kuaishou_get_video_comment_replies_by_comment_id`
-- WEIBO: `weibo_get_hot_search_list`, `weibo_search_posts`, `weibo_get_post_detail_by_post_id`, `weibo_get_post_comments_by_post_id`, `weibo_get_user_info_by_user_id`, `weibo_get_user_posts_by_user_id`, `weibo_get_post_detail_by_post_url`, `weibo_get_post_comments_by_post_url`, `weibo_get_post_liker_list_by_post_id`, `weibo_get_post_liker_list_by_post_url`, `weibo_get_post_repost_list_by_post_id`, `weibo_get_post_repost_list_by_post_url`, `weibo_get_user_info_by_profile_url`, `weibo_get_user_posts_by_profile_url`, `weibo_get_post_comment_replies_by_comment_id`
+- WEIBO: `weibo_get_hot_search_list`, `weibo_search_posts`, `weibo_get_post_detail_by_post_id`, `weibo_get_post_comments_by_post_id`, `weibo_get_user_info_by_user_id`, `weibo_get_user_posts_by_user_id`, `weibo_get_post_detail_by_post_url`, `weibo_get_post_comments_by_post_url`, `weibo_get_post_liker_list_by_post_id`, `weibo_get_post_repost_list_by_post_id`, `weibo_get_user_info_by_profile_url`, `weibo_get_user_posts_by_profile_url`, `weibo_get_post_comment_replies_by_comment_id`
 - WECHAT: `wechat_get_hot_search_list`, `wechat_search_videos`, `wechat_get_video_detail_by_encrypted_object_id`, `wechat_get_video_comments_by_object_id`, `wechat_get_user_info_by_user_id`, `wechat_get_user_posted_videos_by_user_id`, `wechat_get_video_detail_by_url`, `wechat_get_video_comments_by_url`, `wechat_get_user_posted_videos_by_url`, `wechat_get_video_comment_replies_by_comment_id`
 
 Use the automatically listed MCP tools above as the source of truth for tool names. Pick the narrowest tool for the user's platform and task.