@zenalexa/unicli 0.215.1 → 0.216.2

package/src/adapters/xueqiu/extra.ts

@@ -0,0 +1,78 @@
+import { cli, Strategy } from "../../registry.js";
+import type { IPage } from "../../types.js";
+import { loadCookies, formatCookieHeader } from "../../engine/cookies.js";
+import { USER_AGENT } from "../../constants.js";
+import { intArg, js, str } from "../_shared/browser-tools.js";
+
+async function xueqiuJson(url: string): Promise<Record<string, unknown>> {
+  const cookies = loadCookies("xueqiu");
+  const headers: Record<string, string> = {
+    "user-agent": USER_AGENT,
+    referer: "https://xueqiu.com",
+    accept: "application/json",
+  };
+  if (cookies) headers.cookie = formatCookieHeader(cookies);
+  const response = await fetch(url, { headers });
+  if (!response.ok) {
+    throw new Error(`Xueqiu request failed: HTTP ${response.status}`);
+  }
+  return (await response.json()) as Record<string, unknown>;
+}
+
+cli({
+  site: "xueqiu",
+  name: "kline",
+  description: "Fetch Xueqiu stock candlestick data",
+  domain: "xueqiu.com",
+  strategy: Strategy.COOKIE,
+  args: [
+    { name: "symbol", type: "str", required: true, positional: true },
+    { name: "period", type: "str", default: "day" },
+    { name: "count", type: "int", default: 120 },
+  ],
+  columns: ["timestamp", "open", "close", "high", "low", "volume"],
+  func: async (_page, kwargs) => {
+    const symbol = str(kwargs.symbol).toUpperCase();
+    const count = intArg(kwargs.count, 120, 1000);
+    const url = new URL("https://stock.xueqiu.com/v5/stock/chart/kline.json");
+    url.searchParams.set("symbol", symbol);
+    url.searchParams.set("begin", String(Date.now()));
+    url.searchParams.set("period", str(kwargs.period, "day"));
+    url.searchParams.set("type", "before");
+    url.searchParams.set("count", `-${count}`);
+    const data = await xueqiuJson(url.href);
+    const item = (data.data ?? {}) as Record<string, unknown>;
+    const columns = Array.isArray(item.column) ? (item.column as string[]) : [];
+    const rows = Array.isArray(item.item) ? (item.item as unknown[][]) : [];
+    return rows.map((row) =>
+      Object.fromEntries(columns.map((name, i) => [name, row[i]])),
+    );
+  },
+});
+
+cli({
+  site: "xueqiu",
+  name: "groups",
+  description: "Read visible Xueqiu portfolio or group lists",
+  domain: "xueqiu.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [{ name: "limit", type: "int", default: 20 }],
+  columns: ["name", "url"],
+  func: async (page, kwargs) => {
+    const p = page as IPage;
+    const limit = intArg(kwargs.limit, 20, 100);
+    await p.goto("https://xueqiu.com/portfolio", { settleMs: 2500 });
+    const rows = await p.evaluate(`(() => {
+      const links = [...document.querySelectorAll('a[href*="/P/"], a[href*="portfolio"], a[href]')];
+      const seen = new Set();
+      return links.map((a) => {
+        const url = new URL(a.getAttribute('href') || '', location.href).href;
+        if (seen.has(url)) return null;
+        seen.add(url);
+        return { name: (a.textContent || '').replace(/\\s+/g, ' ').trim(), url };
+      }).filter((row) => row && row.name).slice(0, ${js(limit)});
+    })()`);
+    return Array.isArray(rows) ? (rows as Record<string, unknown>[]) : [];
+  },
+});

package/src/adapters/youtube/personal.ts

