@zenalexa/unicli 0.207.1

package/src/adapters/douyin/draft.ts

@@ -0,0 +1,201 @@
+/**
+ * Douyin draft — upload a video through the official creator page and save as draft.
+ *
+ * Drives the official upload page via browser automation so it stays
+ * aligned with the site.
+ */
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { cli, Strategy } from "../../registry.js";
+import type { IPage } from "../../types.js";
+
+const VISIBILITY_LABELS: Record<string, string> = {
+  public: "\u516c\u5f00",
+  friends: "\u597d\u53cb\u53ef\u89c1",
+  private: "\u4ec5\u81ea\u5df1\u53ef\u89c1",
+};
+
+const DRAFT_UPLOAD_URL =
+  "https://creator.douyin.com/creator-micro/content/upload";
+
+cli({
+  site: "douyin",
+  name: "draft",
+  description: "Upload a video and save as draft on Douyin",
+  domain: "creator.douyin.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    {
+      name: "video",
+      required: true,
+      positional: true,
+      description: "Video file path",
+    },
+    {
+      name: "title",
+      required: true,
+      description: "Video title (max 30 chars)",
+    },
+    {
+      name: "caption",
+      default: "",
+      description: "Caption text (max 1000 chars)",
+    },
+    { name: "cover", default: "", description: "Cover image path" },
+    {
+      name: "visibility",
+      default: "public",
+      choices: ["public", "friends", "private"],
+      description: "Visibility setting",
+    },
+  ],
+  columns: ["status", "draft_id"],
+  func: async (page, kwargs) => {
+    const p = page as IPage;
+    const videoPath = path.resolve(kwargs.video as string);
+    if (!fs.existsSync(videoPath)) {
+      throw new Error(`Video file not found: ${videoPath}`);
+    }
+    const ext = path.extname(videoPath).toLowerCase();
+    if (![".mp4", ".mov", ".avi", ".webm"].includes(ext)) {
+      throw new Error(
+        `Unsupported video format: ${ext} (supported: mp4/mov/avi/webm)`,
+      );
+    }
+
+    const title = kwargs.title as string;
+    if (title.length > 30) throw new Error("Title must be <= 30 characters");
+
+    const caption = (kwargs.caption as string) || "";
+    if (caption.length > 1000)
+      throw new Error("Caption must be <= 1000 characters");
+
+    const visibilityLabel =
+      VISIBILITY_LABELS[(kwargs.visibility as string) ?? "public"] ??
+      VISIBILITY_LABELS.public;
+
+    // Navigate and upload
+    await p.goto(DRAFT_UPLOAD_URL);
+    await p.waitForSelector('input[type="file"]', 20);
+
+    // Dismiss known modals
+    await p.evaluate(`() => {
+      const targets = ['我知道了', '知道了', '关闭'];
+      for (const text of targets) {
+        const btn = Array.from(document.querySelectorAll('button,[role="button"]'))
+          .find((el) => (el.textContent || '').trim() === text);
+        if (btn instanceof HTMLElement) btn.click();
+      }
+    }`);
+
+    await p.setFileInput('input[type="file"]', [videoPath]);
+
+    // Wait for composer
+    for (let attempt = 0; attempt < 120; attempt++) {
+      const ready = (await p.evaluate(`() => ({
+        ready: !!Array.from(document.querySelectorAll('input')).find(
+          (el) => (el.placeholder || '').includes('填写作品标题')
+        ) && !!Array.from(document.querySelectorAll('button')).find(
+          (el) => (el.textContent || '').includes('暂存离开')
+        )
+      })`)) as { ready: boolean };
+      if (ready.ready) break;
+      await p.wait(0.5);
+    }
+
+    // Fill title via React props
+    await p.evaluate(`() => {
+      const titleInput = Array.from(document.querySelectorAll('input')).find(
+        (el) => (el.placeholder || '').includes('填写作品标题')
+      );
+      if (!(titleInput instanceof HTMLInputElement)) return false;
+      const propKey = Object.keys(titleInput).find((key) => key.startsWith('__reactProps$'));
+      const props = propKey ? titleInput[propKey] : null;
+      if (props?.onChange) {
+        props.onChange({ target: { value: ${JSON.stringify(title)} }, currentTarget: { value: ${JSON.stringify(title)} } });
+      } else {
+        titleInput.focus();
+        titleInput.value = ${JSON.stringify(title)};
+        titleInput.dispatchEvent(new Event('input', { bubbles: true }));
+        titleInput.dispatchEvent(new Event('change', { bubbles: true }));
+      }
+      return true;
+    }`);
+
+    // Fill caption
+    if (caption) {
+      await p.evaluate(`() => {
+        const editor = document.querySelector('[contenteditable="true"]');
+        if (!(editor instanceof HTMLElement)) return false;
+        editor.focus();
+        editor.textContent = '';
+        document.execCommand('selectAll', false);
+        document.execCommand('insertText', false, ${JSON.stringify(caption)});
+        editor.dispatchEvent(new Event('input', { bubbles: true }));
+        return true;
+      }`);
+    }
+
+    // Set visibility
+    await p.evaluate(`() => {
+      const visibility = Array.from(document.querySelectorAll('label')).find(
+        (el) => (el.textContent || '').includes(${JSON.stringify(visibilityLabel)})
+      );
+      if (visibility instanceof HTMLElement) visibility.click();
+    }`);
+
+    // Upload cover if provided
+    if (kwargs.cover) {
+      const coverPath = path.resolve(kwargs.cover as string);
+      if (!fs.existsSync(coverPath)) {
+        throw new Error(`Cover file not found: ${coverPath}`);
+      }
+      // Click "upload new cover" label
+      await p.evaluate(`() => {
+        const coverLabel = Array.from(document.querySelectorAll('label')).find(
+          (el) => (el.textContent || '').includes('上传新封面')
+        );
+        if (coverLabel instanceof HTMLElement) coverLabel.click();
+      }`);
+      await p.wait(1);
+
+      // Find and inject cover file
+      const coverInputs = (await p.evaluate(
+        `() => Array.from(document.querySelectorAll('input[type="file"]')).length`,
+      )) as number;
+      if (coverInputs > 1) {
+        // Use the last file input (likely the cover one)
+        await p.setFileInput('input[type="file"]:last-of-type', [coverPath]);
+        await p.wait(3);
+      }
+    }
+
+    await p.wait(1);
+
+    // Click save draft button
+    const saveResult = (await p.evaluate(`() => {
+      const btn = Array.from(document.querySelectorAll('button')).find(
+        (el) => (el.textContent || '').includes('暂存离开')
+      );
+      if (!(btn instanceof HTMLButtonElement)) return { ok: false };
+      btn.click();
+      return { ok: true };
+    }`)) as { ok: boolean };
+
+    if (!saveResult.ok) {
+      throw new Error("Could not find draft save button");
+    }
+
+    // Wait for confirmation
+    await p.wait(3);
+
+    return [
+      {
+        status: "Draft saved — continue editing in creator center",
+        draft_id: title,
+      },
+    ];
+  },
+});

