publishport-opencli 1.0.0

package/clis/tieba/search.js

@@ -0,0 +1,54 @@
+import{ArgumentError as F,EmptyResultError as H}from"@jackwener/opencli/errors";import{cli as I,Strategy as J}from"@jackwener/opencli/registry";import{buildTiebaSearchItems as K,normalizeTiebaLimit as L}from"./utils.js";const z="1";function Q(f){return`
+    (async () => {
+      const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+      const waitFor = async (predicate, timeoutMs = 5000) => {
+        const start = Date.now();
+        while (Date.now() - start < timeoutMs) {
+          if (predicate()) return true;
+          await wait(100);
+        }
+        return false;
+      };
+      const getVueProps = (element) => {
+        const vue = element && element.__vue__ ? element.__vue__ : null;
+        return vue ? (vue._props || vue.$props || {}) : {};
+      };
+      await waitFor(() => {
+        const bodyText = document.body?.innerText || '';
+        return Boolean(
+          document.querySelector('.threadcardclass.thread-new3.index-feed-cards')
+          || document.querySelector('.search-no-result, .search-nodata, .no-result')
+          || /百度安全验证|安全验证|请完成验证/.test(bodyText)
+        );
+      });
+      const items = document.querySelectorAll('.threadcardclass.thread-new3.index-feed-cards');
+      return Array.from(items).slice(0, ${f}).map((item) => {
+        const forum = item.querySelector('.forum-name-text, .forum-name')?.textContent?.trim() || '';
+        const meta = item.querySelector('.user-forum-info')?.textContent?.replace(/\\s+/g, ' ').trim() || '';
+        const metaWithoutForum = forum && meta.startsWith(forum)
+          ? meta.slice(forum.length).trim()
+          : meta;
+        const metaMatch = metaWithoutForum.match(/^(.*?)\\s*发布于\\s*(.+)$/);
+        const actionBar = item.querySelector('.action-bar-container.search-action-bar');
+        const businessInfo = getVueProps(actionBar).businessInfo || {};
+        const href = item.querySelector('a[href*="/p/"]')?.href || '';
+        const threadId = String(businessInfo.thread_id || '').trim();
+        const title = item.querySelector('.title-wrap')?.textContent?.trim()
+          || item.querySelector('.title-content-wrap')?.textContent?.trim()
+          || '';
+        const snippet = item.querySelector('.title-content-wrap')?.textContent?.trim()
+          || item.querySelector('.abstract-wrap')?.textContent?.trim()
+          || '';
+
+        return {
+          title,
+          forum,
+          author: metaMatch ? metaMatch[1].trim() : metaWithoutForum,
+          time: metaMatch ? metaMatch[2].trim() : '',
+          snippet: snippet.substring(0, 200),
+          id: threadId,
+          url: href || (threadId ? 'https://tieba.baidu.com/p/' + threadId : ''),
+        };
+      }).filter((item) => item.title);
+    })()
+  `}function V(f){const j=String(f.keyword||""),q=Number(f.page||1);return`https://tieba.baidu.com/f/search/res?qw=${encodeURIComponent(j)}&ie=utf-8&pn=${q}`}function W(f){if(String(f.page||1)===z)return;throw new F(`tieba search currently only supports --page ${z}`,`Baidu Tieba search no longer exposes stable browser pagination; omit --page or use --page ${z}`)}I({site:"tieba",name:"search",access:"read",description:"Search posts across tieba",domain:"tieba.baidu.com",strategy:J.COOKIE,browser:!0,navigateBefore:!1,args:[{name:"keyword",positional:!0,required:!0,type:"string",help:"Search keyword"},{name:"page",type:"int",default:1,choices:["1"],help:"Page number (currently only 1 is supported)"},{name:"limit",type:"int",default:20,help:"Number of items to return"}],columns:["rank","id","title","forum","author","time","url"],func:async(f,j)=>{W(j);const q=L(j.limit);await f.goto(V(j));const B=await f.evaluate(Q(q)),C=K(Array.isArray(B)?B:[],q);if(!C.length)throw new H("tieba search","Tieba may have blocked the result page, or the DOM structure may have changed");return C}});

package/clis/tieba/utils.js

