socialdatax-skills 0.2.0

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "socialdatax-skills",
+  "version": "0.2.0",
+  "description": "SocialDataX / 社媒数据助手 skill installer and direct CLI helper for hosted platform social media MCP services.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "socialdatax-skills": "cli.mjs"
+  },
+  "files": [
+    "cli.mjs",
+    "README.md",
+    "LICENSE",
+    "skills/**",
+    "assets/logo.png"
+  ],
+  "scripts": {
+    "start": "node ./cli.mjs",
+    "pack:check": "npm pack --dry-run --json",
+    "test": "node --test test/*.test.mjs"
+  },
+  "keywords": [
+    "socialdatax",
+    "socialdatax-skills",
+    "agentskills",
+    "skills",
+    "skill-installer",
+    "xiaohongshu",
+    "xhs",
+    "rednote",
+    "rednote-data",
+    "douyin",
+    "douyin-data",
+    "douyin-search",
+    "xiaohongshu-data",
+    "xiaohongshu-search",
+    "xhs-data",
+    "xhs-search",
+    "social-insights",
+    "social-media",
+    "media-search",
+    "content-analysis",
+    "creator-analytics"
+  ],
+  "homepage": "https://socialdatax.com",
+  "bugs": {
+    "url": "https://socialdatax.com"
+  },
+  "engines": {
+    "node": ">=20.18.1"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  }
+}

package/skills/media-comments/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: media-comments
+description: Fetch and analyze XHS comments/replies and Douyin first-level comments. This version is backed by hosted platform MCP services and supports Xiaohongshu, 小红书, XHS, RedNote, and Douyin / 抖音.
+metadata:
+  openclaw:
+    requires:
+      env:
+        - SOCIALDATAX_API_KEY
+      bins:
+        - node
+        - npm
+    primaryEnv: SOCIALDATAX_API_KEY
+    emoji: "💬"
+    homepage: https://socialdatax.com
+    install:
+      - kind: node
+        package: "socialdatax-skills"
+        bins: []
+---
+
+# Media Comments
+
+Use this skill when the user wants comment mining, audience feedback, sentiment themes, objections, pain points, FAQ extraction, or discussion summaries for supported social media content.
+
+Current platform support:
+
+- Xiaohongshu / XHS / RedNote notes through the `xhs_get_note_comments_by_*` and `xhs_get_note_sub_comments_by_comment_id` tools.
+- Douyin / 抖音 works, including video and image/text posts, through the `douyin_get_video_comments_by_*` tools.
+
+## Preferred Direct CLI
+
+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 --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 --url "<douyin_content_url_or_share_text>" --pretty
+```
+
+- XHS `--note-id <note_id>`: preferred when the note ID is already known and should anchor the comment thread.
+- Douyin `--aweme-id <aweme_id>`: preferred when the video ID is already known and should anchor the comment thread.
+- `--url <url_or_share_text>`: use for a content page URL, short link, or share text for first-level comments; for Douyin, do not pass `video.play_url`.
+- `--comment-id <comment_id>`: required only for XHS reply commands; use the first-level comment ID under the same content item.
+- `--page-token <next_page_token>`: opaque pagination token; pass back exactly the token returned by the previous page and do not reuse it across content items or comments.
+- `--pretty`: output formatting only.
+
+For XHS `comments`, use either `--note-id` or `--url`, not both. For Douyin `comments`, use either `--aweme-id` or `--url`, not both. For XHS reply commands, use the content ID together with `--comment-id`.
+
+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.
+
+## MCP Tools
+
+If MCP tools are already available in the current agent, use one of these tools:
+
+- `xhs_get_note_comments_by_note_id`: use when the note ID is known.
+- `xhs_get_note_comments_by_note_url`: use for note URLs, short links, or share text.
+- `xhs_get_note_sub_comments_by_comment_id`: use when the note ID and first-level comment ID are known.
+- `douyin_get_video_comments_by_aweme_id`: use when the aweme_id is known.
+- `douyin_get_video_comments_by_url`: use for Douyin content page URLs, short links, or share text; do not pass playback URLs such as `video.play_url`.
+
+Comment pagination uses `page_token`. Pass back exactly the returned `next_page_token`; tokens are bound to the current content item and should not be reused across objects. XHS reply pagination also uses `page_token` and is bound to the current comment.
+
+## Output Guidance
+
+Group comments by observed themes before inferring sentiment or demand. Mention whether the result is one page or multiple pages. Empty comments can be a valid successful result.

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

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

package/skills/media-detail/SKILL.md

@@ -0,0 +1,66 @@
+---
+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, and Douyin / 抖音.
+metadata:
+  openclaw:
+    requires:
+      env:
+        - SOCIALDATAX_API_KEY
+      bins:
+        - node
+        - npm
+    primaryEnv: SOCIALDATAX_API_KEY
+    emoji: "📄"
+    homepage: https://socialdatax.com
+    install:
+      - kind: node
+        package: "socialdatax-skills"
+        bins: []
+---
+
+# Media Detail
+
+Use this skill when the user provides a content link, short link, share text, or content ID and wants structured details or interaction metrics.
+
+Current platform support:
+
+- Xiaohongshu / XHS / RedNote notes through the `xhs_get_note_detail_by_*` tools.
+- Douyin / 抖音 works, including video and image/text posts, through the `douyin_get_video_detail_by_*` tools.
+
+## Preferred Direct CLI
+
+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_or_note_id>" --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
+```
+
+- XHS `--note-id <note_id>`: preferred when the note ID is already known from search, comments, or a previous detail result.
+- XHS `--url <note_url_or_share_text_or_note_id>`: use for a note link, short link, share text, or note ID when you want the alternate entrypoint for one note.
+- Douyin `--aweme-id <aweme_id>`: preferred when the Douyin work ID is already known.
+- Douyin `--url <douyin_content_url_or_share_text>`: use for a Douyin content page URL, short link, or share text; do not pass `video.play_url`.
+- `--pretty`: output formatting only.
+
+Use either the ID option or the URL option for detail commands, not both.
+
+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.
+
+## MCP Tools
+
+If MCP tools are already available in the current agent, use one of these tools:
+
+- `xhs_get_note_detail_by_note_id`: use when a note ID is already known.
+- `xhs_get_note_detail_by_note_url`: use for note URLs, short links, share text, or note IDs.
+- `douyin_get_video_detail_by_aweme_id`: use when an aweme_id is already known.
+- `douyin_get_video_detail_by_url`: use for Douyin content page URLs, short links, or share text; do not pass playback URLs such as `video.play_url`.
+
+## Output Guidance
+
+Return factual fields such as title or description, content, author, publish time, interaction counts, `content_type`, images, and media summary when available. For Douyin detail, use `images` for image/text posts; `video` is the platform player resource and may be audio for image/text posts; `music` is the bound music or original-sound asset. Detail access is read-only and does not provide account actions.

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

