@jackwener/opencli 1.7.13 → 1.7.15

package/cli-manifest.json

@@ -2443,7 +2443,7 @@
         "type": "str",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Bilibili 视频 BV ID（如 BV1xx411c7mD），或视频 URL / b23.tv 短链"
       },
       {
         "name": "lang",
@@ -6896,7 +6896,7 @@
         "name": "city",
         "type": "str",
         "required": false,
-        "help": "城市名（北京/上海/beijing/...）或 cityId 数字。不传则使用 cookie 默认城市"
+        "help": "城市名（北京/上海/汕头/beijing/shantou/...）或 cityId 数字。未在静态表中的城市会通过 dianping.com 在线解析。不传则使用 cookie 默认城市"
       },
       {
         "name": "limit",
@@ -8491,7 +8491,7 @@
         "type": "str",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "抖音作品 ID（aweme_id，可从作品 URL 末尾获取）"
       }
     ],
     "columns": [
@@ -8517,7 +8517,7 @@
         "type": "str",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "抖音作品 ID（aweme_id，可从作品 URL 末尾获取）"
       },
       {
         "name": "reschedule",
@@ -13173,7 +13173,7 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "即刻搜索关键词"
       },
       {
         "name": "limit",
@@ -19350,7 +19350,7 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Reddit search query"
       },
       {
         "name": "subreddit",
@@ -19408,7 +19408,7 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Subreddit name (no `r/` prefix; e.g. `python`)"
       },
       {
         "name": "sort",
@@ -19553,7 +19553,7 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Reddit username (no `u/` prefix needed)"
       }
     ],
     "columns": [
@@ -19579,7 +19579,7 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Reddit username (no `u/` prefix needed)"
       },
       {
         "name": "limit",
@@ -19614,7 +19614,7 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Reddit username (no `u/` prefix needed)"
       },
       {
         "name": "limit",
@@ -22229,10 +22229,76 @@
     "sourceFile": "twitter/bookmark.js",
     "navigateBefore": true
   },