@@ -0,0 +1 @@
+import{createHash as q}from"node:crypto";export const MAX_TIEBA_LIMIT=20;const B="36770b1f34c9bbf2e7d1a99d2b82fa9e",S="Asia/Shanghai";export function normalizeTiebaLimit(j,K=MAX_TIEBA_LIMIT){const Q=Number(j??K);if(!Number.isFinite(Q)||Q<1)return K;return Math.min(Math.trunc(Q),MAX_TIEBA_LIMIT)}export function normalizeText(j){return typeof j==="string"?j.replace(/\s+/g," ").trim():""}export function signTiebaPcParams(j){const K=Object.keys(j).sort((Q,J)=>Q.localeCompare(J)).map((Q)=>`${Q}=${j[Q]}`).join("")+B;return q("md5").update(K).digest("hex")}export function parseTiebaCount(j){const K=normalizeText(j).toUpperCase();if(!K)return 0;const Q=K.replace(/[^\d.W万]/g,"");if(Q.endsWith("万"))return Math.round(parseFloat(Q.slice(0,-1))*1e4);if(Q.endsWith("W"))return Math.round(parseFloat(Q.slice(0,-1))*1e4);return parseInt(Q.replace(/[^\d]/g,""),10)||0}export function parseTiebaLastReply(j){const K=normalizeText(j).replace(/^回复于/,"").trim(),Q=K.match(/(刚刚|\d+\s*(?:分钟|小时|天)前|\d{2}-\d{2}(?:\s+\d{2}:\d{2})?|\d{4}-\d{2}-\d{2}(?:\s+\d{2}:\d{2})?)/);return Q?Q[1].trim():K}function N(j,K){const Q=normalizeText(K);if(Q)return Q;return j?`https://tieba.baidu.com/p/${j}`:""}function R(j){const K=normalizeText(j.threadId);if(K)return K;const Q=normalizeText(j.url).match(/\/p\/(\d+)/);return Q?Q[1]:""}function H(j,K){const J=(Array.isArray(j?.components)?j.components:[]).find((W)=>normalizeText(W.component)===K);if(!J)return{};const V=J[K];return V&&typeof V==="object"?V:{}}function E(j){const K=H(j,"feed_head"),Q=Array.isArray(K.main_data)?K.main_data:[];for(const J of Q){const V=J.text,W=normalizeText(V?.text);if(W)return W}return""}function A(j){const K=H(j,"feed_title"),V=(Array.isArray(K.data)?K.data:[])[0]?.text_info;return normalizeText(V?.text)||normalizeText(j?.business_info_map?.title)}function M(j){const K=H(j,"feed_social"),Q=Number(K.comment_num??j?.business_info_map?.comment_num??0);return Number.isFinite(Q)?Q:0}function k(j){const K=normalizeText(j?.business_info_map?.thread_id);if(K)return K;const Q=Array.isArray(j?.log_param)?j.log_param:[],J=normalizeText(Q.find((W)=>normalizeText(W?.key)==="tid")?.value);if(J)return J;const V=normalizeText(j?.schema).match(/[?&]tid=(\d+)/);return V?V[1]:""}function _(j){const K=H(j,"feed_head"),J=(Array.isArray(K.extra_data)?K.extra_data:[])[0],V=normalizeText(J?.business_info_map?.time_prefix),W=J?.text,Y=normalizeText(W?.text),$=/^\d+$/.test(Y)?X(Y):Y;return[V,$].filter(Boolean).join("")}export function buildTiebaPostCardsFromPagePc(j){return j.filter((K)=>normalizeText(K.layout)==="feed"&&K.feed).map((K)=>{const Q=K.feed,J=k(Q);return{title:A(Q),author:E(Q),descInfo:_(Q),commentCount:M(Q),actionTexts:[],threadId:J,url:N(J)}}).filter((K)=>normalizeText(K.title))}export function buildTiebaPostItems(j,K){const Q=normalizeTiebaLimit(K);return j.map((J)=>{const V=normalizeText(J.title),W=R(J),Y=Array.isArray(J.actionTexts)?J.actionTexts.map(normalizeText).filter(Boolean):[],$=Y.find((D)=>/评论/.test(D))||Y[Y.length-1]||"";return{title:V,author:normalizeText(J.author),replies:Number.isFinite(Number(J.commentCount))?Number(J.commentCount):parseTiebaCount($),last_reply:parseTiebaLastReply(String(J.descInfo??"")),id:W,url:N(W,J.url)}}).filter((J)=>J.title).slice(0,Q).map((J,V)=>({rank:V+1,...J}))}export function buildTiebaSearchItems(j,K){const Q=normalizeTiebaLimit(K);return j.map((J)=>{const V=normalizeText(J.url),W=normalizeText(J.id),Y=V.match(/\/p\/(\d+)/)?.[1]||"";return{title:normalizeText(J.title),forum:normalizeText(J.forum),author:normalizeText(J.author),time:normalizeText(J.time),snippet:normalizeText(J.snippet).slice(0,200),id:W||Y,url:V}}).filter((J)=>J.title).slice(0,Q).map((J,V)=>({rank:V+1,...J}))}function X(j){const K=Number(j||0);if(!Number.isFinite(K)||K<=0)return"";const Q=new Intl.DateTimeFormat("sv-SE",{timeZone:S,year:"numeric",month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit",hour12:!1}).formatToParts(new Date(K*1000)),J=Object.fromEntries(Q.map((V)=>[V.type,V.value]));return`${J.year}-${J.month}-${J.day} ${J.hour}:${J.minute}`}function g(j){const Q=normalizeText(j).replace(/^第\d+楼\s+/,"").trim(),J=Q.match(/^(刚刚|昨天|前天|\d+\s*(?:分钟|小时|天)前|\d{2}-\d{2}(?:\s+\d{2}:\d{2})?|\d{4}-\d{2}-\d{2}(?:\s+\d{2}:\d{2})?)/);return J?J[1].trim():Q}function U(j){if(!j)return null;const K=normalizeText(j.title),Q=normalizeText(j.author)||normalizeText(j.fallbackAuthor),J=normalizeText(j.contentText)||normalizeText(j.structuredText),V=Boolean(j.hasMedia),W=[K,J||(V?"[media]":"")].filter(Boolean).join(" ").trim();if(!W)return null;return{floor:1,author:Q,content:W,time:normalizeText(j.visibleTime)||X(j.structuredTime)}}export function buildTiebaReadItems(j,K={}){const Q=Number.isFinite(Number(K.limit))?Number(K.limit):30,J=Math.max(1,Math.trunc(Q)),V=K.includeMainPost!==!1,W=[],Y=U(j.mainPost);if(V&&Y)W.push(Y);const $=Array.isArray(j.replies)?j.replies:[],D=[];for(const G of $){const O=Number(G.floor||0),Z=normalizeText(G.content);if(!Number.isFinite(O)||O<1||!Z)continue;D.push({floor:O,author:normalizeText(G.author),content:Z,time:g(String(G.time??""))})}return W.concat(D.slice(0,J))}

package/clis/tiktok/auth.js

@@ -0,0 +1,30 @@
+import{AuthRequiredError as n,CommandExecutionError as c}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as u}from"../_shared/site-auth.js";async function s(e){const t=await e.getCookies({url:"https://www.tiktok.com"}),i=new Set(t.filter((o)=>o.value).map((o)=>o.name));return i.has("sessionid")||i.has("sid_tt")||i.has("uid_tt")}async function r(e){if(!await s(e))throw new n("www.tiktok.com","TikTok session cookies (sessionid/sid_tt/uid_tt) missing");await e.goto("https://www.tiktok.com/foryou");await e.wait(2);const t=await e.evaluate(`
+    (() => {
+      const raw = document.querySelector('script[id="__UNIVERSAL_DATA_FOR_REHYDRATION__"]')?.textContent;
+      if (!raw) return null;
+      let data;
+      try { data = JSON.parse(raw); } catch { return null; }
+      const scope = data?.['__DEFAULT_SCOPE__'] || {};
+      const seen = new Set();
+      const stack = [scope];
+      while (stack.length) {
+        const node = stack.pop();
+        if (!node || typeof node !== 'object' || seen.has(node)) continue;
+        seen.add(node);
+        if (Array.isArray(node)) { stack.push(...node); continue; }
+        const u = node.user;
+        if (u && typeof u === 'object') {
+          const isMe = Boolean(u.isOwner || u.is_owner || u.isCurrentUser);
+          if (isMe && (u.secUid || u.sec_uid)) {
+            return {
+              sec_uid: String(u.secUid || u.sec_uid),
+              username: String(u.uniqueId || u.unique_id || u.username || ''),
+              nickname: String(u.nickname || u.nickName || ''),
+            };
+          }
+        }
+        for (const v of Object.values(node)) if (v && typeof v === 'object') stack.push(v);
+      }
+      return null;
+    })()
+  `);if(!t?.sec_uid)throw new n("www.tiktok.com","TikTok universal data has no owner user — identity not rehydrated");return{sec_uid:t.sec_uid,username:t.username,nickname:t.nickname}}u({site:"tiktok",domain:"tiktok.com",loginUrl:"https://www.tiktok.com/login",columns:["sec_uid","username","nickname"],quickCheck:s,verify:r,poll:async(e)=>{if(!await s(e))throw new n("www.tiktok.com","Waiting for TikTok session cookies");return r(e)}});

package/clis/tiktok/comment.js

@@ -0,0 +1,69 @@
+import{cli as c,Strategy as m}from"@jackwener/opencli/registry";import{BROWSER_HELPERS as l,BUTTON_WALKER_HELPERS as u,RETRYABLE_HINTS as d,parseTikTokVideoUrl as p,requireCommentText as T,throwButtonWalkerError as h}from"./utils.js";function a(e){return`
+(async () => {
+  const commentText = ${JSON.stringify(e)};
+
+  ${l}
+  ${u}
+
+  ensureLoggedInOrThrow();
+  ensureNoRateLimitOrThrow();
+
+  // Expand the comment panel if it is collapsed (vertical feed pages).
+  const commentIcon = document.querySelector('[data-e2e="comment-icon"]');
+  if (commentIcon) {
+    const cBtn = commentIcon.closest('button') || commentIcon.closest('[role="button"]') || commentIcon;
+    cBtn.click();
+    await waitFor(() => Boolean(
+      document.querySelector('[data-e2e="comment-input"] [contenteditable="true"]')
+    ), { timeoutMs: 4000 });
+  }
+
+  const beforeCount = document.querySelectorAll('[data-e2e="comment-level-1"]').length;
+
+  const input = document.querySelector('[data-e2e="comment-input"] [contenteditable="true"]')
+    || document.querySelector('[contenteditable="true"]');
+  if (!input) {
+    throw new Error('BUTTON_NOT_FOUND: comment input not found (page not rendered, comments disabled, or selectors changed)');
+  }
+
+  input.focus();
+  // execCommand is deprecated but still the only reliable way to inject
+  // text into TikTok's contenteditable so its React tree picks up the
+  // value; replicating with InputEvent fires but TikTok ignores it.
+  document.execCommand('insertText', false, commentText);
+
+  // Wait for the post button to become enabled — TikTok disables it
+  // until non-empty text is detected by their input handler.
+  const postReady = await waitFor(() => {
+    const candidate = findButtonByText(['Post', '发布', '发送']);
+    if (!candidate) return false;
+    const ariaDisabled = candidate.getAttribute && candidate.getAttribute('aria-disabled');
+    return !candidate.disabled && ariaDisabled !== 'true';
+  }, { timeoutMs: 4000 });
+  if (!postReady) {
+    ensureNoRateLimitOrThrow();
+    throw new Error('BUTTON_NOT_FOUND: Post button never became enabled (text not registered or selectors changed)');
+  }
+
+  const postBtn = findButtonByText(['Post', '发布', '发送']);
+  postBtn.click();
+
+  // State verification: a new comment-level-1 element should appear.
+  const flipped = await waitFor(
+    () => document.querySelectorAll('[data-e2e="comment-level-1"]').length > beforeCount,
+    { timeoutMs: 8000 },
+  );
+  if (!flipped) {
+    ensureNoRateLimitOrThrow();
+    throw new Error('STATE_VERIFY_FAIL: comment count did not increase within 8s; comment may or may not have been recorded server-side');
+  }
+
+  ensureNoRateLimitOrThrow();
+
+  return [{
+    url: location.href,
+    text: commentText,
+    result: 'posted',
+  }];
+})()
+`}async function w(e,r){const{url:o}=p(r.url),s=T(r.text),i=(n)=>h(n,{authMessage:"TikTok requires login to post comments",failureMessage:`Failed to post comment on ${o}`,retryableHint:d.commentFailure});let t;try{await e.goto(o,{waitUntil:"load",settleMs:6000});t=await e.evaluate(a(s))}catch(n){i(n)}if(!Array.isArray(t)||t.length===0)i(Error(`STATE_VERIFY_FAIL: comment returned no row for ${o}`));return t}export const commentCommand=c({site:"tiktok",name:"comment",access:"write",description:"Post a comment on a TikTok video",domain:"www.tiktok.com",strategy:m.COOKIE,browser:!0,args:[{name:"url",required:!0,positional:!0,help:"TikTok video URL (https://www.tiktok.com/@user/video/<id>)"},{name:"text",required:!0,positional:!0,help:"Comment text (≤150 chars)"}],columns:["url","text","result"],func:w}),__test__={buildCommentScript:a};

package/clis/tiktok/creator-videos.js

@@ -0,0 +1,45 @@
+import{cli as V,Strategy as R}from"@jackwener/opencli/registry";import{ArgumentError as j,AuthRequiredError as G,CommandExecutionError as $,EmptyResultError as T,getErrorMessage as _}from"@jackwener/opencli/errors";const F="https://www.tiktok.com/tiktokstudio/content",A="/tiktok/creator/manage/item_list/v1/",y=20,N=250,P=50;function U(B,J,W,Q){const Z=Number(B??W);if(!Number.isInteger(Z)||Z<=0)throw new j(`${J} must be a positive integer`,`Example: opencli tiktok creator-videos --${J} ${W}`);if(Z>Q)throw new j(`${J} must be <= ${Q}`,`Example: opencli tiktok creator-videos --${J} ${Q}`);return Z}function O(B){const W=String(B??"0").trim();if(!/^\d+$/.test(W))throw new j("cursor must be a non-negative integer string","Example: opencli tiktok creator-videos --cursor 0");const Q=Number(W);if(!Number.isSafeInteger(Q))throw new j("cursor must be a safe integer","Example: opencli tiktok creator-videos --cursor 0");return Q}function h(B,J){return{cursor:B,size:J,query:{conditions:[],sort_orders:[{field_name:"create_time",order:2}]}}}function q(B){const J={url:`${A}?aid=1988`,body:B};return`
+(async () => {
+  const request = ${JSON.stringify(J)};
+  try {
+    const res = await fetch(request.url, {
+      method: 'POST',
+      credentials: 'include',
+      headers: {
+        accept: 'application/json',
+        'content-type': 'application/json',
+      },
+      body: JSON.stringify(request.body),
+    });
+    const text = await res.text();
+    let data = null;
+    if (text.trim()) {
+      try {
+        data = JSON.parse(text);
+      } catch (error) {
+        return {
+          ok: false,
+          status: res.status,
+          statusText: res.statusText,
+          parseError: error instanceof Error ? error.message : String(error),
+          text: text.slice(0, 500),
+        };
+      }
+    }
+    return {
+      ok: res.ok,
+      status: res.status,
+      statusText: res.statusText,
+      data,
+      text: text.slice(0, 500),
+    };
+  } catch (error) {
+    return {
+      ok: false,
+      status: 0,
+      statusText: '',
+      networkError: error instanceof Error ? error.message : String(error),
+    };
+  }
+})()
+`}function S(B){return/\b(auth|login|log in|permission|unauthori[sz]ed|forbidden)\b/i.test(B)}function M(B){if(!B||typeof B!=="object")throw new $("TikTok Studio item_list returned an empty response");return B.data&&typeof B.data==="object"?B.data:B}function b(B){const J=B.status_code??B.statusCode,W=String(B.status_msg??B.statusMsg??"").trim();if(J!==void 0&&Number(J)!==0){if(S(W))throw new G("www.tiktok.com",`TikTok Studio item_list requires login: ${W||J}`);throw new $(`TikTok Studio item_list failed: ${W||J}`)}if(W&&!/^(success|ok)$/i.test(W)){if(S(W))throw new G("www.tiktok.com",`TikTok Studio item_list requires login: ${W}`);throw new $(`TikTok Studio item_list failed: ${W}`)}}function H(B){const J=Number(B);return Number.isFinite(J)?J:0}function C(B){const J=Number(B);if(!Number.isFinite(J)||J<=0)return"";return new Date(J*1000).toLocaleString("zh-CN",{timeZone:"Asia/Shanghai",hour12:!1})}function v(B){const J=B.author?.unique_id??B.author?.uniqueId??B.author_unique_id??B.authorUniqueId??B.user_name??B.username;if(J)return String(J);const W=[...Array.isArray(B.play_addr)?B.play_addr:[],...B.download_info&&Array.isArray(B.download_info.download_urls)?B.download_info.download_urls:[]];for(const Q of W)try{const Y=String(Q).match(/[?&]user_text=([^&]+)/);if(Y)return decodeURIComponent(Y[1])}catch{}return""}function z(B){if(!B||typeof B!=="object")return null;const J=String(B.item_id??B.id??"").trim();if(!J)return null;const W=v(B),Q=W?`https://www.tiktok.com/@${encodeURIComponent(W)}/video/${encodeURIComponent(J)}`:"";return{video_id:J,title:String(B.desc??B.title??"").replace(/\s+/g," ").trim(),date:C(B.post_time??B.create_time??B.schedule_time),views:H(B.play_count),likes:H(B.like_count),comments:H(B.comment_count),saves:H(B.favorite_count),shares:H(B.share_count),url:Q}}async function x(B,J,W){const Q=await B.evaluate(q(h(J,W))).catch((Z)=>{throw new $(`Failed to fetch TikTok Studio item_list: ${_(Z)}`)});if(!Q||typeof Q!=="object")throw new $("TikTok Studio item_list returned an unreadable response");if(Q.networkError)throw new $(`TikTok Studio item_list network failure: ${Q.networkError}`);if(Q.status===401||Q.status===403)throw new G("www.tiktok.com",`TikTok Studio item_list requires login (HTTP ${Q.status})`);if(!Q.ok){const Z=Q.parseError?`invalid JSON (${Q.parseError})`:`HTTP ${Q.status||0}${Q.statusText?` ${Q.statusText}`:""}`;throw new $(`TikTok Studio item_list failed: ${Z}`,Q.text?`Response preview: ${Q.text}`:void 0)}const Y=M(Q.data);b(Y);return Y}async function I(B,J){const W=U(J.limit,"limit",y,N);let Q=O(J.cursor);const Y=[];let Z=0;const X=W>P?P:W,w=Math.ceil(W/X);await B.goto(F,{waitUntil:"load",settleMs:6000});for(let D=0;D<w&&Y.length<W;D+=1){const K=await x(B,Q,X),f=Array.isArray(K.item_list)?K.item_list:[];for(const L of f){const k=z(L);if(!k){Z+=1;continue}Y.push(k);if(Y.length>=W)break}if(!K.has_more||f.length===0)break;Q=O(K.cursor);await B.wait(250)}if(Y.length===0&&Z>0)throw new $("TikTok Studio item_list returned videos without stable video_id");if(Y.length===0)throw new T("tiktok creator-videos","No creator videos were returned. Confirm the current Chrome profile is logged in to TikTok Studio and has published content.");return Y.slice(0,W)}export const creatorVideosCommand=V({site:"tiktok",name:"creator-videos",access:"read",description:"TikTok Studio creator content list (views/likes/comments/saves/shares)",domain:"www.tiktok.com",strategy:R.COOKIE,browser:!0,navigateBefore:F,args:[{name:"limit",type:"int",default:y,help:`Number of creator videos to return (max ${N})`},{name:"cursor",type:"string",default:"0",help:"Non-negative TikTok Studio pagination cursor"}],columns:["video_id","title","date","views","likes","comments","saves","shares","url"],func:I}),__test__={buildFetchItemListScript:q,buildItemListRequest:h,extractUsername:v,normalizeRow:z,requireCursor:O,requirePositiveInt:U};

package/clis/tiktok/explore.js

@@ -0,0 +1,76 @@
+import{cli as m,Strategy as l}from"@jackwener/opencli/registry";import{EmptyResultError as d}from"@jackwener/opencli/errors";import{BROWSER_HELPERS as c,MAX_PAGES as u,SERVER_PAGE_MAX as p,TIKTOK_AID as f,requireLimit as w,throwTikTokPageContextError as k,VIDEO_ITEM_NORMALIZER as g}from"./utils.js";const r=20,o=120;function i(e){return`
+(async () => {
+  const limit = ${Number(e)};
+  const maxPages = ${u};
+  const SERVER_PAGE_MAX = ${p};
+  // limit was validated upfront (requireLimit). pageSize is the per-request
+  // cap TikTok accepts; we still loop until \`dedup.size < limit\` is satisfied.
+  const pageSize = limit < SERVER_PAGE_MAX ? limit : SERVER_PAGE_MAX;
+  const aid = ${JSON.stringify(f)};
+
+  ${c}
+  ${g}
+
+  function collectFromState(root) {
+    if (!root) return [];
+    const out = [];
+    walkObjects(root, (node) => {
+      if (Array.isArray(node)) return false;
+      if (Array.isArray(node.itemList)) {
+        for (const item of node.itemList) out.push(item);
+      }
+      if (Array.isArray(node.items)) {
+        for (const item of node.items) out.push(item);
+      }
+      return false;
+    });
+    return out;
+  }
+
+  const dedup = new Map();
+  const universal = findUniversalData();
+  for (const item of collectFromState(universal)) {
+    const row = normalizeVideoItem(item, dedup.size + 1);
+    if (row && !dedup.has(row.id)) dedup.set(row.id, row);
+  }
+
+  const msToken = getCookie('msToken');
+  let apiFailure = null;
+  if (dedup.size < limit) {
+    let cursor = 0;
+    for (let page = 0; page < maxPages && dedup.size < limit; page += 1) {
+      const params = new URLSearchParams({
+        aid,
+        count: String(pageSize),
+        from_page: 'fyp',
+        cursor: String(cursor),
+      });
+      if (msToken) params.set('msToken', msToken);
+      try {
+        const data = await fetchJson('/api/recommend/item_list/?' + params.toString());
+        assertTikTokApiSuccess(data, 'recommend');
+        const items = Array.isArray(data.itemList) ? data.itemList : [];
+        for (const item of items) {
+          const row = normalizeVideoItem(item, dedup.size + 1);
+          if (row && !dedup.has(row.id)) dedup.set(row.id, row);
+        }
+        if (data.hasMore !== true && items.length === 0) break;
+        cursor = asNumber(data.cursor) ?? cursor + items.length;
+      } catch (error) {
+        apiFailure = error instanceof Error ? error.message : String(error);
+        break;
+      }
+    }
+  }
+
+  const rows = Array.from(dedup.values())
+    .slice(0, limit)
+    .map((row, index) => ({ ...row, index: index + 1 }));
+
+  if (rows.length === 0) {
+    const suffix = apiFailure ? ' (recommend API failed: ' + apiFailure + ')' : '';
+    throw new Error('No videos found on /explore' + suffix);
+  }
+  return rows;
+})()
+`}async function A(e,s){const a=w(s.limit,{fallback:r,max:o});await e.goto("https://www.tiktok.com/explore",{waitUntil:"load",settleMs:5000});let t;try{t=await e.evaluate(i(a))}catch(n){k(n,{authMessage:"TikTok requires browser access to load the explore feed",emptyPattern:/No videos found/,emptyTarget:"tiktok explore",failureMessage:"Failed to load TikTok explore feed"})}if(!Array.isArray(t)||t.length===0)throw new d("tiktok explore","TikTok returned an empty recommend feed");return t}export const exploreCommand=m({site:"tiktok",name:"explore",access:"read",description:"Get trending TikTok videos from the recommend feed via page-context APIs",domain:"www.tiktok.com",strategy:l.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:r,help:`Number of videos to return (max ${o})`}],columns:["index","id","author","url","cover","title","desc","plays","likes","comments","shares","createTime"],func:A}),__test__={buildExploreScript:i,DEFAULT_LIMIT:r,MAX_LIMIT:o};

