@gecho-ai/gecho-bridge 1.1.37 → 1.1.38-beta.0

package/.claude-plugin/plugin.json

@@ -1,5 +1,5 @@
 {
   "name": "@gecho-ai/gecho-bridge",
-  "version": "1.1.37",
-  "description": "TikTok Search Tool for OpenClaw"
+  "version": "1.1.38-beta.0",
+  "description": "Browser research tools for OpenClaw via the Gecho Chrome Extension"
 }

package/README.md

@@ -1,16 +1,16 @@
 # Gecho Bridge 🚀
 
-**Gecho Bridge connects AI clients such as OpenClaw, Hermes, Trae, and Claude Code to a live Chrome browser through MCP and the Gecho Chrome extension.** Use it to search TikTok videos, collect structured metadata, save JSON results, and run async product, trend, competitor, and content insight workflows.
+**Gecho Bridge connects AI clients such as OpenClaw, Hermes, Trae, and Claude Code to a live Chrome browser through MCP and the Gecho Chrome extension.** Use it to search TikTok videos, YouTube Shorts, Facebook Reels, X posts, and Amazon products, collect structured metadata, save JSON results, and run async product, trend, competitor, and content insight workflows.
 
 ## ⚠️ Critical Prerequisite: Read Before Use
 
-Gecho Bridge cannot work from the README, Skill page, or MCP config alone. Before the first TikTok search or insight job, all 3 items below are required:
+Gecho Bridge cannot work from the README, Skill page, or MCP config alone. Before the first platform search or insight job, all 3 items below are required:
 
 1. **Configure Gecho Bridge MCP** in your AI client.
 2. **Install the Gecho Chrome extension** and log in to your Gecho account.
-3. **Log in to TikTok web in Chrome** and keep the logged-in TikTok tab open.
+3. **Log in to the target platform in Chrome** and keep the logged-in platform tab open.
 
-If any of these are missing, TikTok search and insight tools may fail even if the Skill or plugin is installed.
+If any of these are missing, the selected platform tool may fail even if the Skill or plugin is installed.
 
 ## 🚀 3-Step Quick Start
 
@@ -125,6 +125,49 @@ A new team Skill also requires at least one team category ID. For an existing Sk
 
 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).
 
