@jackwener/opencli 1.1.0 → 1.2.0

package/dist/clis/tiktok/following.yaml

@@ -0,0 +1,46 @@
+site: tiktok
+name: following
+description: List accounts you follow on TikTok
+domain: www.tiktok.com
+
+args:
+  limit:
+    type: int
+    default: 20
+    description: Number of accounts
+
+pipeline:
+  - navigate:
+      url: https://www.tiktok.com/following
+      settleMs: 5000
+
+  - evaluate: |
+      (() => {
+        const limit = ${{ args.limit }};
+        const links = Array.from(document.querySelectorAll('a[href*="/@"]'))
+          .filter(function(a) {
+            const text = a.textContent.trim();
+            return text.length > 1 && text.length < 80 &&
+              !text.includes('Profile') && !text.includes('More') && !text.includes('Upload');
+          });
+
+        const seen = {};
+        const results = [];
+        for (const a of links) {
+          const match = a.href.match(/@([^/]+)/);
+          const username = match ? match[1] : '';
+          if (!username || seen[username]) continue;
+          seen[username] = true;
+          const raw = a.textContent.trim();
+          const name = raw.replace(username, '').replace('@', '').trim();
+          results.push({
+            index: results.length + 1,
+            username: username,
+            name: name || username,
+          });
+          if (results.length >= limit) break;
+        }
+        return results;
+      })()
+
+columns: [index, username, name]

package/dist/clis/tiktok/friends.yaml

@@ -0,0 +1,47 @@
+site: tiktok
+name: friends
+description: Get TikTok friend suggestions
+domain: www.tiktok.com
+
+args:
+  limit:
+    type: int
+    default: 20
+    description: Number of suggestions
+
+pipeline:
+  - navigate:
+      url: https://www.tiktok.com/friends
+      settleMs: 5000
+
+  - evaluate: |
+      (() => {
+        const limit = ${{ args.limit }};
+        const links = Array.from(document.querySelectorAll('a[href*="/@"]'))
+          .filter(function(a) {
+            const text = a.textContent.trim();
+            return text.length > 1 && text.length < 80 &&
+              !text.includes('Profile') && !text.includes('More') && !text.includes('Upload');
+          });
+
+        const seen = {};
+        const results = [];
+        for (const a of links) {
+          const match = a.href.match(/@([^/]+)/);
+          const username = match ? match[1] : '';
+          if (!username || seen[username]) continue;
+          seen[username] = true;
+          const raw = a.textContent.trim();
+          const hasFollow = raw.includes('Follow');
+          const name = raw.replace('Follow', '').replace(username, '').replace('@', '').trim();
+          results.push({
+            index: results.length + 1,
+            username: username,
+            name: name || username,
+          });
+          if (results.length >= limit) break;
+        }
+        return results;
+      })()
+
+columns: [index, username, name]

package/dist/clis/tiktok/like.yaml

@@ -0,0 +1,38 @@
+site: tiktok
+name: like
+description: Like a TikTok video
+domain: www.tiktok.com
+
+args:
+  url:
+    type: str
+    required: true
+    positional: true
+    description: TikTok video 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 }];
+      })()
+
+columns: [status, likes, url]

package/dist/clis/tiktok/live.yaml

@@ -0,0 +1,51 @@
+site: tiktok
+name: live
+description: Browse live streams on TikTok
+domain: www.tiktok.com
+
+args:
+  limit:
+    type: int
+    default: 10
+    description: Number of streams
+
+pipeline:
+  - navigate:
+      url: https://www.tiktok.com/live
+      settleMs: 5000
+
+  - evaluate: |
+      (() => {
+        const limit = ${{ args.limit }};
+        // Sidebar live list has structured data
+        const items = document.querySelectorAll('[data-e2e="live-side-nav-item"]');
+        const sidebar = Array.from(items).slice(0, limit).map(function(el, i) {
+          const nameEl = el.querySelector('[data-e2e="live-side-nav-name"]');
+          const countEl = el.querySelector('[data-e2e="person-count"]');
+          const link = el.querySelector('a');
+          return {
+            index: i + 1,
+            streamer: nameEl ? nameEl.textContent.trim() : '',
+            viewers: countEl ? countEl.textContent.trim() : '-',
+            url: link ? link.href : '',
+          };
+        });
+
+        if (sidebar.length > 0) return sidebar;
+
+        // Fallback: main content cards
+        const cards = document.querySelectorAll('[data-e2e="discover-list-live-card"]');
+        return Array.from(cards).slice(0, limit).map(function(card, i) {
+          const text = card.textContent.trim().replace(/\s+/g, ' ');
+          const link = card.querySelector('a[href*="/live"]');
+          const viewerMatch = text.match(/(\d[\d,.]*)\s*watching/);
+          return {
+            index: i + 1,
+            streamer: text.replace(/LIVE.*$/, '').trim().substring(0, 40),
+            viewers: viewerMatch ? viewerMatch[1] : '-',
+            url: link ? link.href : '',
+          };
+        });
+      })()
+
+columns: [index, streamer, viewers, url]

