socialdatax-skills 0.2.41 → 0.2.43

package/CATALOG.md

@@ -2,7 +2,7 @@
 
 SocialDataX (社媒数据助手) provides Agent Skills for read-only social media research workflows. These Skills help agents use the `socialdatax-skills` CLI and SocialDataX MCP services for content research, comment analysis, topic planning, video transcript extraction, and copy safety review.
 
-Official website and API Key access: <https://socialdatax.com/ai?from=github>
+Official website and API Key access: <https://socialdatax.com/ai?from=npm>
 
 ## Quick Start
 
@@ -17,7 +17,7 @@ Run a direct CLI command:
 ```bash
 npx -y socialdatax-skills@latest xhs search \
   --keyword "露营" --sort-type like_count_descending --pages 2 --max-items 20 --pretty \
-  --source-client socialdatax-skills --source-platform github --source-skill media-search
+  --source-client socialdatax-skills --source-platform npm --source-skill media-search
 ```
 
 The CLI does not log in to user accounts, post content, like, comment, or change account settings.
@@ -30,11 +30,11 @@ This table is a curated marketplace catalog, not the complete platform support l
 | --- | --- | --- | --- |
 | 社媒内容研究助手 | Research supported SocialDataX public platforms including XHS, Douyin, Kuaishou, Bilibili, Zhihu, Instagram, X / Twitter, YouTube, TikTok, Weibo, and WeChat Channels, plus WeChat Official Account article details. | Cross-platform social content research | SkillHub / ModelScope / GitHub: `socialdatax-content-research-assistant` |
 | 小红书内容研究 | Research popular XHS / Xiaohongshu / RedNote note samples, content angles, keywords, competitor content, and trend material. | XHS note search | ClawHub / ModelScope: `xhs-content-research` |
-| 小红书评论分析与需求挖掘 | Analyze comments from a provided XHS note URL or complete `note_id` for user feedback, pain points, purchase objections, FAQ, and demand signals. | XHS comments and replies | ClawHub / ModelScope: `xhs-comment-insights` |
+| 小红书评论分析与需求挖掘 | Analyze comments from a provided XHS note URL or complete `note_id` for user feedback, pain points, purchase objections, FAQ, and demand signals. | XHS comments and replies | ClawHub / ModelScope / GitHub: `xhs-comment-insights` |
 | 小红书热榜选题分析 | Turn current XHS hot-list signals and related popular note samples into actionable topic ideas. | XHS hot search plus note search | ClawHub / ModelScope: `xhs-hot-topic-selection` |
 | 小红书爆款笔记研究 | Study high-engagement XHS note samples from a keyword, niche, product, or scenario. | XHS note search | ClawHub / ModelScope: `xhs-viral-note-research` |
 | 小红书爆款文案拆解 | Break down XHS viral copy structure, title hooks, opening style, selling points, emotional wording, CTA, and reusable copy framework. | XHS search and note detail | ClawHub / ModelScope: `xhs-viral-copy-breakdown` |
-| 抖音文案提取 | Extract Douyin video context, original description, spoken transcript, copy-ready version, and task status from a URL, share text, `aweme_id`, or transcript `job_id`. | Douyin transcript job | SkillHub / ClawHub / ModelScope: `douyin-video-copy-extract` |
+| 抖音文案提取 | Extract Douyin video context, original description, spoken transcript, copy-ready version, and task status from a URL, share text, `aweme_id`, or transcript `job_id`. | Douyin transcript job | SkillHub / ClawHub / ModelScope / GitHub: `douyin-video-copy-extract` |
 | 敏感词检测与违禁词检查 | Check copy before publishing for sensitive terms, platform risk hints, and safer rewrite suggestions. | Copy safety review | SkillHub / ClawHub / ModelScope: `socialdatax-sensitive-check` |
 
 ## Direct CLI Examples
@@ -44,7 +44,7 @@ This table is a curated marketplace catalog, not the complete platform support l
 ```bash
 npx -y socialdatax-skills@latest xhs search \
   --keyword "<keyword>" --sort-type like_count_descending --pages 2 --max-items 20 --pretty \
-  --source-client socialdatax-skills --source-platform github --source-skill media-search
+  --source-client socialdatax-skills --source-platform npm --source-skill media-search
 ```
 
 ### XHS Viral Note Research