@@ -0,0 +1,215 @@
+import { cli, Strategy } from "../../registry.js";
+import type { IPage } from "../../types.js";
+import { clickFirst, intArg, str } from "../_shared/browser-tools.js";
+
+const HOME = "https://www.youtube.com";
+
+async function extractVideos(
+  page: IPage,
+  url: string,
+  limit: number,
+): Promise<Record<string, unknown>[]> {
+  await page.goto(url, { settleMs: 2200 });
+  const rows = (await page.evaluate(`(() => {
+    const anchors = [...document.querySelectorAll('a#video-title, a.yt-simple-endpoint[href*="/watch"], ytd-rich-item-renderer a[href*="/watch"]')];
+    const seen = new Set();
+    return anchors.map((a) => {
+      const href = a.getAttribute('href') || '';
+      const url = new URL(href, location.href).href;
+      if (!url.includes('/watch') || seen.has(url)) return null;
+      seen.add(url);
+      const root = a.closest('ytd-video-renderer, ytd-rich-item-renderer, ytd-grid-video-renderer, ytd-playlist-video-renderer') || a.parentElement;
+      return {
+        title: (a.getAttribute('title') || a.textContent || '').trim(),
+        channel: (root?.querySelector('#channel-name, ytd-channel-name')?.textContent || '').trim(),
+        meta: (root?.textContent || '').replace(/\\s+/g, ' ').trim().slice(0, 300),
+        url
+      };
+    }).filter(Boolean);
+  })()`)) as Record<string, unknown>[];
+  return rows.slice(0, limit);
+}
+
+async function toggleVideoAction(
+  page: IPage,
+  target: string,
+  selectors: readonly string[],
+): Promise<Record<string, unknown>[]> {
+  const url = target.startsWith("http")
+    ? target
+    : `${HOME}/watch?v=${encodeURIComponent(target)}`;
+  await page.goto(url, { settleMs: 2200 });
+  const selector = await clickFirst(page, selectors);
+  return [{ ok: selector !== null, selector, url: await page.url() }];
+}
+
+cli({
+  site: "youtube",
+  name: "feed",
+  description: "Read YouTube homepage recommended videos",
+  domain: "www.youtube.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [{ name: "limit", type: "int", default: 20 }],
+  columns: ["title", "channel", "url"],
+  func: async (page, kwargs) =>
+    extractVideos(page as IPage, HOME, intArg(kwargs.limit, 20, 100)),
+});
+
+cli({
+  site: "youtube",
+  name: "history",
+  description: "Read YouTube watch history",
+  domain: "www.youtube.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [{ name: "limit", type: "int", default: 20 }],
+  columns: ["title", "channel", "url"],
+  func: async (page, kwargs) =>
+    extractVideos(
+      page as IPage,
+      `${HOME}/feed/history`,
+      intArg(kwargs.limit, 20, 100),
+    ),
+});
+
+cli({
+  site: "youtube",
+  name: "watch-later",
+  description: "Read YouTube Watch Later queue",
+  domain: "www.youtube.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [{ name: "limit", type: "int", default: 20 }],
+  columns: ["title", "channel", "url"],
+  func: async (page, kwargs) =>
+    extractVideos(
+      page as IPage,
+      `${HOME}/playlist?list=WL`,
+      intArg(kwargs.limit, 20, 100),
+    ),
+});
+
+cli({
+  site: "youtube",
+  name: "subscriptions",
+  description: "List YouTube subscribed channels",
+  domain: "www.youtube.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [{ name: "limit", type: "int", default: 50 }],
+  columns: ["title", "url"],
+  func: async (page, kwargs) => {
+    const p = page as IPage;
+    await p.goto(`${HOME}/feed/channels`, { settleMs: 2200 });
+    const limit = intArg(kwargs.limit, 50, 200);
+    const rows = (await p.evaluate(`(() => {
+      const links = [...document.querySelectorAll('a[href^="/channel/"], a[href^="/@"]')];
+      const seen = new Set();
+      return links.map((a) => {
+        const url = new URL(a.getAttribute('href') || '', location.href).href;
+        if (seen.has(url)) return null;
+        seen.add(url);
+        return { title: (a.textContent || a.getAttribute('title') || '').trim(), url };
+      }).filter((row) => row && row.title);
+    })()`)) as Record<string, unknown>[];
+    return rows.slice(0, limit);
+  },
+});
+
+cli({
+  site: "youtube",
+  name: "like",
+  description: "Like a YouTube video in the active browser session",
+  domain: "www.youtube.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [{ name: "video", type: "str", required: true, positional: true }],
+  columns: ["ok", "selector", "url"],
+  func: async (page, kwargs) =>
+    toggleVideoAction(page as IPage, str(kwargs.video), [
+      "like-button-view-model button",
+      "ytd-toggle-button-renderer:first-of-type button",
+      "button[aria-label*='like']",
+      "button[aria-label*='喜欢']",
+    ]),
+});
+
+cli({
+  site: "youtube",
+  name: "unlike",
+  description: "Remove a YouTube video like in the active browser session",
+  domain: "www.youtube.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [{ name: "video", type: "str", required: true, positional: true }],
+  columns: ["ok", "selector", "url"],
+  func: async (page, kwargs) =>
+    toggleVideoAction(page as IPage, str(kwargs.video), [
+      "like-button-view-model button",
+      "ytd-toggle-button-renderer:first-of-type button",
+      "button[aria-pressed='true'][aria-label*='like']",
+      "button[aria-label*='不喜欢']",
+    ]),
+});
+
+cli({
+  site: "youtube",
+  name: "subscribe",
+  description: "Subscribe to a YouTube channel",
+  domain: "www.youtube.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [{ name: "channel", type: "str", required: true, positional: true }],
+  columns: ["ok", "selector", "url"],
+  func: async (page, kwargs) => {
+    const p = page as IPage;
+    const channel = str(kwargs.channel);
+    const url = channel.startsWith("http")
+      ? channel
+      : channel.startsWith("@")
+        ? `${HOME}/${channel}`
+        : `${HOME}/channel/${encodeURIComponent(channel)}`;
+    await p.goto(url, { settleMs: 2200 });
+    const selector = await clickFirst(p, [
+      "ytd-subscribe-button-renderer button",
+      "button[aria-label*='Subscribe']",
+      "button[aria-label*='订阅']",
+    ]);
+    return [{ ok: selector !== null, selector, url: await p.url() }];
+  },
+});
+
+cli({
+  site: "youtube",
+  name: "unsubscribe",
+  description: "Unsubscribe from a YouTube channel",
+  domain: "www.youtube.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [{ name: "channel", type: "str", required: true, positional: true }],
+  columns: ["ok", "selector", "url"],
+  func: async (page, kwargs) => {
+    const p = page as IPage;
+    const channel = str(kwargs.channel);
+    const url = channel.startsWith("http")
+      ? channel
+      : channel.startsWith("@")
+        ? `${HOME}/${channel}`
+        : `${HOME}/channel/${encodeURIComponent(channel)}`;
+    await p.goto(url, { settleMs: 2200 });
+    const first = await clickFirst(p, [
+      "ytd-subscribe-button-renderer button",
+      "button[aria-label*='Subscribed']",
+      "button[aria-label*='已订阅']",
+    ]);
+    const confirm = await clickFirst(p, [
+      "yt-confirm-dialog-renderer #confirm-button button",
+      "tp-yt-paper-dialog button[aria-label*='Unsubscribe']",
+      "button[aria-label*='取消订阅']",
+    ]);
+    return [
+      { ok: first !== null, selector: confirm ?? first, url: await p.url() },
+    ];
+  },
+});

