opencli-plugin-socialdatax 0.1.0 → 0.1.1

package/README.md

@@ -16,6 +16,8 @@ Use this OpenCLI plugin when you want API Key based data access without relying
 opencli plugin install /Users/devin/work/cx/code/social-service/public-listings/socialdatax-opencli
 ```
 
+OpenCLI plugin install currently accepts file, GitHub, and git sources. It does not install plugins directly from an npm package name, so use an absolute local path for this private-repo smoke test or a GitHub/git source after the plugin is mirrored to a public repository.
+
 Set your API Key before data calls:
 
 ```bash
@@ -60,3 +62,26 @@ Users and agents may search for this plugin with:
 - `social media data`
 - `creator analytics`
 - `comment analysis`
+
+## Maintainer Notes
+
+Published package: `opencli-plugin-socialdatax`.
+
+Current npm release: `0.1.0`, published on `2026-05-19 11:17:29` Asia/Shanghai.
+
+Local source version: `0.1.1`, prepared after smoke testing so the plugin ships a precompiled `socialdatax.js` entrypoint for OpenCLI environments without `esbuild`.
+
+Release from the repository root:
+
+```bash
+node scripts/publish_socialdatax_opencli.mjs --dry-run
+node scripts/publish_socialdatax_opencli.mjs
+```
+
+Verify after publishing:
+
+```bash
+npm view opencli-plugin-socialdatax version time dist-tags.latest homepage engines --json
+opencli plugin install /Users/devin/work/cx/code/social-service/public-listings/socialdatax-opencli
+opencli list | rg 'socialdatax|小红书|抖音|xiaohongshu|douyin'
+```

package/opencli-plugin.json

@@ -2,7 +2,7 @@
   "name": "socialdatax",
   "displayName": "SocialDataX / 社媒数据助手",
   "description": "SocialDataX / 社媒数据助手 provides hosted read-only social data tools for 小红书 / Xiaohongshu / XHS / RedNote and 抖音 / Douyin: search content, read details, analyze comments, creator profiles, and creator posts.",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "opencli": ">=1.0.0",
   "homepage": "https://socialdatax.com",
   "keywords": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencli-plugin-socialdatax",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "SocialDataX / 社媒数据助手 OpenCLI plugin for 小红书, Xiaohongshu, XHS, RedNote, 抖音, and Douyin read-only social data workflows.",
   "license": "MIT",
   "type": "module",
@@ -8,6 +8,7 @@
     "README.md",
     "LICENSE",
     "opencli-plugin.json",
+    "socialdatax.js",
     "socialdatax.ts",
     "lib/**",
     "skills/**"

package/socialdatax.js