package/dist/clis/tiktok/notifications.yaml

@@ -0,0 +1,52 @@
+site: tiktok
+name: notifications
+description: Get TikTok notifications (likes, comments, mentions, followers)
+domain: www.tiktok.com
+
+args:
+  limit:
+    type: int
+    default: 15
+    description: Number of notifications
+  type:
+    type: str
+    default: all
+    description: Notification type
+    choices: [all, likes, comments, mentions, followers]
+
+pipeline:
+  - navigate:
+      url: https://www.tiktok.com/following
+      settleMs: 5000
+
+  - evaluate: |
+      (async () => {
+        const limit = ${{ args.limit }};
+        const type = ${{ args.type | json }};
+        const wait = (ms) => new Promise(r => setTimeout(r, ms));
+
+        // Click inbox icon to open notifications panel
+        const inboxIcon = document.querySelector('[data-e2e="inbox-icon"]');
+        if (inboxIcon) inboxIcon.click();
+        await wait(1500);
+
+        // Click specific tab if needed
+        if (type !== 'all') {
+          const tab = document.querySelector('[data-e2e="' + type + '"]');
+          if (tab) {
+            tab.click();
+            await wait(1500);
+          }
+        }
+
+        const items = document.querySelectorAll('[data-e2e="inbox-list"] > div, [data-e2e="inbox-list"] [role="button"]');
+        return Array.from(items)
+          .filter(el => el.textContent.trim().length > 5)
+          .slice(0, limit)
+          .map((el, i) => ({
+            index: i + 1,
+            text: el.textContent.trim().replace(/\s+/g, ' ').substring(0, 150),
+          }));
+      })()
+
+columns: [index, text]

package/dist/clis/tiktok/profile.yaml

@@ -0,0 +1,45 @@
+site: tiktok
+name: profile
+description: Get TikTok user profile info
+domain: www.tiktok.com
+
+args:
+  username:
+    type: str
+    required: true
+    positional: true
+    description: TikTok username (without @)
+
+pipeline:
+  - navigate:
+      url: https://www.tiktok.com/explore
+      settleMs: 5000
+
+  - evaluate: |
+      (async () => {
+        const username = ${{ args.username | json }};
+        const res = await fetch('https://www.tiktok.com/@' + encodeURIComponent(username), { credentials: 'include' });
+        if (!res.ok) throw new Error('User not found: ' + username);
+        const html = await res.text();
+        const idx = html.indexOf('__UNIVERSAL_DATA_FOR_REHYDRATION__');
+        if (idx === -1) throw new Error('Could not parse profile data');
+        const start = html.indexOf('>', idx) + 1;
+        const end = html.indexOf('</script>', start);
+        const data = JSON.parse(html.substring(start, end));
+        const ud = data['__DEFAULT_SCOPE__'] && data['__DEFAULT_SCOPE__']['webapp.user-detail'];
+        const u = ud && ud.userInfo && ud.userInfo.user;
+        const s = ud && ud.userInfo && ud.userInfo.stats;
+        if (!u) throw new Error('User not found: ' + username);
+        return [{
+          username: u.uniqueId || username,
+          name: u.nickname || '',
+          bio: (u.signature || '').replace(/\n/g, ' ').substring(0, 120),
+          followers: s && s.followerCount || 0,
+          following: s && s.followingCount || 0,
+          likes: s && s.heartCount || 0,
+          videos: s && s.videoCount || 0,
+          verified: u.verified ? 'Yes' : 'No',
+        }];
+      })()
+
+columns: [username, name, followers, following, likes, videos, verified, bio]