@@ -0,0 +1,7 @@
+interface:
+  display_name: "Media Detail"
+  short_description: "Read content details"
+  default_prompt: "Use $media-detail to read structured details and metrics for supported social media content."
+
+policy:
+  allow_implicit_invocation: true

package/skills/media-search/SKILL.md

@@ -0,0 +1,134 @@
+---
+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, and Douyin / 抖音.
+metadata:
+  openclaw:
+    requires:
+      env:
+        - SOCIALDATAX_API_KEY
+      bins:
+        - node
+        - npm
+    primaryEnv: SOCIALDATAX_API_KEY
+    emoji: "🔍"
+    homepage: https://socialdatax.com
+    install:
+      - kind: node
+        package: "socialdatax-skills"
+        bins: []
+---
+
+# Media Search
+
+Use this skill when the user wants to discover social media content from a keyword, brand, product, campaign, creator niche, or research topic.
+
+Current platform support:
+
+- Xiaohongshu / XHS / RedNote notes through `xhs_search_notes`.
+- Douyin / 抖音 works, including video and image/text posts, through `douyin_search_videos`.
+
+## Preferred Direct CLI
+
+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 douyin search --keyword "<keyword>" --pretty
+```
+
+Required arguments:
+
+- `--keyword <text>`: search phrase or topic; use the user's actual intent, trim whitespace, and keep it focused.
+
+Optional arguments:
+
+- XHS `--page <number>`: 1-based page number; use `1` for the first page and only increase it when continuing pagination.
+- XHS `--sort-type <general|time_descending|like_count_descending|comment_count_descending|collect_count_descending>`: optional sort value; omit it for default sorting.
+- XHS `--note-type <all|image|video>`: optional note type filter; default is `all`.
+- XHS `--publish-time-range <all|day|week|half_year>`: optional publish-time filter; default is `all`.
+- Douyin `--page-token <next_page_token>`: opaque pagination token returned by the previous page.
+- Douyin `--sort-type <general|time_descending|like_count_descending>`: optional sort value; omit it for the default sort.
+- Douyin `--publish-time-range <all|day|week|half_year>`: optional publish-time filter; omit it for no publish-time filter.
+- Douyin `--duration-range <all|under_1_minute|one_to_five_minutes|over_5_minutes>`: optional duration filter; omit it for no duration filter.
+- Douyin `--content-type <all|video|image>`: optional content type filter; omit it for all content types.
+- `--pretty`: output formatting only; it does not change the query or the returned notes.
+
+XHS sort values:
+
+- `general`: default sorting.
+- `time_descending`: newest first.
+- `like_count_descending`: most liked first.
+- `comment_count_descending`: most commented first.
+- `collect_count_descending`: most collected first.
+
+XHS note type filter values:
+
+- `all`: no note type filter.
+- `image`: image/text notes.
+- `video`: video notes.
+
+XHS publish-time filter values:
+
+- `all`: no publish-time filter.
+- `day`: published within one day.
+- `week`: published within one week.
+- `half_year`: published within half a year.
+
+Douyin sort values:
+
+- `general`: default sorting.
+- `time_descending`: newest first.
+- `like_count_descending`: most liked first.
+
+Douyin publish-time filter values:
+
+- `all`: no publish-time filter.
+- `day`: published within one day.
+- `week`: published within one week.
+- `half_year`: published within half a year.
+
+Douyin duration filter values:
+
+- `all`: no duration filter.
+- `under_1_minute`: under 1 minute.
+- `one_to_five_minutes`: 1-5 minutes.
+- `over_5_minutes`: over 5 minutes.
+
+Douyin content type filter values:
+
+- `all`: all content types.
+- `video`: video works.
+- `image`: image/text posts.
+
+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.
+
+## MCP Tools
+
+If MCP tools are already available in the current agent, call `xhs_search_notes` with:
+
+- `keyword`: required search phrase or topic; use the user's actual intent and trim whitespace.
+- `page`: optional 1-based page number; use `1` for the first page.
+- `sort_type`: optional, one of `general`, `time_descending`, `like_count_descending`, `comment_count_descending`, `collect_count_descending`; omit it for default sorting.
+- `note_type`: optional search filter, one of `all`, `image`, `video`; default is `all`.
+- `publish_time_range`: optional search filter, one of `all`, `day`, `week`, `half_year`; default is `all`.
+
+Use the same meanings as the CLI XHS sort and filter values above.
+
+For Douyin, call `douyin_search_videos` with:
+
+- `keyword`: required search phrase or topic.
+- `page_token`: optional opaque pagination token from the previous page.
+- `sort_type`: optional, one of `general`, `time_descending`, `like_count_descending`; omit it for the default sort.
+- `publish_time_range`: optional publish-time filter, one of `all`, `day`, `week`, `half_year`; omit it for no publish-time filter.
+- `duration_range`: optional duration filter, one of `all`, `under_1_minute`, `one_to_five_minutes`, `over_5_minutes`; omit it for no duration filter.
+- `content_type`: optional content type filter, one of `all`, `video`, `image`; omit it for all content types.
+
+Continue XHS pagination only when `next_page` is not `null`, and keep the same `keyword`, `sort_type`, `note_type`, and `publish_time_range` while changing only `page`. Continue Douyin pagination only when `next_page_token` is not empty. Do not stop only because one page has empty `items`.
+
+## Output Guidance
+
+Summarize visible evidence separately from interpretation. Include useful content IDs, URLs, titles or descriptions, authors, counts, publish time, and Douyin `content_type` when the user needs traceability. For Douyin image/text search results, use returned `images` and treat `video.media_type="audio"` as an audio player resource rather than a video post.

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

@@ -0,0 +1,7 @@
+interface:
+  display_name: "Media Search"
+  short_description: "Search content by keyword"
+  default_prompt: "Use $media-search to search supported social media content by keyword and choose an appropriate sort when useful."
+
+policy:
+  allow_implicit_invocation: true

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

@@ -0,0 +1,66 @@
+---
+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, and Douyin / 抖音 creators.
+metadata:
+  openclaw:
+    requires:
+      env:
+        - SOCIALDATAX_API_KEY
+      bins:
+        - node
+        - npm
+    primaryEnv: SOCIALDATAX_API_KEY
+    emoji: "👤"
+    homepage: https://socialdatax.com
+    install:
+      - kind: node
+        package: "socialdatax-skills"
+        bins: []
+---
+
+# Media User Info
+
+Use this skill when the user wants creator profile data, account basics, creator positioning, audience scale, or profile lookup for supported social media platforms.
+
+Current platform support:
+
+- Xiaohongshu / XHS / RedNote creators through the `xhs_get_user_info_by_*` tools.
+- Douyin / 抖音 creators through the `douyin_get_user_info_by_*` tools.
+
+## Preferred Direct CLI
+
+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
+```
+
+- XHS `--user-id <user_id>`: preferred when the creator ID is already known from another result.
+- XHS `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text.
+- Douyin `--sec-user-id <sec_user_id>`: preferred when the creator sec_user_id is already known.
+- Douyin `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text.
+- `--pretty`: output formatting only.
+
+Use either the ID option or the profile URL option for a single command, not both.
+
+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.
+
+## MCP Tools
+
+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.
+- `xhs_get_user_info_by_profile_url`: use for profile URLs, short links, or profile share text.
+- `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.
+
+## Output Guidance
+
+Report profile fields such as name, platform IDs, bio, verification, follower count, following count, received like count, IP location, and gender when available. Separate profile facts from strategic interpretation.

package/skills/media-user-info/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "Media User Info"
+  short_description: "Retrieve creator profiles"
+  default_prompt: "Use $media-user-info to retrieve creator profile information from a user ID, profile URL, short link, or share text."
+
+policy:
+  allow_implicit_invocation: true

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

@@ -0,0 +1,69 @@
+---
+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, and Douyin / 抖音 creators.
+metadata:
+  openclaw:
+    requires:
+      env:
+        - SOCIALDATAX_API_KEY
+      bins:
+        - node
+        - npm
+    primaryEnv: SOCIALDATAX_API_KEY
+    emoji: "🗂️"
+    homepage: https://socialdatax.com
+    install:
+      - kind: node
+        package: "socialdatax-skills"
+        bins: []
+---
+
+# Media User Posts
+
+Use this skill when the user wants a creator's published content list, content style analysis, recent-topic review, creator benchmarking, or account tracking for supported social media platforms.
+
+Current platform support:
+
+- Xiaohongshu / XHS / RedNote creator notes through the `xhs_get_user_posted_notes_by_*` tools.
+- Douyin / 抖音 creator works, including video and image/text posts, through the `douyin_get_user_posted_videos_by_*` tools.
+
+## Preferred Direct CLI
+
+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 --profile-url "<profile_url_or_share_text>" --pretty
+npx -y socialdatax-skills@latest douyin user-posts --sec-user-id "<sec_user_id>" --pretty
+npx -y socialdatax-skills@latest douyin user-posts --profile-url "<profile_url_or_share_text>" --pretty
+```
+
+- XHS `--user-id <user_id>`: preferred when the creator ID is already known.
+- XHS `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text.
+- Douyin `--sec-user-id <sec_user_id>`: preferred when the creator sec_user_id is already known.
+- Douyin `--profile-url <profile_url_or_share_text>`: use for a profile URL, short link, or profile share text.
+- `--page-token <next_page_token>`: opaque pagination token; pass back exactly the token returned by the previous page and do not reuse it across users.
+- `--pretty`: output formatting only.
+
+Use either the ID option or the profile URL option for a single command, not both.
+
+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.
+
+## MCP Tools
+
+If MCP tools are already available in the current agent, use one of these tools:
+
+- `xhs_get_user_posted_notes_by_user_id`: preferred when `user_id` is already known.
+- `xhs_get_user_posted_notes_by_profile_url`: use for profile URLs, short links, or profile share text.
+- `douyin_get_user_posted_videos_by_sec_user_id`: preferred when `sec_user_id` is already known.
+- `douyin_get_user_posted_videos_by_profile_url`: use for profile URLs, short links, or profile share text.
+
+Creator content-list pagination uses `page_token`. Pass back exactly the returned `next_page_token`; tokens are bound to the current user and should not be reused across users.
+
+## Output Guidance
+
+Summarize content-list evidence by title or description, summary, publish time, interaction counts, media links, and content type when present. For Douyin image/text posts, use `image_urls` rather than assuming a video playback URL exists. Use returned content IDs to chain into detail or comment analysis when needed.

package/skills/media-user-posts/agents/openai.yaml

@@ -0,0 +1,7 @@
+interface:
+  display_name: "Media User Posts"
+  short_description: "Retrieve creator content"
+  default_prompt: "Use $media-user-posts to retrieve a creator's published content list from a platform user ID, profile URL, short link, or share text."
+
+policy:
+  allow_implicit_invocation: true