@jackwener/opencli 1.5.7 → 1.5.9

package/dist/cli-manifest.json

@@ -111,6 +111,163 @@
     "type": "ts",
     "modulePath": "36kr/search.js"
   },
+  {
+    "site": "amazon",
+    "name": "bestsellers",
+    "description": "Amazon Best Sellers pages for category candidate discovery",
+    "domain": "amazon.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "input",
+        "type": "str",
+        "required": false,
+        "positional": true,
+        "help": "Best sellers URL or /zgbs path. Omit to use the root Best Sellers page."
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 100,
+        "required": false,
+        "help": "Maximum number of ranked items to return (default 100)"
+      }
+    ],
+    "columns": [
+      "rank",
+      "asin",
+      "title",
+      "price_text",
+      "rating_value",
+      "review_count"
+    ],
+    "type": "ts",
+    "modulePath": "amazon/bestsellers.js",
+    "navigateBefore": false
+  },
+  {
+    "site": "amazon",
+    "name": "discussion",
+    "description": "Amazon review summary and sample customer discussion from product review pages",
+    "domain": "amazon.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "input",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "ASIN or product URL, for example B0FJS72893"
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 10,
+        "required": false,
+        "help": "Maximum number of review samples to return (default 10)"
+      }
+    ],
+    "columns": [
+      "asin",
+      "average_rating_value",
+      "total_review_count"
+    ],
+    "type": "ts",
+    "modulePath": "amazon/discussion.js",
+    "navigateBefore": false
+  },
+  {
+    "site": "amazon",
+    "name": "offer",
+    "description": "Amazon seller, buy box, and fulfillment facts from the product page",
+    "domain": "amazon.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "input",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "ASIN or product URL, for example B0FJS72893"
+      }
+    ],
+    "columns": [
+      "asin",
+      "price_text",
+      "sold_by",
+      "ships_from",
+      "is_amazon_sold",
+      "is_amazon_fulfilled"
+    ],
+    "type": "ts",
+    "modulePath": "amazon/offer.js",
+    "navigateBefore": false
+  },
+  {
+    "site": "amazon",
+    "name": "product",
+    "description": "Amazon product page facts for candidate validation",
+    "domain": "amazon.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "input",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "ASIN or product URL, for example B0FJS72893"
+      }
+    ],
+    "columns": [
+      "asin",
+      "title",
+      "price_text",
+      "rating_value",
+      "review_count"
+    ],
+    "type": "ts",
+    "modulePath": "amazon/product.js",
+    "navigateBefore": false
+  },
+  {
+    "site": "amazon",
+    "name": "search",
+    "description": "Amazon search results for product discovery and coarse filtering",
+    "domain": "amazon.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "query",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Search query, for example \"desk shelf organizer\""
+      },
+      {
+        "name": "limit",
+        "type": "int",
+        "default": 20,
+        "required": false,
+        "help": "Maximum number of results to return (default 20)"
+      }
+    ],
+    "columns": [
+      "rank",
+      "asin",
+      "title",
+      "price_text",
+      "rating_value",
+      "review_count"
+    ],
+    "type": "ts",
+    "modulePath": "amazon/search.js",
+    "navigateBefore": false
+  },
   {
     "site": "antigravity",
     "name": "dump",
@@ -5218,6 +5375,114 @@
     ],
     "type": "yaml"
   },