@@ -52,7 +52,7 @@ npx -y socialdatax-skills@latest xhs search \
 ```bash
 npx -y socialdatax-skills@latest xhs search \
   --keyword "<keyword>" --sort-type like_count_descending --pages 2 --max-items 20 --pretty \
-  --source-client socialdatax-skills --source-platform github --source-skill media-search
+  --source-client socialdatax-skills --source-platform npm --source-skill media-search
 ```
 
 ### XHS Viral Copy Breakdown
@@ -62,7 +62,7 @@ Find candidate notes:
 ```bash
 npx -y socialdatax-skills@latest xhs search \
   --keyword "<keyword>" --sort-type like_count_descending --pages 2 --max-items 20 --pretty \
-  --source-client socialdatax-skills --source-platform github --source-skill socialdatax-content-research-assistant
+  --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
 ```
 
 Read one selected note for copy breakdown:
@@ -70,7 +70,7 @@ Read one selected note for copy breakdown:
 ```bash
 npx -y socialdatax-skills@latest xhs detail \
   --url "<xhs_note_url_or_share_text>" --pretty \
-  --source-client socialdatax-skills --source-platform github --source-skill socialdatax-content-research-assistant
+  --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
 ```
 
 ### XHS Comment Analysis
@@ -78,14 +78,14 @@ npx -y socialdatax-skills@latest xhs detail \
 ```bash
 npx -y socialdatax-skills@latest xhs comments \
   --url "<xhs_note_url_or_share_text>" --pages 2 --max-items 20 --include-replies --pretty \
-  --source-client socialdatax-skills --source-platform github --source-skill media-comments
+  --source-client socialdatax-skills --source-platform npm --source-skill media-comments
 ```
 
 ### XHS Hot Topic Planning
 
 ```bash
 npx -y socialdatax-skills@latest xhs hot-search \
-  --pretty --source-client socialdatax-skills --source-platform github \
+  --pretty --source-client socialdatax-skills --source-platform npm \
   --source-skill socialdatax-content-research-assistant
 ```
 
@@ -94,7 +94,7 @@ Then search notes for one selected hot topic:
 ```bash
 npx -y socialdatax-skills@latest xhs search \
   --keyword "<hot_topic_keyword>" --sort-type like_count_descending --pages 2 --max-items 20 --pretty \
-  --source-client socialdatax-skills --source-platform github --source-skill socialdatax-content-research-assistant
+  --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
 ```
 
 ### Douyin Copy Extraction
@@ -102,7 +102,7 @@ npx -y socialdatax-skills@latest xhs search \
 ```bash
 npx -y socialdatax-skills@latest douyin transcript \
   --url "<douyin_video_url_or_share_text>" --pretty \
-  --source-client socialdatax-skills --source-platform github --source-skill media-transcript
+  --source-client socialdatax-skills --source-platform npm --source-skill media-transcript
 ```
 
 If the transcript job is still pending, keep the returned `job_id` and query it again:
@@ -110,7 +110,7 @@ If the transcript job is still pending, keep the returned `job_id` and query it
 ```bash
 npx -y socialdatax-skills@latest douyin transcript \
   --job-id "<job_id>" --pretty \
-  --source-client socialdatax-skills --source-platform github --source-skill media-transcript
+  --source-client socialdatax-skills --source-platform npm --source-skill media-transcript
 ```
 
 ### Sensitive Term Check
@@ -118,7 +118,7 @@ npx -y socialdatax-skills@latest douyin transcript \
 ```bash
 npx -y socialdatax-skills@latest sensitive-check text \
   --text "<copy_to_check>" --platform xhs --pretty \
-  --source-client socialdatax-skills --source-platform github --source-skill sensitive-check
+  --source-client socialdatax-skills --source-platform npm --source-skill sensitive-check
 ```
 
 ## Output Principles

package/README.md

@@ -89,7 +89,7 @@ Common search phrases for this skill package:
 - Reserved future SocialDataX namespace names for existing platform listings without draft files yet: `com.socialdatax/kuaishou-insights`, `com.socialdatax/bilibili-insights`, `com.socialdatax/weibo-insights`, `com.socialdatax/wechat-channels-insights`, `com.socialdatax/zhihu-insights`, `com.socialdatax/instagram-insights`, `com.socialdatax/x-insights`, `com.socialdatax/youtube-insights`, and `com.socialdatax/tiktok-insights`.
 - Hosted endpoint without a repo-tracked standalone listing: Sensitive Words Check.
 - Unified MCP registry name: none; this package installs skills and calls explicit hosted MCP entries.