package/clis/tiktok/follow.js

@@ -0,0 +1,49 @@
+import{cli as V,Strategy as X}from"@jackwener/opencli/registry";import{BROWSER_HELPERS as Z,BUTTON_WALKER_HELPERS as $,RETRYABLE_HINTS as v,TIKTOK_HOST as D,normalizeUsername as z,throwButtonWalkerError as Y}from"./utils.js";function M(q){return`
+(async () => {
+  const username = ${JSON.stringify(q)};
+
+  ${Z}
+  ${$}
+
+  ensureLoggedInOrThrow();
+  ensureNoRateLimitOrThrow();
+
+  const FOLLOW_LABELS = ['Follow', '关注', 'フォロー'];
+  const FOLLOWING_LABELS = ['Following', '已关注', 'フォロー中'];
+  const FRIENDS_LABELS = ['Friends', '互关', 'フレンド'];
+  const ALREADY_LABELS = FOLLOWING_LABELS.concat(FRIENDS_LABELS);
+
+  // Idempotent fast path: already in target state.
+  if (buttonExists(FRIENDS_LABELS)) {
+    return [{ username, url: ${JSON.stringify(D)} + '/@' + encodeURIComponent(username), result: 'already-friends' }];
+  }
+  if (buttonExists(FOLLOWING_LABELS)) {
+    return [{ username, url: ${JSON.stringify(D)} + '/@' + encodeURIComponent(username), result: 'already-following' }];
+  }
+
+  const followBtn = findButtonByText(FOLLOW_LABELS);
+  if (!followBtn) {
+    throw new Error('BUTTON_NOT_FOUND: Follow button not on profile page (logged out, private account, or selectors changed)');
+  }
+
+  const target = followBtn.closest('button') || followBtn.closest('[role="button"]') || followBtn;
+  target.click();
+
+  // State verification: button text should flip to Following / 已关注 etc.
+  const flipped = await waitFor(() => buttonExists(ALREADY_LABELS), { timeoutMs: 5000 });
+  if (!flipped) {
+    ensureNoRateLimitOrThrow();
+    throw new Error('STATE_VERIFY_FAIL: follow button did not flip to Following within 5s; relation may not have been recorded');
+  }
+
+  // Re-check rate limit AFTER click — TikTok sometimes flashes captcha
+  // mid-flight even when the button text appears to flip.
+  ensureNoRateLimitOrThrow();
+
+  return [{
+    username,
+    url: ${JSON.stringify(D)} + '/@' + encodeURIComponent(username),
+    result: 'followed',
+  }];
+})()
+`}async function b(q,Q){const x=z(Q.username),J=(G)=>Y(G,{authMessage:"TikTok requires login to follow users",failureMessage:`Failed to follow @${x}`,retryableHint:v.relationFailure});let C;try{await q.goto(`${D}/@${encodeURIComponent(x)}`,{waitUntil:"load",settleMs:5000});C=await q.evaluate(M(x))}catch(G){J(G)}if(!Array.isArray(C)||C.length===0)J(Error(`STATE_VERIFY_FAIL: follow returned no row for @${x}`));return C}export const followCommand=V({site:"tiktok",name:"follow",access:"write",description:"Follow a TikTok user by username",domain:"www.tiktok.com",strategy:X.COOKIE,browser:!0,args:[{name:"username",required:!0,positional:!0,help:"TikTok username (without @)"}],columns:["username","url","result"],func:b}),__test__={buildFollowScript:M};