@@ -0,0 +1,145 @@
+import { cli, Strategy } from "@jackwener/opencli/registry";
+import { runSocialDataXCommand } from "./lib/socialdatax-core.mjs";
+
+const COMMON_COLUMNS = [
+  "note_id",
+  "note_url",
+  "aweme_id",
+  "sec_user_id",
+  "comment_id",
+  "title",
+  "desc",
+  "content",
+  "nickname",
+  "author_nickname",
+  "profile_nickname",
+  "like_count",
+  "comment_count",
+  "top_level_comment_count",
+  "next_page",
+  "next_page_token",
+];
+
+const pageTokenOption = {
+  name: "page-token",
+  type: "string",
+  help: "Opaque pagination token returned by the previous page.",
+};
+
+function localCommand(name, description, options = {}) {
+  return cli({
+    site: "socialdatax",
+    name,
+    description,
+    access: "read",
+    example: `opencli socialdatax ${name} -f json`,
+    strategy: Strategy.LOCAL,
+    browser: false,
+    args: options,
+    columns: COMMON_COLUMNS,
+    async func(argv) {
+      return runSocialDataXCommand(name, argv);
+    },
+  });
+}
+
+localCommand(
+  "xhs-search",
+  "Search 小红书 / Xiaohongshu / XHS / RedNote notes with SocialDataX / 社媒数据助手.",
+  [
+    { name: "keyword", type: "string", required: true, help: "Search keyword." },
+    { name: "page", type: "int", help: "1-based page number." },
+    { name: "sort-type", type: "string", help: "general, time_descending, like_count_descending, comment_count_descending, or collect_count_descending." },
+    { name: "note-type", type: "string", help: "all, image, or video." },
+    { name: "publish-time-range", type: "string", help: "all, day, week, or half_year." },
+  ]
+);
+localCommand(
+  "xhs-detail",
+  "Read one 小红书 / Xiaohongshu / XHS / RedNote note detail.",
+  [
+    { name: "note-id", type: "string", help: "Known XHS note ID." },
+    { name: "url", type: "string", help: "XHS note URL, short link, share text, or note ID." },
+  ]
+);
+localCommand(
+  "xhs-comments",
+  "Fetch 小红书 / Xiaohongshu / XHS / RedNote first-level comments.",
+  [
+    { name: "note-id", type: "string", help: "Known XHS note ID." },
+    { name: "url", type: "string", help: "XHS note URL, short link, or share text." },
+    pageTokenOption,
+  ]
+);
+localCommand(
+  "xhs-sub-comments",
+  "Fetch 小红书 / Xiaohongshu / XHS / RedNote replies under one comment.",
+  [
+    { name: "note-id", type: "string", required: true, help: "Known XHS note ID." },
+    { name: "comment-id", type: "string", required: true, help: "First-level comment ID." },
+    pageTokenOption,
+  ]
+);
+localCommand(
+  "xhs-user-info",
+  "Read 小红书 / Xiaohongshu / XHS / RedNote creator profile data.",
+  [
+    { name: "user-id", type: "string", help: "Known XHS user ID." },
+    { name: "profile-url", type: "string", help: "XHS profile URL, short link, or share text." },
+  ]
+);
+localCommand(
+  "xhs-user-posts",
+  "Fetch 小红书 / Xiaohongshu / XHS / RedNote creator notes.",
+  [
+    { name: "user-id", type: "string", help: "Known XHS user ID." },
+    { name: "profile-url", type: "string", help: "XHS profile URL, short link, or share text." },
+    pageTokenOption,
+  ]
+);
+localCommand(
+  "douyin-search",
+  "Search 抖音 / Douyin works with SocialDataX / 社媒数据助手.",
+  [
+    { name: "keyword", type: "string", required: true, help: "Search keyword." },
+    pageTokenOption,
+    { name: "sort-type", type: "string", help: "general, time_descending, or like_count_descending." },
+    { name: "publish-time-range", type: "string", help: "all, day, week, or half_year." },
+    { name: "duration-range", type: "string", help: "all, under_1_minute, one_to_five_minutes, or over_5_minutes." },
+    { name: "content-type", type: "string", help: "all, video, or image." },
+  ]
+);
+localCommand(
+  "douyin-detail",
+  "Read one 抖音 / Douyin work detail.",
+  [
+    { name: "aweme-id", type: "string", help: "Known Douyin aweme_id." },
+    { name: "url", type: "string", help: "Douyin content URL, short link, or share text." },
+  ]
+);
+localCommand(
+  "douyin-comments",
+  "Fetch 抖音 / Douyin first-level comments.",
+  [
+    { name: "aweme-id", type: "string", help: "Known Douyin aweme_id." },
+    { name: "url", type: "string", help: "Douyin content URL, short link, or share text." },
+    pageTokenOption,
+  ]
+);
+localCommand(
+  "douyin-user-info",
+  "Read 抖音 / Douyin creator profile data.",
+  [
+    { name: "sec-user-id", type: "string", help: "Known Douyin sec_user_id." },
+    { name: "profile-url", type: "string", help: "Douyin profile URL, short link, or share text." },
+  ]
+);
+localCommand(
+  "douyin-user-posts",
+  "Fetch 抖音 / Douyin creator works.",
+  [
+    { name: "sec-user-id", type: "string", help: "Known Douyin sec_user_id." },
+    { name: "profile-url", type: "string", help: "Douyin profile URL, short link, or share text." },
+    pageTokenOption,
+  ]
+);