-- Current public capability version: `0.2.41`
+- Current public capability version: `0.2.43`
 
 ## Direct CLI
 
@@ -193,6 +193,7 @@ npx -y socialdatax-skills@latest wechat comments --object-id "<object_id>" --obj
 npx -y socialdatax-skills@latest wechat comments --url "<wechat_video_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest wechat replies --object-id "<object_id>" --object-nonce-id "<object_nonce_id>" --comment-id "<comment_id>" --pretty
 npx -y socialdatax-skills@latest wechat user-info --user-id "<v2_finder_user_id>" --pretty
+npx -y socialdatax-skills@latest wechat user-info --url "<wechat_work_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest wechat user-posts --user-id "<v2_finder_user_id>" --pretty
 npx -y socialdatax-skills@latest wechat user-posts --url "<wechat_work_url_or_share_text>" --pretty
 npx -y socialdatax-skills@latest wechat transcript --url "<wechat_video_url_or_share_text>" --pretty

package/cli.mjs

@@ -22,7 +22,7 @@ import { decryptWechatMediaCommand } from "./lib/media/wechat-decrypt.mjs";
 export { decryptWechatMediaCommand };
 
 const PACKAGE_NAME = "socialdatax-skills";
-const PACKAGE_VERSION = "0.2.41";
+const PACKAGE_VERSION = "0.2.43";
 const PACKAGE_SPEC = `${PACKAGE_NAME}@latest`;
 const LOG_PREFIX = `[${PACKAGE_NAME}]`;
 const MIN_NODE_VERSION = "20.18.1";
@@ -788,7 +788,7 @@ const WECHAT_DIRECT_ACTION_OPTIONS = {
     "includeReplies",
     "pretty",
   ],