package/src/adapters/douyin/drafts.ts

@@ -0,0 +1,45 @@
+/**
+ * Douyin drafts — list draft videos from the creator center.
+ */
+
+import { cli, Strategy } from "../../registry.js";
+import type { IPage } from "../../types.js";
+import { browserFetch } from "./_shared/browser-fetch.js";
+
+cli({
+  site: "douyin",
+  name: "drafts",
+  description: "List Douyin draft videos",
+  domain: "creator.douyin.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    {
+      name: "limit",
+      type: "int",
+      default: 20,
+      description: "Number of results",
+    },
+  ],
+  columns: ["aweme_id", "title", "create_time"],
+  func: async (page, kwargs) => {
+    const p = page as IPage;
+    const url =
+      "https://creator.douyin.com/web/api/media/aweme/draft/?aid=1128";
+    const res = (await browserFetch(p, "GET", url)) as {
+      aweme_list: Array<{
+        aweme_id: string;
+        desc: string;
+        create_time: number;
+      }>;
+    };
+    const items = (res.aweme_list ?? []).slice(0, kwargs.limit as number);
+    return items.map((v) => ({
+      aweme_id: v.aweme_id,
+      title: v.desc,
+      create_time: new Date(v.create_time * 1000).toLocaleString("zh-CN", {
+        timeZone: "Asia/Shanghai",
+      }),
+    }));
+  },
+});