package/dist/clis/tiktok/save.yaml

@@ -0,0 +1,34 @@
+site: tiktok
+name: save
+description: Add a TikTok video to Favorites
+domain: www.tiktok.com
+
+args:
+  url:
+    type: str
+    required: true
+    positional: true
+    description: TikTok video URL
+
+pipeline:
+  - navigate:
+      url: ${{ args.url }}
+      settleMs: 6000
+
+  - evaluate: |
+      (async () => {
+        const url = ${{ args.url | json }};
+        const btn = document.querySelector('[data-e2e="bookmark-icon"]') ||
+                    document.querySelector('[data-e2e="collect-icon"]');
+        if (!btn) throw new Error('Favorites 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();
+        if (aria.includes('remove from favorites') || aria.includes('取消收藏')) {
+          return [{ status: 'Already in Favorites', url: url }];
+        }
+        container.click();
+        await new Promise(r => setTimeout(r, 2000));
+        return [{ status: 'Added to Favorites', url: url }];
+      })()
+
+columns: [status, url]

package/dist/clis/tiktok/search.yaml

@@ -0,0 +1,46 @@
+site: tiktok
+name: search
+description: Search TikTok videos
+domain: www.tiktok.com
+
+args:
+  query:
+    type: str
+    required: true
+    positional: true
+    description: Search query
+  limit:
+    type: int
+    default: 10
+    description: Number of results
+
+pipeline:
+  - navigate:
+      url: https://www.tiktok.com/explore
+      settleMs: 5000
+
+  - evaluate: |
+      (async () => {
+        const query = ${{ args.query | json }};
+        const limit = ${{ args.limit }};
+        const res = await fetch('/api/search/general/full/?keyword=' + encodeURIComponent(query) + '&offset=0&count=' + limit + '&aid=1988', { credentials: 'include' });
+        if (!res.ok) throw new Error('Search failed: HTTP ' + res.status);
+        const data = await res.json();
+        const items = (data.data || []).filter(function(i) { return i.type === 1 && i.item; });
+        return items.slice(0, limit).map(function(i, idx) {
+          var v = i.item;
+          var a = v.author || {};
+          var s = v.stats || {};
+          return {
+            rank: idx + 1,
+            desc: (v.desc || '').replace(/\n/g, ' ').substring(0, 100),
+            author: a.uniqueId || '',
+            plays: s.playCount || 0,
+            likes: s.diggCount || 0,
+            comments: s.commentCount || 0,
+            shares: s.shareCount || 0,
+          };
+        });
+      })()
+
+columns: [rank, desc, author, plays, likes, comments, shares]

package/dist/clis/tiktok/unfollow.yaml

@@ -0,0 +1,44 @@
+site: tiktok
+name: unfollow
+description: Unfollow a TikTok user
+domain: www.tiktok.com
+
+args:
+  username:
+    type: str
+    required: true
+    positional: true
+    description: TikTok username (without @)
+
+pipeline:
+  - navigate:
+      url: https://www.tiktok.com/@${{ args.username }}
+      settleMs: 6000
+
+  - evaluate: |
+      (async () => {
+        const username = ${{ args.username | json }};
+        const buttons = Array.from(document.querySelectorAll('button, [role="button"]'));
+        const followingBtn = buttons.find(function(b) {
+          var text = b.textContent.trim();
+          return text === 'Following' || text === '已关注' || text === 'Friends' || text === '互关';
+        });
+        if (!followingBtn) {
+          return [{ status: 'Not following this user', username: username }];
+        }
+        followingBtn.click();
+        await new Promise(r => setTimeout(r, 2000));
+        // Confirm unfollow if dialog appears
+        var allBtns = Array.from(document.querySelectorAll('button'));
+        var confirm = allBtns.find(function(b) {
+          var t = b.textContent.trim();
+          return t === 'Unfollow' || t === '取消关注';
+        });
+        if (confirm) {
+          confirm.click();
+          await new Promise(r => setTimeout(r, 1500));
+        }
+        return [{ status: 'Unfollowed', username: username }];
+      })()
+
+columns: [status, username]

package/dist/clis/tiktok/unlike.yaml

@@ -0,0 +1,38 @@
+site: tiktok
+name: unlike
+description: Unlike a TikTok video
+domain: www.tiktok.com
+
+args:
+  url:
+    type: str
+    required: true
+    positional: true
+    description: TikTok video 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: 'Not 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: 'Unliked', likes: count ? count.textContent.trim() : '-', url: url }];
+      })()
+
+columns: [status, likes, url]

