publishport-opencli 1.0.0

package/clis/band/post.js

@@ -0,0 +1,76 @@
+import{AuthRequiredError as q,EmptyResultError as A}from"@jackwener/opencli/errors";import{formatCookieHeader as S}from"@jackwener/opencli/download";import{downloadMedia as Z}from"@jackwener/opencli/download/media-download";import{cli as j,Strategy as B}from"@jackwener/opencli/registry";j({site:"band",name:"post",access:"read",description:"Export full content of a post including comments",domain:"www.band.us",strategy:B.COOKIE,navigateBefore:!1,browser:!0,args:[{name:"band_no",positional:!0,required:!0,type:"int",help:"Band number"},{name:"post_no",positional:!0,required:!0,type:"int",help:"Post number"},{name:"output",type:"str",default:"",help:"Directory to save attached photos"},{name:"comments",type:"bool",default:!0,help:"Include comments (default: true)"}],columns:["type","author","date","text"],func:async(G,J)=>{const _=Number(J.band_no),$=Number(J.post_no),K=J.output,f=J.comments;await G.goto(`https://www.band.us/band/${_}/post/${$}`);if(!(await G.getCookies({domain:"band.us"})).some((v)=>v.name==="band_session"))throw new q("band.us","Not logged in to Band");const F=await G.evaluate(`
+      (async () => {
+        const withComments = ${f};
+        const sleep = ms => new Promise(r => setTimeout(r, ms));
+        const norm = s => (s || '').replace(/\\s+/g, ' ').trim();
+        // Band embeds <band:mention>, <band:sticker>, etc. in content — strip to plain text.
+        const stripTags = s => s.replace(/<\\/?band:[^>]+>/g, '');
+
+        // Wait up to 9 s for the post content to render (poll for the author link,
+        // which appears after React hydration fills the post header).
+        for (let i = 0; i < 30; i++) {
+          if (document.querySelector('._postWrapper a.text')) break;
+          await sleep(300);
+        }
+
+        const postCard = document.querySelector('._postWrapper');
+        const commentSection = postCard?.querySelector('.dPostCommentMainView');
+
+        // Author and date live in the post header, above the comment section.
+        // Exclude any matches inside the comment section to avoid picking up comment authors.
+        let author = '', date = '';
+        for (const el of (postCard?.querySelectorAll('a.text') || [])) {
+          if (!commentSection?.contains(el)) { author = norm(el.textContent); break; }
+        }
+        for (const el of (postCard?.querySelectorAll('time.time') || [])) {
+          if (!commentSection?.contains(el)) { date = norm(el.textContent); break; }
+        }
+
+        const bodyEl = postCard?.querySelector('.postText._postText');
+        const text = bodyEl ? stripTags(norm(bodyEl.innerText || bodyEl.textContent)) : '';
+
+        // Photo thumbnails have a ?type=sNNN query param; strip it for full-res URL.
+        // Use location.href as base so protocol-relative or relative URLs resolve correctly.
+        const photos = Array.from(postCard?.querySelectorAll('img._imgRecentPhoto, img._imgPhoto') || [])
+          .map(img => {
+            const src = img.getAttribute('src') || '';
+            if (!src) return '';
+            try { const u = new URL(src, location.href); return u.origin + u.pathname; }
+            catch { return ''; }
+          })
+          .filter(Boolean);
+
+        if (!withComments) return { author, date, text, photos, comments: [] };
+
+        // Wait up to 6 s for the comment list container to render.
+        // Wait for the container itself (not .cComment) so posts with zero comments
+        // don't incur a fixed 6s delay waiting for an element that never appears.
+        for (let i = 0; i < 20; i++) {
+          if (postCard?.querySelector('.sCommentList._heightDetectAreaForComment')) break;
+          await sleep(300);
+        }
+
+        // Recursively collect comments and their replies.
+        // Replies live in .sReplyList > .sCommentList, not in ._replyRegion.
+        function extractComments(container, depth) {
+          const results = [];
+          for (const el of container.querySelectorAll(':scope > .cComment')) {
+            results.push({
+              depth,
+              author: norm(el.querySelector('strong.name')?.textContent),
+              date:   norm(el.querySelector('time.time')?.textContent),
+              text:   stripTags(norm(el.querySelector('p.txt._commentContent')?.innerText || '')),
+            });
+            const replyList = el.querySelector('.sReplyList .sCommentList._heightDetectAreaForComment');
+            if (replyList) results.push(...extractComments(replyList, depth + 1));
+          }
+          return results;
+        }
+
+        const commentList = postCard?.querySelector('.sCommentList._heightDetectAreaForComment');
+        const comments = commentList ? extractComments(commentList, 0) : [];
+
+        return { author, date, text, photos, comments };
+      })()
+    `);if(!F?.text&&!F?.comments?.length&&!F?.photos?.length)throw new A("band post","Post not found or not accessible");const L=F.photos??[];if(K&&L.length>0){const v=S(await G.getCookies({url:"https://www.band.us"})),O=(z)=>{try{const Y=new URL(z).hostname;return Y==="band.us"||Y.endsWith(".band.us")}catch{return!1}},T=(z)=>{try{return new URL(z).pathname.match(/\.(\w+)$/)?.[1]??"jpg"}catch{return"jpg"}};let V=1;const W=L.filter(O),X=L.filter((z)=>!O(z));if(W.length>0)await Z(W.map((z)=>({type:"image",url:z,filename:`photo_${V++}.${T(z)}`})),{output:K,verbose:!1,cookies:v});if(X.length>0)await Z(X.map((z)=>({type:"image",url:z,filename:`photo_${V++}.${T(z)}`})),{output:K,verbose:!1})}const Q=[];Q.push({type:"post",author:F.author??"",date:F.date??"",text:[F.text??"",...K?[]:L.map((v,O)=>`[photo${O+1}] ${v}`)].filter(Boolean).join(`
+`)});for(const v of F.comments??[])Q.push({type:v.depth===0?"comment":"reply",author:v.author??"",date:v.date??"",text:v.depth>0?"  ".repeat(v.depth)+"└ "+(v.text??""):v.text??""});return Q}});

package/clis/band/posts.js

@@ -0,0 +1,50 @@
+import{AuthRequiredError as H,EmptyResultError as I}from"@jackwener/opencli/errors";import{cli as J,Strategy as K}from"@jackwener/opencli/registry";J({site:"band",name:"posts",access:"read",description:"List posts from a Band",domain:"www.band.us",strategy:K.COOKIE,navigateBefore:!1,browser:!0,args:[{name:"band_no",positional:!0,required:!0,type:"int",help:"Band number (get it from: band bands)"},{name:"limit",type:"int",default:20,help:"Max results"}],columns:["date","author","content","comments","url"],func:async(v,B)=>{const C=Number(B.band_no),F=Number(B.limit);await v.goto(`https://www.band.us/band/${C}/post`);if(!(await v.getCookies({domain:"band.us"})).some((G)=>G.name==="band_session"))throw new H("band.us","Not logged in to Band");const z=await v.evaluate(`
+      (async () => {
+        const sleep = ms => new Promise(r => setTimeout(r, ms));
+        const norm = s => (s || '').replace(/\\s+/g, ' ').trim();
+        const limit = ${F};
+
+        // Wait up to 9 s for post items to render.
+        for (let i = 0; i < 30; i++) {
+          if (document.querySelector('article.cContentsCard._postMainWrap')) break;
+          await sleep(300);
+        }
+
+        // Band embeds custom <band:mention>, <band:sticker>, etc. tags in content.
+        const stripTags = s => s.replace(/<\\/?band:[^>]+>/g, '');
+
+        const results = [];
+        const postEls = Array.from(
+          document.querySelectorAll('article.cContentsCard._postMainWrap')
+        );
+
+        for (const el of postEls) {
+          // URL: first post permalink link (absolute or relative).
+          const linkEl = el.querySelector('a[href*="/post/"]');
+          const href = linkEl?.getAttribute('href') || '';
+          if (!href) continue;
+          const url = href.startsWith('http') ? href : 'https://www.band.us' + href;
+
+          // Author name — a.text in the post header area.
+          const author = norm(el.querySelector('a.text')?.textContent);
+
+          // Date / timestamp.
+          const date = norm(el.querySelector('time')?.textContent);
+
+          // Post body text (strip Band markup tags, truncate for listing).
+          const bodyEl = el.querySelector('.postText._postText');
+          const content = bodyEl
+            ? stripTags(norm(bodyEl.innerText || bodyEl.textContent)).slice(0, 120)
+            : '';
+
+          // Comment count is in span.count inside the count area.
+          const commentEl = el.querySelector('span.count');
+          const comments = commentEl ? parseInt((commentEl.textContent || '').replace(/[^0-9]/g, ''), 10) || 0 : 0;
+
+          if (results.length >= limit) break;
+          results.push({ date, author, content, comments, url });
+        }
+
+        return results;
+      })()
+    `);if(!z||z.length===0)throw new I("band posts","No posts found in this Band");return z}});

package/clis/barchart/flow.js