+  {
+    "site": "gemini",
+    "name": "ask",
+    "description": "Send a prompt to Gemini and return only the assistant response",
+    "domain": "gemini.google.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "prompt",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Prompt to send"
+      },
+      {
+        "name": "timeout",
+        "type": "str",
+        "default": "60",
+        "required": false,
+        "help": "Max seconds to wait (default: 60)"
+      },
+      {
+        "name": "new",
+        "type": "str",
+        "default": "false",
+        "required": false,
+        "help": "Start a new chat first (true/false, default: false)"
+      }
+    ],
+    "columns": [
+      "response"
+    ],
+    "timeout": 180,
+    "type": "ts",
+    "modulePath": "gemini/ask.js",
+    "navigateBefore": false
+  },
+  {
+    "site": "gemini",
+    "name": "image",
+    "description": "Generate images with Gemini web and save them locally",
+    "domain": "gemini.google.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "prompt",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Image prompt to send to Gemini"
+      },
+      {
+        "name": "rt",
+        "type": "str",
+        "default": "1:1",
+        "required": false,
+        "help": "Ratio shorthand for aspect ratio (1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3)"
+      },
+      {
+        "name": "st",
+        "type": "str",
+        "default": "",
+        "required": false,
+        "help": "Style shorthand, e.g. anime, icon, watercolor"
+      },
+      {
+        "name": "op",
+        "type": "str",
+        "default": "/home/runner/tmp/gemini-images",
+        "required": false,
+        "help": "Output directory shorthand"
+      },
+      {
+        "name": "sd",
+        "type": "boolean",
+        "default": false,
+        "required": false,
+        "help": "Skip download shorthand; only show Gemini page link"
+      }
+    ],
+    "columns": [
+      "status",
+      "file",
+      "link"
+    ],
+    "timeout": 240,
+    "type": "ts",
+    "modulePath": "gemini/image.js",
+    "navigateBefore": false
+  },
+  {
+    "site": "gemini",
+    "name": "new",
+    "description": "Start a new conversation in Gemini web chat",
+    "domain": "gemini.google.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [],
+    "columns": [
+      "Status",
+      "Action"
+    ],
+    "type": "ts",
+    "modulePath": "gemini/new.js",
+    "navigateBefore": false
+  },
   {
     "site": "google",
     "name": "news",
@@ -8079,28 +8344,6 @@
     "type": "ts",
     "modulePath": "medium/user.js"
   },
-  {
-    "site": "notebooklm",
-    "name": "bind-current",
-    "aliases": [
-      "use"
-    ],
-    "description": "Bind the current active NotebookLM notebook tab into the site:notebooklm workspace",
-    "domain": "notebooklm.google.com",
-    "strategy": "cookie",
-    "browser": true,
-    "args": [],
-    "columns": [
-      "workspace",
-      "tab_id",
-      "notebook_id",
-      "title",
-      "url"
-    ],
-    "type": "ts",
-    "modulePath": "notebooklm/bind-current.js",
-    "navigateBefore": false
-  },
   {
     "site": "notebooklm",
     "name": "current",
@@ -8231,6 +8474,35 @@
     "modulePath": "notebooklm/notes-get.js",
     "navigateBefore": false
   },
