npm - oc-browser-relay - Versions diffs - 1.0.0 - Mend

oc-browser-relay 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (387) hide show

package/bundled-relay/public/configs/task-templates/taobao-item-detail-comments.json ADDED Viewed

@@ -0,0 +1,76 @@
+{
+  "siteId": "taobao_web",
+  "taskType": "collect_product_data",
+  "platform": "taobao",
+  "name": "采集淘宝商品详情与评论",
+  "description": "打开淘宝商品详情页，提取商品结构化数据，并打开评论面板采集评论接口。",
+  "requiredFields": [
+    {
+      "name": "url",
+      "type": "string",
+      "description": "淘宝或天猫商品详情页链接"
+    }
+  ],
+  "optionalFields": [],
+  "workflow": [
+    {
+      "stepId": "s1",
+      "name": "open_product_detail",
+      "goal": "打开淘宝商品详情页",
+      "tool": "open_tab",
+      "args": {
+        "url": "{{data.url}}"
+      }
+    },
+    {
+      "stepId": "s2",
+      "name": "validate_product_detail_page",
+      "goal": "校验当前页面已进入淘宝商品详情页",
+      "tool": "validate_page",
+      "args": {}
+    },
+    {
+      "stepId": "s3",
+      "name": "collect_product_detail",
+      "goal": "提取商品详情结构化数据",
+      "tool": "collect_structured_data",
+      "args": {
+        "extractor": "product_detail"
+      }
+    },
+    {
+      "stepId": "s4",
+      "name": "open_product_comments",
+      "goal": "打开评价并截取评论接口",
+      "tool": "trigger_action",
+      "args": {
+        "action": "open_comments",
+        "captureNetwork": {
+          "urlPattern": "/h5/mtop.taobao.rate.detaillist.get/",
+          "method": "GET",
+          "timeoutMs": 15000,
+          "capability": "hybrid",
+          "operation": "capture_response",
+          "persistent": true,
+          "startPhase": "before_action",
+          "actionScope": "step",
+          "artifactType": "hybrid",
+          "includeBody": true,
+          "locationSuffix": "taobao_comments_page_1",
+          "hint": "capture taobao product comments"
+        }
+      }
+    },
+    {
+      "stepId": "s5",
+      "name": "collect_product_comments",
+      "goal": "投影评论接口为结构化评论数据",
+      "tool": "collect_structured_data",
+      "args": {
+        "extractor": "product_comments",
+        "sourceStepId": "s4",
+        "targetCommentCount": 50
+      }
+    }
+  ]
+}

package/bundled-relay/public/configs/task-templates/xiaohongshu-creator-publish.json ADDED Viewed

@@ -0,0 +1,83 @@
+{
+  "siteId": "xiaohongshu_creator",
+  "taskType": "publish_note",
+  "platform": "xiaohongshu",
+  "name": "发布小红书图文笔记",
+  "description": "在小红书创作平台发布图文笔记",
+  "requiredFields": [
+    {
+      "name": "title",
+      "type": "string",
+      "description": "笔记标题",
+      "validation": "length:1-20"
+    },
+    {
+      "name": "content",
+      "type": "string",
+      "description": "笔记正文",
+      "validation": "length:1-1000"
+    },
+    {
+      "name": "images",
+      "type": "array",
+      "description": "图片文件路径数组",
+      "validation": "minLength:1,maxLength:9"
+    }
+  ],
+  "optionalFields": [
+    {
+      "name": "topics",
+      "type": "array",
+      "description": "要添加的话题标签数组，例如 [\"通勤穿搭\", \"春季搭配\"]"
+    }
+  ],
+  "workflow": [
+    {
+      "stepId": "s1",
+      "name": "ensure_publish_ready",
+      "tool": "ensure_publish_ready",
+      "args": {}
+    },
+    {
+      "stepId": "s2",
+      "name": "upload_images",
+      "tool": "upload_assets",
+      "args": {
+        "field": "images",
+        "assets": "{{data.images}}"
+      }
+    },
+    {
+      "stepId": "s3",
+      "name": "fill_title",
+      "tool": "fill_field",
+      "args": {
+        "field": "title",
+        "value": "{{data.title}}"
+      }
+    },
+    {
+      "stepId": "s4",
+      "name": "fill_content",
+      "tool": "fill_field",
+      "args": {
+        "field": "content",
+        "value": "{{data.content}}"
+      }
+    },
+    {
+      "stepId": "s5",
+      "name": "publish",
+      "tool": "trigger_action",
+      "args": {
+        "action": "publish"
+      }
+    }
+  ],
+  "validation": [
+    {
+      "rule": "images.length >= 1",
+      "message": "至少需要上传一张图片"
+    }
+  ]
+}