@@ -0,0 +1,70 @@
+import{cli as a,Strategy as l}from"@jackwener/opencli/registry";a({site:"barchart",name:"flow",access:"read",description:"Barchart unusual options activity / options flow",domain:"www.barchart.com",strategy:l.COOKIE,args:[{name:"type",type:"str",default:"all",help:"Filter: all, call, or put",choices:["all","call","put"]},{name:"limit",type:"int",default:20,help:"Number of results"}],columns:["symbol","type","strike","expiration","last","volume","openInterest","volOiRatio","iv"],func:async(i,o)=>{const s=o.type||"all",r=o.limit??20;await i.goto("https://www.barchart.com/options/unusual-activity/stocks");await i.wait(5);const e=await i.evaluate(`
+      (async () => {
+        const limit = ${r};
+        const typeFilter = ${JSON.stringify(s)}.toLowerCase();
+
+        // Wait for CSRF token to appear (Angular may inject it after initial render)
+        let csrf = '';
+        for (let i = 0; i < 10; i++) {
+          csrf = document.querySelector('meta[name="csrf-token"]')?.content || '';
+          if (csrf) break;
+          await new Promise(r => setTimeout(r, 500));
+        }
+        if (!csrf) return { error: 'no-csrf' };
+
+        const headers = { 'X-CSRF-TOKEN': csrf };
+        const fields = [
+          'baseSymbol','strikePrice','expirationDate','optionType',
+          'lastPrice','volume','openInterest','volumeOpenInterestRatio','volatility',
+        ].join(',');
+
+        // Fetch extra rows when filtering by type since server-side filter doesn't work
+        const fetchLimit = typeFilter !== 'all' ? limit * 3 : limit;
+
+        // Try unusual_activity first, fall back to mostActive (unusual_activity is
+        // empty outside market hours)
+        const lists = [
+          'options.unusual_activity.stocks.us',
+          'options.mostActive.us',
+        ];
+
+        for (const list of lists) {
+          try {
+            const url = '/proxies/core-api/v1/options/get?list=' + list
+              + '&fields=' + fields
+              + '&orderBy=volumeOpenInterestRatio&orderDir=desc'
+              + '&raw=1&limit=' + fetchLimit;
+
+            const resp = await fetch(url, { credentials: 'include', headers });
+            if (!resp.ok) continue;
+            const d = await resp.json();
+            let items = d?.data || [];
+            if (items.length === 0) continue;
+
+            // Apply client-side type filter
+            if (typeFilter !== 'all') {
+              items = items.filter(i => {
+                const t = ((i.raw || i).optionType || '').toLowerCase();
+                return t === typeFilter;
+              });
+            }
+            return items.slice(0, limit).map(i => {
+              const r = i.raw || i;
+              return {
+                symbol: r.baseSymbol || r.symbol,
+                type: r.optionType,
+                strike: r.strikePrice,
+                expiration: r.expirationDate,
+                last: r.lastPrice,
+                volume: r.volume,
+                openInterest: r.openInterest,
+                volOiRatio: r.volumeOpenInterestRatio,
+                iv: r.volatility,
+              };
+            });
+          } catch(e) {}
+        }
+
+        return [];
+      })()
+    `);if(!e)return[];if(e.error==="no-csrf")throw Error("Could not extract CSRF token from barchart.com. Make sure you are logged in.");if(!Array.isArray(e))return[];return e.slice(0,r).map((t)=>({symbol:t.symbol||"",type:t.type||"",strike:t.strike,expiration:t.expiration??null,last:t.last!=null?Number(Number(t.last).toFixed(2)):null,volume:t.volume,openInterest:t.openInterest,volOiRatio:t.volOiRatio!=null?Number(Number(t.volOiRatio).toFixed(2)):null,iv:t.iv!=null?Number(Number(t.iv).toFixed(2))+"%":null}))}});

package/clis/barchart/greeks.js

@@ -0,0 +1,88 @@
+import{cli as g,Strategy as y}from"@jackwener/opencli/registry";import{ArgumentError as n,CommandExecutionError as o,EmptyResultError as x}from"@jackwener/opencli/errors";const m=10,u=1,c=100;function p(t){const r=String(t??"").trim().toUpperCase();if(!r)throw new n("symbol is required");return r}function d(t){const r=String(t??"").trim();if(!r)return"";if(!/^\d{4}-\d{2}-\d{2}$/.test(r))throw new n("--expiration must use YYYY-MM-DD format");const i=new Date(`${r}T00:00:00Z`);if(Number.isNaN(i.getTime())||i.toISOString().slice(0,10)!==r)throw new n("--expiration must be a valid calendar date");return r}function f(t){if(t===void 0||t===null||t==="")return m;const r=Number(t);if(!Number.isInteger(r)||r<u||r>c)throw new n(`--limit must be an integer between ${u} and ${c}`);return r}function h(t){if(t&&typeof t==="object"&&"session"in t&&"data"in t)return t.data;return t}g({site:"barchart",name:"greeks",access:"read",description:"Barchart options greeks overview (IV, delta, gamma, theta, vega)",domain:"www.barchart.com",strategy:y.COOKIE,args:[{name:"symbol",required:!0,positional:!0,help:"Stock ticker (e.g. AAPL)"},{name:"expiration",type:"str",help:"Expiration date (YYYY-MM-DD). Defaults to the nearest available expiration."},{name:"limit",type:"int",default:m,help:"Number of near-the-money strikes per type (1-100)"}],columns:["type","strike","last","iv","delta","gamma","theta","vega","rho","volume","openInterest","expiration"],func:async(t,r)=>{const i=p(r.symbol),w=d(r.expiration),b=f(r.limit);await t.goto(`https://www.barchart.com/stocks/quotes/${encodeURIComponent(i)}/options`);await t.wait(4);const a=h(await t.evaluate(`
+      (async () => {
+        const sym = ${JSON.stringify(i)};
+        const expDate = ${JSON.stringify(w)};
+        const limit = ${b};
+        const csrf = document.querySelector('meta[name="csrf-token"]')?.content || '';
+        const headers = { 'X-CSRF-TOKEN': csrf };
+
+        try {
+          const fields = [
+            'strikePrice','lastPrice','volume','openInterest',
+            'volatility','delta','gamma','theta','vega','rho',
+            'expirationDate','optionType','percentFromLast',
+          ].join(',');
+
+          let url = '/proxies/core-api/v1/options/chain?symbol=' + encodeURIComponent(sym)
+            + '&fields=' + fields + '&raw=1';
+          if (expDate) url += '&expirationDate=' + encodeURIComponent(expDate);
+          const resp = await fetch(url, { credentials: 'include', headers });
+          if (!resp.ok) {
+            return { ok: false, reason: 'http', status: resp.status, statusText: resp.statusText || '' };
+          }
+
+          const d = await resp.json();
+          const allItems = d?.data;
+          if (!Array.isArray(allItems)) {
+            return { ok: false, reason: 'malformed' };
+          }
+          let items = allItems;
+
+          if (!expDate) {
+            const expirations = items
+              .map(i => (i.raw || i).expirationDate || null)
+              .filter(Boolean)
+              .sort((a, b) => {
+                const aTime = Date.parse(a);
+                const bTime = Date.parse(b);
+                if (Number.isNaN(aTime) && Number.isNaN(bTime)) return 0;
+                if (Number.isNaN(aTime)) return 1;
+                if (Number.isNaN(bTime)) return -1;
+                return aTime - bTime;
+              });
+            const nearestExpiration = expirations[0];
+            if (nearestExpiration) {
+              items = items.filter(i => ((i.raw || i).expirationDate || null) === nearestExpiration);
+            }
+          }
+
+          // Separate calls and puts, sort by distance from current price.
+          const calls = items
+            .filter(i => ((i.raw || i).optionType || '').toLowerCase() === 'call')
+            .sort((a, b) => Math.abs((a.raw || a).percentFromLast || 999) - Math.abs((b.raw || b).percentFromLast || 999))
+            .slice(0, limit);
+          const puts = items
+            .filter(i => ((i.raw || i).optionType || '').toLowerCase() === 'put')
+            .sort((a, b) => Math.abs((a.raw || a).percentFromLast || 999) - Math.abs((b.raw || b).percentFromLast || 999))
+            .slice(0, limit);
+          const selected = [...calls, ...puts];
+
+          if (items.length > 0 && selected.length === 0) {
+            return { ok: false, reason: 'malformed', message: 'options rows did not include call or put identities' };
+          }
+
+          return {
+            ok: true,
+            rows: selected.map(i => {
+              const r = i.raw || i;
+              return {
+                type: r.optionType,
+                strike: r.strikePrice,
+                last: r.lastPrice,
+                iv: r.volatility,
+                delta: r.delta,
+                gamma: r.gamma,
+                theta: r.theta,
+                vega: r.vega,
+                rho: r.rho,
+                volume: r.volume,
+                openInterest: r.openInterest,
+                expiration: r.expirationDate,
+              };
+            })
+          };
+        } catch(e) {
+          return { ok: false, reason: 'exception', message: e?.message || String(e) };
+        }
+      })()
+    `));if(!a||a.ok!==!0){if(a?.reason==="http")throw new o(`Barchart greeks request failed: HTTP ${a.status}${a.statusText?` ${a.statusText}`:""}`);if(a?.reason==="malformed")throw new o(`Barchart greeks returned an unreadable options payload${a.message?`: ${a.message}`:""}`);if(a?.reason==="exception")throw new o(`Barchart greeks request failed: ${a.message||"unknown error"}`);throw new o(`Failed to fetch Barchart greeks for ${i}`)}if(!Array.isArray(a.rows))throw new o("Barchart greeks returned an unreadable options payload");if(a.rows.length===0)throw new x("barchart greeks",`No option greeks were returned for ${i}. Confirm the symbol, expiration, and Barchart login state.`);return a.rows.map((e)=>{if(!e||typeof e!=="object"||Array.isArray(e))throw new o("Barchart greeks returned a malformed option row");const s=String(e.type||"").trim(),l=String(e.expiration||"").trim();if(!/^(call|put)$/i.test(s)||e.strike===void 0||e.strike===null||e.strike===""||!l)throw new o("Barchart greeks returned a malformed option row identity");return{type:s,strike:e.strike,last:e.last!=null?Number(Number(e.last).toFixed(2)):null,iv:e.iv!=null?Number(Number(e.iv).toFixed(2))+"%":null,delta:e.delta!=null?Number(Number(e.delta).toFixed(4)):null,gamma:e.gamma!=null?Number(Number(e.gamma).toFixed(4)):null,theta:e.theta!=null?Number(Number(e.theta).toFixed(4)):null,vega:e.vega!=null?Number(Number(e.vega).toFixed(4)):null,rho:e.rho!=null?Number(Number(e.rho).toFixed(4)):null,volume:e.volume,openInterest:e.openInterest,expiration:l}})}});export const __test__={normalizeSymbol:p,normalizeExpiration:d,parseLimit:f,unwrapBrowserResult:h};