+  {
+    "site": "notebooklm",
+    "name": "open",
+    "aliases": [
+      "select"
+    ],
+    "description": "Open one NotebookLM notebook in the automation workspace by id or URL",
+    "domain": "notebooklm.google.com",
+    "strategy": "cookie",
+    "browser": true,
+    "args": [
+      {
+        "name": "notebook",
+        "type": "str",
+        "required": true,
+        "positional": true,
+        "help": "Notebook id from list output, or a full NotebookLM notebook URL"
+      }
+    ],
+    "columns": [
+      "id",
+      "title",
+      "url",
+      "source"
+    ],
+    "type": "ts",
+    "modulePath": "notebooklm/open.js",
+    "navigateBefore": false
+  },
   {
     "site": "notebooklm",
     "name": "source-fulltext",

package/dist/clis/amazon/bestsellers.d.ts

@@ -0,0 +1,21 @@
+interface BestsellersPagePayload {
+    href?: string;
+    title?: string;
+    list_title?: string;
+    cards?: Array<{
+        rank_text?: string | null;
+        asin?: string | null;
+        title?: string | null;
+        href?: string | null;
+        price_text?: string | null;
+        rating_text?: string | null;
+        review_count_text?: string | null;
+        card_text?: string | null;
+    }>;
+    page_links?: string[];
+}
+declare function normalizeBestsellerCandidate(candidate: NonNullable<BestsellersPagePayload['cards']>[number], rank: number, listTitle: string | null, sourceUrl: string): Record<string, unknown>;
+export declare const __test__: {
+    normalizeBestsellerCandidate: typeof normalizeBestsellerCandidate;
+};
+export {};

package/dist/clis/amazon/bestsellers.js

@@ -0,0 +1,130 @@
+import { CommandExecutionError } from '../../errors.js';
+import { cli, Strategy } from '../../registry.js';
+import { buildProvenance, cleanText, extractAsin, extractReviewCountFromCardText, firstMeaningfulLine, normalizeProductUrl, parsePriceText, parseRatingValue, parseReviewCount, resolveBestsellersUrl, uniqueNonEmpty, assertUsableState, gotoAndReadState, } from './shared.js';
+function normalizeBestsellerCandidate(candidate, rank, listTitle, sourceUrl) {
+    const productUrl = normalizeProductUrl(candidate.href);
+    const asin = extractAsin(candidate.asin ?? '') ?? extractAsin(productUrl ?? '') ?? null;
+    const title = cleanText(candidate.title) || firstMeaningfulLine(candidate.card_text);
+    const price = parsePriceText(cleanText(candidate.price_text) || candidate.card_text);
+    const ratingText = cleanText(candidate.rating_text) || null;
+    const reviewCountText = cleanText(candidate.review_count_text)
+        || extractReviewCountFromCardText(candidate.card_text)
+        || null;
+    const provenance = buildProvenance(sourceUrl);
+    return {
+        rank,
+        asin,
+        title: title || null,
+        product_url: productUrl,
+        list_title: listTitle,
+        ...provenance,
+        price_text: price.price_text,
+        price_value: price.price_value,
+        currency: price.currency,
+        rating_text: ratingText,
+        rating_value: parseRatingValue(ratingText),
+        review_count_text: reviewCountText,
+        review_count: parseReviewCount(reviewCountText),
+    };
+}
+async function readBestsellersPage(page, url) {
+    const state = await gotoAndReadState(page, url, 2500, 'bestsellers');
+    assertUsableState(state, 'bestsellers');
+    return await page.evaluate(`
+    (() => ({
+      href: window.location.href,
+      title: document.title || '',
+      list_title:
+        document.querySelector('#zg_banner_text')?.textContent
+        || document.querySelector('h1')?.textContent
+        || '',
+      cards: Array.from(document.querySelectorAll('.p13n-sc-uncoverable-faceout'))
+        .map((card) => ({
+          rank_text:
+            card.querySelector('.zg-bdg-text')?.textContent
+            || card.querySelector('[class*="rank"]')?.textContent
+            || '',
+          asin: card.id || '',
+          title:
+            card.querySelector('[class*="line-clamp"]')?.textContent
+            || card.querySelector('img')?.getAttribute('alt')
+            || '',
+          href: card.querySelector('a[href*="/dp/"]')?.href || '',
+          price_text: card.querySelector('.a-price .a-offscreen')?.textContent || '',
+          rating_text: card.querySelector('[aria-label*="out of 5 stars"]')?.getAttribute('aria-label') || '',
+          review_count_text:
+            card.querySelector('a[href*="#customerReviews"]')?.textContent
+            || card.querySelector('.a-size-small')?.textContent
+            || '',
+          card_text: card.innerText || '',
+        })),
+      page_links: Array.from(document.querySelectorAll('li.a-normal a, li.a-selected a'))
+        .map((anchor) => anchor.href || '')
+        .filter((href) => /\\/zgbs\\//.test(href) && /(?:[?&]pg=|ref=zg_bs_pg_)/.test(href)),
+    }))()
+  `);
+}
+cli({
+    site: 'amazon',
+    name: 'bestsellers',
+    description: 'Amazon Best Sellers pages for category candidate discovery',
+    domain: 'amazon.com',
+    strategy: Strategy.COOKIE,
+    navigateBefore: false,
+    args: [
+        {
+            name: 'input',
+            positional: true,
+            help: 'Best sellers URL or /zgbs path. Omit to use the root Best Sellers page.',
+        },
+        {
+            name: 'limit',
+            type: 'int',
+            default: 100,
+            help: 'Maximum number of ranked items to return (default 100)',
+        },
+    ],
+    columns: ['rank', 'asin', 'title', 'price_text', 'rating_value', 'review_count'],
+    func: async (page, kwargs) => {
+        const limit = Math.max(1, Number(kwargs.limit) || 100);
+        const initialUrl = resolveBestsellersUrl(typeof kwargs.input === 'string' ? kwargs.input : undefined);
+        const queue = [initialUrl];
+        const visited = new Set();
+        const seenAsins = new Set();
+        const results = [];
+        let listTitle = null;
+        while (queue.length > 0 && results.length < limit) {
+            const nextUrl = queue.shift();
+            if (visited.has(nextUrl))
+                continue;
+            visited.add(nextUrl);
+            const payload = await readBestsellersPage(page, nextUrl);
+            const sourceUrl = cleanText(payload.href) || nextUrl;
+            listTitle = cleanText(payload.list_title) || cleanText(payload.title) || listTitle;
+            const cards = payload.cards ?? [];
+            for (const card of cards) {
+                const normalized = normalizeBestsellerCandidate(card, results.length + 1, listTitle, sourceUrl);
+                const asin = cleanText(String(normalized.asin ?? ''));
+                if (!asin || seenAsins.has(asin))
+                    continue;
+                seenAsins.add(asin);
+                results.push(normalized);
+                if (results.length >= limit)
+                    break;
+            }
+            const pageLinks = uniqueNonEmpty(payload.page_links ?? []);
+            for (const href of pageLinks) {
+                if (!visited.has(href) && !queue.includes(href)) {
+                    queue.push(href);
+                }
+            }
+        }
+        if (results.length === 0) {
+            throw new CommandExecutionError('amazon bestsellers did not expose any ranked items', 'Open the same best sellers page in Chrome, verify it is a real Amazon ranking page, and retry.');
+        }
+        return results.slice(0, limit);
+    },
+});
+export const __test__ = {
+    normalizeBestsellerCandidate,
+};

package/dist/clis/amazon/bestsellers.test.js

@@ -0,0 +1,20 @@
+import { describe, expect, it } from 'vitest';
+import { __test__ } from './bestsellers.js';
+describe('amazon bestsellers normalization', () => {
+    it('normalizes bestseller cards and infers review counts from card text', () => {
+        const result = __test__.normalizeBestsellerCandidate({
+            asin: 'B0DR31GC3D',
+            title: '',
+            href: 'https://www.amazon.com/NUTIKAS-Shelves-Desktop-Orgnizer-Shlef/dp/B0DR31GC3D/ref=zg_bs',
+            price_text: '$25.92',
+            rating_text: '4.3 out of 5 stars',
+            review_count_text: '',
+            card_text: 'Desk Shelves Desktop Organizer Shlef\n4.3 out of 5 stars\n435\n$25.92',
+        }, 2, 'Amazon Best Sellers: Best Desktop & Off-Surface Shelves', 'https://www.amazon.com/example');
+        expect(result.rank).toBe(2);
+        expect(result.asin).toBe('B0DR31GC3D');
+        expect(result.title).toBe('Desk Shelves Desktop Organizer Shlef');
+        expect(result.review_count).toBe(435);
+        expect(result.list_title).toBe('Amazon Best Sellers: Best Desktop & Off-Surface Shelves');
+    });
+});

package/dist/clis/amazon/discussion.d.ts

@@ -0,0 +1,20 @@
+interface DiscussionPayload {
+    href?: string;
+    title?: string;
+    average_rating_text?: string | null;
+    total_review_count_text?: string | null;
+    qa_links?: string[];
+    review_samples?: Array<{
+        title?: string | null;
+        rating_text?: string | null;
+        author?: string | null;
+        date_text?: string | null;
+        body?: string | null;
+        verified?: boolean;
+    }>;
+}
+declare function normalizeDiscussionPayload(payload: DiscussionPayload): Record<string, unknown>;
+export declare const __test__: {
+    normalizeDiscussionPayload: typeof normalizeDiscussionPayload;
+};
+export {};

package/dist/clis/amazon/discussion.js

@@ -0,0 +1,91 @@
+import { CommandExecutionError } from '../../errors.js';
+import { cli, Strategy } from '../../registry.js';
+import { buildDiscussionUrl, buildProvenance, cleanText, extractAsin, normalizeProductUrl, parseRatingValue, parseReviewCount, trimRatingPrefix, uniqueNonEmpty, assertUsableState, gotoAndReadState, } from './shared.js';
+function normalizeDiscussionPayload(payload) {
+    const sourceUrl = cleanText(payload.href) || buildDiscussionUrl(payload.href ?? '');
+    const asin = extractAsin(payload.href ?? '') ?? null;
+    const averageRatingText = cleanText(payload.average_rating_text) || null;
+    const totalReviewCountText = cleanText(payload.total_review_count_text) || null;
+    const provenance = buildProvenance(sourceUrl);
+    return {
+        asin,
+        product_url: asin ? normalizeProductUrl(asin) : null,
+        discussion_url: sourceUrl,
+        ...provenance,
+        average_rating_text: averageRatingText,
+        average_rating_value: parseRatingValue(averageRatingText),
+        total_review_count_text: totalReviewCountText,
+        total_review_count: parseReviewCount(totalReviewCountText),
+        qa_urls: uniqueNonEmpty(payload.qa_links ?? []),
+        review_samples: (payload.review_samples ?? []).map((sample) => ({
+            title: trimRatingPrefix(sample.title) || null,
+            rating_text: cleanText(sample.rating_text) || null,
+            rating_value: parseRatingValue(sample.rating_text),
+            author: cleanText(sample.author) || null,
+            date_text: cleanText(sample.date_text) || null,
+            body: cleanText(sample.body) || null,
+            verified_purchase: sample.verified === true,
+        })),
+    };
+}
+async function readDiscussionPayload(page, input, limit) {
+    const url = buildDiscussionUrl(input);
+    const state = await gotoAndReadState(page, url, 2500, 'discussion');
+    assertUsableState(state, 'discussion');
+    return await page.evaluate(`
+    (() => ({
+      href: window.location.href,
+      title: document.title || '',
+      average_rating_text: document.querySelector('[data-hook="rating-out-of-text"]')?.textContent || '',
+      total_review_count_text: document.querySelector('[data-hook="total-review-count"]')?.textContent || '',
+      qa_links: Array.from(document.querySelectorAll('a[href*="ask/questions"]')).map((anchor) => anchor.href || ''),
+      review_samples: Array.from(document.querySelectorAll('[data-hook="review"]')).slice(0, ${limit}).map((card) => ({
+        title: card.querySelector('[data-hook="review-title"]')?.textContent || '',
+        rating_text:
+          card.querySelector('[data-hook="review-star-rating"]')?.textContent
+          || card.querySelector('[data-hook="cmps-review-star-rating"]')?.textContent
+          || '',
+        author: card.querySelector('.a-profile-name')?.textContent || '',
+        date_text: card.querySelector('[data-hook="review-date"]')?.textContent || '',
+        body: card.querySelector('[data-hook="review-body"]')?.textContent || '',
+        verified: !!card.querySelector('[data-hook="avp-badge"]'),
+      })),
+    }))()
+  `);
+}
+cli({
+    site: 'amazon',
+    name: 'discussion',
+    description: 'Amazon review summary and sample customer discussion from product review pages',
+    domain: 'amazon.com',
+    strategy: Strategy.COOKIE,
+    navigateBefore: false,
+    args: [
+        {
+            name: 'input',
+            required: true,
+            positional: true,
+            help: 'ASIN or product URL, for example B0FJS72893',
+        },
+        {
+            name: 'limit',
+            type: 'int',
+            default: 10,
+            help: 'Maximum number of review samples to return (default 10)',
+        },
+    ],
+    columns: ['asin', 'average_rating_value', 'total_review_count'],
+    func: async (page, kwargs) => {
+        const input = String(kwargs.input ?? '');
+        const limit = Math.max(1, Number(kwargs.limit) || 10);
+        const payload = await readDiscussionPayload(page, input, limit);
+        const normalized = normalizeDiscussionPayload(payload);
+        if (!normalized.average_rating_text && !normalized.total_review_count_text) {
+            throw new CommandExecutionError('amazon discussion page did not expose review summary', 'The review page may have changed or hit a robot check. Open the review page in Chrome and retry.');
+        }
+        return [normalized];
+    },
+});
+export const __test__ = {
+    normalizeDiscussionPayload,
+};

package/dist/clis/amazon/discussion.test.js

@@ -0,0 +1,36 @@
+import { describe, expect, it } from 'vitest';
+import { __test__ } from './discussion.js';
+describe('amazon discussion normalization', () => {
+    it('normalizes review summary and sample reviews', () => {
+        const result = __test__.normalizeDiscussionPayload({
+            href: 'https://www.amazon.com/product-reviews/B0FJS72893',
+            average_rating_text: '3.9 out of 5',
+            total_review_count_text: '27 global ratings',
+            qa_links: [],
+            review_samples: [
+                {
+                    title: '5.0 out of 5 stars Great value and quality',
+                    rating_text: '5.0 out of 5 stars',
+                    author: 'GTreader2',
+                    date_text: 'Reviewed in the United States on February 21, 2026',
+                    body: 'Small but mighty.',
+                    verified: true,
+                },
+            ],
+        });
+        expect(result.asin).toBe('B0FJS72893');
+        expect(result.average_rating_value).toBe(3.9);
+        expect(result.total_review_count).toBe(27);
+        expect(result.review_samples).toEqual([
+            {
+                title: 'Great value and quality',
+                rating_text: '5.0 out of 5 stars',
+                rating_value: 5,
+                author: 'GTreader2',
+                date_text: 'Reviewed in the United States on February 21, 2026',
+                body: 'Small but mighty.',
+                verified_purchase: true,
+            },
+        ]);
+    });
+});

package/dist/clis/amazon/offer.d.ts

@@ -0,0 +1,23 @@
+interface OfferPayload {
+    href?: string;
+    title?: string;
+    price_text?: string | null;
+    merchant_info?: string | null;
+    sold_by?: string | null;
+    ships_from_text?: string | null;
+    offer_link?: string | null;
+    review_url?: string | null;
+    qa_url?: string | null;
+    buybox_text?: string | null;
+}
+declare function extractShipsFrom(text: string): string | null;
+declare function extractSoldBy(text: string): string | null;
+declare function isDeliveryLocationBlocked(text: string | null | undefined): boolean;
+declare function normalizeOfferPayload(payload: OfferPayload): Record<string, unknown>;
+export declare const __test__: {
+    extractShipsFrom: typeof extractShipsFrom;
+    extractSoldBy: typeof extractSoldBy;
+    isDeliveryLocationBlocked: typeof isDeliveryLocationBlocked;
+    normalizeOfferPayload: typeof normalizeOfferPayload;
+};
+export {};