+  {
+    "site": "twitter",
+    "name": "bookmark-folder",
+    "description": "Read the tweets inside a single Twitter/X bookmark folder. Get the folder id from `opencli twitter bookmark-folders`.",
+    "access": "read",
+    "domain": "x.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "folder-id",
+        "type": "string",
+        "required": true,
+        "positional": true,
+        "help": "Folder id from `opencli twitter bookmark-folders`."
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "help": "Maximum number of bookmarks to return (default 20)."
+      },
+      {
+        "name": "top-by-engagement",
+        "type": "int",
+        "default": 0,
+        "required": false,
+        "help": "When set to N>0, re-rank the folder by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps the API's native (saved-time) ordering."
+      }
+    ],
+    "columns": [
+      "id",
+      "author",
+      "text",
+      "likes",
+      "retweets",
+      "bookmarks",
+      "created_at",
+      "url"
+    ],
+    "type": "js",
+    "modulePath": "twitter/bookmark-folder.js",
+    "sourceFile": "twitter/bookmark-folder.js",
+    "navigateBefore": "https://x.com"
+  },
+  {
+    "site": "twitter",
+    "name": "bookmark-folders",
+    "description": "List your Twitter/X bookmark folders (the user-created collections under Bookmarks). Returns folder id, name, item count, and created_at.",
+    "access": "read",
+    "domain": "x.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [],
+    "columns": [
+      "id",
+      "name",
+      "items",
+      "created_at"
+    ],
+    "type": "js",
+    "modulePath": "twitter/bookmark-folders.js",
+    "sourceFile": "twitter/bookmark-folders.js",
+    "navigateBefore": "https://x.com"
+  },
   {
     "site": "twitter",
     "name": "bookmarks",
-    "description": "Fetch Twitter/X bookmarks",
+    "description": "Fetch your Twitter/X bookmarks (the logged-in user's saved tweets, newest first)",
     "access": "read",
     "domain": "x.com",
     "strategy": "cookie",
@@ -22243,7 +22309,14 @@
         "type": "int",
         "default": 20,
         "required": false,
-        "help": ""
+        "help": "Maximum number of bookmarks to return (default 20)."
+      },
+      {
+        "name": "top-by-engagement",
+        "type": "int",
+        "default": 0,
+        "required": false,
+        "help": "When set to N>0, re-rank the bookmarks by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps the API's native (saved-time) ordering."
       }
     ],
     "columns": [
@@ -22290,7 +22363,7 @@
   {
     "site": "twitter",
     "name": "download",
-    "description": "下载 Twitter/X 媒体（图片和视频）",
+    "description": "Download Twitter/X media (images and videos). Provide either <username> to scan a profile's media tab, or --tweet-url to download a single tweet.",
     "access": "read",
     "domain": "x.com",
     "strategy": "cookie",
@@ -22301,27 +22374,27 @@
         "type": "str",
         "required": false,
         "positional": true,
-        "help": "Twitter username (downloads from media tab)"
+        "help": "Twitter username (with or without @) to scan their /media tab. Either <username> or --tweet-url is required."
       },
       {
         "name": "tweet-url",
         "type": "str",
         "required": false,
-        "help": "Single tweet URL to download"
+        "help": "Single tweet URL to download. Use this OR <username>, not both required at once."
       },
       {
         "name": "limit",
         "type": "int",
         "default": 10,
         "required": false,
-        "help": "Number of tweets to scan"
+        "help": "Maximum number of media items to download when scanning a profile (default 10). Ignored when --tweet-url is used."
       },
       {
         "name": "output",
         "type": "str",
         "default": "./twitter-downloads",
         "required": false,
-        "help": "Output directory"
+        "help": "Output directory (default ./twitter-downloads). A per-source subdir is created inside."
       }
     ],
     "columns": [
@@ -22364,7 +22437,7 @@
   {
     "site": "twitter",
     "name": "followers",
-    "description": "Get accounts following a Twitter/X user",
+    "description": "Get accounts following a Twitter/X user (defaults to the logged-in user when no user is given)",
     "access": "read",
     "domain": "x.com",
     "strategy": "ui",
@@ -22375,14 +22448,14 @@
         "type": "string",
         "required": false,
         "positional": true,
-        "help": ""
+        "help": "Twitter/X handle (with or without @). Omit to fetch followers of the currently logged-in account."
       },
       {
         "name": "limit",
         "type": "int",
         "default": 50,
         "required": false,
-        "help": ""
+        "help": "Maximum number of follower rows to return (default 50). Must be a positive integer."
       }
     ],
     "columns": [
@@ -22398,7 +22471,7 @@
   {
     "site": "twitter",
     "name": "following",
-    "description": "Get accounts a Twitter/X user is following",
+    "description": "Get accounts a Twitter/X user is following (defaults to the logged-in user when no user is given)",
     "access": "read",
     "domain": "x.com",
     "strategy": "cookie",
@@ -22409,14 +22482,14 @@
         "type": "string",
         "required": false,
         "positional": true,
-        "help": ""
+        "help": "Twitter/X handle (with or without @). Omit to fetch the accounts the currently logged-in user follows."
       },
       {
         "name": "limit",
         "type": "int",
         "default": 50,
         "required": false,
-        "help": ""
+        "help": "Maximum number of following rows to return (default 50). Must be a positive integer."
       }
     ],
     "columns": [
@@ -22485,7 +22558,7 @@
   {
     "site": "twitter",
     "name": "likes",
-    "description": "Fetch liked tweets of a Twitter user",
+    "description": "Fetch liked tweets of a Twitter user (defaults to the logged-in user when no username is given)",
     "access": "read",
     "domain": "x.com",
     "strategy": "cookie",
@@ -22496,14 +22569,21 @@
         "type": "string",
         "required": false,
         "positional": true,
-        "help": "Twitter screen name (without @). Defaults to logged-in user."
+        "help": "Twitter screen name (with or without @). Defaults to the logged-in user when omitted."
       },
       {
         "name": "limit",
         "type": "int",
         "default": 20,
         "required": false,
-        "help": ""
+        "help": "Maximum number of liked tweets to return (default 20)."
+      },
+      {
+        "name": "top-by-engagement",
+        "type": "int",
+        "default": 0,
+        "required": false,
+        "help": "When set to N>0, re-rank the liked tweets by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps the API's native (recency) ordering."
       }
     ],
     "columns": [
@@ -22537,14 +22617,14 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Numeric ID of the list you own (e.g. from `opencli twitter lists`)"
       },
       {
         "name": "username",
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Twitter/X handle to add (with or without @)"
       }
     ],
     "columns": [
@@ -22573,14 +22653,14 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Numeric ID of the list you own (e.g. from `opencli twitter lists`)"
       },
       {
         "name": "username",
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Twitter/X handle to remove (with or without @)"
       }
     ],
     "columns": [
@@ -22609,7 +22689,7 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Numeric ID of a Twitter/X list (e.g. from `opencli twitter lists`)"
       },
       {
         "name": "limit",
@@ -22617,6 +22697,13 @@
         "default": 50,
         "required": false,
         "help": ""
+      },
+      {
+        "name": "top-by-engagement",
+        "type": "int",
+        "default": 0,
+        "required": false,
+        "help": "When set to N>0, re-rank the list timeline by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps the list's native (recency) ordering."
       }
     ],
     "columns": [
@@ -22648,7 +22735,7 @@
         "type": "int",
         "default": 50,
         "required": false,
-        "help": ""
+        "help": "Maximum number of lists to return (default 50)."
       }
     ],
     "columns": [
@@ -22666,7 +22753,7 @@
   {
     "site": "twitter",
     "name": "notifications",
-    "description": "Get Twitter/X notifications",
+    "description": "Get your Twitter/X notifications (the logged-in user's likes/replies/follows feed, newest first)",
     "access": "read",
     "domain": "x.com",
     "strategy": "intercept",
@@ -22677,7 +22764,7 @@
         "type": "int",
         "default": 20,
         "required": false,
-        "help": ""
+        "help": "Maximum number of notifications to return (default 20)."
       }
     ],
     "columns": [
@@ -22728,7 +22815,7 @@
   {
     "site": "twitter",
     "name": "profile",
-    "description": "Fetch a Twitter user profile (bio, stats, etc.)",
+    "description": "Fetch a Twitter user profile — bio, stats, etc. (defaults to the logged-in user when no username is given)",
     "access": "read",
     "domain": "x.com",
     "strategy": "cookie",
@@ -22739,7 +22826,7 @@
         "type": "string",
         "required": false,
         "positional": true,
-        "help": "Twitter screen name (without @). Defaults to logged-in user."
+        "help": "Twitter screen name (with or without @). Defaults to the logged-in user when omitted."
       }
     ],
     "columns": [
@@ -22760,6 +22847,52 @@
     "sourceFile": "twitter/profile.js",
     "navigateBefore": "https://x.com"
   },
