@gecho-ai/gecho-bridge 1.1.30 → 1.1.37

package/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "@gecho-ai/gecho-bridge",
-  "version": "1.1.30",
+  "version": "1.1.37",
   "description": "TikTok Search Tool for OpenClaw"
 }

package/README.md

@@ -87,6 +87,44 @@ openclaw gateway restart
 *If you need to upgrade an installed version, use `openclaw plugins update clawhub:@gecho-ai/gecho-bridge-bundle`.*
 *The plugin will automatically start a local Gecho service when needed. If the browser extension was opened after the client, run `openclaw gateway restart` once to reconnect cleanly.*
 
+### Publish to Tencent SkillHub
+
+Tencent SkillHub currently requires top-level `slug`, `version`, and `displayName` fields in `SKILL.md`. This repository provides a dedicated publisher: every run rebuilds copies under the Git-ignored `tmp/tencent-skillhub-publish/` directory and leaves source Skills unchanged.
+
+Each distribution Skill has a `publish.json` with platform-specific slug/display-name values for ClawHub, Tencent SkillHub, and ModelScope. Tencent's Chinese entries keep the slug of existing publications, while English entries use a separate slug so an update is not accidentally published as a new Skill. These config files are used only during staging and are not uploaded.
+
+```bash
+# Build publish copies for all English and Chinese Skills
+npm run skillhub:tencent:stage
+
+# Run the official CLI dry-run for one Skill
+npm run skillhub:tencent:dry-run -- --skill tiktok-insight
+
+# Publish one Skill through the public/community CLI
+skillhub login --key skh_...
+npm run skillhub:tencent:publish -- --community --skill tiktok-insight --locale zh-CN
+
+# Check platform metadata for every Skill
+npm run publish:config:check
+```
+
+For the public community, use a `skh_...` key and pass `--community` so a saved enterprise credential is not selected accidentally. The installed official CLI is currently `2026.8.5`: it has `skillhub publish` for the public community, but not the `skillhub skill publish` command shown in the website screenshot.
+
+An enterprise key (`sk-ent-...`) can log in to the enterprise source and search or install team Skills, but the current team upload endpoint requires a web login session. Team publication must therefore be completed in the [enterprise publishing console](https://skillhub.cn/enterprise/dashboard/publish); this repository can still generate and validate the upload copy.
+
+```bash
+# Public/community publication: log in with skh_... first
+skillhub login --key skh_...
+npm run skillhub:tencent:publish -- \
+  --community --skill tiktok-video-search --locale zh-CN --changelog 'Update Skill content'
+```
+
+An enterprise key can be reused from `~/.skillhub/credentials.json`, but `--community` deliberately ignores it. Chinese targets normally use `update-or-create`, while English targets commonly use an independent `create` slug; check each Skill's `publish.json`.
+
+A new team Skill also requires at least one team category ID. For an existing Skill, the publisher inherits category IDs from the remote Skill detail. For a new Skill, set `platforms.tencent-skillhub.categoryIds` in its `publish.json`, or pass `--category-ids 12,13` for a one-off publish. If they are missing, the script fetches the team's available categories and stops before uploading with the IDs to use.
+
+Official documentation: [CLI installation](https://skillhub.cn/install/skillhub.md), [community publishing](https://skillhub.cn/ai/release.md), [enterprise publishing](https://skillhub.cn/enterprise/dashboard/publish), and [enterprise API keys](https://skillhub.cn/enterprise/dashboard/keys).
+
 ### Option 2: One-Click Setup in Hermes (Hermes Skill Hub)
 You can quickly add the service to Hermes and restart it with the following commands:
 ```bash
@@ -135,13 +173,20 @@ After the environment is configured and your AI client has restarted, you can di
 
 ### 🧩 Skills
 
-Gecho provides both an aggregate TikTok Skill and focused single-tool Skills:
+Gecho provides four aggregate Skills:
+
+- **`amazon`**: Amazon search, product detail, and review collection.
+- **`tiktok-search`**: the aggregate TikTok research workflow, covering keyword video search, video detail, influencer lookup, insight jobs, and insight status checks.
+- **`tiktok-shop`**: TikTok Shop search and product detail.
+- **`x`**: X search and post detail.
+
+Focused single-tool Skills are also available:
 
-- **`tiktok-search`**: the default aggregate Skill for the complete TikTok search and insight workflow. It covers `tiktok_search`, `tiktok_insight`, and `check_insight_status`.
-- **`tiktok-video-search`**: a focused distribution Skill for keyword-based TikTok video search and metadata collection.
-- **`tiktok-insight`**: a focused distribution Skill for TikTok product, trend, competitor, and content insight jobs, plus insight status checks.
+- **Amazon**: `amazon-search`, `amazon-product`, `amazon-reviews`.
+- **TikTok**: `tiktok-video-search` for keyword-based video search; `tiktok-video` for a specific video’s detail, comments, and replies; `tiktok-influencer`, `tiktok-insight`, `tiktok-product`, and `tiktok-shop-search` for focused workflows.
+- **X**: `x-search` and `x-post-detail`.
 
-If you only need one focused capability, use the single-tool Skills. If you want the full research workflow, use `tiktok-search`.
+Use `tiktok-video-search` when you want to discover videos by keyword. Use `tiktok-video` when you already have a video URL and need its detail data. If you want the full TikTok research workflow, use `tiktok-search`.
 
 ### 🔍 Basic Search (`tiktok_search`)
 Suitable for quickly retrieving and collecting video data.

package/README.zh.md

@@ -87,6 +87,44 @@ openclaw gateway restart
 *如需升级已安装的版本，使用 `openclaw plugins update clawhub:@gecho-ai/gecho-bridge-bundle` 即可。*
 *插件会在需要时自动启动本地 Gecho Service。如果是先打开了客户端、后打开浏览器扩展，建议再执行一次 `openclaw gateway restart` 重新建立连接。*
 
+### 腾讯 SkillHub 发布
+
+腾讯 SkillHub 当前要求在 `SKILL.md` 顶层声明 `slug`、`version` 和 `displayName`。项目提供了独立发布脚本：每次执行都会在被 Git 忽略的 `tmp/tencent-skillhub-publish/` 中重新生成副本，不修改源 Skill。
+
+每个分发 Skill 都有自己的 `publish.json`，分别维护 ClawHub、腾讯 SkillHub 和魔塔社区的 slug/displayName。腾讯 SkillHub 的中文配置会沿用已有条目的 slug，英文配置使用独立 slug，避免把更新误发成新 Skill。`publish.json` 只参与发布准备，不会被上传到平台。
+
+```bash
+# 只生成发布副本，默认处理全部中英文 Skill
+npm run skillhub:tencent:stage
+
+# 使用官方 CLI 做单个 Skill 的本地 dry-run
+npm run skillhub:tencent:dry-run -- --skill tiktok-insight
+
+# 使用个人/社区 Key，通过官方 CLI 发布单个 Skill
+skillhub login --key skh_...
+npm run skillhub:tencent:publish -- --community --skill tiktok-insight --locale zh-CN
+
+# 检查所有 Skill 是否都有三个平台注册配置
+npm run publish:config:check
+```
+
+公共社区发布使用 `skh_...` Key，并建议加 `--community`，避免脚本误用本机保存的企业凭证。当前官方 CLI `2026.8.5` 没有截图中的 `skillhub skill publish` 命令，`skillhub publish` 仍是公共社区发布接口。
+
+企业 Key（`sk-ent-...`）目前可以登录企业源、搜索和安装团队 Skill，但不能直接调用团队上传接口。团队发布需要在[企业发布控制台](https://skillhub.cn/enterprise/dashboard/publish)完成；本脚本可以继续生成和检查上传副本。
+
+```bash
+# 公共社区发布：先登录 skh_...，再显式选择公共链路
+skillhub login --key skh_...
+npm run skillhub:tencent:publish -- \
+  --community --skill tiktok-video-search --locale zh-CN --changelog '更新 Skill 内容'
+```
+
+企业 Key 会从 `~/.skillhub/credentials.json` 复用，但不会用于 `--community` 公共发布。中文目标配置为 `update-or-create`，英文目标通常配置为独立 slug 的 `create`，具体以各 Skill 的 `publish.json` 为准。
+
+新建团队 Skill 还必须有至少一个团队分类 ID。已有 Skill 更新时脚本会从远端 Skill 详情继承分类；新建时可在对应 `publish.json` 的 `platforms.tencent-skillhub.categoryIds` 配置，或临时传 `--category-ids 12,13`。如果没有配置，脚本会先读取团队分类并在上传前给出可用 ID，不会提交一个必然失败的请求。
+
+官方文档：[CLI 安装](https://skillhub.cn/install/skillhub.md)、[公共发布](https://skillhub.cn/ai/release.md)、[企业发布控制台](https://skillhub.cn/enterprise/dashboard/publish)、[企业 API Key](https://skillhub.cn/enterprise/dashboard/keys)。
+
 ### 方式二：在 Hermes 中一键配置 (Hermes Skill Hub)
 你可以通过以下命令将服务快捷添加到 Hermes 并重启：
 ```bash
@@ -135,13 +173,20 @@ claude mcp add gecho-bridge -- npx -y @gecho-ai/gecho-bridge@latest
 
 ### 🧩 Skills 说明
 
-Gecho 同时提供 TikTok 聚合 Skill 和单工具分发 Skill：
+Gecho 提供四个聚合 Skill：
+
+- **`amazon`**：覆盖 Amazon 搜索、商品详情和评论采集。
+- **`tiktok-search`**：TikTok 聚合研究工作流，覆盖关键词视频搜索、视频详情、达人查询、洞察任务和洞察状态查询。
+- **`tiktok-shop`**：TikTok Shop 搜索和商品详情。
+- **`x`**：X 搜索和帖子详情。
+
+同时提供单功能 Skill：
 
-- **`tiktok-search`**：默认聚合 Skill，适合完整 TikTok 搜索 + 洞察工作流，覆盖 `tiktok_search`、`tiktok_insight` 和 `check_insight_status`。
-- **`tiktok-video-search`**：单工具分发 Skill，适合按关键词搜索 TikTok 视频并采集元数据。
-- **`tiktok-insight`**：单工具分发 Skill，适合 TikTok 产品、趋势、竞品和内容洞察任务，并支持查询洞察任务状态。
+- **Amazon**：`amazon-search`、`amazon-product`、`amazon-reviews`。
+- **TikTok**：`tiktok-video-search` 用于按关键词搜索视频；`tiktok-video` 用于指定视频的详情、评论和回复；另有 `tiktok-influencer`、`tiktok-insight`、`tiktok-product` 和 `tiktok-shop-search`。
+- **X**：`x-search` 和 `x-post-detail`。
 
-如果只需要某个单点能力，可以使用单工具 Skill；如果需要完整研究流程，建议使用 `tiktok-search`。
+需要按关键词发现视频时使用 `tiktok-video-search`；已有视频 URL、需要获取视频详情时使用 `tiktok-video`。需要完整 TikTok 研究工作流时，使用 `tiktok-search`。
 
 ### 🔍 基础搜索 (`tiktok_search`)
 适用于快速检索和收集视频数据。

package/dist/mcp-client.cjs

@@ -33854,7 +33854,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@gecho-ai/gecho-bridge",
-      version: "1.1.30",
+      version: "1.1.37",
       description: "TikTok Search and Insight tools for OpenClaw, connecting LLMs to TikTok via Chrome Extension.",
       main: "mcp-client.js",
       bin: {
@@ -33882,7 +33882,25 @@ var require_package = __commonJS({
         "bundle:stage": "bash ./scripts/publish-bundle-dist.sh stage",
         "bundle:publish": "bash ./scripts/publish-bundle-dist.sh publish",
         "bundle:stage:dist": "bash ./scripts/publish-bundle-dist.sh stage",
-        "bundle:publish:dist": "bash ./scripts/publish-bundle-dist.sh publish"
+        "bundle:publish:dist": "bash ./scripts/publish-bundle-dist.sh publish",
+        "skill:validate": "node ./scripts/validate-skills.js",
+        "skill:stage": "bash ./scripts/publish-clawhub-skills.sh stage",
+        "skill:dry-run": "bash ./scripts/publish-clawhub-skills.sh dry-run",
+        "skill:publish": "bash ./scripts/publish-clawhub-skills.sh publish",
+        "skill:legacy:stage": "bash ./scripts/publish-skills.sh stage",
+        "skill:legacy:dry-run": "bash ./scripts/publish-skills.sh dry-run",
+        "skill:legacy:publish": "bash ./scripts/publish-skills.sh publish",
+        "skillhub:tencent:stage": "bash ./scripts/publish-tencent-skillhub.sh stage",
+        "skillhub:tencent:dry-run": "bash ./scripts/publish-tencent-skillhub.sh dry-run",
+        "skillhub:tencent:publish": "bash ./scripts/publish-tencent-skillhub.sh publish",
+        "skillhub:modelscope:stage": "bash ./scripts/publish-modelscope-skills.sh stage",
+        "skillhub:modelscope:dry-run": "bash ./scripts/publish-modelscope-skills.sh dry-run",
+        "skillhub:modelscope:publish": "bash ./scripts/publish-modelscope-skills.sh publish",
+        "skillhub:modelscope:verify": "bash ./scripts/publish-modelscope-skills.sh verify",
+        "publish:config:generate": "node ./scripts/generate-publish-configs.js",
+        "publish:config:check": "node ./scripts/generate-publish-configs.js --check",
+        "test:skillhub:tencent": "node --test ./test/publish-config.test.js ./test/tencent-skillhub-publish.test.js",
+        "test:skillhub:modelscope": "node --test ./test/modelscope-publish.test.js"
       },
       keywords: [
         "mcp",
@@ -34228,11 +34246,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "amazon_search",
-        description: "\u5728 Amazon \u4E0A\u641C\u7D22\u5173\u952E\u8BCD\uFF0C\u81EA\u52A8\u91C7\u96C6\u591A\u9875\u5546\u54C1\u4FE1\u606F\uFF08\u652F\u6301\u81EA\u52A8\u7FFB\u9875\uFF09\u3002",
+        description: "\u5728 Amazon \u4E0A\u641C\u7D22\u5173\u952E\u8BCD\uFF0C\u81EA\u52A8\u91C7\u96C6\u591A\u9875\u5546\u54C1\u4FE1\u606F\uFF08\u652F\u6301\u81EA\u52A8\u7FFB\u9875\uFF09\u3002marketplace \u53EF\u9009\uFF0C\u672A\u4F20\u65F6\u9ED8\u8BA4 US\u3002",
         inputSchema: {
           type: "object",
           properties: {
             query: { type: "string", description: "\u641C\u7D22\u5173\u952E\u8BCD (\u4F8B\u5982: 'clothes')" },
+            marketplace: { type: "string", description: "\u53EF\u9009 Amazon \u7AD9\u70B9\u56FD\u5BB6\u7801\uFF0C\u4F8B\u5982 US\u3001IN\uFF1B\u672A\u4F20\u65F6\u9ED8\u8BA4 US", default: "US" },
             targetPages: { type: "number", description: "\u9884\u671F\u91C7\u96C6\u7684\u9875\u6570\uFF0C\u9ED8\u8BA4 5 (\u7EA6100\u6761)", default: 5 },
             save_dir: { type: "string", description: "\u53EF\u9009\u7684\u4FDD\u5B58\u76EE\u5F55\u7EDD\u5BF9\u8DEF\u5F84" }
           },
@@ -34241,11 +34260,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "amazon_product",
-        description: "\u83B7\u53D6 Amazon \u5546\u54C1\u8BE6\u60C5\u9875\u7684\u5B8C\u6574\u6570\u636E\uFF08\u6807\u9898\u3001\u4EF7\u683C\u3001\u63CF\u8FF0\u3001\u53D8\u4F53\u3001\u89C4\u683C\u7B49\uFF09\u3002",
+        description: "\u83B7\u53D6 Amazon \u5546\u54C1\u8BE6\u60C5\u9875\u7684\u5B8C\u6574\u6570\u636E\uFF08\u6807\u9898\u3001\u4EF7\u683C\u3001\u63CF\u8FF0\u3001\u53D8\u4F53\u3001\u89C4\u683C\u7B49\uFF09\u3002marketplace \u53EF\u9009\uFF0C\u88F8 ASIN \u672A\u4F20\u65F6\u9ED8\u8BA4 US\u3002",
         inputSchema: {
           type: "object",
           properties: {
             product_url: { type: "string", description: "\u5546\u54C1\u8BE6\u60C5\u9875 URL \u6216 ASIN (\u4F8B\u5982: 'B0CXJJHY8B' \u6216 'https://www.amazon.com/dp/...') " },
+            marketplace: { type: "string", description: "\u53EF\u9009 Amazon \u7AD9\u70B9\u56FD\u5BB6\u7801\uFF0C\u4F8B\u5982 US\u3001IN\uFF1B\u4EC5\u4F20 ASIN \u65F6\u7528\u4E8E\u786E\u5B9A\u7AD9\u70B9\uFF0C\u672A\u4F20\u65F6\u9ED8\u8BA4 US", default: "US" },
             save_dir: { type: "string", description: "\u53EF\u9009\u7684\u4FDD\u5B58\u76EE\u5F55\u7EDD\u5BF9\u8DEF\u5F84" }
           },
           required: ["product_url"]
@@ -34253,11 +34273,12 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "amazon_reviews",
-        description: "\u5728 Amazon \u4E13\u7528\u8BC4\u8BBA\u9875\u91C7\u96C6\u8BC4\u8BBA\uFF0C\u652F\u6301\u591A\u9875\u81EA\u52A8\u7FFB\u9875\u3002",
+        description: "\u5728 Amazon \u4E13\u7528\u8BC4\u8BBA\u9875\u91C7\u96C6\u8BC4\u8BBA\uFF0C\u652F\u6301\u591A\u9875\u81EA\u52A8\u7FFB\u9875\u3002marketplace \u53EF\u9009\uFF0C\u88F8 ASIN \u672A\u4F20\u65F6\u9ED8\u8BA4 US\u3002",
         inputSchema: {
           type: "object",
           properties: {
             product_url: { type: "string", description: "\u5546\u54C1\u8BE6\u60C5\u9875 URL \u6216 ASIN (\u4F8B\u5982: 'B0CXJJHY8B' \u6216 'https://www.amazon.com/product-reviews/...') " },
+            marketplace: { type: "string", description: "\u53EF\u9009 Amazon \u7AD9\u70B9\u56FD\u5BB6\u7801\uFF0C\u4F8B\u5982 US\u3001IN\uFF1B\u4EC5\u4F20 ASIN \u65F6\u7528\u4E8E\u786E\u5B9A\u7AD9\u70B9\uFF0C\u672A\u4F20\u65F6\u9ED8\u8BA4 US", default: "US" },
             targetCount: { type: "number", description: "\u9884\u671F\u91C7\u96C6\u7684\u8BC4\u8BBA\u6570\u91CF\uFF0C\u9ED8\u8BA4 100", default: 100 },
             save_dir: { type: "string", description: "\u53EF\u9009\u7684\u4FDD\u5B58\u76EE\u5F55\u7EDD\u5BF9\u8DEF\u5F84" }
           },

package/dist/server.cjs

@@ -3640,7 +3640,7 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@gecho-ai/gecho-bridge",
-      version: "1.1.30",
+      version: "1.1.37",
       description: "TikTok Search and Insight tools for OpenClaw, connecting LLMs to TikTok via Chrome Extension.",
       main: "mcp-client.js",
       bin: {
@@ -3668,7 +3668,25 @@ var require_package = __commonJS({
         "bundle:stage": "bash ./scripts/publish-bundle-dist.sh stage",
         "bundle:publish": "bash ./scripts/publish-bundle-dist.sh publish",
         "bundle:stage:dist": "bash ./scripts/publish-bundle-dist.sh stage",
-        "bundle:publish:dist": "bash ./scripts/publish-bundle-dist.sh publish"
+        "bundle:publish:dist": "bash ./scripts/publish-bundle-dist.sh publish",
+        "skill:validate": "node ./scripts/validate-skills.js",
+        "skill:stage": "bash ./scripts/publish-clawhub-skills.sh stage",
+        "skill:dry-run": "bash ./scripts/publish-clawhub-skills.sh dry-run",
+        "skill:publish": "bash ./scripts/publish-clawhub-skills.sh publish",
+        "skill:legacy:stage": "bash ./scripts/publish-skills.sh stage",
+        "skill:legacy:dry-run": "bash ./scripts/publish-skills.sh dry-run",
+        "skill:legacy:publish": "bash ./scripts/publish-skills.sh publish",
+        "skillhub:tencent:stage": "bash ./scripts/publish-tencent-skillhub.sh stage",
+        "skillhub:tencent:dry-run": "bash ./scripts/publish-tencent-skillhub.sh dry-run",
+        "skillhub:tencent:publish": "bash ./scripts/publish-tencent-skillhub.sh publish",
+        "skillhub:modelscope:stage": "bash ./scripts/publish-modelscope-skills.sh stage",
+        "skillhub:modelscope:dry-run": "bash ./scripts/publish-modelscope-skills.sh dry-run",
+        "skillhub:modelscope:publish": "bash ./scripts/publish-modelscope-skills.sh publish",
+        "skillhub:modelscope:verify": "bash ./scripts/publish-modelscope-skills.sh verify",
+        "publish:config:generate": "node ./scripts/generate-publish-configs.js",
+        "publish:config:check": "node ./scripts/generate-publish-configs.js --check",
+        "test:skillhub:tencent": "node --test ./test/publish-config.test.js ./test/tencent-skillhub-publish.test.js",
+        "test:skillhub:modelscope": "node --test ./test/modelscope-publish.test.js"
       },
       keywords: [
         "mcp",