package/src/adapters/douyin/hashtag.ts

@@ -0,0 +1,112 @@
+/**
+ * Douyin hashtag — search, AI-suggest, and hot topics from the creator center.
+ *
+ * Three actions:
+ *   - search: keyword-based hashtag lookup
+ *   - suggest: AI-recommended hashtags (optionally based on a cover image URI)
+ *   - hot: trending hotspot words
+ */
+
+import { cli, Strategy } from "../../registry.js";
+import type { IPage } from "../../types.js";
+import { browserFetch } from "./_shared/browser-fetch.js";
+
+cli({
+  site: "douyin",
+  name: "hashtag",
+  description: "Search, suggest, or list hot Douyin hashtags",
+  domain: "creator.douyin.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    {
+      name: "action",
+      required: true,
+      positional: true,
+      description:
+        "search=keyword search, suggest=AI recommend, hot=trending hotspot words",
+    },
+    {
+      name: "keyword",
+      default: "",
+      description: "Search keyword (for search/hot actions)",
+    },
+    {
+      name: "cover",
+      default: "",
+      description: "Cover URI (for suggest action)",
+    },
+    { name: "limit", type: "int", default: 10, description: "Max results" },
+  ],
+  columns: ["name", "id", "view_count"],
+  func: async (page, kwargs) => {
+    const p = page as IPage;
+    const action = kwargs.action as string;
+    const limit = Number(kwargs.limit) || 10;
+
+    if (action === "search") {
+      const keyword = encodeURIComponent(String(kwargs.keyword ?? ""));
+      const url = `https://creator.douyin.com/aweme/v1/challenge/search/?keyword=${keyword}&count=${limit}&aid=1128`;
+      const res = (await browserFetch(p, "GET", url)) as {
+        challenge_list: Array<{
+          challenge_info: {
+            cid: string;
+            cha_name: string;
+            view_count: number;
+          };
+        }>;
+      };
+      return (res.challenge_list ?? []).map((c) => ({
+        name: c.challenge_info.cha_name,
+        id: c.challenge_info.cid,
+        view_count: c.challenge_info.view_count,
+      }));
+    }
+
+    if (action === "suggest") {
+      const cover = encodeURIComponent(String(kwargs.cover ?? ""));
+      const url = `https://creator.douyin.com/web/api/media/hashtag/rec/?cover_uri=${cover}&aid=1128`;
+      const res = (await browserFetch(p, "GET", url)) as {
+        hashtag_list: Array<{
+          name: string;
+          id: string;
+          view_count: number;
+        }>;
+      };
+      return (res.hashtag_list ?? []).map((h) => ({
+        name: h.name,
+        id: h.id,
+        view_count: h.view_count,
+      }));
+    }
+
+    if (action === "hot") {
+      const kw = String(kwargs.keyword ?? "");
+      const url = `https://creator.douyin.com/aweme/v1/hotspot/recommend/?${kw ? `keyword=${encodeURIComponent(kw)}&` : ""}aid=1128`;
+      const res = (await browserFetch(p, "GET", url)) as {
+        hotspot_list?: Array<{ sentence: string; hot_value: number }>;
+        all_sentences?: Array<{
+          sentence_id?: string;
+          word?: string;
+          hot_value: number;
+        }>;
+      };
+      const items =
+        res.hotspot_list ??
+        res.all_sentences?.map((h) => ({
+          sentence: h.word ?? "",
+          hot_value: h.hot_value,
+          sentence_id: h.sentence_id ?? "",
+        })) ??
+        [];
+      return items.slice(0, limit).map((h) => ({
+        name: h.sentence,
+        id:
+          "sentence_id" in h ? (h as { sentence_id: string }).sentence_id : "",
+        view_count: h.hot_value,
+      }));
+    }
+
+    throw new Error(`Unknown action: ${action}. Use search, suggest, or hot.`);
+  },
+});