package/bundled-relay/public/configs/task-templates/xiaohongshu-creator-save-draft.json ADDED Viewed

@@ -0,0 +1,83 @@
+{
+  "siteId": "xiaohongshu_creator",
+  "taskType": "save_note_draft",
+  "platform": "xiaohongshu",
+  "name": "保存小红书图文草稿",
+  "description": "在小红书创作平台保存图文笔记为草稿",
+  "requiredFields": [
+    {
+      "name": "title",
+      "type": "string",
+      "description": "笔记标题",
+      "validation": "length:1-20"
+    },
+    {
+      "name": "content",
+      "type": "string",
+      "description": "笔记正文",
+      "validation": "length:1-1000"
+    },
+    {
+      "name": "images",
+      "type": "array",
+      "description": "图片文件路径数组",
+      "validation": "minLength:1,maxLength:9"
+    }
+  ],
+  "optionalFields": [
+    {
+      "name": "topics",
+      "type": "array",
+      "description": "要添加的话题标签数组，例如 [\"通勤穿搭\", \"春季搭配\"]"
+    }
+  ],
+  "workflow": [
+    {
+      "stepId": "s1",
+      "name": "ensure_publish_ready",
+      "tool": "ensure_publish_ready",
+      "args": {}
+    },
+    {
+      "stepId": "s2",
+      "name": "upload_images",
+      "tool": "upload_assets",
+      "args": {
+        "field": "images",
+        "assets": "{{data.images}}"
+      }
+    },
+    {
+      "stepId": "s3",
+      "name": "fill_title",
+      "tool": "fill_field",
+      "args": {
+        "field": "title",
+        "value": "{{data.title}}"
+      }
+    },
+    {
+      "stepId": "s4",
+      "name": "fill_content",
+      "tool": "fill_field",
+      "args": {
+        "field": "content",
+        "value": "{{data.content}}"
+      }
+    },
+    {
+      "stepId": "s5",
+      "name": "save_draft",
+      "tool": "trigger_action",
+      "args": {
+        "action": "saveDraft"
+      }
+    }
+  ],
+  "validation": [
+    {
+      "rule": "images.length >= 1",
+      "message": "至少需要上传一张图片"
+    }
+  ]
+}

package/bundled-relay/public/configs/task-templates/xiaohongshu-web-search-notes.json ADDED Viewed