package/dist/clis/tiktok/unsave.yaml

@@ -0,0 +1,36 @@
+site: tiktok
+name: unsave
+description: Remove a TikTok video from Favorites
+domain: www.tiktok.com
+
+args:
+  url:
+    type: str
+    required: true
+    positional: true
+    description: TikTok video URL
+
+pipeline:
+  - navigate:
+      url: ${{ args.url }}
+      settleMs: 6000
+
+  - evaluate: |
+      (async () => {
+        const url = ${{ args.url | json }};
+        const btn = document.querySelector('[data-e2e="bookmark-icon"]') ||
+                    document.querySelector('[data-e2e="collect-icon"]');
+        if (!btn) throw new Error('Favorites 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();
+        if (aria.includes('add to favorites') || aria.includes('收藏')) {
+          if (!aria.includes('remove') && !aria.includes('取消')) {
+            return [{ status: 'Not in Favorites', url: url }];
+          }
+        }
+        container.click();
+        await new Promise(r => setTimeout(r, 2000));
+        return [{ status: 'Removed from Favorites', url: url }];
+      })()
+
+columns: [status, url]

package/dist/clis/tiktok/user.yaml

@@ -0,0 +1,44 @@
+site: tiktok
+name: user
+description: Get recent videos from a TikTok user
+domain: www.tiktok.com
+
+args:
+  username:
+    type: str
+    required: true
+    positional: true
+    description: TikTok username (without @)
+  limit:
+    type: int
+    default: 10
+    description: Number of videos
+
+pipeline:
+  - navigate:
+      url: https://www.tiktok.com/@${{ args.username }}
+      settleMs: 6000
+
+  - evaluate: |
+      (() => {
+        const limit = ${{ args.limit }};
+        const username = ${{ args.username | json }};
+        const links = Array.from(document.querySelectorAll('a[href*="/video/"]'));
+        const seen = {};
+        const results = [];
+        for (const a of links) {
+          const href = a.href;
+          if (seen[href]) continue;
+          seen[href] = true;
+          results.push({
+            index: results.length + 1,
+            views: a.textContent.trim() || '-',
+            url: href,
+          });
+          if (results.length >= limit) break;
+        }
+        if (results.length === 0) throw new Error('No videos found for @' + username);
+        return results;
+      })()
+
+columns: [index, views, url]

package/dist/clis/twitter/accept.js

@@ -8,14 +8,14 @@ cli({
     browser: true,
     timeoutSeconds: 600, // 10 min — batch operation iterating many conversations
     args: [
-        { name: 'keyword', type: 'string', required: true, help: 'Keywords to match (comma-separated for OR, e.g. "群,微信")' },
+        { name: 'query', type: 'string', required: true, positional: true, help: 'Keywords to match (comma-separated for OR, e.g. "群,微信")' },
         { name: 'max', type: 'int', required: false, default: 20, help: 'Maximum number of requests to accept (default: 20)' },
     ],
     columns: ['index', 'status', 'user', 'message'],
     func: async (page, kwargs) => {
         if (!page)
             throw new Error('Requires browser');
-        const keywords = kwargs.keyword.split(',').map((k) => k.trim()).filter(Boolean);
+        const keywords = kwargs.query.split(',').map((k) => k.trim()).filter(Boolean);
         const maxAccepts = kwargs.max ?? 20;
         const results = [];
         let acceptCount = 0;

package/dist/clis/twitter/article.js

@@ -7,12 +7,12 @@ cli({
     strategy: Strategy.COOKIE,
     browser: true,
     args: [
-        { name: 'tweet_id', type: 'string', positional: true, required: true, help: 'Tweet ID or URL containing the article' },
+        { name: 'tweet-id', type: 'string', positional: true, required: true, help: 'Tweet ID or URL containing the article' },
     ],
     columns: ['title', 'author', 'content', 'url'],
     func: async (page, kwargs) => {
         // Extract tweet ID from URL if needed
-        let tweetId = kwargs.tweet_id;
+        let tweetId = kwargs['tweet-id'];
         const urlMatch = tweetId.match(/\/(?:status|article)\/(\d+)/);
         if (urlMatch)
             tweetId = urlMatch[1];

package/dist/clis/twitter/block.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clis/twitter/block.js

@@ -0,0 +1,88 @@
+import { cli, Strategy } from '../../registry.js';
+cli({
+    site: 'twitter',
+    name: 'block',
+    description: 'Block a Twitter user',
+    domain: 'x.com',
+    strategy: Strategy.UI,
+    browser: true,
+    args: [
+        { name: 'username', type: 'string', positional: true, required: true, help: 'Twitter screen name (without @)' },
+    ],
+    columns: ['status', 'message'],
+    func: async (page, kwargs) => {
+        if (!page)
+            throw new Error('Requires browser');
+        const username = kwargs.username.replace(/^@/, '');
+        await page.goto(`https://x.com/${username}`);
+        await page.wait(5);
+        const result = await page.evaluate(`(async () => {
+        try {
+            let attempts = 0;
+
+            // Check if already blocked (profile shows "Blocked" / unblock button)
+            while (attempts < 20) {
+                const blockedIndicator = document.querySelector('[data-testid$="-unblock"]');
+                if (blockedIndicator) {
+                    return { ok: true, message: 'Already blocking @${username}.' };
+                }
+
+                const moreBtn = document.querySelector('[data-testid="userActions"]');
+                if (moreBtn) break;
+
+                await new Promise(r => setTimeout(r, 500));
+                attempts++;
+            }
+
+            const moreBtn = document.querySelector('[data-testid="userActions"]');
+            if (!moreBtn) {
+                return { ok: false, message: 'Could not find user actions menu. Are you logged in?' };
+            }
+
+            // Open the more actions menu
+            moreBtn.click();
+            await new Promise(r => setTimeout(r, 1000));
+
+            // Find the Block menu item
+            const menuItems = document.querySelectorAll('[role="menuitem"]');
+            let blockItem = null;
+            for (const item of menuItems) {
+                if (item.textContent && item.textContent.includes('Block')) {
+                    blockItem = item;
+                    break;
+                }
+            }
+
+            if (!blockItem) {
+                return { ok: false, message: 'Could not find Block option in menu.' };
+            }
+
+            blockItem.click();
+            await new Promise(r => setTimeout(r, 1000));
+
+            // Confirm the block in the dialog
+            const confirmBtn = document.querySelector('[data-testid="confirmationSheetConfirm"]');
+            if (confirmBtn) {
+                confirmBtn.click();
+                await new Promise(r => setTimeout(r, 1500));
+            }
+
+            // Verify
+            const verify = document.querySelector('[data-testid$="-unblock"]');
+            if (verify) {
+                return { ok: true, message: 'Successfully blocked @${username}.' };
+            } else {
+                return { ok: false, message: 'Block action initiated but UI did not update.' };
+            }
+        } catch (e) {
+            return { ok: false, message: e.toString() };
+        }
+    })()`);
+        if (result.ok)
+            await page.wait(2);
+        return [{
+                status: result.ok ? 'success' : 'failed',
+                message: result.message
+            }];
+    }
+});

package/dist/clis/twitter/delete.js

@@ -7,7 +7,7 @@ cli({
     strategy: Strategy.UI, // Utilizes internal DOM flows for interaction
     browser: true,
     args: [
-        { name: 'url', type: 'string', required: true, help: 'The URL of the tweet to delete' },
+        { name: 'url', type: 'string', required: true, positional: true, help: 'The URL of the tweet to delete' },
     ],
     columns: ['status', 'message'],
     func: async (page, kwargs) => {

package/dist/clis/twitter/download.d.ts

@@ -2,7 +2,7 @@
  * Twitter/X download — download images and videos from tweets.
  *
  * Usage:
- *   opencli twitter download --username elonmusk --limit 10 --output ./twitter
+ *   opencli twitter download elonmusk --limit 10 --output ./twitter
  *   opencli twitter download --tweet-url https://x.com/xxx/status/123 --output ./twitter
  */
 export {};