package/clis/tiktok/following.js

@@ -0,0 +1,103 @@
+import{cli as c,Strategy as d}from"@jackwener/opencli/registry";import{EmptyResultError as l}from"@jackwener/opencli/errors";import{BROWSER_HELPERS as u,MAX_PAGES as f,SERVER_PAGE_MAX as w,TIKTOK_AID as m,USER_ITEM_NORMALIZER as p,requireLimit as g,throwTikTokPageContextError as _}from"./utils.js";const i=20,t=200;function o(e){return`
+(async () => {
+  const limit = ${Number(e)};
+  const maxPages = ${f*2};
+  const SERVER_PAGE_MAX = ${w};
+  const pageSize = limit < SERVER_PAGE_MAX ? limit : SERVER_PAGE_MAX;
+  const aid = ${JSON.stringify(m)};
+
+  ${u}
+  ${p}
+
+  function findViewerSecUid(root) {
+    if (!root) return '';
+    let found = '';
+    walkObjects(root, (node) => {
+      if (Array.isArray(node)) return false;
+      const candidate = node?.user;
+      if (candidate && typeof candidate === 'object') {
+        const secUid = String(candidate.secUid || candidate.sec_uid || '').trim();
+        const isMe = Boolean(candidate.isOwner || candidate.is_owner || candidate.isCurrentUser);
+        if (secUid && isMe) {
+          found = secUid;
+          return true;
+        }
+      }
+      const direct = node?.userInfo?.user;
+      if (direct && (direct.isOwner || direct.is_owner)) {
+        const secUid = String(direct.secUid || direct.sec_uid || '').trim();
+        if (secUid) {
+          found = secUid;
+          return true;
+        }
+      }
+      return false;
+    });
+    return found;
+  }
+
+  function findViewerSecUidFromAppContext() {
+    const scope = window.__$UNIVERSAL_DATA$__?.__DEFAULT_SCOPE__;
+    const appUser = scope?.['webapp.app-context']?.user;
+    return String(appUser?.secUid || appUser?.sec_uid || '').trim();
+  }
+
+  const universal = findUniversalData();
+  let viewerSecUid = findViewerSecUid(universal) || findViewerSecUidFromAppContext();
+  const msToken = getCookie('msToken');
+
+  if (!viewerSecUid) {
+    try {
+      const me = await fetchJson('/api/user/info/?aid=' + aid + (msToken ? '&msToken=' + encodeURIComponent(msToken) : ''));
+      viewerSecUid = String(me?.userInfo?.user?.secUid || me?.user?.secUid || me?.userInfo?.secUid || '').trim();
+    } catch {
+      // Fall through to typed AUTH_REQUIRED below.
+    }
+  }
+  if (!viewerSecUid) {
+    throw new Error('AUTH_REQUIRED: cannot resolve viewer secUid (login required)');
+  }
+
+  const dedup = new Map();
+  let apiFailure = null;
+  let cursor = 0;
+  for (let page = 0; page < maxPages && dedup.size < limit; page += 1) {
+    const params = new URLSearchParams({
+      aid,
+      scene: '21',
+      secUid: viewerSecUid,
+      count: String(pageSize),
+      minCursor: String(cursor),
+      maxCursor: '0',
+    });
+    if (msToken) params.set('msToken', msToken);
+    try {
+      const data = await fetchJson('/api/user/list/?' + params.toString());
+      assertTikTokApiSuccess(data, 'user-list');
+      const list = Array.isArray(data.userList)
+        ? data.userList
+        : (Array.isArray(data.user_list) ? data.user_list : []);
+      if (list.length === 0) break;
+      for (const entry of list) {
+        const row = normalizeUserRow(entry?.user || entry, dedup.size + 1);
+        if (row && !dedup.has(row.username)) dedup.set(row.username, row);
+      }
+      if (data.hasMore !== true) break;
+      cursor = asNumber(data.minCursor) ?? asNumber(data.cursor) ?? cursor + list.length;
+    } catch (error) {
+      apiFailure = error instanceof Error ? error.message : String(error);
+      break;
+    }
+  }
+
+  const rows = Array.from(dedup.values())
+    .slice(0, limit)
+    .map((row, index) => ({ ...row, index: index + 1 }));
+
+  if (rows.length === 0) {
+    const suffix = apiFailure ? ' (user-list API failed: ' + apiFailure + ')' : '';
+    throw new Error('No following entries returned' + suffix);
+  }
+  return rows;
+})()
+`}async function U(e,s){const n=g(s.limit,{fallback:i,max:t});await e.goto("https://www.tiktok.com/following",{waitUntil:"load",settleMs:5000});let r;try{r=await e.evaluate(o(n))}catch(a){_(a,{authMessage:"TikTok requires login to read your following list",emptyPattern:/No following entries/,emptyTarget:"tiktok following",failureMessage:"Failed to load TikTok following list"})}if(!Array.isArray(r)||r.length===0)throw new l("tiktok following","TikTok returned no following entries");return r}export const followingCommand=c({site:"tiktok",name:"following",access:"read",description:"List accounts the logged-in user follows on TikTok via page-context APIs",domain:"www.tiktok.com",strategy:d.COOKIE,browser:!0,siteSession:"persistent",args:[{name:"limit",type:"int",default:i,help:`Number of accounts (max ${t})`}],columns:["index","username","name","secUid","verified","followers","following","url"],func:U}),__test__={buildFollowingScript:o,DEFAULT_LIMIT:i,MAX_LIMIT:t};