+  {
+    "site": "twitter",
+    "name": "quote",
+    "description": "Quote-tweet a specific tweet with your own text, optionally with a local or remote image",
+    "access": "write",
+    "domain": "x.com",
+    "strategy": "ui",
+    "browser": true,
+    "args": [
+      {
+        "name": "url",
+        "type": "string",
+        "required": true,
+        "positional": true,
+        "help": "The URL of the tweet to quote"
+      },
+      {
+        "name": "text",
+        "type": "string",
+        "required": true,
+        "positional": true,
+        "help": "The text content of your quote"
+      },
+      {
+        "name": "image",
+        "type": "str",
+        "required": false,
+        "help": "Optional local image path to attach to the quote tweet"
+      },
+      {
+        "name": "image-url",
+        "type": "str",
+        "required": false,
+        "help": "Optional remote image URL to download and attach to the quote tweet"
+      }
+    ],
+    "columns": [
+      "status",
+      "message",
+      "text"
+    ],
+    "type": "js",
+    "modulePath": "twitter/quote.js",
+    "sourceFile": "twitter/quote.js",
+    "navigateBefore": true
+  },
   {
     "site": "twitter",
     "name": "reply",
@@ -22855,10 +22988,36 @@
     "sourceFile": "twitter/reply-dm.js",
     "navigateBefore": true
   },