package/src/adapters/douyin/location.ts

@@ -0,0 +1,46 @@
+/**
+ * Douyin location — search POI (Point of Interest) locations for video tagging.
+ */
+
+import { cli, Strategy } from "../../registry.js";
+import type { IPage } from "../../types.js";
+import { browserFetch } from "./_shared/browser-fetch.js";
+
+cli({
+  site: "douyin",
+  name: "location",
+  description: "Search Douyin POI locations for video tagging",
+  domain: "creator.douyin.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [
+    {
+      name: "query",
+      required: true,
+      positional: true,
+      description: "Location keyword",
+    },
+    { name: "limit", type: "int", default: 20, description: "Max results" },
+  ],
+  columns: ["poi_id", "name", "address", "city"],
+  func: async (page, kwargs) => {
+    const p = page as IPage;
+    const keyword = encodeURIComponent(String(kwargs.query));
+    const limit = Number(kwargs.limit) || 20;
+    const url = `https://creator.douyin.com/aweme/v1/life/video_api/search/poi/?keyword=${keyword}&count=${limit}&aid=1128`;
+    const res = (await browserFetch(p, "GET", url)) as {
+      poi_list: Array<{
+        poi_id: string;
+        poi_name: string;
+        address: string;
+        city_name: string;
+      }>;
+    };
+    return (res.poi_list ?? []).map((poi) => ({
+      poi_id: poi.poi_id,
+      name: poi.poi_name,
+      address: poi.address,
+      city: poi.city_name,
+    }));
+  },
+});

package/src/adapters/douyin/profile.ts

@@ -0,0 +1,58 @@
+/**
+ * Douyin profile — fetch account info from the creator center API.
+ */
+
+import { cli, Strategy } from "../../registry.js";
+import type { IPage } from "../../types.js";
+import { browserFetch } from "./_shared/browser-fetch.js";
+
+cli({
+  site: "douyin",
+  name: "profile",
+  description: "Get Douyin account info",
+  domain: "creator.douyin.com",
+  strategy: Strategy.COOKIE,
+  browser: true,
+  args: [],
+  columns: [
+    "uid",
+    "nickname",
+    "follower_count",
+    "following_count",
+    "aweme_count",
+  ],
+  func: async (page, _kwargs) => {
+    const p = page as IPage;
+    const url = "https://creator.douyin.com/web/api/media/user/info/?aid=1128";
+    const res = (await browserFetch(p, "GET", url)) as {
+      user_info?: {
+        uid: string;
+        nickname: string;
+        follower_count: number;
+        following_count: number;
+        aweme_count: number;
+      };
+      user?: {
+        uid: string;
+        nickname: string;
+        follower_count: number;
+        following_count: number;
+        aweme_count: number;
+      };
+    };
+    const u = res.user_info ?? res.user;
+    if (!u)
+      throw new Error(
+        "Failed to get user info — are you logged into creator.douyin.com?",
+      );
+    return [
+      {
+        uid: u.uid,
+        nickname: u.nickname,
+        follower_count: u.follower_count,
+        following_count: u.following_count,
+        aweme_count: u.aweme_count,
+      },
+    ];
+  },
+});