-  "user-info": ["userId", "pretty"],
+  "user-info": ["userId", "url", "pretty"],
   "user-posts": [
     "userId",
     "url",
@@ -3077,6 +3077,9 @@ function printHelp() {
   console.log(`  npx -y ${PACKAGE_SPEC} wechat user-info --user-id "<v2_finder_user_id>" --pretty`);
   console.log("      Call the WeChat Channels / 视频号 creator profile tool with a v2_...@finder user_id.");
   console.log("");
+  console.log(`  npx -y ${PACKAGE_SPEC} wechat user-info --url "<wechat_work_url_or_share_text>" --pretty`);
+  console.log("      Resolve a WeChat Channels / 视频号 video or image-post link or share text into creator profile data.");
+  console.log("");
   console.log(`  npx -y ${PACKAGE_SPEC} wechat user-posts --user-id "<v2_finder_user_id>" --pretty`);
   console.log("      Call the WeChat Channels / 视频号 creator videos and image posts tool with a v2_...@finder user_id.");
   console.log("");
@@ -4531,12 +4534,15 @@ function buildWechatOperation(action, options) {
     case "user-info":
       return buildDirectOperation(
         "user-info",
-        buildRequiredIdCall(options, {
+        buildOneOfCall(options, {
           idOption: "userId",
-          tool: "wechat_get_user_info_by_user_id",
+          urlOption: "url",
+          idTool: "wechat_get_user_info_by_user_id",
+          urlTool: "wechat_get_user_info_by_url",
           idArgument: "user_id",
+          urlArgument: "url",
           idDisplay: "--user-id",
-          platformLabel: "wechat user-info",
+          urlDisplay: "--url",
         }),
         PLATFORMS.wechat
       );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "socialdatax-skills",
-  "version": "0.2.41",
+  "version": "0.2.43",
   "description": "SocialDataX / 社媒数据助手 skill installer and direct CLI helper for hosted MCP services.",
   "license": "MIT",
   "type": "module",
@@ -19,7 +19,7 @@
   "scripts": {
     "start": "node ./cli.mjs",
     "pack:check": "npm pack --dry-run --json",
-    "test": "node --test test/*.test.mjs"
+    "test": "node ./test/run-tests.mjs"
   },
   "keywords": [
     "socialdatax",

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

@@ -142,6 +142,10 @@ npx -y socialdatax-skills@latest weibo user-info \
 npx -y socialdatax-skills@latest wechat user-info \
   --user-id "<v2_finder_user_id>" --pretty --source-client socialdatax-skills \
   --source-platform npm --source-skill media-user-info
+
+npx -y socialdatax-skills@latest wechat user-info \
+  --url "<wechat_work_url_or_share_text>" --pretty --source-client socialdatax-skills \
+  --source-platform npm --source-skill media-user-info
 ```
 
 Optional arguments:
@@ -166,9 +170,10 @@ Optional arguments:
 - Weibo `--user-id <user_id>`: preferred when the creator user_id is already known.
 - Weibo `--profile-url <profile_url>`: use for a Weibo user profile URL.
 - WeChat Channels / 视频号 `--user-id <v2_finder_user_id>`: use when the creator `v2_...@finder` user_id is already known.
+- WeChat Channels / 视频号 `--url <wechat_work_url_or_share_text>`: use for a video or image-post link or share text that can resolve the creator profile.
 - `--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.
+Use exactly one supported identifier or URL entrypoint for a single command; do not combine them.
 
 The command prints JSON with `platform`, `tool`, `arguments`, and `data`.
 
@@ -190,9 +195,9 @@ MCP tools matching the direct CLI commands above:
 - YOUTUBE: `youtube_get_channel_info_by_url`
 - TIKTOK: `tiktok_get_user_info_by_tiktok_id`, `tiktok_get_user_info_by_profile_url`
 - WEIBO: `weibo_get_user_info_by_user_id`, `weibo_get_user_info_by_profile_url`
-- WECHAT: `wechat_get_user_info_by_user_id`
+- WECHAT: `wechat_get_user_info_by_user_id`, `wechat_get_user_info_by_url`
 
-MCP-only tools not available through the direct CLI: `douyin_get_user_info_by_douyin_id`, `wechat_get_user_info_by_url`
+MCP-only tools not available through the direct CLI: `douyin_get_user_info_by_douyin_id`
 
 If MCP tools are already available in the current agent, use one of these tools:
 - `xhs_get_user_info_by_user_id`: preferred when `user_id` is already known from search, detail, comments, or creator note lists.

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

@@ -254,6 +254,7 @@ npx -y socialdatax-skills@latest weibo replies --post-id "<post_id>" --comment-i
 npx -y socialdatax-skills@latest wechat detail --url "<wechat_work_url_or_share_text>" --pretty --source-client socialdatax-skills --source-platform npm --source-skill socialdatax-content-research-assistant
 npx -y socialdatax-skills@latest wechat article --url "<mp_article_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-info --url "<wechat_work_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_work_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
 ```
@@ -326,9 +327,9 @@ MCP tools matching the direct CLI commands above:
 - YOUTUBE: `youtube_search_videos`, `youtube_get_video_detail_by_url`, `youtube_get_video_comments_by_url`, `youtube_get_channel_info_by_url`, `youtube_get_user_posted_videos_by_channel_url`, `youtube_get_video_comment_replies`
 - TIKTOK: `tiktok_search_posts`, `tiktok_get_post_detail_by_url`, `tiktok_get_post_comments_by_post_id`, `tiktok_get_user_info_by_tiktok_id`, `tiktok_get_user_posts_by_tiktok_id`, `tiktok_get_post_comments_by_url`, `tiktok_get_post_comment_replies`, `tiktok_get_user_info_by_profile_url`, `tiktok_get_user_posts_by_profile_url`
 - 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_mp_article_detail_by_url`, `wechat_get_video_comments_by_url`, `wechat_get_user_posted_videos_by_url`, `wechat_get_video_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_mp_article_detail_by_url`, `wechat_get_video_comments_by_url`, `wechat_get_user_info_by_url`, `wechat_get_user_posted_videos_by_url`, `wechat_get_video_comment_replies_by_comment_id`
 
-MCP-only tools not available through the direct CLI: `douyin_search_users`, `douyin_get_user_info_by_douyin_id`, `weibo_get_post_liker_list_by_post_url`, `weibo_get_post_repost_list_by_post_url`, `wechat_get_user_info_by_url`
+MCP-only tools not available through the direct CLI: `douyin_search_users`, `douyin_get_user_info_by_douyin_id`, `weibo_get_post_liker_list_by_post_url`, `weibo_get_post_repost_list_by_post_url`
 
 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. For search pagination, omit `page_token` on the first request and pass only the complete returned `next_page_token` when continuing the same chain.