package/clis/barchart/options.js

@@ -0,0 +1,61 @@
+import{cli as s,Strategy as l}from"@jackwener/opencli/registry";s({site:"barchart",name:"options",access:"read",description:"Barchart options chain with greeks, IV, volume, and open interest",domain:"www.barchart.com",strategy:l.COOKIE,args:[{name:"symbol",required:!0,positional:!0,help:"Stock ticker (e.g. AAPL)"},{name:"type",type:"str",default:"Call",help:"Option type: Call or Put",choices:["Call","Put"]},{name:"limit",type:"int",default:20,help:"Max number of strikes to return"}],columns:["strike","bid","ask","last","change","volume","openInterest","iv","delta","gamma","theta","vega","expiration"],func:async(t,a)=>{const r=a.symbol.toUpperCase().trim(),n=a.type||"Call",o=a.limit??20;await t.goto(`https://www.barchart.com/stocks/quotes/${encodeURIComponent(r)}/options`);await t.wait(4);const i=await t.evaluate(`
+      (async () => {
+        const sym = ${JSON.stringify(r)};
+        const type = ${JSON.stringify(n)};
+        const limit = ${o};
+        const csrf = document.querySelector('meta[name="csrf-token"]')?.content || '';
+        const headers = { 'X-CSRF-TOKEN': csrf };
+
+        // API: options chain with greeks
+        try {
+          const fields = [
+            'strikePrice','bidPrice','askPrice','lastPrice','priceChange',
+            'volume','openInterest','volatility',
+            'delta','gamma','theta','vega',
+            'expirationDate','optionType','percentFromLast',
+          ].join(',');
+
+          const url = '/proxies/core-api/v1/options/chain?symbol=' + encodeURIComponent(sym)
+            + '&fields=' + fields + '&raw=1';
+          const resp = await fetch(url, { credentials: 'include', headers });
+          if (resp.ok) {
+            const d = await resp.json();
+            let items = d?.data || [];
+
+            // Filter by type
+            items = items.filter(i => {
+              const t = (i.raw || i).optionType || '';
+              return t.toLowerCase() === type.toLowerCase();
+            });
+
+            // Sort by closeness to current price
+            items.sort((a, b) => {
+              const aD = Math.abs((a.raw || a).percentFromLast || 999);
+              const bD = Math.abs((b.raw || b).percentFromLast || 999);
+              return aD - bD;
+            });
+
+            return items.slice(0, limit).map(i => {
+              const r = i.raw || i;
+              return {
+                strike: r.strikePrice,
+                bid: r.bidPrice,
+                ask: r.askPrice,
+                last: r.lastPrice,
+                change: r.priceChange,
+                volume: r.volume,
+                openInterest: r.openInterest,
+                iv: r.volatility,
+                delta: r.delta,
+                gamma: r.gamma,
+                theta: r.theta,
+                vega: r.vega,
+                expiration: r.expirationDate,
+              };
+            });
+          }
+        } catch(e) {}
+
+        return [];
+      })()
+    `);if(!i||!Array.isArray(i))return[];return i.map((e)=>({strike:e.strike,bid:e.bid!=null?Number(Number(e.bid).toFixed(2)):null,ask:e.ask!=null?Number(Number(e.ask).toFixed(2)):null,last:e.last!=null?Number(Number(e.last).toFixed(2)):null,change:e.change!=null?Number(Number(e.change).toFixed(2)):null,volume:e.volume,openInterest:e.openInterest,iv:e.iv!=null?Number(Number(e.iv).toFixed(2))+"%":null,delta:e.delta!=null?Number(Number(e.delta).toFixed(4)):null,gamma:e.gamma!=null?Number(Number(e.gamma).toFixed(4)):null,theta:e.theta!=null?Number(Number(e.theta).toFixed(4)):null,vega:e.vega!=null?Number(Number(e.vega).toFixed(4)):null,expiration:e.expiration??null}))}});

package/clis/barchart/quote.js

@@ -0,0 +1,87 @@
+import{cli as F,Strategy as G}from"@jackwener/opencli/registry";import{CommandExecutionError as H}from"@jackwener/opencli/errors";F({site:"barchart",name:"quote",access:"read",description:"Barchart stock quote with price, volume, and key metrics",domain:"www.barchart.com",strategy:G.COOKIE,args:[{name:"symbol",required:!0,positional:!0,help:"Stock ticker (e.g. AAPL, MSFT, TSLA)"}],columns:["symbol","name","price","change","changePct","open","high","low","prevClose","volume","avgVolume","marketCap","peRatio","eps"],func:async(B,D)=>{const q=D.symbol.toUpperCase().trim();await B.goto(`https://www.barchart.com/stocks/quotes/${encodeURIComponent(q)}/overview`);await B.wait(4);const z=await B.evaluate(`
+      (async () => {
+        const sym = ${JSON.stringify(q)};
+        const csrf = document.querySelector('meta[name="csrf-token"]')?.content || '';
+
+        // Strategy 1: internal proxy API with CSRF token
+        try {
+          const fields = [
+            'symbol','symbolName','lastPrice','priceChange','percentChange',
+            'highPrice','lowPrice','openPrice','previousPrice','volume','averageVolume',
+            'marketCap','peRatio','earningsPerShare','tradeTime',
+          ].join(',');
+          const url = '/proxies/core-api/v1/quotes/get?symbol=' + encodeURIComponent(sym) + '&fields=' + fields;
+          const resp = await fetch(url, {
+            credentials: 'include',
+            headers: { 'X-CSRF-TOKEN': csrf },
+          });
+          if (resp.ok) {
+            const d = await resp.json();
+            const row = d?.data?.[0] || null;
+            if (row) {
+              return { source: 'api', row };
+            }
+          }
+        } catch(e) {}
+
+        // Strategy 2: parse from DOM
+        try {
+          const priceEl = document.querySelector('span.last-change');
+          const price = priceEl ? priceEl.textContent.trim() : null;
+
+          // Change values are sibling spans inside .pricechangerow > .last-change
+          const changeParent = priceEl?.parentElement;
+          const changeSpans = changeParent ? changeParent.querySelectorAll('span') : [];
+          let change = null;
+          let changePct = null;
+          for (const s of changeSpans) {
+            const t = s.textContent.trim();
+            if (s === priceEl) continue;
+            if (t.includes('%')) changePct = t.replace(/[()]/g, '');
+            else if (t.match(/^[+-]?[\\d.]+$/)) change = t;
+          }
+
+          // Financial data rows
+          const rows = document.querySelectorAll('.financial-data-row');
+          const fdata = {};
+          for (const row of rows) {
+            const spans = row.querySelectorAll('span');
+            if (spans.length >= 2) {
+              const label = spans[0].textContent.trim();
+              const valSpan = row.querySelector('span.right span:not(.ng-hide)');
+              fdata[label] = valSpan ? valSpan.textContent.trim() : '';
+            }
+          }
+
+          // Day high/low from row chart
+          const dayLow = document.querySelector('.bc-quote-row-chart .small-6:first-child .inline:not(.ng-hide)');
+          const dayHigh = document.querySelector('.bc-quote-row-chart .text-right .inline:not(.ng-hide)');
+          const openEl = document.querySelector('.mark span');
+          const openText = openEl ? openEl.textContent.trim().replace('Open ', '') : null;
+
+          const name = document.querySelector('h1 span.symbol');
+
+          return {
+            source: 'dom',
+            row: {
+              symbol: sym,
+              symbolName: name ? name.textContent.trim() : sym,
+              lastPrice: price,
+              priceChange: change,
+              percentChange: changePct,
+              open: openText,
+              highPrice: dayHigh ? dayHigh.textContent.trim() : null,
+              lowPrice: dayLow ? dayLow.textContent.trim() : null,
+              previousClose: fdata['Previous Close'] || null,
+              volume: fdata['Volume'] || null,
+              averageVolume: fdata['Average Volume'] || null,
+              marketCap: null,
+              peRatio: null,
+              earningsPerShare: null,
+            }
+          };
+        } catch(e) {
+          return { error: 'Could not fetch quote for ' + sym + ': ' + e.message };
+        }
+      })()
+    `);if(!z||z.error)throw new H(z?.error||`Failed to fetch quote for ${q}`);const h=z.row||{},J=h.raw||{};return[{symbol:h.symbol||q,name:h.symbolName||h.name||q,price:h.lastPrice??null,change:h.priceChange??null,changePct:h.percentChange??null,open:h.openPrice??h.open??null,high:h.highPrice??null,low:h.lowPrice??null,prevClose:h.previousPrice??h.previousClose??null,volume:h.volume??null,avgVolume:h.averageVolume??null,marketCap:h.marketCap??null,peRatio:h.peRatio??null,eps:h.earningsPerShare??null}]}});