package/clis/tiktok/friends.js

@@ -0,0 +1,79 @@
+import{cli as u,Strategy as l}from"@jackwener/opencli/registry";import{EmptyResultError as c}from"@jackwener/opencli/errors";import{BROWSER_HELPERS as d,MAX_PAGES as f,SERVER_PAGE_MAX as m,TIKTOK_AID as g,USER_ITEM_NORMALIZER as p,requireLimit as w,throwTikTokPageContextError as k}from"./utils.js";const t=20,s=100;function o(e){return`
+(async () => {
+  const limit = ${Number(e)};
+  const maxPages = ${f};
+  const SERVER_PAGE_MAX = ${m};
+  const pageSize = limit < SERVER_PAGE_MAX ? limit : SERVER_PAGE_MAX;
+  const aid = ${JSON.stringify(g)};
+
+  ${d}
+  ${p}
+
+  function collectUsersFromState(root) {
+    if (!root) return [];
+    const out = [];
+    walkObjects(root, (node) => {
+      if (Array.isArray(node)) return false;
+      if (Array.isArray(node.userList)) {
+        for (const entry of node.userList) {
+          out.push(entry?.user || entry);
+        }
+      }
+      if (Array.isArray(node.suggestList)) {
+        for (const entry of node.suggestList) out.push(entry?.user || entry);
+      }
+      return false;
+    });
+    return out;
+  }
+
+  const dedup = new Map();
+  const universal = findUniversalData();
+  for (const user of collectUsersFromState(universal)) {
+    const row = normalizeUserRow(user, dedup.size + 1);
+    if (row && !dedup.has(row.username)) dedup.set(row.username, row);
+  }
+
+  let apiFailure = null;
+  const msToken = getCookie('msToken');
+  if (dedup.size < limit) {
+    let cursor = 0;
+    for (let page = 0; page < maxPages && dedup.size < limit; page += 1) {
+      const params = new URLSearchParams({
+        aid,
+        count: String(pageSize),
+        cursor: String(cursor),
+        scene: '15',
+      });
+      if (msToken) params.set('msToken', msToken);
+      try {
+        const data = await fetchJson('/api/recommend/user/?' + params.toString());
+        assertTikTokApiSuccess(data, 'recommend-user');
+        const list = Array.isArray(data.userList)
+          ? data.userList
+          : (Array.isArray(data.user_list) ? data.user_list : []);
+        if (list.length === 0) break;
+        for (const entry of list) {
+          const row = normalizeUserRow(entry?.user || entry, dedup.size + 1);
+          if (row && !dedup.has(row.username)) dedup.set(row.username, row);
+        }
+        if (data.hasMore !== true) break;
+        cursor = asNumber(data.cursor) ?? cursor + list.length;
+      } catch (error) {
+        apiFailure = error instanceof Error ? error.message : String(error);
+        break;
+      }
+    }
+  }
+
+  const rows = Array.from(dedup.values())
+    .slice(0, limit)
+    .map((row, index) => ({ ...row, index: index + 1 }));
+
+  if (rows.length === 0) {
+    const suffix = apiFailure ? ' (recommend-user API failed: ' + apiFailure + ')' : '';
+    throw new Error('No friend suggestions returned by TikTok' + suffix);
+  }
+  return rows;
+})()
+`}async function y(e,i){const a=w(i.limit,{fallback:t,max:s});await e.goto("https://www.tiktok.com/friends",{waitUntil:"load",settleMs:5000});let r;try{r=await e.evaluate(o(a))}catch(n){k(n,{authMessage:"TikTok requires browser access to load friend suggestions",emptyPattern:/No friend suggestions/,emptyTarget:"tiktok friends",failureMessage:"Failed to load TikTok friend suggestions"})}if(!Array.isArray(r)||r.length===0)throw new c("tiktok friends","TikTok returned no friend suggestions");return r}export const friendsCommand=u({site:"tiktok",name:"friends",access:"read",description:"Get TikTok friend / who-to-follow suggestions via page-context APIs",domain:"www.tiktok.com",strategy:l.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:t,help:`Number of suggestions (max ${s})`}],columns:["index","username","name","secUid","verified","followers","following","url"],func:y}),__test__={buildFriendsScript:o,DEFAULT_LIMIT:t,MAX_LIMIT:s};