@@ -0,0 +1,152 @@
+{
+  "siteId": "xiaohongshu_web",
+  "taskType": "search_notes",
+  "platform": "xiaohongshu",
+  "name": "搜索小红书笔记",
+  "description": "打开小红书首页，输入关键词并进入搜索结果页。首阶段仅负责搜索入口，后续滚动与接口采集由搜索工作流接管。",
+  "requiredFields": [
+    {
+      "name": "keyword",
+      "type": "string",
+      "description": "搜索关键词"
+    }
+  ],
+  "optionalFields": [
+    {
+      "name": "targetCount",
+      "type": "number",
+      "description": "目标采集笔记数量，当前仅保存到任务 payload，默认 25",
+      "default": 25
+    },
+    {
+      "name": "filters",
+      "type": "array",
+      "description": "可选筛选条件数组，元素格式为 { group, option }"
+    },
+    {
+      "name": "detailTargetCount",
+      "type": "number",
+      "description": "可选详情采集数量，若提供则在列表采集后继续按 noteId 打开并采集前 N 条详情"
+    },
+    {
+      "name": "randomizeOrder",
+      "type": "boolean",
+      "description": "详情采集时是否打乱访问顺序以模拟真实浏览行为",
+      "default": true
+    }
+  ],
+  "workflow": [
+    {
+      "stepId": "s1",
+      "name": "open_search_home",
+      "goal": "打开小红书首页搜索入口",
+      "tool": "open_tab",
+      "args": {
+        "url": "https://www.xiaohongshu.com/explore"
+      }
+    },
+    {
+      "stepId": "s2",
+      "name": "fill_search_keyword",
+      "goal": "填写搜索关键词",
+      "tool": "fill_field",
+      "args": {
+        "field": "keyword",
+        "value": "{{data.keyword}}"
+      }
+    },
+    {
+      "stepId": "s3",
+      "name": "submit_search",
+      "goal": "提交搜索并进入搜索结果页",
+      "tool": "trigger_action",
+      "args": {
+        "action": "search",
+        "captureNetwork": {
+          "urlPattern": "https://edith.xiaohongshu.com/api/sns/web/v1/search/notes",
+          "method": "POST",
+          "timeoutMs": 12000,
+          "capability": "hybrid",
+          "operation": "capture_response",
+          "persistent": true,
+          "activationCondition": "no_filters",
+          "startPhase": "before_action",
+          "actionScope": "step",
+          "artifactType": "hybrid",
+          "locationSuffix": "search_notes_page_1",
+          "hint": "listening search notes responses"
+        }
+      },
+      "expectedObservation": {
+        "type": "logical_or",
+        "conditions": [
+          {
+            "type": "url_contains",
+            "value": "/search_result"
+          },
+          {
+            "type": "element_visible",
+            "selector": "#channel-container"
+          }
+        ]
+      }
+    },
+    {
+      "stepId": "s4",
+      "name": "apply_search_filters",
+      "goal": "按需应用搜索筛选条件",
+      "tool": "apply_search_filters",
+      "args": {
+        "captureNetwork": {
+          "urlPattern": "https://edith.xiaohongshu.com/api/sns/web/v1/search/notes",
+          "method": "POST",
+          "timeoutMs": 12000,
+          "capability": "hybrid",
+          "operation": "capture_response",
+          "persistent": true,
+          "activationCondition": "with_filters",
+          "startPhase": "before_action",
+          "actionScope": "last_action",
+          "artifactType": "hybrid",
+          "locationSuffix": "search_notes_page_1",
+          "hint": "listening search notes responses"
+        }
+      }
+    },
+    {
+      "stepId": "s5",
+      "name": "collect_search_notes",
+      "goal": "滚动搜索结果页并累计采集笔记结果",
+      "tool": "collect_search_notes",
+      "args": {
+        "targetCount": "{{data.targetCount}}",
+        "captureNetwork": {
+          "urlPattern": "https://edith.xiaohongshu.com/api/sns/web/v1/search/notes",
+          "method": "POST",
+          "timeoutMs": 12000,
+          "capability": "hybrid",
+          "operation": "capture_response",
+          "persistent": true,
+          "activationCondition": "always",
+          "startPhase": "before_step",
+          "actionScope": "step",
+          "artifactType": "hybrid",
+          "locationSuffix": "search_notes_page_1",
+          "hint": "listening search notes responses"
+        }
+      }
+    },
+    {
+      "stepId": "s6",
+      "name": "collect_note_details",
+      "goal": "按搜索结果前 N 条 noteId 在页面中逐条打开并采集详情",
+      "tool": "collect_note_details",
+      "condition": "detailTargetCount",
+      "args": {
+        "targetCount": "{{data.detailTargetCount}}",
+        "sourceStepId": "s5",
+        "randomizeOrder": "{{data.randomizeOrder}}"
+      }
+    }
+  ]
+}

package/bundled-relay/public/configs/task-templates/xiaohongshu_open_website.json ADDED Viewed

@@ -0,0 +1,24 @@
+{
+  "taskType": "open_website",
+  "platform": "xiaohongshu",
+  "name": "打开小红书网站",
+  "description": "打开小红书网站首页或创作平台",
+  "requiredFields": [],
+  "optionalFields": [
+    {
+      "name": "page",
+      "type": "string",
+      "description": "要打开的页面：home(首页) 或 creator(创作平台)",
+      "default": "home"
+    }
+  ],
+  "workflow": [
+    {
+      "stepId": "s1",
+      "tool": "open_tab",
+      "args": {
+        "url": "https://www.xiaohongshu.com"
+      }
+    }
+  ]
+}

package/index.js ADDED Viewed

@@ -0,0 +1 @@

package/install.mjs ADDED Viewed