package/clis/bbc/news.js

@@ -0,0 +1 @@
+import{cli as I,Strategy as J}from"@jackwener/opencli/registry";I({site:"bbc",name:"news",access:"read",description:"BBC News headlines (RSS)",domain:"www.bbc.com",strategy:J.PUBLIC,args:[{name:"limit",type:"int",default:20,help:"Number of headlines (max 50)"}],columns:["rank","title","description","url"],func:async(B)=>{const C=Math.min(B.limit||20,50),v=await fetch("https://feeds.bbci.co.uk/news/rss.xml");if(!v.ok)return[];const E=await v.text(),q=[],F=/<item>([\s\S]*?)<\/item>/g;let z;while((z=F.exec(E))&&q.length<C){const f=z[1],A=f.match(/<title><!\[CDATA\[(.*?)\]\]>|<title>(.*?)<\/title>/)?.[1]||f.match(/<title>(.*?)<\/title>/)?.[1]||"",G=f.match(/<description><!\[CDATA\[(.*?)\]\]>|<description>(.*?)<\/description>/)?.[1]||f.match(/<description>(.*?)<\/description>/)?.[1]||"",H=f.match(/<link>(.*?)<\/link>/)?.[1]||f.match(/<guid[^>]*>(.*?)<\/guid>/)?.[1]||"";if(A)q.push({rank:q.length+1,title:A.trim(),description:G.trim().substring(0,200),url:H.trim()})}return q}});

package/clis/bbc/topic.js

@@ -0,0 +1 @@
+import{cli as a,Strategy as p}from"@jackwener/opencli/registry";import{ArgumentError as l,EmptyResultError as m}from"@jackwener/opencli/errors";import{bbcFetchRss as u,parseRssItems as d,pubDateToIso as b,requireBoundedInt as h}from"./utils.js";const s=["world","business","politics","health","education","science_and_environment","technology","entertainment_and_arts"];a({site:"bbc",name:"topic",access:"read",description:"BBC News headlines for a specific section (RSS feed)",domain:"www.bbc.com",strategy:p.PUBLIC,browser:!1,args:[{name:"topic",positional:!0,required:!0,help:`Section name (${s.join(" / ")})`},{name:"limit",type:"int",default:20,help:"Max headlines (1-50)"}],columns:["rank","title","description","pubDate","url"],func:async(i)=>{const e=String(i.topic??"").trim().toLowerCase().replace(/[\s-]+/g,"_");if(!s.includes(e))throw new l(`bbc topic "${i.topic}" is not supported`,`Supported topics: ${s.join(", ")}`);const n=h(i.limit,20,50),r=await u(`${e}/rss.xml`,`bbc topic ${e}`),o=d(r);if(!o.length)throw new m("bbc topic",`BBC ${e} feed returned no items.`);return o.slice(0,n).map((t,c)=>({rank:c+1,title:t.title,description:t.description,pubDate:b(t.pubDate),url:t.link}))}});

package/clis/bbc/utils.js