package/clis/tiktok/like.js

@@ -0,0 +1,19 @@
+import{cli as t}from"@jackwener/opencli/registry";t({site:"tiktok",name:"like",access:"write",description:"Like a TikTok video",domain:"www.tiktok.com",args:[{name:"url",required:!0,positional:!0,help:"TikTok video URL"}],columns:["status","likes","url"],pipeline:[{navigate:{url:"${{ args.url }}",settleMs:6000}},{evaluate:`(async () => {
+  const url = \${{ args.url | json }};
+  const btn = document.querySelector('[data-e2e="like-icon"]');
+  if (!btn) throw new Error('Like button not found - make sure you are logged in');
+  const container = btn.closest('button') || btn.closest('[role="button"]') || btn;
+  const aria = (container.getAttribute('aria-label') || '').toLowerCase();
+  const color = window.getComputedStyle(btn).color;
+  const isLiked = aria.includes('unlike') || aria.includes('取消点赞') ||
+                  (color && (color.includes('255, 65') || color.includes('fe2c55')));
+  if (isLiked) {
+    const count = document.querySelector('[data-e2e="like-count"]');
+    return [{ status: 'Already liked', likes: count ? count.textContent.trim() : '-', url: url }];
+  }
+  container.click();
+  await new Promise(r => setTimeout(r, 2000));
+  const count = document.querySelector('[data-e2e="like-count"]');
+  return [{ status: 'Liked', likes: count ? count.textContent.trim() : '-', url: url }];
+})()
+`}]});