+  {
+    "site": "twitter",
+    "name": "retweet",
+    "description": "Retweet a specific tweet",
+    "access": "write",
+    "domain": "x.com",
+    "strategy": "ui",
+    "browser": true,
+    "args": [
+      {
+        "name": "url",
+        "type": "string",
+        "required": true,
+        "positional": true,
+        "help": "The URL of the tweet to retweet"
+      }
+    ],
+    "columns": [
+      "status",
+      "message"
+    ],
+    "type": "js",
+    "modulePath": "twitter/retweet.js",
+    "sourceFile": "twitter/retweet.js",
+    "navigateBefore": true
+  },
   {
     "site": "twitter",
     "name": "search",
-    "description": "Search Twitter/X for tweets",
+    "description": "Search Twitter/X for tweets, with optional --from / --has / --exclude / --product filters mapped to X's search operators",
     "access": "read",
     "domain": "x.com",
     "strategy": "intercept",
@@ -22869,25 +23028,75 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Search query. Raw X operators (e.g. \"exact phrase\", #tag, OR, lang:en, since:YYYY-MM-DD, from:, since:) are passed through unchanged."
       },
       {
         "name": "filter",
         "type": "string",
         "default": "top",
         "required": false,
-        "help": "",
+        "help": "Legacy alias for --product. Kept for backwards compatibility; if --product is set it wins.",
         "choices": [
           "top",
           "live"
         ]
       },
+      {
+        "name": "product",
+        "type": "string",
+        "required": false,
+        "help": "Which X search tab to read: top (default), live (Latest), photos, videos. Maps to the f= URL param.",
+        "choices": [
+          "top",
+          "live",
+          "photos",
+          "videos"
+        ]
+      },
+      {
+        "name": "from",
+        "type": "string",
+        "required": false,
+        "help": "Restrict to tweets authored by <user>. Leading @ is stripped. Equivalent to appending `from:<user>` to the query."
+      },
+      {
+        "name": "has",
+        "type": "string",
+        "required": false,
+        "help": "Restrict to tweets that have media|images|videos|links|replies. Maps to X's `filter:<has>` operator.",
+        "choices": [
+          "media",
+          "images",
+          "videos",
+          "links",
+          "replies"
+        ]
+      },
+      {
+        "name": "exclude",
+        "type": "string",
+        "required": false,
+        "help": "Exclude tweets matching <type>: replies|retweets|media|links. Maps to X's `-filter:<x>` operator (retweets → -filter:nativeretweets).",
+        "choices": [
+          "replies",
+          "retweets",
+          "media",
+          "links"
+        ]
+      },
       {
         "name": "limit",
         "type": "int",
         "default": 15,
         "required": false,
-        "help": ""
+        "help": "Maximum number of tweets to return (default 15). Result count after server-side filtering."
+      },
+      {
+        "name": "top-by-engagement",
+        "type": "int",
+        "default": 0,
+        "required": false,
+        "help": "When set to N>0, re-rank the results by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps X's native ordering."
       }
     ],
     "columns": [
@@ -22920,7 +23129,7 @@
         "type": "string",
         "required": true,
         "positional": true,
-        "help": ""
+        "help": "Tweet numeric ID (e.g. 1234567890) or full status URL"
       },
       {
         "name": "limit",
@@ -22928,6 +23137,13 @@
         "default": 50,
         "required": false,
         "help": ""
+      },
+      {
+        "name": "top-by-engagement",
+        "type": "int",
+        "default": 0,
+        "required": false,
+        "help": "When set to N>0, re-rank the thread by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps the conversation's structural ordering."
       }
     ],
     "columns": [
@@ -22948,7 +23164,7 @@
   {
     "site": "twitter",
     "name": "timeline",
-    "description": "Fetch Twitter timeline (for-you or following)",
+    "description": "Fetch the logged-in user's home timeline (for-you algorithmic feed by default; pass --type following for the chronological feed of accounts you follow)",
     "access": "read",
     "domain": "x.com",
     "strategy": "cookie",
@@ -22959,7 +23175,7 @@
         "type": "str",
         "default": "for-you",
         "required": false,
-        "help": "Timeline type: for-you (algorithmic) or following (chronological)",
+        "help": "Which home-timeline feed to read. Default for-you (algorithmic). Use following for the chronological feed of accounts you follow.",
         "choices": [
           "for-you",
           "following"
@@ -22970,7 +23186,14 @@
         "type": "int",
         "default": 20,
         "required": false,
-        "help": ""
+        "help": "Maximum number of tweets to return (default 20)."
+      },
+      {
+        "name": "top-by-engagement",
+        "type": "int",
+        "default": 0,
+        "required": false,
+        "help": "When set to N>0, re-rank the timeline by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps X's native ordering."
       }
     ],
     "columns": [
@@ -23040,6 +23263,13 @@
         "default": 20,
         "required": false,
         "help": "Max tweets to return"
+      },
+      {
+        "name": "top-by-engagement",
+        "type": "int",
+        "default": 0,
+        "required": false,
+        "help": "When set to N>0, re-rank the tweets by weighted engagement (likes×1 + retweets×3 + replies×2 + bookmarks×5 + log10(views+1)×0.5) and return the top N. Default 0 keeps the chronological ordering."
       }
     ],
     "columns": [
@@ -23139,6 +23369,58 @@
     "sourceFile": "twitter/unfollow.js",
     "navigateBefore": true
   },
+  {
+    "site": "twitter",
+    "name": "unlike",
+    "description": "Remove a like from a specific tweet",
+    "access": "write",
+    "domain": "x.com",
+    "strategy": "ui",
+    "browser": true,
+    "args": [
+      {
+        "name": "url",
+        "type": "string",
+        "required": true,
+        "positional": true,
+        "help": "The URL of the tweet to unlike"
+      }
+    ],
+    "columns": [
+      "status",
+      "message"
+    ],
+    "type": "js",
+    "modulePath": "twitter/unlike.js",
+    "sourceFile": "twitter/unlike.js",
+    "navigateBefore": true
+  },
+  {
+    "site": "twitter",
+    "name": "unretweet",
+    "description": "Undo a retweet on a specific tweet",
+    "access": "write",
+    "domain": "x.com",
+    "strategy": "ui",
+    "browser": true,
+    "args": [
+      {
+        "name": "url",
+        "type": "string",
+        "required": true,
+        "positional": true,
+        "help": "The URL of the tweet to unretweet"
+      }
+    ],
+    "columns": [
+      "status",
+      "message"
+    ],
+    "type": "js",
+    "modulePath": "twitter/unretweet.js",
+    "sourceFile": "twitter/unretweet.js",
+    "navigateBefore": true
+  },
   {
     "site": "uisdc",
     "name": "news",