@@ -0,0 +1 @@
+import{ArgumentError as Q,CommandExecutionError as W}from"@jackwener/opencli/errors";export const BBC_FEED_BASE="https://feeds.bbci.co.uk/news";const X="opencli-bbc-adapter (+https://github.com/jackwener/opencli)",Z={"&amp;":"&","&lt;":"<","&gt;":">","&quot;":'"',"&apos;":"'","&#39;":"'","&nbsp;":" "};export function decodeHtmlEntities(G){return String(G??"").replace(/&#x([0-9a-fA-F]+);/g,(q,z)=>String.fromCodePoint(parseInt(z,16))).replace(/&#(\d+);/g,(q,z)=>String.fromCodePoint(parseInt(z,10))).replace(/&(amp|lt|gt|quot|apos|#39|nbsp);/g,(q)=>Z[q]||q)}export function extractRssTag(G,q){const z=G.match(new RegExp(`<${q}[^>]*>\\s*<!\\[CDATA\\[([\\s\\S]*?)\\]\\]>\\s*<\\/${q}>`));if(z)return z[1];const J=G.match(new RegExp(`<${q}[^>]*>([\\s\\S]*?)<\\/${q}>`));return J?J[1]:""}export function parseRssItems(G){const q=[],z=/<item[^>]*>([\s\S]*?)<\/item>/g;let J;while((J=z.exec(String(G||"")))!==null){const K=J[1];q.push({title:decodeHtmlEntities(extractRssTag(K,"title")).trim(),description:decodeHtmlEntities(extractRssTag(K,"description")).trim(),link:decodeHtmlEntities(extractRssTag(K,"link")).trim(),pubDate:decodeHtmlEntities(extractRssTag(K,"pubDate")).trim(),guid:decodeHtmlEntities(extractRssTag(K,"guid")).trim()})}return q}export function requireBoundedInt(G,q,z,J="limit"){const K=G??q,P=typeof K==="number"?K:Number(K);if(!Number.isInteger(P)||P<=0)throw new Q(`bbc ${J} must be a positive integer`);if(P>z)throw new Q(`bbc ${J} must be <= ${z}`);return P}export async function bbcFetchRss(G,q){const z=`${BBC_FEED_BASE}/${G}`;let J;try{J=await fetch(z,{headers:{"user-agent":X,accept:"application/rss+xml, application/xml"}})}catch(K){throw new W(`${q} request failed: ${K?.message??K}`,"Check that feeds.bbci.co.uk is reachable from this network.")}if(!J.ok)throw new W(`${q} returned HTTP ${J.status} (${z})`);return J.text()}export function pubDateToIso(G){if(!G)return"";const q=new Date(G);if(Number.isNaN(q.getTime()))return"";return q.toISOString().slice(0,10)}

package/clis/bilibili/article.js

@@ -0,0 +1 @@
+import{CliError as j,CommandExecutionError as P}from"@jackwener/opencli/errors";import{cli as m,Strategy as o}from"@jackwener/opencli/registry";import{publishArticle as c}from"../_shared/article/publish.js";import{readFile as g,stat as l}from"node:fs/promises";function d(K){if(!K.execute)throw new j("INVALID_INPUT","此写操作需要 --execute 才会真正提交。注意：本报错仅表示缺少 --execute，并未校验其余参数，不能当 dry-run 预览用")}async function p(K){const G=typeof K.text==="string"?K.text:void 0,M=typeof K.file==="string"?K.file:void 0;if(G&&M)throw new j("INVALID_INPUT","正文和 --file 只能选一个");let z=G??"";if(M){let $;try{$=await l(M)}catch{throw new j("INVALID_INPUT",`文件不存在：${M}`)}if(!$.isFile())throw new j("INVALID_INPUT",`--file 必须是可读的文本文件：${M}`);let Z;try{Z=await g(M)}catch{throw new j("INVALID_INPUT",`文件无法读取：${M}`)}try{z=new TextDecoder("utf-8",{fatal:!0}).decode(Z)}catch{throw new j("INVALID_INPUT",`文件无法以 UTF-8 解码：${M}`)}}if(!z.trim())throw new j("INVALID_INPUT","正文不能为空");return z}function u(K,G,M,z,$={}){return[{status:"success",outcome:z,message:K,target_type:G,target:M,...$}]}export const bilibiliArticleProfile={home:"https://member.bilibili.com/platform/upload/text",originRe:"^https?://([^/]*\\.)?bilibili\\.com(/|$)",outputFormat:"html",preprocessConfig:{removeLinks:!0},image:{uploadFn:async(K,G)=>{var M=G.cookie("bili_jct");if(!M)throw Error("未找到 bili_jct CSRF token，请确认已登录 B站");var z=await fetch(K,{credentials:"omit"});if(!z.ok)throw Error("图片下载失败（HTTP "+z.status+"）："+K.slice(0,120));var $=await z.blob(),Z=new FormData;Z.append("binary",$,"image.jpg");Z.append("csrf",M);var _=await fetch("https://api.bilibili.com/x/article/creative/article/upcover",{method:"POST",credentials:"include",body:Z}),Y=await _.text(),V=null;try{V=JSON.parse(Y)}catch(h){}if(!_.ok||!V||V.code!==0||!V.data||!V.data.url)throw Error("B站图片上传失败："+(V&&V.message?V.message:Y.slice(0,150)));return{url:V.data.url}},skip:["hdslb.com","bilibili.com","biliimg.com"]},publish:async(K,G)=>{var M=G.cookie("bili_jct");if(!M)return{ok:!1,stage:"csrf",status:0,message:"未找到 bili_jct CSRF token，请确认已登录 B站"};var z=K.params||{},$=z.tid?String(z.tid):"4",Z=z.listId!=null?String(z.listId):"0",_=z.bannerUrl?String(z.bannerUrl):"",Y=z.summary?String(z.summary):"";if(!_&&z.coverSrc)try{var V=await fetch(String(z.coverSrc),{credentials:"omit"});if(!V.ok)return{ok:!1,stage:"cover",status:V.status,message:"封面图下载失败（HTTP "+V.status+"）："+String(z.coverSrc).slice(0,120)};var h=await V.blob(),H=new FormData;H.append("binary",h,"cover.jpg");H.append("csrf",M);var T=await fetch("https://api.bilibili.com/x/article/creative/article/upcover",{method:"POST",credentials:"include",body:H}),v=await T.text(),B=null;try{B=JSON.parse(v)}catch(Q){}if(!T.ok||!B||B.code!==0||!B.data||!B.data.url)return{ok:!1,stage:"cover",status:T.status,message:"封面图上传失败："+(B&&B.message?B.message:v.slice(0,150))};_=B.data.url}catch(Q){return{ok:!1,stage:"cover",status:0,message:"封面图上传异常："+String(Q&&Q.message||Q)}}var F=z.tags?String(z.tags):"",U=z.original===!1?!1:!0,N=0;try{var y=document.createElement("div");y.innerHTML=K.content||"";N=(y.textContent||y.innerText||"").replace(/\s+/g,"").length}catch(Q){N=0}var W=new URLSearchParams;W.append("title",K.title);W.append("content",K.content);W.append("csrf",M);W.append("save","0");W.append("tid",$);if(z.category)W.append("category",String(z.category));if(Z)W.append("list_id",Z);if(_)W.append("banner_url",_);if(Y)W.append("summary",Y);if(F)W.append("tags",F);W.append("reprint",U?"0":"1");W.append("original",U?"1":"0");W.append("media_id","0");W.append("spoiler","0");if(N)W.append("words",String(N));var C=await fetch("https://api.bilibili.com/x/article/creative/draft/addupdate",{method:"POST",credentials:"include",headers:{"Content-Type":"application/x-www-form-urlencoded",Origin:"https://member.bilibili.com",Referer:"https://member.bilibili.com/"},body:W.toString()}),R=await C.text(),L=null;try{L=JSON.parse(R)}catch(Q){}if(!C.ok||!L)return{ok:!1,stage:"draft",status:C.status,message:R.slice(0,300)};if(L.code!==0||!L.data||!L.data.aid)return{ok:!1,stage:"draft",status:C.status,message:(L.message||"保存草稿失败")+"（code="+L.code+"）"};var q=String(L.data.aid);if(K.draftOnly){var k="https://member.bilibili.com/platform/upload/text/edit?aid="+q;return{ok:!0,draft:!0,id:q,url:k}}if(!z.category)return{ok:!1,stage:"category",status:0,message:"正式发布缺少必填的专栏分类 category（草稿 aid="+q+" 已存）。请用 `bilibili categories` 取合法分类 id 后传 --category。"};var J=[];try{var D=await fetch("https://api.bilibili.com/x/article/categories",{credentials:"include"}),S=await D.json();if(!S||S.code!==0||!Array.isArray(S.data))return{ok:!1,stage:"category",status:D.status,message:"获取 B站专栏分类失败，无法校验 category（草稿 aid="+q+" 已存）："+(S&&S.message||"code="+(S&&S.code))};(function Q(w){w.forEach(function(E){var I=Array.isArray(E.children)?E.children:[];J.push({id:String(E.id),name:E.name||"",leaf:I.length===0});if(I.length)Q(I)})})(S.data)}catch(Q){return{ok:!1,stage:"category",status:0,message:"获取 B站专栏分类异常，无法校验 category（草稿 aid="+q+" 已存）："+String(Q&&Q.message||Q)}}var x=J.find(function(Q){return Q.id===String(z.category)});if(!x){var f=J.filter(function(Q){return Q.leaf}).map(function(Q){return Q.id+"="+Q.name}).join(" / ");return{ok:!1,stage:"category",status:0,message:"专栏分类 id「"+z.category+"」不存在（草稿 aid="+q+" 已存）。合法叶子分类："+(f||"（无）")}}if(!x.leaf)return{ok:!1,stage:"category",status:0,message:"专栏分类 id「"+z.category+"」（"+x.name+"）是父分类，请改用其下的叶子分类 id（草稿 aid="+q+" 已存）。"};var X=new URLSearchParams;X.append("aid",q);X.append("title",K.title);X.append("content",K.content);X.append("category",String(z.category));X.append("list_id",Z);X.append("tid",$);if(_)X.append("banner_url",_);if(Y)X.append("summary",Y);if(F)X.append("tags",F);X.append("reprint",U?"0":"1");X.append("original",U?"1":"0");X.append("media_id","0");X.append("spoiler","0");if(N)X.append("words",String(N));X.append("csrf",M);var O=await fetch("https://api.bilibili.com/x/article/creative/article/submit",{method:"POST",credentials:"include",headers:{"Content-Type":"application/x-www-form-urlencoded",Origin:"https://member.bilibili.com",Referer:"https://member.bilibili.com/"},body:X.toString()}),b=await O.text(),A=null;try{A=JSON.parse(b)}catch(Q){}if(O.status===412)return{ok:!1,stage:"submit",status:412,message:"B站风控拦截了发表（HTTP 412），草稿已保存（aid="+q+"），可在创作中心改后重试。"};if(!O.ok||!A)return{ok:!1,stage:"submit",status:O.status,message:"正式发布失败："+b.slice(0,300)+"（草稿 aid="+q+" 已存）"};if(A.code!==0)return{ok:!1,stage:"submit",status:O.status,message:(A.message||"正式发布失败")+"（code="+A.code+"，草稿 aid="+q+" 已存）"};var n=A.data&&A.data.aid!=null?String(A.data.aid):q;return{ok:!0,draft:!1,id:n,url:"https://www.bilibili.com/read/cv"+n}}};m({site:"bilibili",name:"article",access:"write",description:"发布 B站专栏长文（opus/article）。默认正式发布，加 --draft 仅存草稿。正文默认 Markdown，图片自动转存至 B站图床。正式发布必填 --category（合法值用 `bilibili categories` 取）。",domain:"member.bilibili.com",strategy:o.COOKIE,browser:!0,args:[{name:"title",positional:!0,required:!0,help:"文章标题"},{name:"text",positional:!0,help:"正文（默认 Markdown；加 --html 则作 HTML 处理）"},{name:"file",help:"正文文件路径（UTF-8，默认 Markdown）"},{name:"html",type:"boolean",help:"将正文视为原始 HTML 而非 Markdown"},{name:"category",help:"专栏分类 id（正式发布必填，叶子分类）。合法值用 `bilibili categories` 列举，禁止臆造。"},{name:"tid",type:"int",default:4,help:"封面版式：4=单图 / 3=三图（按封面图数量定，默认 4）"},{name:"cover",help:"封面图源 URL（可空）；会先经 upcover 上传到 B站图床再作 banner_url"},{name:"banner-url",help:"封面图的 B站 CDN url（可空，已有则直接用，跳过 upcover 上传）"},{name:"summary",help:"文章摘要/digest（可空）"},{name:"tags",help:"标签，逗号拼接的自由文本字符串（可空，非闭合词表）"},{name:"reprint",type:"boolean",help:"标记为转载（默认原创）；加此参数则 original=0、reprint=1"},{name:"list-id",type:"int",default:0,help:"文集编号（默认 0=不加入文集）"},{name:"draft",type:"boolean",help:"仅保存草稿，不正式发布"},{name:"execute",type:"boolean",help:"实际提交。不加此参数时命令拒绝写入。"}],columns:["status","outcome","message","target_type","target","created_target","created_url"],func:async(K,G)=>{if(!K)throw new P("B站专栏发布需要浏览器会话");d(G);const M=String(G.title??"").trim();if(!M)throw new j("INVALID_INPUT","文章标题不能为空");const z=await p(G),$=Boolean(G.draft),Z=typeof G.category==="string"?G.category.trim():"";if(!$&&!Z)throw new j("INVALID_INPUT","正式发布 B站专栏必须指定 --category（专栏分类 id）。请先用 `bilibili categories` 列举合法分类 id；如只想存草稿请加 --draft。");const _={category:Z||void 0,tid:G.tid!=null?String(G.tid):"4",coverSrc:typeof G.cover==="string"?G.cover.trim():"",bannerUrl:typeof G["banner-url"]==="string"?G["banner-url"].trim():"",summary:typeof G.summary==="string"?G.summary:"",tags:typeof G.tags==="string"?G.tags.trim():"",original:!G.reprint,listId:G["list-id"]!=null?String(G["list-id"]):"0"},Y=await c(K,{title:M,body:z,format:G.html?"html":"markdown",draftOnly:$,profile:bilibiliArticleProfile,publishParams:_}),V=Y.images.uploaded.length|0,h=Y.images.failed.length|0;let H=Y.draft?"已保存 B站专栏草稿（需在创作中心手动发布）":"已正式提交 B站专栏发表（可能进入审核态，请用 `bilibili drafts` 或访问返回 URL 回查）";if(V||h)H+=`·图片：${V} 张已转存${h?`，${h} 张失败`:""}`;return u(H,"article","",Y.draft?"draft":"created",{created_target:(Y.draft?"draft:":"article:")+Y.id,created_url:Y.url})}});

package/clis/bilibili/auth.js

@@ -0,0 +1 @@
+import{AuthRequiredError as s}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as n}from"../_shared/site-auth.js";import{apiGet as r,getSelfUid as m}from"./utils.js";async function a(i){const t=await i.getCookies({url:"https://www.bilibili.com"}),o=new Set(t.filter((e)=>e.value).map((e)=>e.name));return o.has("SESSDATA")&&o.has("DedeUserID")}async function l(i){await i.goto("https://www.bilibili.com");const t=await m(i),e=(await r(i,"/x/space/wbi/acc/info",{params:{mid:t},signed:!0}))?.data??{};return{id:String(e.mid??t),username:e.name??"",level:e.level??0}}n({site:"bilibili",domain:"www.bilibili.com",loginUrl:"https://passport.bilibili.com/login",columns:["id","username","level"],quickCheck:a,verify:l,poll:async(i)=>{if(!await a(i))throw new s("bilibili.com","Waiting for Bilibili session cookies");return l(i)}});

package/clis/bilibili/categories.js

@@ -0,0 +1 @@
+import{cli as B,Strategy as D}from"@jackwener/opencli/registry";import{CommandExecutionError as F}from"@jackwener/opencli/errors";import{gotoWritePage as G}from"../_shared/article/publish.js";import{bilibiliArticleProfile as z}from"./article.js";B({site:"bilibili",name:"categories",access:"read",description:"列出 B站专栏文章分类树（id + 名称 + 父分类），供 `bilibili article --category` 取合法分类 id。优先选叶子分类（is_leaf=true）。",domain:"member.bilibili.com",strategy:D.COOKIE,browser:!0,columns:["category_id","category_name","parent_id","parent_name","is_leaf"],func:async(q)=>{if(!q)throw new F("B站专栏分类列举需要浏览器会话");await G(q,z.home,z.originRe);const v=await q.evaluate("(async () => {const r = await fetch('https://api.bilibili.com/x/article/categories', { credentials: 'include' });const j = await r.json();if (!j || j.code !== 0 || !Array.isArray(j.data)) {"+"  throw new Error('获取 B站专栏分类失败：' + ((j && j.message) || ('code=' + (j && j.code))));"+"}const out = [];function walk(node, parentName) {  const kids = Array.isArray(node.children) ? node.children : [];  out.push({    category_id: String(node.id),    category_name: node.name || '',    parent_id: String(node.parent_id == null ? 0 : node.parent_id),    parent_name: parentName || '',    is_leaf: kids.length === 0,  });  kids.forEach((c) => walk(c, node.name));}j.data.forEach((top) => walk(top, ''));return out;})()");return Array.isArray(v)?v:[]}});

package/clis/bilibili/coin.js

@@ -0,0 +1 @@
+import{cli as W,Strategy as X}from"@jackwener/opencli/registry";import{ArgumentError as K,CommandExecutionError as N}from"@jackwener/opencli/errors";import{apiGet as Q,apiPost as Y,requireOkPayload as L,resolveVideoIds as Z}from"./utils.js";W({site:"bilibili",name:"coin",access:"write",description:"给 B站视频投币（官方 API，需登录；消耗硬币不可撤销，需 --execute）",domain:"www.bilibili.com",strategy:X.COOKIE,args:[{name:"bvid",required:!0,positional:!0,help:"Video BV ID / URL / b23.tv short link"},{name:"count",type:"int",default:1,help:"投币数量，1 或 2（单视频累计上限 2 枚）"},{name:"with-like",type:"boolean",help:"投币同时点赞"},{name:"execute",type:"boolean",help:"Actually spend coins. Without it the command refuses to write."}],columns:["bvid","coined","total","status","url"],func:async(D,F)=>{if(!D)throw new N("Browser session required for bilibili coin");const h=Number(F.count??1);if(h!==1&&h!==2)throw new K("bilibili coin --count must be 1 or 2");if(!F.execute)throw new K("Refusing to spend coins: pass --execute to actually pay coins");const{bvid:z,aid:H}=await Z(D,F.bvid),M=`https://www.bilibili.com/video/${z}`,R=await Q(D,"/x/web-interface/archive/coins",{params:{aid:H,bvid:z}}),B=Number(L(R,"archive coins")?.multiply??0);if(B>=2)return[{bvid:z,coined:0,total:B,status:"already-maxed",url:M}];if(B+h>2)throw new K(`已投 ${B} 枚，再投 ${h} 枚会超过单视频 2 枚上限；改用 --count ${2-B}`);const T=await Y(D,"/x/web-interface/coin/add",{params:{aid:H,bvid:z,multiply:h,like:F["with-like"]?1:0}});L(T,"coin add");const U=await Q(D,"/x/web-interface/archive/coins",{params:{aid:H,bvid:z}}),J=Number(L(U,"archive coins")?.multiply??0);if(J<B+h)throw new N(`Bilibili coin did not verify: multiply=${J} after paying ${h}`);return[{bvid:z,coined:h,total:J,status:"coined",url:M}]}});

package/clis/bilibili/comment-del.js

@@ -0,0 +1 @@
+import{cli as H,Strategy as J}from"@jackwener/opencli/registry";import{ArgumentError as B,CommandExecutionError as K}from"@jackwener/opencli/errors";import{apiPost as L,requireOkPayload as M,resolveVideoIds as N}from"./utils.js";function Q(h){const f=Number(h);if(!Number.isSafeInteger(f)||f<=0)throw new B("bilibili comment-del rpid must be a positive integer");return f}H({site:"bilibili",name:"comment-del",access:"write",description:"删除自己发的 B站视频评论（官方 API，需登录；不可恢复，需 --execute）",domain:"www.bilibili.com",strategy:J.COOKIE,args:[{name:"bvid",required:!0,positional:!0,help:"Video BV ID / URL / b23.tv short link"},{name:"rpid",required:!0,positional:!0,help:"要删除的评论 rpid（comment 命令发布时返回的 rpid）"},{name:"execute",type:"boolean",help:"Actually delete the comment. Without it the command refuses to write."}],columns:["bvid","rpid","status"],func:async(h,f)=>{if(!h)throw new K("Browser session required for bilibili comment-del");const z=Q(f.rpid);if(!f.execute)throw new B("Refusing to delete: pass --execute to actually delete this comment");const{bvid:D,aid:F}=await N(h,f.bvid),G=await L(h,"/x/v2/reply/del",{params:{oid:F,type:1,rpid:z}});M(G,"reply del");return[{bvid:D,rpid:String(z),status:"deleted"}]}});

package/clis/bilibili/comment-like.js

@@ -0,0 +1 @@
+import{cli as m,Strategy as d}from"@jackwener/opencli/registry";import{ArgumentError as a,CommandExecutionError as p}from"@jackwener/opencli/errors";import{apiPost as s,requireOkPayload as c,resolveVideoIds as b}from"./utils.js";function u(e){const i=Number(e);if(!Number.isSafeInteger(i)||i<=0)throw new a("bilibili comment-like rpid must be a positive integer");return i}m({site:"bilibili",name:"comment-like",access:"write",description:"给 B站视频评论点赞 / 取消点赞（官方 API，需登录；rpid 从 comments 命令取）",domain:"www.bilibili.com",strategy:d.COOKIE,args:[{name:"bvid",required:!0,positional:!0,help:"Video BV ID / URL / b23.tv short link"},{name:"rpid",required:!0,positional:!0,help:"评论 rpid（bilibili comments 输出里的 id）"},{name:"undo",type:"boolean",help:"取消点赞（默认是点赞）"}],columns:["bvid","rpid","status","url"],func:async(e,i)=>{if(!e)throw new p("Browser session required for bilibili comment-like");const o=u(i.rpid),r=Boolean(i.undo),{bvid:t,aid:n}=await b(e,i.bvid),l=await s(e,"/x/v2/reply/action",{params:{oid:n,type:1,rpid:o,action:r?0:1}});c(l,"reply action");return[{bvid:t,rpid:String(o),status:r?"unliked":"liked",url:`https://www.bilibili.com/video/${t}#reply${o}`}]}});

package/clis/bilibili/comment.js

@@ -0,0 +1 @@
+import{cli as L,Strategy as S}from"@jackwener/opencli/registry";import{ArgumentError as V,CommandExecutionError as W,EmptyResultError as U}from"@jackwener/opencli/errors";import{apiGet as _,apiPost as h,requireOkPayload as $,resolveBvid as q,resolveUid as O}from"./utils.js";import{assertLiteralContent as R}from"../_shared/content-guard.js";function j(D,z){const f=Number(D);if(!Number.isInteger(f)||f<=0)throw new V(`bilibili comment ${z} must be a positive integer`);return f}L({site:"bilibili",name:"comment",access:"write",description:"在 B站视频下发表评论或回复（官方 API，需登录；消息里的 @用户 会被解析为真实提及）",domain:"www.bilibili.com",strategy:S.COOKIE,args:[{name:"bvid",required:!0,positional:!0,help:"Video BV ID / URL / b23.tv short link"},{name:"message",required:!0,positional:!0,help:"Comment text. Any @username in it is resolved to a real mention"},{name:"parent",type:"int",help:"top-level/root rpid to reply under (omit for a top-level comment)"},{name:"execute",type:"boolean",help:"Actually post the comment. Without it the command refuses to write."}],columns:["rpid","bvid","oid","message","url"],func:async(D,z)=>{if(!D)throw new W("Browser session required for bilibili comment");const f=String(z.message??"").trim();R(f,{label:"评论内容"});if(!f)throw new V("bilibili comment message cannot be empty");if(!z.execute)throw new V("Refusing to post: pass --execute to actually publish this comment");const X=z.parent!=null?j(z.parent,"parent"):null;let H;try{H=await q(z.bvid)}catch(J){throw new V(`Cannot resolve Bilibili BV ID from input: ${String(z.bvid??"")}`,J instanceof Error?J.message:String(J))}const B=await _(D,"/x/web-interface/view",{params:{bvid:H}}),Y=$(B,"view")?.aid;if(!Y)throw new W(`Cannot resolve aid for bvid: ${H}`);const K={};for(const J of f.matchAll(/@([^\s@]+)/g)){const Q=J[1];if(Q in K)continue;try{const F=Number(await O(D,Q));if(!Number.isInteger(F)||F<=0)throw new W(`Bilibili user search returned malformed mid for @${Q}`);K[Q]=F}catch(F){if(!(F instanceof U))throw F}}const G={oid:Y,type:1,message:f,plat:1,...X!=null?{root:X,parent:X}:{},...Object.keys(K).length>0?{at_name_to_mid:JSON.stringify(K)}:{}},I=await h(D,"/x/v2/reply/add",{params:G}),Z=$(I,"reply add")?.rpid;if(!Z)throw new W("Bilibili reply add API did not return rpid for the posted comment");return[{rpid:String(Z),bvid:H,oid:String(Y),message:f,url:`https://www.bilibili.com/video/${H}#reply${Z}`}]}});

package/clis/bilibili/comments.js

@@ -0,0 +1 @@
+import{cli as j,Strategy as G}from"@jackwener/opencli/registry";import{ArgumentError as Q,AuthRequiredError as L,CommandExecutionError as J,EmptyResultError as P}from"@jackwener/opencli/errors";import{apiGet as W,resolveBvid as T}from"./utils.js";const $=50;function _(z,F){return z===-101||z===-403||/登录|账号|权限|forbidden|permission|login/i.test(String(F??""))}function q(z){const F=z==null?20:z,H=Number(F);if(!Number.isInteger(H)||H<=0||H>$)throw new Q(`bilibili comments limit must be an integer between 1 and ${$}`);return H}const f={hot:3,time:2};function I(z){const F=z==null?"hot":String(z).trim().toLowerCase(),H=f[F];if(!H)throw new Q(`bilibili comments sort must be one of: ${Object.keys(f).join(", ")}`);return H}function M(z){if(z==null)return null;const F=Number(z);if(!Number.isInteger(F)||F<=0)throw new Q("bilibili comments parent must be a positive integer rpid");return F}function h(z,F){if(!z||typeof z!=="object"||Array.isArray(z)||!Object.hasOwn(z,"code"))throw new J(`Bilibili ${F} API returned a malformed payload`);if(z.code!==0){const H=z.message??"unknown error";if(_(z.code,H))throw new L("bilibili.com",`Bilibili ${F} API requires login or permission: ${H} (${z.code})`);throw new J(`Bilibili ${F} API failed: ${H} (${z.code})`)}return z.data}function O(z,F){if(!z||typeof z!=="object"||Array.isArray(z))throw new J(`Bilibili ${F} API returned malformed data`);if(!Object.hasOwn(z,"replies"))throw new J(`Bilibili ${F} API did not return replies`);if(z.replies===null)return[];if(!Array.isArray(z.replies))throw new J(`Bilibili ${F} API returned malformed replies`);return z.replies}function S(z,F){if(!z||typeof z!=="object"||Array.isArray(z))throw new J(`Bilibili comments reply ${F+1} was malformed`);const H=String(z.rpid??"").trim();if(!H)throw new J(`Bilibili comments reply ${F+1} was missing rpid`);const K=Number(z.ctime);if(!Number.isFinite(K))throw new J(`Bilibili comments reply ${F+1} was missing ctime`);return{rank:F+1,rpid:H,author:String(z.member?.uname??""),text:String(z.content?.message??"").replace(/\n/g," ").trim(),likes:z.like??0,replies:z.rcount??0,time:new Date(K*1000).toISOString().slice(0,16).replace("T"," ")}}j({site:"bilibili",name:"comments",access:"read",description:"获取 B站视频评论（官方 API；用 --parent <rpid> 读取某条评论下的「楼中楼」回复；--sort time 按最新排序，发评论后回查用）",domain:"www.bilibili.com",strategy:G.COOKIE,args:[{name:"bvid",required:!0,positional:!0,help:"Video BV ID (e.g. BV1WtAGzYEBm)"},{name:"parent",type:"int",help:"rpid of a comment — fetch the replies under it instead of top-level comments"},{name:"sort",default:"hot",help:"Top-level order: hot (default) or time (newest first; use to verify a just-posted comment)"},{name:"limit",type:"int",default:20,help:"Number of comments (max 50)"}],columns:["rank","rpid","author","text","likes","replies","time"],func:async(z,F)=>{if(!z)throw new J("Browser session required for bilibili comments");let H;try{H=await T(F.bvid)}catch(V){throw new Q(`Cannot resolve Bilibili BV ID from input: ${String(F.bvid??"")}`,V instanceof Error?V.message:String(V))}const K=q(F.limit),N=M(F.parent),B=I(F.sort),D=await W(z,"/x/web-interface/view",{params:{bvid:H}}),U=h(D,"view")?.aid;if(!U)throw new J(`Cannot resolve aid for bvid: ${H}`);const X=N!=null?await W(z,"/x/v2/reply/reply",{params:{oid:U,type:1,root:N,pn:1,ps:K}}):await W(z,"/x/v2/reply/main",{params:{oid:U,type:1,mode:B,ps:K},signed:!0}),Y=N!=null?"reply thread":"reply main",Z=O(h(X,Y),Y);if(Z.length===0)throw new P(N!=null?`bilibili comment replies: ${N}`:`bilibili comments: ${H}`);return Z.slice(0,K).map(S)}});

package/clis/bilibili/dm-list.js

@@ -0,0 +1 @@
+import{cli as R,Strategy as T}from"@jackwener/opencli/registry";import{CommandExecutionError as U}from"@jackwener/opencli/errors";import{apiGet as V,fetchJson as W,requireOkPayload as X}from"./utils.js";export function parseMsgContent(v){const z=String(v??"");try{const b=JSON.parse(z);if(b&&typeof b==="object"){if(typeof b.content==="string")return b.content;if(typeof b.title==="string"||typeof b.text==="string")return[b.title,b.text].filter(Boolean).join("：");return z}}catch{}return z}R({site:"bilibili",name:"dm-list",access:"read",description:"B站私信会话列表（talker_id 即对方 UID，供 dm-read / dm-send 用）",domain:"www.bilibili.com",strategy:T.COOKIE,args:[{name:"limit",type:"int",default:20,help:"返回会话数上限"}],columns:["talker_id","name","last_content","unread","last_time"],func:async(v,z)=>{if(!v)throw new U("Browser session required for bilibili dm-list");const b=Math.max(1,Number(z.limit??20)),L=new URLSearchParams({session_type:"1",group_fold:"1",unfollow_fold:"0",sort_rule:"2",build:"0",mobi_app:"web"}).toString(),N=await W(v,`https://api.vc.bilibili.com/session_svr/v1/session_svr/get_sessions?${L}`),Q=(X(N,"dm get_sessions")?.session_list??[]).slice(0,b),B=[];for(const A of Q){const D=String(A?.talker_id??"");let F="";try{F=(await V(v,"/x/web-interface/card",{params:{mid:D}}))?.data?.card?.name??""}catch{}const H=A?.last_msg??{},K=Number(H?.timestamp??0);B.push({talker_id:D,name:F,last_content:parseMsgContent(H?.content).replace(/\s+/g," ").slice(0,80),unread:Number(A?.unread_count??0),last_time:K?new Date(K*1000).toISOString():""})}return B}});

package/clis/bilibili/dm-read.js

@@ -0,0 +1 @@
+import{cli as T,Strategy as V}from"@jackwener/opencli/registry";import{CommandExecutionError as W,EmptyResultError as X}from"@jackwener/opencli/errors";import{fetchJson as Y,getSelfUid as Z,requireOkPayload as _,resolveUid as $,wbiSign as b}from"./utils.js";import{parseMsgContent as h}from"./dm-list.js";T({site:"bilibili",name:"dm-read",access:"read",description:"读取与某 B站用户的私信记录（近 30 条；target 为 UID / 用户名）",domain:"www.bilibili.com",strategy:V.COOKIE,args:[{name:"target",required:!0,positional:!0,help:"对方 UID / 用户名（dm-list 的 talker_id）"}],columns:["time","direction","sender_uid","content","msg_type"],func:async(z,H)=>{if(!z)throw new W("Browser session required for bilibili dm-read");const D=await $(z,String(H.target??"").trim()),K=await Z(z),L=await b(z,{talker_id:D,session_type:1,size:30,begin_seqno:0}),N=new URLSearchParams(L).toString().replace(/\+/g,"%20"),Q=await Y(z,`https://api.vc.bilibili.com/svr_sync/v1/svr_sync/fetch_session_msgs?${N}`),F=_(Q,"dm fetch_session_msgs")?.messages??[];if(!F.length)throw new X(`bilibili dm-read: ${D}`,"与该用户还没有私信往来。");return F.slice().reverse().map((B)=>{const G=Number(B?.timestamp??0);return{time:G?new Date(G*1000).toISOString():"",direction:String(B?.sender_uid??"")===K?"sent":"received",sender_uid:String(B?.sender_uid??""),content:h(B?.content).replace(/\s+/g," ").slice(0,200),msg_type:Number(B?.msg_type??0)}})}});

package/clis/bilibili/dm-send.js

@@ -0,0 +1 @@
+import{cli as T,Strategy as W}from"@jackwener/opencli/registry";import{ArgumentError as J,CommandExecutionError as N}from"@jackwener/opencli/errors";import{apiPostAbs as X,getSelfUid as Y,requireOkPayload as Z,resolveUid as $,wbiSign as f}from"./utils.js";import{assertLiteralContent as h}from"../_shared/content-guard.js";const L="A6716E9A-7CE3-47AF-994B-F0B34178D28D";T({site:"bilibili",name:"dm-send",access:"write",description:"给 B站用户发私信（纯文本，官方 API，需登录；不可撤回，需 --execute）",domain:"www.bilibili.com",strategy:W.COOKIE,args:[{name:"target",required:!0,positional:!0,help:"对方 UID / 用户名（dm-list 的 talker_id）"},{name:"message",required:!0,positional:!0,help:"私信内容（纯文本）"},{name:"execute",type:"boolean",help:"Actually send the message. Without it the command refuses to write."}],columns:["receiver_id","msg_key","status"],func:async(z,F)=>{if(!z)throw new N("Browser session required for bilibili dm-send");const G=String(F.message??"").trim();h(G,{label:"私信内容"});if(!G)throw new J("bilibili dm-send message cannot be empty");if(!F.execute)throw new J("Refusing to send: pass --execute to actually send this message");const B=Number(await $(z,String(F.target??"").trim())),H=Number(await Y(z));if(B===H)throw new J("Cannot send a private message to yourself");const Q=await f(z,{w_sender_uid:H,w_receiver_id:B}),R=await X(z,"https://api.vc.bilibili.com/web_im/v1/web_im/send_msg",{query:Q,params:{"msg[sender_uid]":H,"msg[receiver_id]":B,"msg[receiver_type]":1,"msg[msg_type]":1,"msg[msg_status]":0,"msg[content]":JSON.stringify({content:G}),"msg[dev_id]":L,"msg[new_face_version]":0,"msg[timestamp]":Math.floor(Date.now()/1000),from_filework:0,build:0,mobi_app:"web"}}),M=Z(R,"dm send_msg")?.msg_key;if(!M)throw new N("Bilibili send_msg API did not return msg_key for the sent message");return[{receiver_id:String(B),msg_key:String(M),status:"sent"}]}});

package/clis/bilibili/download.js

@@ -0,0 +1,7 @@
+import{cli as q,Strategy as A}from"@jackwener/opencli/registry";import{CliError as G,CommandExecutionError as Z,EXIT_CODES as U}from"@jackwener/opencli/errors";import{checkYtdlp as N,sanitizeFilename as S}from"@jackwener/opencli/download";import{downloadMedia as f}from"@jackwener/opencli/download/media-download";import{apiGet as D,resolveBvid as x,parsePageArg as O,selectVideoPart as h}from"./utils.js";const j={vip:"大会员专享/付费 OGV",ugc_pay:"UGC 单点付费",upower:"充电专属"};function z(J){return J&&typeof J==="object"&&!Array.isArray(J)}async function T(J,W){let K;try{const H=await D(J,"/x/web-interface/view",{params:{bvid:W}});if(!z(H)||!Object.hasOwn(H,"code"))throw new Z("Bilibili view API returned a malformed payload during paid-content pre-check");if(H.code!==0)return;if(!z(H.data)||!z(H.data.rights))throw new Z("Bilibili view API returned malformed paid-content metadata");K=H.data}catch(H){if(H instanceof Z)throw H;return}const Q=K.rights,R=Q.pay?"vip":Q.ugc_pay||Q.arc_pay?"ugc_pay":K.is_upower_exclusive?"upower":"";if(!R)return;if(R==="vip")try{const H=await D(J,"/x/web-interface/nav");if(H.code===0&&Number(H.data?.vipStatus)===1)return}catch{}throw new G("PAID_CONTENT",`该视频为付费内容（${j[R]}），当前账号无观看权益，无法获取完整视频流`,"若已购买/已充电/已开通会员，加 --force 跳过本检查直接下载",U.NOPERM)}async function C(J,W,K){let Q;try{Q=await D(J,"/x/web-interface/view",{params:{bvid:W}})}catch(R){throw new Z(`获取视频分P信息失败: ${R?.message||R}`)}if(!z(Q)||Q.code!==0)throw new Z(`获取视频分P信息失败: ${Q?.message??"unknown"} (${Q?.code??"malformed"})`);return h(Q.data,K)}q({site:"bilibili",name:"download",access:"read",description:"下载B站视频（需要 yt-dlp）",domain:"www.bilibili.com",strategy:A.COOKIE,args:[{name:"bvid",required:!0,positional:!0,help:"Video BV ID (e.g., BV1xxx)"},{name:"output",default:"./bilibili-downloads",help:"Output directory"},{name:"quality",default:"best",help:"Video quality (best, 1080p, 720p, 480p)"},{name:"force",type:"boolean",default:!1,help:"跳过付费内容预检直接下载（已购买/已充电/已开通会员时用）"},{name:"page",required:!1,help:"分P 选集序号（从 1 开始）。多 P 视频下载该集；缺省下载默认 P1"}],columns:["bvid","title","status","size"],func:async(J,W)=>{const K=await x(W.bvid),Q=W.output,R=W.quality,H=O(W.page),F=H!=null?await C(J,K,H):null,I=H!=null?`https://www.bilibili.com/video/${K}?p=${H}`:`https://www.bilibili.com/video/${K}`;if(!N())return[{bvid:K,title:"-",status:"failed",size:"yt-dlp not installed. Run: pip install yt-dlp"}];await J.goto(I);await J.wait(3);if(!W.force)await T(J,K);const L=await J.evaluate(`
+      (() => {
+        const title = document.querySelector('h1.video-title, .video-title')?.textContent?.trim() || 'video';
+        const author = document.querySelector('.up-name, .username')?.textContent?.trim() || 'unknown';
+        return { title, author };
+      })()
+    `),V=(typeof F?.part==="string"?F.part.trim():"")||L?.title||"video",X=S(V),M=await J.getCookies({domain:"bilibili.com"});let $="bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best";if(R==="1080p")$="bestvideo[height<=1080][ext=mp4]+bestaudio[ext=m4a]/best[height<=1080]";else if(R==="720p")$="bestvideo[height<=720][ext=mp4]+bestaudio[ext=m4a]/best[height<=720]";else if(R==="480p")$="bestvideo[height<=480][ext=mp4]+bestaudio[ext=m4a]/best[height<=480]";const Y=I,_=H!=null?`${K}_p${H}_${X}.mp4`:`${K}_${X}.mp4`,B=(await f([{type:"video-ytdlp",url:Y,filename:_}],{output:Q,browserCookies:M,filenamePrefix:K,ytdlpExtraArgs:["-f",$,"--merge-output-format","mp4","--embed-thumbnail"]}))[0]||{status:"failed",size:"-"};return[{bvid:K,title:V,status:B.status,size:B.size}]}});

package/clis/bilibili/drafts.js

@@ -0,0 +1 @@
+import{cli as H,Strategy as I}from"@jackwener/opencli/registry";import{CommandExecutionError as J}from"@jackwener/opencli/errors";import{gotoWritePage as K}from"../_shared/article/publish.js";import{bilibiliArticleProfile as D}from"./article.js";H({site:"bilibili",name:"drafts",access:"read",description:"列出当前用户的 B站专栏草稿（aid + 标题 + 分类），用于发布后回查或取 aid。",domain:"member.bilibili.com",strategy:I.COOKIE,browser:!0,args:[{name:"keyword",help:"按标题关键词过滤（可空）"},{name:"page",type:"int",default:1,help:"页码，默认 1"},{name:"size",type:"int",default:10,help:"每页条数，默认 10"}],columns:["aid","title","category","words","mtime"],func:async(v,q)=>{if(!v)throw new J("B站专栏草稿列举需要浏览器会话");await K(v,D.home,D.originRe);const z=typeof q.keyword==="string"?q.keyword:"",F=Number(q.page)||1,G=Number(q.size)||10,B=await v.evaluate('(async () => {const q = new URLSearchParams();q.set("pn", '+JSON.stringify(String(F))+');q.set("ps", '+JSON.stringify(String(G))+");if ("+JSON.stringify(z)+') q.set("keyword", '+JSON.stringify(z)+");const r = await fetch('https://api.bilibili.com/x/article/creative/draft/list?' + q.toString(), { credentials: 'include' });const j = await r.json();if (!j || j.code !== 0) {"+"  throw new Error('获取 B站专栏草稿失败：' + ((j && j.message) || ('code=' + (j && j.code))));"+'}const drafts = (j.data && j.data.artlist && j.data.artlist.drafts) || [];return drafts.map((d) => ({  aid: String(d.aid == null ? "" : d.aid),  title: d.title || "",  category: (d.category && d.category.name) || String(d.category_id == null ? "" : d.category_id),  words: d.words == null ? 0 : d.words,  mtime: d.mtime == null ? "" : String(d.mtime),}));})()');return Array.isArray(B)?B:[]}});