package/clis/tiktok/live.js

@@ -0,0 +1,79 @@
+import{cli as l,Strategy as c}from"@jackwener/opencli/registry";import{EmptyResultError as d}from"@jackwener/opencli/errors";import{BROWSER_HELPERS as m,LIVE_ITEM_NORMALIZER as u,SERVER_PAGE_MAX as f,TIKTOK_AID as v,requireLimit as p,throwTikTokPageContextError as y}from"./utils.js";const r=10,i=60;function o(e){return`
+(async () => {
+  const limit = ${Number(e)};
+  const SERVER_PAGE_MAX = ${f};
+  const pageSize = limit < SERVER_PAGE_MAX ? limit : SERVER_PAGE_MAX;
+  const aid = ${JSON.stringify(v)};
+
+  ${m}
+  ${u}
+
+  function collectFromState(root) {
+    if (!root) return [];
+    const out = [];
+    walkObjects(root, (node) => {
+      if (Array.isArray(node)) return false;
+      if (Array.isArray(node.liveList)) {
+        for (const entry of node.liveList) out.push(entry);
+      }
+      if (Array.isArray(node.live_list)) {
+        for (const entry of node.live_list) out.push(entry);
+      }
+      if (Array.isArray(node.discoverList)) {
+        for (const entry of node.discoverList) out.push(entry);
+      }
+      return false;
+    });
+    return out;
+  }
+
+  const dedup = new Map();
+  const universal = findUniversalData();
+  for (const item of collectFromState(universal)) {
+    const row = normalizeLiveItem(item, dedup.size + 1);
+    if (row) {
+      const key = row.streamer || row.url;
+      if (key && !dedup.has(key)) dedup.set(key, row);
+    }
+  }
+
+  let apiFailure = null;
+  const msToken = getCookie('msToken');
+  if (dedup.size < limit) {
+    const params = new URLSearchParams({
+      aid,
+      count: String(pageSize),
+      from_page: 'live_discover',
+    });
+    if (msToken) params.set('msToken', msToken);
+    try {
+      const data = await fetchJson('/api/live/discover/get/?' + params.toString());
+      assertTikTokApiSuccess(data, 'live-discover');
+      const list = Array.isArray(data.data?.list)
+        ? data.data.list
+        : (Array.isArray(data.list)
+          ? data.list
+          : (Array.isArray(data.live_list) ? data.live_list : []));
+      for (const entry of list) {
+        const row = normalizeLiveItem(entry, dedup.size + 1);
+        if (row) {
+          const key = row.streamer || row.url;
+          if (key && !dedup.has(key)) dedup.set(key, row);
+        }
+      }
+    } catch (error) {
+      apiFailure = error instanceof Error ? error.message : String(error);
+    }
+  }
+
+  const rows = Array.from(dedup.values())
+    .slice(0, limit)
+    .map((row, index) => ({ ...row, index: index + 1 }));
+
+  if (rows.length === 0) {
+    const suffix = apiFailure ? ' (live-discover API failed: ' + apiFailure + ')' : '';
+    throw new Error('No live streams returned' + suffix);
+  }
+  return rows;
+})()
+`}async function k(e,s){const a=p(s.limit,{fallback:r,max:i});await e.goto("https://www.tiktok.com/live",{waitUntil:"load",settleMs:5000});let t;try{t=await e.evaluate(o(a))}catch(n){y(n,{authMessage:"TikTok requires browser access to load live streams",emptyPattern:/No live streams returned/,emptyTarget:"tiktok live",failureMessage:"Failed to load TikTok live streams"})}if(!Array.isArray(t)||t.length===0)throw new d("tiktok live","TikTok returned no live streams");return t}export const liveCommand=l({site:"tiktok",name:"live",access:"read",description:"Browse TikTok live streams via page-context APIs",domain:"www.tiktok.com",strategy:c.COOKIE,browser:!0,args:[{name:"limit",type:"int",default:r,help:`Number of streams (max ${i})`}],columns:["index","streamer","name","title","viewers","likes","secUid","url"],func:k}),__test__={buildLiveScript:o,DEFAULT_LIMIT:r,MAX_LIMIT:i};