package/src/adapters/zhihu/actions.ts

@@ -0,0 +1,111 @@
+import { cli, Strategy } from "../../registry.js";
+import type { IPage } from "../../types.js";
+import { boolArg, clickFirst, js, str } from "../_shared/browser-tools.js";
+
+function targetUrl(target: string): string {
+  if (target.startsWith("http")) return target;
+  const [kind, a, b] = target.split(":");
+  if (kind === "question") return `https://www.zhihu.com/question/${a}`;
+  if (kind === "answer")
+    return `https://www.zhihu.com/question/${a}/answer/${b}`;
+  if (kind === "article") return `https://zhuanlan.zhihu.com/p/${a}`;
+  if (kind === "user") return `https://www.zhihu.com/people/${a}`;
+  return `https://www.zhihu.com/search?type=content&q=${encodeURIComponent(target)}`;
+}
+
+function requireExecute(kwargs: Record<string, unknown>): void {
+  if (!boolArg(kwargs.execute)) {
+    throw new Error("Pass --execute to perform this Zhihu write action");
+  }
+}
+
+cli({
+  site: "zhihu",
+  name: "follow",
+  description: "Follow a Zhihu user or question",
+  domain: "zhihu.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    { name: "target", type: "str", required: true, positional: true },
+    { name: "execute", type: "bool", default: false },
+  ],
+  columns: ["ok", "selector", "url"],
+  func: async (page, kwargs) => {
+    requireExecute(kwargs);
+    const p = page as IPage;
+    await p.goto(targetUrl(str(kwargs.target)), { settleMs: 2500 });
+    const selector = await clickFirst(p, [
+      "button.FollowButton",
+      "button[aria-label*='关注']",
+      "button:has(.Zi--Follow)",
+    ]);
+    return [{ ok: selector !== null, selector, url: await p.url() }];
+  },
+});
+
+cli({
+  site: "zhihu",
+  name: "like",
+  description: "Like a Zhihu answer or article",
+  domain: "zhihu.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    { name: "target", type: "str", required: true, positional: true },
+    { name: "execute", type: "bool", default: false },
+  ],
+  columns: ["ok", "selector", "url"],
+  func: async (page, kwargs) => {
+    requireExecute(kwargs);
+    const p = page as IPage;
+    await p.goto(targetUrl(str(kwargs.target)), { settleMs: 2500 });
+    const selector = await clickFirst(p, [
+      "button.VoteButton--up",
+      "button[aria-label*='赞同']",
+      "button[aria-label*='喜欢']",
+    ]);
+    return [{ ok: selector !== null, selector, url: await p.url() }];
+  },
+});
+
+cli({
+  site: "zhihu",
+  name: "favorite",
+  description: "Favorite a Zhihu answer or article into an existing collection",
+  domain: "zhihu.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    { name: "target", type: "str", required: true, positional: true },
+    { name: "collection", type: "str", required: false },
+    { name: "collection_id", type: "str", required: false },
+    { name: "execute", type: "bool", default: false },
+  ],
+  columns: ["ok", "selector", "url"],
+  func: async (page, kwargs) => {
+    requireExecute(kwargs);
+    const p = page as IPage;
+    await p.goto(targetUrl(str(kwargs.target)), { settleMs: 2500 });
+    await clickFirst(p, [
+      "button[aria-label*='收藏']",
+      "button:has(.Zi--Star)",
+      ".ContentItem-actions button",
+    ]);
+    await p.wait(0.8);
+    if (kwargs.collection) {
+      await p.evaluate(`(() => {
+        const name = ${js(str(kwargs.collection))};
+        const nodes = [...document.querySelectorAll('button, label, div')];
+        const node = nodes.find((el) => (el.textContent || '').includes(name));
+        if (node) node.click();
+      })()`);
+    }
+    const selector = await clickFirst(p, [
+      "button.Button--primary",
+      "button[aria-label*='确认']",
+      "button[aria-label*='完成']",
+    ]);
+    return [{ ok: selector !== null, selector, url: await p.url() }];
+  },
+});