+### WorkBuddy Skill Packaging
+
+WorkBuddy uses a separate Skill package format, so a Tencent SkillHub staging copy must not be uploaded directly.
+The repository creates Git-ignored copies under `tmp/workbuddy-publish/`, adds
+`display_name`, `display_name_en`, `description_zh`, `description_en`, `version`, and `author`, and packages
+each Skill using WorkBuddy's official `skills/<skill-name>/SKILL.md` layout.
+
+```bash
+# Create WorkBuddy-only staging copies
+npm run skillhub:workbuddy:stage
+
+# Build all English and Chinese ZIPs and validate their structure
+npm run skillhub:workbuddy:dry-run
+
+# Prepare one Chinese Skill
+npm run skillhub:workbuddy:dry-run -- \
+  --skill tiktok-video-search --locale zh-CN
+```
+
+ZIP files are written to `tmp/workbuddy-publish/archives/` (each must be no larger than 3MB) for manual upload to the
+[WorkBuddy Open Platform](https://open.workbuddy.cn/). The script has no login or submit command and never uses
+Tencent SkillHub `skh_...` or `sk-ent-...` credentials. See the official [WorkBuddy Skill documentation](https://open.workbuddy.cn/docs/skill).
+
+### WorkBuddy Open Platform Connector
+
+WorkBuddy's open platform Connector publication is separate from Skill publication. The Connector ZIP contains the
+platform metadata and the MCP startup configuration; it is not one of the Skill ZIPs above.
+
+```bash
+# Build and validate the Connector ZIP for the current package version
+npm run skillhub:workbuddy:connector:dry-run
+```
+
+The uploadable file is generated at:
+
+```text
+tmp/workbuddy-connector/gecho-bridge-workbuddy-v1.1.37.zip
+```
+
+It uses the public `@gecho-ai/gecho-bridge@1.1.37` npm package as a local Stdio MCP server. The generated ZIP contains
+`connector-meta.json`, `mcp.json`, `icon.svg`, and a concise Connector Skill. It is only staged locally; this command
+does not upload or submit a review request. See the official [WorkBuddy Connector documentation](https://open.workbuddy.cn/docs/connector).
+
 ### 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
@@ -167,7 +210,7 @@ After the environment is configured and your AI client has restarted, you can di
 ### ✅ Self-Check Before First Use
 1. `gecho-bridge` MCP is configured, or the `@gecho-ai/gecho-bridge-bundle` plugin is installed.
 2. The [Gecho browser extension](https://chromewebstore.google.com/detail/pjkaeenpekolahdbccjfenjcmanemlbj?utm_source=item-share-cb) is installed.
-3. TikTok is open in Chrome and the account is logged in.
+3. The target platform is open in Chrome and the account is logged in (TikTok, YouTube, Facebook, X, or Amazon as applicable).
 4. The Gecho extension is logged in to a Gecho account and online.
 5. The TikTok page is not stuck or left on a CAPTCHA page.
 
@@ -185,8 +228,9 @@ Focused single-tool Skills are also available:
 - **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`.
+- **Short-form video**: `youtube-shorts-search` for YouTube Shorts and `facebook-reels-search` for Facebook Reels.
 
-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`.
+Use `tiktok-video-search`, `youtube-shorts-search`, or `facebook-reels-search` when you want to discover short-form 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

@@ -1,16 +1,16 @@
 # Gecho Bridge 🚀
 
-**Gecho Bridge 通过 MCP 和 Gecho Chrome 扩展，把 OpenClaw、Hermes、Trae、Claude Code 等 AI 客户端连接到真实 Chrome 浏览器。** 你可以用它搜索 TikTok 视频、采集结构化元数据、保存 JSON 结果，并运行异步的产品、趋势、竞品和内容洞察工作流。
+**Gecho Bridge 通过 MCP 和 Gecho Chrome 扩展，把 OpenClaw、Hermes、Trae、Claude Code 等 AI 客户端连接到真实 Chrome 浏览器。** 你可以用它搜索 TikTok 视频、YouTube Shorts、Facebook Reels、X 帖子和 Amazon 商品，采集结构化元数据、保存 JSON 结果，并运行异步的产品、趋势、竞品和内容洞察工作流。
 
 ## ⚠️ 重要前置：使用前必看
 
-Gecho Bridge 不能只靠 README、Skill 页面或 MCP 配置单独运行。首次搜索 TikTok 或运行洞察任务前，必须同时满足下面 3 个条件：
+Gecho Bridge 不能只靠 README、Skill 页面或 MCP 配置单独运行。首次搜索平台内容或运行洞察任务前，必须同时满足下面 3 个条件：
 
 1. **在 AI 客户端中配置 Gecho Bridge MCP**。
 2. **安装 Gecho Chrome 扩展**，并在扩展中登录 Gecho 账号。
-3. **在 Chrome 中登录 TikTok 网页版**，并保持已登录的 TikTok 标签页打开。
+3. **在 Chrome 中登录目标平台**，并保持已登录的平台标签页打开。
 
-如果任一条件缺失，即使 Skill 或 Plugin 已安装，TikTok 搜索和洞察功能也可能无法正常运行。
+如果任一条件缺失，即使 Skill 或 Plugin 已安装，所选平台的搜索功能也可能无法正常运行。
 
 ## 🚀 3 步快速上手
 
@@ -125,6 +125,54 @@ npm run skillhub:tencent:publish -- \
 
 官方文档：[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)。
 
+### WorkBuddy Skill 发布准备
+
+WorkBuddy 使用独立的 Skill 包格式，不能直接上传腾讯 SkillHub 副本。项目会从源 Skill 创建被 Git 忽略的
+`tmp/workbuddy-publish/` 副本，补齐 `display_name`、`display_name_en`、`description_zh`、
+`description_en`、`version` 和 `author`，并按 WorkBuddy 官方要求使用
+`skills/<skill-name>/SKILL.md` 目录结构打包。
+
+```bash
+# 只生成 WorkBuddy 临时副本
+npm run skillhub:workbuddy:stage
+
+# 生成全部中英文 ZIP，并进行本地结构校验
+npm run skillhub:workbuddy:dry-run
+
+# 只准备一个中文 Skill
+npm run skillhub:workbuddy:dry-run -- \
+  --skill tiktok-video-search --locale zh-CN
+```
+
+输出的 ZIP 位于 `tmp/workbuddy-publish/archives/`（单个不超过 3MB），可在 [WorkBuddy 开放平台](https://open.workbuddy.cn/)
+手动上传。脚本没有登录或自动提交功能，不会使用腾讯 SkillHub 的 `skh_...` 或 `sk-ent-...` Key。
+WorkBuddy 官方格式参考：[Skill 文档](https://open.workbuddy.cn/docs/skill)。
+
+### Aily SkillHub 发布
+
+Aily 当前通过网页上传 Skill 压缩包。项目提供了浏览器自动化脚本，复用已登录的 Edge，
+从 `tmp/manual-skill-packages/manifest.tsv` 读取压缩包，并使用每个 Skill 的
+`publish.json` 中 `platforms.aily-skillhub.displayName` 自动填写展示名称。
+
+首次使用需要完全退出 Edge 后，以远程调试端口启动，再在该窗口登录 Aily：
+
+```bash
+/Applications/Microsoft\ Edge.app/Contents/MacOS/Microsoft\ Edge \
+  --remote-debugging-port=9222
+```
+
+然后执行：
+
+```bash
+npm run skill:package:manual
+npm run skillhub:aily:dry-run -- --skill tiktok-shop-search --locale zh-CN
+npm run skillhub:aily:publish -- --skill tiktok-shop-search --locale zh-CN
+```
+
+脚本只修改网页表单，不修改源 Skill，也不保存浏览器凭证；发布结果写入
+`tmp/aily-browser-publish/results.json`。完整参数和批量发布方式见
+[`scripts/README.md`](scripts/README.md)。
+
 ### 方式二：在 Hermes 中一键配置 (Hermes Skill Hub)
 你可以通过以下命令将服务快捷添加到 Hermes 并重启：
 ```bash
@@ -167,7 +215,7 @@ claude mcp add gecho-bridge -- npx -y @gecho-ai/gecho-bridge@latest
 ### ✅ 首次使用前自检
 1. 已配置 `gecho-bridge` MCP，或已安装 `@gecho-ai/gecho-bridge-bundle` Plugin。
 2. 已安装 [Gecho 浏览器扩展](https://chromewebstore.google.com/detail/pjkaeenpekolahdbccjfenjcmanemlbj?utm_source=item-share-cb)。
-3. Chrome 中已打开 TikTok 并登录账号。
+3. Chrome 中已打开目标平台并登录账号（按任务选择 TikTok、YouTube、Facebook、X 或 Amazon）。
 4. Gecho 扩展已登录 Gecho 账号并处于在线状态。
 5. TikTok 页面未卡住或未停在验证码页面。
 
@@ -185,8 +233,9 @@ Gecho 提供四个聚合 Skill：
 - **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`。
+- **短视频**：`youtube-shorts-search` 用于 YouTube Shorts，`facebook-reels-search` 用于 Facebook Reels。
 
-需要按关键词发现视频时使用 `tiktok-video-search`；已有视频 URL、需要获取视频详情时使用 `tiktok-video`。需要完整 TikTok 研究工作流时，使用 `tiktok-search`。
+需要按关键词发现短视频时使用 `tiktok-video-search`、`youtube-shorts-search` 或 `facebook-reels-search`；已有视频 URL、需要获取视频详情时使用 `tiktok-video`。需要完整 TikTok 研究工作流时，使用 `tiktok-search`。
 
 ### 🔍 基础搜索 (`tiktok_search`)
 适用于快速检索和收集视频数据。

package/action-result.js

@@ -0,0 +1,53 @@
+const ACTION_RESULT_METADATA_FIELDS = ["meta", "errorCode", "errorMessage"];
+
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+
+function hasOwn(value, key) {
+  return Object.prototype.hasOwnProperty.call(value, key);
+}
+
+function getActionResultMetadata(result) {
+  const metadata = {};
+  if (!isRecord(result)) return metadata;
+
+  for (const field of ACTION_RESULT_METADATA_FIELDS) {
+    if (hasOwn(result, field)) metadata[field] = result[field];
+  }
+  return metadata;
+}
+
+function createActionResultEnvelope(message) {
+  const source = isRecord(message) ? message : {};
+  return {
+    data: source.data,
+    ...getActionResultMetadata(source)
+  };
+}
+
+function normalizeActionResult(result) {
+  if (!isRecord(result) || !hasOwn(result, "data")) return { data: result };
+  return {
+    data: result.data,
+    ...getActionResultMetadata(result)
+  };
+}
+
+function isHardActionResultFailure(result) {
+  if (!isRecord(result)) return false;
+
+  const hasFailure = ["errorCode", "errorMessage"].some((field) => {
+    return hasOwn(result, field) && result[field] !== undefined && result[field] !== null && result[field] !== "";
+  });
+  if (!hasFailure) return false;
+
+  return String(result.meta?.status || "").toLowerCase() !== "partial";
+}
+
+module.exports = {
+  createActionResultEnvelope,
+  getActionResultMetadata,
+  isHardActionResultFailure,
+  normalizeActionResult
+};

package/dist/mcp-client.cjs

@@ -33854,8 +33854,8 @@ var require_package = __commonJS({
   "package.json"(exports2, module2) {
     module2.exports = {
       name: "@gecho-ai/gecho-bridge",
-      version: "1.1.37",
-      description: "TikTok Search and Insight tools for OpenClaw, connecting LLMs to TikTok via Chrome Extension.",
+      version: "1.1.38-beta.0",
+      description: "Browser research tools for OpenClaw, connecting LLMs to TikTok, YouTube Shorts, Facebook Reels, X, and Amazon via the Gecho Chrome Extension.",
       main: "mcp-client.js",
       bin: {
         "gecho-bridge": "mcp-client.js"
@@ -33869,6 +33869,7 @@ var require_package = __commonJS({
         "openclaw.plugin.json",
         "skills",
         "distribution-skills",
+        "distribution-skills-zh-CN",
         "README.md",
         "README.zh.md",
         "qywx.jpg"
@@ -33884,15 +33885,25 @@ var require_package = __commonJS({
         "bundle:stage:dist": "bash ./scripts/publish-bundle-dist.sh stage",
         "bundle:publish:dist": "bash ./scripts/publish-bundle-dist.sh publish",
         "skill:validate": "node ./scripts/validate-skills.js",
+        "skill:package:manual": "bash ./scripts/package-manual-skills.sh",
         "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",
+        "skill:skills-sh:dry-run": "bash ./scripts/publish-skills-sh.sh dry-run",
+        "skill:skills-sh:publish": "bash ./scripts/publish-skills-sh.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:aily:dry-run": "bash ./scripts/publish-aily-browser.sh dry-run",
+        "skillhub:aily:publish": "bash ./scripts/publish-aily-browser.sh publish",
+        "skillhub:workbuddy:stage": "node ./scripts/publish-workbuddy-skills.js stage",
+        "skillhub:workbuddy:package": "node ./scripts/publish-workbuddy-skills.js package",
+        "skillhub:workbuddy:dry-run": "node ./scripts/publish-workbuddy-skills.js dry-run",
+        "skillhub:workbuddy:connector": "node ./scripts/package-workbuddy-connector.js",
+        "skillhub:workbuddy:connector:dry-run": "node ./scripts/package-workbuddy-connector.js dry-run",
         "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",
@@ -33900,6 +33911,7 @@ var require_package = __commonJS({
         "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:workbuddy": "node --test ./test/publish-config.test.js ./test/workbuddy-publish.test.js",
         "test:skillhub:modelscope": "node --test ./test/modelscope-publish.test.js"
       },
       keywords: [
@@ -33915,10 +33927,11 @@ var require_package = __commonJS({
       type: "commonjs",
       dependencies: {
         "@modelcontextprotocol/sdk": "^1.27.1",
-        ws: "^8.19.0"
+        ws: "^8.21.3"
       },
       devDependencies: {
-        esbuild: "^0.25.4"
+        esbuild: "^0.25.4",
+        "playwright-core": "^1.62.1"
       },
       publishConfig: {
         access: "public"
@@ -33947,6 +33960,55 @@ var require_data_dir = __commonJS({
   }
 });
 
+// action-result.js
+var require_action_result = __commonJS({
+  "action-result.js"(exports2, module2) {
+    var ACTION_RESULT_METADATA_FIELDS = ["meta", "errorCode", "errorMessage"];
+    function isRecord(value) {
+      return value !== null && typeof value === "object" && !Array.isArray(value);
+    }
+    function hasOwn(value, key) {
+      return Object.prototype.hasOwnProperty.call(value, key);
+    }
+    function getActionResultMetadata(result) {
+      const metadata = {};
+      if (!isRecord(result)) return metadata;
+      for (const field of ACTION_RESULT_METADATA_FIELDS) {
+        if (hasOwn(result, field)) metadata[field] = result[field];
+      }
+      return metadata;
+    }
+    function createActionResultEnvelope(message) {
+      const source = isRecord(message) ? message : {};
+      return {
+        data: source.data,
+        ...getActionResultMetadata(source)
+      };
+    }
+    function normalizeActionResult2(result) {
+      if (!isRecord(result) || !hasOwn(result, "data")) return { data: result };
+      return {
+        data: result.data,
+        ...getActionResultMetadata(result)
+      };
+    }
+    function isHardActionResultFailure2(result) {
+      if (!isRecord(result)) return false;
+      const hasFailure = ["errorCode", "errorMessage"].some((field) => {
+        return hasOwn(result, field) && result[field] !== void 0 && result[field] !== null && result[field] !== "";
+      });
+      if (!hasFailure) return false;
+      return String(result.meta?.status || "").toLowerCase() !== "partial";
+    }
+    module2.exports = {
+      createActionResultEnvelope,
+      getActionResultMetadata,
+      isHardActionResultFailure: isHardActionResultFailure2,
+      normalizeActionResult: normalizeActionResult2
+    };
+  }
+});
+
 // mcp-client.js
 var fs = require("fs");
 var { Server } = require_server2();
@@ -33961,6 +34023,7 @@ var { spawn } = require(cpModule);
 var path = require("path");
 var packageJson = require_package();
 var { getDefaultDataDir } = require_data_dir();
+var { isHardActionResultFailure, normalizeActionResult } = require_action_result();
 var SERVICE_BASE_URL = "http://127.0.0.1:18793";
 var HTTP_SERVICE_URL = `${SERVICE_BASE_URL}/search`;
 var PING_URL = `${SERVICE_BASE_URL}/ping`;
@@ -33979,6 +34042,8 @@ var SUPPORTED_TOOL_NAMES = /* @__PURE__ */ new Set([
   "tiktok_video",
   "x_search",
   "x_post_detail",
+  "youtube_shorts_search",
+  "facebook_reels_search",
   "amazon_search",
   "amazon_product",
   "amazon_reviews"
@@ -34244,6 +34309,32 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: ["url"]
         }
       },
+      {
+        name: "youtube_shorts_search",
+        description: "\u5728 YouTube Shorts \u4E0A\u641C\u7D22\u5173\u952E\u8BCD\uFF0C\u91C7\u96C6\u5019\u9009\u89C6\u9891\u5E76\u6309\u70B9\u8D5E\u6570\u8FD4\u56DE\u524D 20 \u6761\uFF0C\u540C\u65F6\u8865\u5145\u89C6\u9891\u8BE6\u60C5\u548C\u8BC4\u8BBA\u3002\u9700\u8981\u5728\u6D4F\u89C8\u5668\u4E2D\u767B\u5F55 YouTube\u3002",
+        inputSchema: {
+          type: "object",
+          properties: {
+            query: { type: "string", description: "\u641C\u7D22\u5173\u952E\u8BCD (\u4F8B\u5982: 'portable blender')" },
+            targetCount: { type: "number", description: "\u5019\u9009\u91C7\u96C6\u6570\u91CF\uFF0C\u9ED8\u8BA4 200\uFF0C\u8303\u56F4 20-200", default: 200, minimum: 20, maximum: 200 },
+            save_dir: { type: "string", description: "\u53EF\u9009\u7684\u4FDD\u5B58\u76EE\u5F55\u7EDD\u5BF9\u8DEF\u5F84" }
+          },
+          required: ["query"]
+        }
+      },
+      {
+        name: "facebook_reels_search",
+        description: "\u5728 Facebook Reels \u4E0A\u641C\u7D22\u5173\u952E\u8BCD\uFF0C\u91C7\u96C6\u5019\u9009\u89C6\u9891\u5E76\u6309\u70B9\u8D5E\u6570\u8FD4\u56DE\u524D 20 \u6761\uFF0C\u540C\u65F6\u8865\u5145\u89C6\u9891\u8BE6\u60C5\u548C\u8BC4\u8BBA\u3002\u9700\u8981\u5728\u6D4F\u89C8\u5668\u4E2D\u767B\u5F55 Facebook\u3002",
+        inputSchema: {
+          type: "object",
+          properties: {
+            query: { type: "string", description: "\u641C\u7D22\u5173\u952E\u8BCD (\u4F8B\u5982: 'portable blender')" },
+            targetCount: { type: "number", description: "\u5019\u9009\u91C7\u96C6\u6570\u91CF\uFF0C\u9ED8\u8BA4 200\uFF0C\u8303\u56F4 20-200", default: 200, minimum: 20, maximum: 200 },
+            save_dir: { type: "string", description: "\u53EF\u9009\u7684\u4FDD\u5B58\u76EE\u5F55\u7EDD\u5BF9\u8DEF\u5F84" }
+          },
+          required: ["query"]
+        }
+      },
       {
         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\u3002marketplace \u53EF\u9009\uFF0C\u672A\u4F20\u65F6\u9ED8\u8BA4 US\u3002",
@@ -34362,15 +34453,27 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       if (statusResponse.status === "error") {
         const stage = statusResponse.stage ? ` (stage=${statusResponse.stage})` : "";
         const retries = typeof statusResponse.retryCount === "number" ? `, retries=${statusResponse.retryCount}` : "";
+        const errorCode = statusResponse.errorCode ? ` [${statusResponse.errorCode}]` : "";
         return {
           content: [{
             type: "text",
-            text: `\u274C \u4EFB\u52A1 [${jobId}] \u6267\u884C\u5931\u8D25${stage}${retries}: ${statusResponse.error}`
+            text: `\u274C \u4EFB\u52A1 [${jobId}] \u6267\u884C\u5931\u8D25${stage}${retries}${errorCode}: ${statusResponse.error || statusResponse.errorMessage || "\u672A\u77E5\u9519\u8BEF"}`
+          }],
+          isError: true
+        };
+      }
+      const statusResult = normalizeActionResult(statusResponse);
+      const result = statusResult.data;
+      if (isHardActionResultFailure(statusResult)) {
+        const errorCode = statusResult.errorCode ? ` [${statusResult.errorCode}]` : "";
+        return {
+          content: [{
+            type: "text",
+            text: `\u274C \u4EFB\u52A1 [${jobId}] \u6267\u884C\u5931\u8D25${errorCode}: ${statusResult.errorMessage || "\u672A\u77E5\u9519\u8BEF"}`
           }],
           isError: true
         };
       }
-      const result = statusResponse.data;
       if (typeof result === "object" && result !== null && result.error) {
         return { content: [{ type: "text", text: `\u274C \u4E1A\u52A1\u9519\u8BEF: ${result.error}` }], isError: true };
       }
@@ -34380,6 +34483,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       const savePath = statusResponse.savePath || "";
       const saveLine = savePath ? `\u{1F4C2} \u6570\u636E\u5DF2\u5B58: ${savePath}
 
+` : "";
+      const statusMetaLine = statusResult.meta ? `\u{1F4CA} \u91C7\u96C6\u72B6\u6001: ${statusResult.meta.status || "unknown"}${statusResult.meta.reason ? ` (${statusResult.meta.reason})` : ""}
 ` : "";
       const top20 = result.slice(0, 20);
       return {
@@ -34387,7 +34492,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           {
             type: "text",
             text: `\u2705 \u4EFB\u52A1 [${jobId}] \u6267\u884C\u6210\u529F\uFF01\u5171\u83B7\u53D6 ${result.length} \u6761\u6570\u636E\u3002
-` + saveLine + `\u4EE5\u4E0B\u662F\u90E8\u5206\u7ED3\u679C\u5C55\u793A\uFF1A
+` + saveLine + statusMetaLine + `\u4EE5\u4E0B\u662F\u90E8\u5206\u7ED3\u679C\u5C55\u793A\uFF1A
 ` + JSON.stringify(top20, null, 2)
           }
         ]
@@ -34481,8 +34586,30 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           throw firstError;
         }
       }
+      const actionResult = normalizeActionResult(serviceResponse);
+      const actionResultMeta = actionResult.meta || {};
+      const actionResultMetaLine = actionResult.meta ? `
+\u{1F4CA} \u91C7\u96C6\u72B6\u6001: ${actionResultMeta.status || "unknown"}${actionResultMeta.reason ? ` (${actionResultMeta.reason})` : ""}
+` : "";
       if (serviceResponse.error) {
-        return { content: [{ type: "text", text: `\u274C \u9519\u8BEF: ${serviceResponse.error}` }], isError: true };
+        const errorCode = serviceResponse.errorCode ? ` [${serviceResponse.errorCode}]` : "";
+        return {
+          content: [{
+            type: "text",
+            text: `\u274C \u9519\u8BEF${errorCode}: ${serviceResponse.error}${actionResultMetaLine}`
+          }],
+          isError: true
+        };
+      }
+      if (isHardActionResultFailure(actionResult) || serviceResponse.success === false) {
+        const errorCode = actionResult.errorCode ? ` [${actionResult.errorCode}]` : "";
+        return {
+          content: [{
+            type: "text",
+            text: `\u274C \u4E1A\u52A1\u9519\u8BEF${errorCode}: ${actionResult.errorMessage || "Bridge \u672A\u5B8C\u6210\u8BE5\u4EFB\u52A1"}${actionResultMetaLine}`
+          }],
+          isError: true
+        };
       }
       if (serviceResponse.jobId) {
         const anticipatedPath = serviceResponse.savePath || "";
@@ -34504,7 +34631,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           ]
         };
       }
-      const result = serviceResponse.data;
+      const result = actionResult.data;
       if (serviceResponse.success && result === void 0) {
         return { content: [{ type: "text", text: "\u2705 \u64CD\u4F5C\u6267\u884C\u6210\u529F\u3002" }] };
       }
@@ -34540,7 +34667,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             {
               type: "text",
               text: `\u2705 [${toolName}] \u89C6\u9891\u8BE6\u60C5\u4E0E\u8BC4\u8BBA\u83B7\u53D6\u6210\u529F\uFF0C\u5171\u91C7\u96C6 ${comments.length} \u6761\u8BC4\u8BBA\u53CA\u56DE\u590D\u3002
-` + saveLine + `\u4EE5\u4E0B\u4EC5\u5C55\u793A\u524D ${preview.commentsPreviewed} \u6761\u8BC4\u8BBA\uFF0C\u5B8C\u6574\u6570\u636E\u8BF7\u67E5\u770B\u4FDD\u5B58\u6587\u4EF6\uFF1A
+` + saveLine + actionResultMetaLine + `\u4EE5\u4E0B\u4EC5\u5C55\u793A\u524D ${preview.commentsPreviewed} \u6761\u8BC4\u8BBA\uFF0C\u5B8C\u6574\u6570\u636E\u8BF7\u67E5\u770B\u4FDD\u5B58\u6587\u4EF6\uFF1A
 ` + JSON.stringify(preview, null, 2)
             }
           ]
@@ -34552,7 +34679,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             {
               type: "text",
               text: `\u2705 [${toolName}] \u5546\u54C1\u8BE6\u60C5\u83B7\u53D6\u6210\u529F\uFF01
-` + saveLine + JSON.stringify(result[0], null, 2)
+` + saveLine + actionResultMetaLine + JSON.stringify(result[0], null, 2)
             }
           ]
         };
@@ -34563,7 +34690,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           {
             type: "text",
             text: `\u2705 [${toolName}] \u6267\u884C\u6210\u529F\uFF0C\u5171 ${result.length} \u6761\u6570\u636E\u3002
-` + saveLine + `\u4EE5\u4E0B\u662F\u90E8\u5206\u7ED3\u679C\u5C55\u793A\uFF1A
+` + saveLine + actionResultMetaLine + `\u4EE5\u4E0B\u662F\u90E8\u5206\u7ED3\u679C\u5C55\u793A\uFF1A
 ` + JSON.stringify(top20, null, 2)
           }
         ]