@@ -0,0 +1,45 @@
+import { existsSync, readFileSync } from "fs";
+import { spawnSync } from "child_process";
+import path from "path";
+import { fileURLToPath } from "url";
+const THIS_FILE = fileURLToPath(import.meta.url);
+const PLUGIN_ROOT = path.dirname(THIS_FILE);
+const BUNDLED_RELAY_ROOT = path.join(PLUGIN_ROOT, "bundled-relay");
+const BUNDLED_RELAY_PACKAGE_JSON = path.join(BUNDLED_RELAY_ROOT, "package.json");
+const PLAYWRIGHT_CORE_PACKAGE_JSON = path.join(BUNDLED_RELAY_ROOT, "node_modules", "playwright-core", "package.json");
+function fail(message) {
+  console.error(`[dabi-relay] ${message}`);
+  process.exit(1);
+}
+if (!existsSync(BUNDLED_RELAY_PACKAGE_JSON)) {
+  fail(`Missing ${BUNDLED_RELAY_PACKAGE_JSON}. Make sure you run this helper from the plugin dist directory.`);
+}
+if (existsSync(PLAYWRIGHT_CORE_PACKAGE_JSON)) {
+  const installed = JSON.parse(readFileSync(PLAYWRIGHT_CORE_PACKAGE_JSON, "utf-8"));
+  console.log(`[dabi-relay] Bundled relay runtime already installed: playwright-core@${installed.version}`);
+  process.exit(0);
+}
+const bundledPkg = JSON.parse(readFileSync(BUNDLED_RELAY_PACKAGE_JSON, "utf-8"));
+const expectedVersion = bundledPkg.dependencies?.["playwright-core"];
+console.log(`[dabi-relay] Installing bundled relay runtime dependencies${expectedVersion ? ` (playwright-core@${expectedVersion})` : ""}...`);
+const npmCommand = process.platform === "win32" ? "npm.cmd" : "npm";
+const result = spawnSync(npmCommand, ["install", "--omit=dev"], {
+  cwd: BUNDLED_RELAY_ROOT,
+  stdio: "inherit",
+});
+if (result.status !== 0) {
+  fail("Runtime dependency install failed. Ensure npm can reach the registry, then rerun `node install.mjs`.");
+}
+if (!existsSync(PLAYWRIGHT_CORE_PACKAGE_JSON)) {
+  fail("Runtime dependency install finished without playwright-core. Check npm output and retry.");
+}
+console.log("[dabi-relay] Bundled relay runtime dependencies installed successfully.");

package/openclaw.plugin.json ADDED Viewed

@@ -0,0 +1,79 @@
+{
+  "id": "oc-browser-relay",
+  "name": "oc browser relay",
+  "description": "Expose a local ChromeAgent/Relay Tool API to OpenClaw as agent tools.",
+  "skills": ["./skills"],
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "baseUrl": {
+        "type": "string",
+        "default": "http://localhost:51234",
+        "description": "Base URL for the local ChromeAgent Relay service"
+      },
+      "relayPort": {
+        "type": "number",
+        "default": 51234,
+        "minimum": 1,
+        "description": "Port used when auto-starting the relay process"
+      },
+      "defaultPollIntervalMs": {
+        "type": "number",
+        "default": 1000,
+        "minimum": 200,
+        "description": "Polling interval for action tasks"
+      },
+      "defaultTimeoutMs": {
+        "type": "number",
+        "default": 30000,
+        "minimum": 1000,
+        "description": "Default timeout when waiting for action tasks"
+      },
+      "autoStart": {
+        "type": "boolean",
+        "default": true,
+        "description": "Automatically start the local relay process when the plugin is called and the relay is not healthy"
+      },
+      "preferBundledRelay": {
+        "type": "boolean",
+        "default": true,
+        "description": "Prefer the relay bundled inside the OpenClaw plugin package"
+      },
+      "relayCommand": {
+        "type": "string",
+        "description": "Optional external command used to start the relay process. When omitted and preferBundledRelay=true, the bundled relay is used"
+      },
+      "relayArgs": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        },
+        "description": "Optional arguments passed to the external relay start command"
+      },
+      "relayCwd": {
+        "type": "string",
+        "description": "Working directory where the external relay start command is executed"
+      },
+      "relayEnv": {
+        "type": "object",
+        "additionalProperties": {
+          "type": "string"
+        },
+        "description": "Optional environment variables for the relay process"
+      },
+      "startupTimeoutMs": {
+        "type": "number",
+        "default": 15000,
+        "minimum": 1000,
+        "description": "Maximum time to wait for the relay health check to pass after auto-start"
+      },
+      "startupPollIntervalMs": {
+        "type": "number",
+        "default": 500,
+        "minimum": 100,
+        "description": "Polling interval while waiting for the relay to become healthy after auto-start"
+      }
+    }
+  }
+}