package/src/hub/external-clis-harness.yaml

@@ -0,0 +1,211 @@
+# External CLI Harness Registry — app/tool-specific passthrough CLIs.
+#
+# Loaded after external-clis.yaml.  Kept separate so the core registry
+# remains stable while app-level harness coverage can expand quickly.
+
+# ── Application and specialist harnesses ────────────────────────────────
+
+- name: 1password-cli
+  binary: op
+  description: "1Password CLI — vault items, secrets, documents, and service accounts"
+  homepage: "https://developer.1password.com/docs/cli"
+  tags: [passwords, secrets, security]
+  json_flag: "--format json"
+  install:
+    mac: "brew install 1password-cli"
+    linux: "https://developer.1password.com/docs/cli/get-started/"
+    default: "https://developer.1password.com/docs/cli/get-started/"
+
+- name: android-cli
+  binary: adb
+  description: "Android platform tools — devices, packages, logs, files, and shell automation"
+  homepage: "https://developer.android.com/tools/adb"
+  tags: [android, mobile, device, automation]
+  install:
+    mac: "brew install android-platform-tools"
+    default: "https://developer.android.com/tools/releases/platform-tools"
+
+- name: anygen
+  binary: anygen
+  description: "AnyGen — generation workflow harness for local creative automation"
+  tags: [generation, creative, automation]
+
+- name: chromadb
+  binary: chroma
+  description: "ChromaDB — local vector database server and collection tooling"
+  homepage: "https://docs.trychroma.com"
+  tags: [vector-db, embeddings, rag]
+  install:
+    default: "pip install chromadb"
+
+- name: cloudanalyzer
+  binary: cloudanalyzer
+  description: "CloudAnalyzer — cloud inventory and cost/security analysis harness"
+  tags: [cloud, analysis, security, cost]
+
+- name: contentful
+  binary: contentful
+  description: "Contentful CLI — spaces, content types, entries, migrations, and releases"
+  homepage: "https://www.contentful.com/developers/docs/tutorials/cli/"
+  tags: [cms, content, headless]
+  json_flag: "--json"
+  install:
+    default: "npm install -g contentful-cli"
+
+- name: dify-workflow
+  binary: dify-workflow
+  description: "Dify workflow CLI — workflow export, import, testing, and deployment automation"
+  homepage: "https://docs.dify.ai"
+  tags: [ai, workflow, dify]
+
+- name: elevenlabs
+  binary: elevenlabs
+  description: "ElevenLabs CLI — text-to-speech, voices, dubbing, and audio generation"
+  homepage: "https://elevenlabs.io/docs"
+  tags: [audio, tts, generation]
+
+- name: eth2-quickstart
+  binary: eth2-quickstart
+  description: "Ethereum validator quickstart tooling"
+  homepage: "https://github.com/ethereum/staking-deposit-cli"
+  tags: [ethereum, validator, blockchain]
+
+- name: exa
+  binary: exa
+  description: "Exa search CLI — neural web search and answer retrieval"
+  homepage: "https://exa.ai"
+  tags: [search, web, research]
+
+- name: generate-veo-video
+  binary: generate-veo-video
+  description: "Veo video generation harness"
+  tags: [video, generation, ai]
+
+- name: intelwatch
+  binary: intelwatch
+  description: "IntelWatch — local monitoring and telemetry harness"
+  tags: [monitoring, telemetry, local]
+
+- name: iterm2
+  binary: iterm2
+  description: "iTerm2 automation harness — windows, tabs, sessions, text, and tmux workflows"
+  homepage: "https://iterm2.com/python-api"
+  tags: [terminal, macos, automation]
+
+- name: lldb
+  binary: lldb
+  description: "LLDB debugger — breakpoints, processes, frames, variables, and expressions"
+  homepage: "https://lldb.llvm.org"
+  tags: [debugger, native, development]
+  install:
+    mac: "xcode-select --install"
+    linux: "apt install lldb"
+    default: "https://lldb.llvm.org/resources/build.html"
+
+- name: n8n
+  binary: n8n
+  description: "n8n workflow automation — import, export, execute, and manage workflows"
+  homepage: "https://docs.n8n.io"
+  tags: [workflow, automation, integrations]
+  install:
+    default: "npm install -g n8n"
+
+- name: nsight-graphics
+  binary: nsys
+  description: "NVIDIA Nsight tooling — capture, inspect, and export graphics/performance sessions"
+  homepage: "https://developer.nvidia.com/nsight-graphics"
+  tags: [nvidia, graphics, profiling]
+
+- name: obs-studio
+  binary: obs
+  description: "OBS Studio automation — scenes, sources, recording, streaming, and screenshots"
+  homepage: "https://obsproject.com"
+  tags: [video, streaming, recording]
+  install:
+    mac: "brew install --cask obs"
+    default: "https://obsproject.com/download"
+
+- name: openscreen
+  binary: openscreen
+  description: "OpenScreen casting and presentation automation harness"
+  tags: [screen, casting, presentation]
+
+- name: pm2
+  binary: pm2
+  description: "PM2 process manager — start, stop, logs, reload, and process status"
+  homepage: "https://pm2.keymetrics.io"
+  tags: [node, process-manager, ops]
+  json_flag: "--json"
+  install:
+    default: "npm install -g pm2"
+
+- name: py4csr
+  binary: py4csr
+  description: "py4csr research workflow harness"
+  tags: [research, python, workflow]
+
+- name: qgis
+  binary: qgis
+  description: "QGIS desktop and processing automation"
+  homepage: "https://qgis.org"
+  tags: [gis, maps, geospatial]
+  install:
+    mac: "brew install --cask qgis"
+    default: "https://qgis.org/download/"
+
+- name: rms
+  binary: rms
+  description: "RMS automation harness"
+  tags: [automation, workflow]
+
+- name: safari
+  binary: safari
+  description: "Safari browser automation harness"
+  homepage: "https://support.apple.com/guide/safari"
+  tags: [browser, macos, automation]
+
+- name: sanity
+  binary: sanity
+  description: "Sanity CLI — datasets, schemas, content, deploys, and studio workflows"
+  homepage: "https://www.sanity.io/docs/cli"
+  tags: [cms, content, headless]
+  install:
+    default: "npm install -g sanity"
+
+- name: seaclip
+  binary: seaclip
+  description: "SeaClip media understanding harness"
+  tags: [vision, media, ai]
+
+- name: shopify
+  binary: shopify
+  description: "Shopify CLI — apps, themes, stores, extensions, and deploy workflows"
+  homepage: "https://shopify.dev/docs/api/shopify-cli"
+  tags: [commerce, shopify, apps]
+  json_flag: "--json"
+  install:
+    default: "npm install -g @shopify/cli"
+
+- name: suno
+  binary: suno
+  description: "Suno music generation harness"
+  tags: [music, audio, generation]
+
+- name: unimol_tools
+  binary: unimol_tools
+  description: "Uni-Mol molecular modeling toolkit"
+  homepage: "https://github.com/deepmodeling/Uni-Mol"
+  tags: [chemistry, molecular, ai]
+  install:
+    default: "pip install unimol-tools"
+
+- name: unrealinsights
+  binary: UnrealInsights
+  description: "Unreal Insights profiling and trace analysis"
+  homepage: "https://dev.epicgames.com/documentation/unreal-engine/unreal-insights-in-unreal-engine"
+  tags: [unreal, profiling, game-dev]
+
+- name: videocaptioner
+  binary: videocaptioner
+  description: "Video captioning workflow harness"
+  tags: [video, captions, transcription]