feat(browser-act): add Kuaishou search pack

Author: chuanxu742-glitch

backend/browser_act_packs/video-platforms/kuaishou-search/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: kuaishou-search
+description: "Extract structured public Kuaishou video search results from the current browser page."
+---
+
+# Kuaishou — Video Search
+
+> Search keyword → bounded structured video results
+
+## Prerequisites
+
+- Browser Act is available.
+- The target browser can reach `kuaishou.com`.
+- The current session may need human login or verification.
+
+## Execution
+
+Navigate to:
+
+```text
+https://www.kuaishou.com/search/video?searchKey={query}
+```
+
+Wait for the page to settle, then run:
+
+```bash
+python scripts/extract-search.py --max-results 10
+```
+
+The result contains the video URL, caption, author, cover, playable media
+URL when exposed by the page, publication timestamp, tags, and bounded
+engagement statistics.
+
+## Operational boundary
+
+This pack reads the public search state already present in the browser. It
+never automates login, captcha solving, or anti-bot bypass. Login, verification,
+regional restrictions, and blocked responses are human-handled conditions.
+
+## Limitations
+
+The manifest extracts the initial search result state only. Cursor-based
+follow-up requests and comment collection are intentionally out of scope for
+this pack; they require a separate pagination contract and should not be
+silently represented as complete results.

backend/browser_act_packs/video-platforms/kuaishou-search/channel.manifest.json

@@ -0,0 +1,15 @@
+{
+  "domain": "video-platforms",
+  "capability": "kuaishou-search",
+  "param_schema": [
+    {"name": "query", "required": true},
+    {"name": "max_results", "required": false, "default": "10"}
+  ],
+  "steps": [
+    {"op": "navigate", "url_template": "https://www.kuaishou.com/search/video?searchKey={query}"},
+    {"op": "wait", "wait_mode": "stable"},
+    {"op": "eval_script", "script": "scripts/extract-search.py", "args": ["--max-results", "{max_results}"]}
+  ],
+  "pagination": {"mode": "none"},
+  "success": {"min_count": 1, "required_field": "url"}
+}

backend/browser_act_packs/video-platforms/kuaishou-search/scripts/extract-search.py

@@ -0,0 +1,88 @@
+import argparse
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--max-results", type=int, default=10)
+    args = parser.parse_args()
+    max_results = max(1, min(args.max_results, 50))
+
+    js = r"""(() => {
+  const clean = (value) => String(value || '').replace(/\s+/g, ' ').trim();
+  const firstUrl = (value) => {
+    if (typeof value === 'string' && value) return value;
+    if (Array.isArray(value)) {
+      for (const item of value) {
+        const result = firstUrl(item);
+        if (result) return result;
+      }
+    }
+    if (value && typeof value === 'object') {
+      for (const key of ['url', 'src', 'srcNoWatermark', 'playUrl']) {
+        const result = firstUrl(value[key]);
+        if (result) return result;
+      }
+    }
+    return null;
+  };
+  const isoTime = (value) => {
+    const timestamp = Number(value);
+    if (!Number.isFinite(timestamp) || timestamp <= 0) return null;
+    const date = new Date(timestamp < 100000000000 ? timestamp * 1000 : timestamp);
+    return Number.isNaN(date.getTime()) ? null : date.toISOString();
+  };
+  const stateValues = Object.values(window.INIT_STATE || {});
+  const state = stateValues.find((value) => value && Array.isArray(value.feeds)) || {feeds: []};
+  const items = state.feeds.map((feed) => {
+    if (!feed || typeof feed !== 'object') return null;
+    const photo = feed.photo && typeof feed.photo === 'object' ? feed.photo : null;
+    if (!photo || !clean(photo.id)) return null;
+    const author = feed.author && typeof feed.author === 'object' ? feed.author : {};
+    const comment = feed.comment && typeof feed.comment === 'object' ? feed.comment : {};
+    const photoId = clean(photo.id);
+    const caption = clean(photo.caption);
+    const coverUrl = firstUrl(photo.coverUrl);
+    const playUrl = firstUrl(photo.manifestH265) || firstUrl(photo.manifest);
+    const statistics = {
+      like_count: photo.likeCount,
+      comment_count: comment.us_c,
+      collect_count: photo.collectCount,
+      view_count: photo.viewCount,
+      share_count: photo.shareCount,
+    };
+    Object.keys(statistics).forEach((key) => {
+      if (statistics[key] === null || statistics[key] === undefined) delete statistics[key];
+    });
+    return {
+      title: caption || `Kuaishou video ${photoId}`,
+      content: caption,
+      author: clean(author.name),
+      author_id: clean(author.id) || null,
+      author_avatar: firstUrl(author.headerUrl),
+      url: `https://www.kuaishou.com/short-video/${encodeURIComponent(photoId)}`,
+      photo_id: photoId,
+      create_time: photo.timestamp || null,
+      published_at: isoTime(photo.timestamp),
+      cover_url: coverUrl,
+      play_url: playUrl,
+      statistics,
+      media: {
+        type: 'video',
+        play_url: playUrl,
+        cover_url: coverUrl,
+        duration_ms: photo.duration || null,
+        width: photo.width || null,
+        height: photo.height || null,
+      },
+      tags: Array.isArray(feed.tags)
+        ? feed.tags.map((tag) => clean(tag && tag.name)).filter(Boolean)
+        : [],
+    };
+  }).filter(Boolean).slice(0, MAX_RESULTS);
+  return {count: items.length, items};
+})()"""
+    print(js.replace("MAX_RESULTS", str(max_results)))
+
+
+if __name__ == "__main__":
+    main()

tests/integration/test_browser_act_packs_api.py

@@ -9,6 +9,7 @@
 SEEDED_WITH_MANIFEST = {
     "ecommerce/taobao-keyword-search",
     "search-research/google-search-serp",
+    "video-platforms/kuaishou-search",
 }
 
 

tests/unit/browser_act_packs/test_kuaishou_pack.py

@@ -0,0 +1,35 @@
+"""Contract checks for the Kuaishou Browser Act pack."""
+
+import subprocess
+import sys
+from pathlib import Path
+
+from backend.browser_act_packs.catalog import PackCatalog
+from backend.browser_act_packs.manifest import load_manifest
+
+_PACK = Path(PackCatalog().root) / "video-platforms" / "kuaishou-search"
+
+
+def test_kuaishou_manifest_points_to_bounded_search_script() -> None:
+    manifest = load_manifest(_PACK / "channel.manifest.json")
+
+    assert manifest.domain == "video-platforms"
+    assert manifest.capability == "kuaishou-search"
+    assert manifest.success.required_field == "url"
+    assert manifest.pagination.mode == "none"
+    assert manifest.steps[-1].script == "scripts/extract-search.py"
+    assert (_PACK / manifest.steps[-1].script).is_file()
+
+
+def test_kuaishou_script_emits_requested_result_bound() -> None:
+    script = _PACK / "scripts" / "extract-search.py"
+    result = subprocess.run(
+        [sys.executable, str(script), "--max-results", "7"],
+        check=True,
+        capture_output=True,
+        text=True,
+    )
+
+    assert "MAX_RESULTS" not in result.stdout
+    assert ".slice(0, 7)" in result.stdout
+    assert "kuaishou.com/short-video" in result.stdout