@jackwener/opencli 1.1.1 → 1.2.1

package/src/clis/medium/shared.ts

@@ -0,0 +1,83 @@
+import type { IPage } from '../../types.js';
+
+export function buildMediumTagUrl(topic?: string): string {
+  return topic ? `https://medium.com/tag/${encodeURIComponent(topic)}` : 'https://medium.com/tag/technology';
+}
+
+export function buildMediumSearchUrl(keyword: string): string {
+  return `https://medium.com/search?q=${encodeURIComponent(keyword)}`;
+}
+
+export function buildMediumUserUrl(username: string): string {
+  return username.startsWith('@') ? `https://medium.com/${username}` : `https://medium.com/@${username}`;
+}
+
+export async function loadMediumPosts(page: IPage, url: string, limit: number): Promise<any[]> {
+  if (!page) throw new Error('Requires browser session');
+  await page.goto(url);
+  await page.wait(5);
+  const data = await page.evaluate(`
+    (async () => {
+      await new Promise((resolve) => setTimeout(resolve, 3000));
+
+      const limit = ${Math.max(1, Math.min(limit, 50))};
+      const normalize = (value) => (value || '').replace(/\\s+/g, ' ').trim();
+      const posts = [];
+      const seen = new Set();
+
+      for (const article of Array.from(document.querySelectorAll('article'))) {
+        try {
+          const titleEl = article.querySelector('h2, h3, h1');
+          const title = normalize(titleEl?.textContent);
+          if (!title) continue;
+
+          const linkEl = titleEl?.closest('a') || article.querySelector('a[href*="/@"], a[href*="/p/"]');
+          let url = linkEl?.getAttribute('href') || '';
+          if (!url) continue;
+          if (!url.startsWith('http')) url = 'https://medium.com' + url;
+          if (seen.has(url)) continue;
+
+          const author = normalize(
+            Array.from(article.querySelectorAll('a[href^="/@"]'))
+              .map((node) => normalize(node.textContent))
+              .find((text) => text && text !== title),
+          );
+
+          const allText = normalize(article.textContent);
+          const dateEl = article.querySelector('time');
+          const date = normalize(dateEl?.textContent) ||
+            dateEl?.getAttribute('datetime') ||
+            allText.match(/\\b(?:[A-Z][a-z]{2}\\s+\\d{1,2}|\\d+[dhmw]\\s+ago)\\b/)?.[0] ||
+            '';
+
+          const readTime = allText.match(/(\\d+)\\s*min\\s*read/i)?.[0] || '';
+          const claps = allText.match(/\\b(\\d+(?:\\.\\d+)?[KkMm]?)\\s*claps?\\b/i)?.[1] || '';
+
+          const description = normalize(
+            Array.from(article.querySelectorAll('h3, p'))
+              .map((node) => normalize(node.textContent))
+              .find((text) => text && text !== title && text !== author && !/member-only story|response icon/i.test(text)),
+          );
+
+          seen.add(url);
+          posts.push({
+            rank: posts.length + 1,
+            title,
+            author,
+            date,
+            readTime,
+            claps,
+            description: description ? description.slice(0, 150) : '',
+            url,
+          });
+
+          if (posts.length >= limit) break;
+        } catch {}
+      }
+
+      return posts;
+    })()
+  `);
+
+  return Array.isArray(data) ? data : [];
+}

package/src/clis/medium/user.ts

@@ -0,0 +1,16 @@
+import { cli, Strategy } from '../../registry.js';
+import { buildMediumUserUrl, loadMediumPosts } from './shared.js';
+
+cli({
+  site: 'medium',
+  name: 'user',
+  description: '获取 Medium 用户的文章列表',
+  domain: 'medium.com',
+  strategy: Strategy.COOKIE,
+  args: [
+    { name: 'username', required: true, positional: true, help: 'Medium 用户名（如 @username 或 username）' },
+    { name: 'limit', type: 'int', default: 20, help: '返回的文章数量' },
+  ],
+  columns: ['rank', 'title', 'date', 'readTime', 'claps', 'url'],
+  func: async (page, args) => loadMediumPosts(page, buildMediumUserUrl(args.username), Number(args.limit) || 20),
+});

package/src/clis/reddit/comment.ts

@@ -8,7 +8,7 @@ cli({
   strategy: Strategy.COOKIE,
   browser: true,
   args: [
-    { name: 'post-id', type: 'string', required: true, help: 'Post ID (e.g. 1abc123) or fullname (t3_xxx)' },
+    { name: 'post-id', type: 'string', required: true, positional: true, help: 'Post ID (e.g. 1abc123) or fullname (t3_xxx)' },
     { name: 'text', type: 'string', required: true, positional: true, help: 'Comment text' },
   ],
   columns: ['status', 'message'],

package/src/clis/reddit/read.ts

@@ -15,7 +15,7 @@ cli({
   domain: 'reddit.com',
   strategy: Strategy.COOKIE,
   args: [
-    { name: 'post-id', required: true, help: 'Post ID (e.g. 1abc123) or full URL' },
+    { name: 'post-id', required: true, positional: true, help: 'Post ID (e.g. 1abc123) or full URL' },
     { name: 'sort', default: 'best', help: 'Comment sort: best, top, new, controversial, old, qa' },
     { name: 'limit', type: 'int', default: 25, help: 'Number of top-level comments' },
     { name: 'depth', type: 'int', default: 2, help: 'Max reply depth (1=no replies, 2=one level of replies, etc.)' },

package/src/clis/reddit/save.ts

@@ -8,7 +8,7 @@ cli({
   strategy: Strategy.COOKIE,
   browser: true,
   args: [
-    { name: 'post-id', type: 'string', required: true, help: 'Post ID (e.g. 1abc123) or fullname (t3_xxx)' },
+    { name: 'post-id', type: 'string', required: true, positional: true, help: 'Post ID (e.g. 1abc123) or fullname (t3_xxx)' },
     { name: 'undo', type: 'boolean', default: false, help: 'Unsave instead of save' },
   ],
   columns: ['status', 'message'],

package/src/clis/reddit/subreddit.yaml

@@ -8,6 +8,7 @@ browser: true
 args:
   name:
     type: string
+    positional: true
     required: true
   sort:
     type: string

package/src/clis/reddit/subscribe.ts

@@ -8,7 +8,7 @@ cli({
   strategy: Strategy.COOKIE,
   browser: true,
   args: [
-    { name: 'subreddit', type: 'string', required: true, help: 'Subreddit name (e.g. python)' },
+    { name: 'subreddit', type: 'string', required: true, positional: true, help: 'Subreddit name (e.g. python)' },
     { name: 'undo', type: 'boolean', default: false, help: 'Unsubscribe instead of subscribe' },
   ],
   columns: ['status', 'message'],

package/src/clis/reddit/upvote.ts

@@ -8,7 +8,7 @@ cli({
   strategy: Strategy.COOKIE,
   browser: true,
   args: [
-    { name: 'post-id', type: 'string', required: true, help: 'Post ID (e.g. 1abc123) or fullname (t3_xxx)' },
+    { name: 'post-id', type: 'string', required: true, positional: true, help: 'Post ID (e.g. 1abc123) or fullname (t3_xxx)' },
     { name: 'direction', type: 'string', default: 'up', help: 'Vote direction: up, down, none' },
   ],
   columns: ['status', 'message'],

package/src/clis/sinablog/article.ts

@@ -0,0 +1,15 @@
+import { cli, Strategy } from '../../registry.js';
+import { loadSinaBlogArticle } from './shared.js';
+
+cli({
+  site: 'sinablog',
+  name: 'article',
+  description: '获取新浪博客单篇文章详情',
+  domain: 'blog.sina.com.cn',
+  strategy: Strategy.COOKIE,
+  args: [
+    { name: 'url', required: true, positional: true, help: '文章URL（如 https://blog.sina.com.cn/s/blog_xxx.html）' },
+  ],
+  columns: ['title', 'author', 'date', 'category', 'readCount', 'commentCount'],
+  func: async (page, args) => loadSinaBlogArticle(page, args.url),
+});

package/src/clis/sinablog/hot.ts

@@ -0,0 +1,15 @@
+import { cli, Strategy } from '../../registry.js';
+import { loadSinaBlogHot } from './shared.js';
+
+cli({
+  site: 'sinablog',
+  name: 'hot',
+  description: '获取新浪博客热门文章/推荐',
+  domain: 'blog.sina.com.cn',
+  strategy: Strategy.COOKIE,
+  args: [
+    { name: 'limit', type: 'int', default: 20, help: '返回的文章数量' },
+  ],
+  columns: ['rank', 'title', 'author', 'date', 'readCount', 'url'],
+  func: async (page, args) => loadSinaBlogHot(page, Number(args.limit) || 20),
+});

package/src/clis/sinablog/search.ts

@@ -0,0 +1,56 @@
+import { cli, Strategy } from '../../registry.js';
+
+function normalize(value: unknown): string {
+  return typeof value === 'string' ? value.replace(/\s+/g, ' ').trim() : '';
+}
+
+function stripHtml(value: string): string {
+  return value.replace(/<[^>]+>/g, '');
+}
+
+async function searchSinaBlog(keyword: string, limit: number): Promise<any[]> {
+  const url = new URL('https://search.sina.com.cn/api/search');
+  url.searchParams.set('q', keyword);
+  url.searchParams.set('tp', 'mix');
+  url.searchParams.set('sort', '0');
+  url.searchParams.set('page', '1');
+  url.searchParams.set('size', String(Math.max(limit, 10)));
+  url.searchParams.set('from', 'search_result');
+
+  const resp = await fetch(url, {
+    headers: {
+      'User-Agent': 'Mozilla/5.0',
+      Accept: 'application/json',
+    },
+  });
+  if (!resp.ok) throw new Error(`Sina blog search failed: HTTP ${resp.status}`);
+
+  const data = await resp.json() as { data?: { list?: any[] } };
+  const list = Array.isArray(data?.data?.list) ? data.data.list : [];
+  return list
+    .filter((item) => normalize(item?.url).includes('blog.sina.com.cn/s/blog_'))
+    .slice(0, limit)
+    .map((item, index) => ({
+      rank: index + 1,
+      title: normalize(stripHtml(item?.title || '')),
+      author: normalize(item?.media_show || item?.author),
+      date: normalize(item?.time || item?.dataTime),
+      description: normalize(item?.intro || item?.searchSummary).slice(0, 150),
+      url: normalize(item?.url),
+    }));
+}
+
+cli({
+  site: 'sinablog',
+  name: 'search',
+  description: '搜索新浪博客文章（通过新浪搜索）',
+  domain: 'blog.sina.com.cn',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'keyword', required: true, positional: true, help: '搜索关键词' },
+    { name: 'limit', type: 'int', default: 20, help: '返回的文章数量' },
+  ],
+  columns: ['rank', 'title', 'author', 'date', 'description', 'url'],
+  func: async (_page, args) => searchSinaBlog(args.keyword, Math.max(1, Math.min(Number(args.limit) || 20, 50))),
+});

package/src/clis/sinablog/shared.ts

@@ -0,0 +1,198 @@
+import type { IPage } from '../../types.js';
+
+function clampLimit(limit: number): number {
+  return Math.max(1, Math.min(limit || 20, 50));
+}
+
+export function buildSinaBlogSearchUrl(keyword: string): string {
+  return `https://search.sina.com.cn/search?q=${encodeURIComponent(keyword)}&tp=mix`;
+}
+
+export function buildSinaBlogUserUrl(uid: string): string {
+  return `https://blog.sina.com.cn/s/articlelist_${encodeURIComponent(uid)}_0_1.html`;
+}
+
+export async function loadSinaBlogArticle(page: IPage, url: string): Promise<any> {
+  await page.goto(url);
+  await page.wait(3);
+  return page.evaluate(`
+    (async () => {
+      await new Promise((resolve) => setTimeout(resolve, 1500));
+      const normalize = (value) => (value || '').replace(/\\s+/g, ' ').trim();
+      const title = normalize(document.querySelector('.articalTitle h2, .title h2, h1, h2.titName')?.textContent);
+      const titleParts = normalize(document.title).split('_').map((part) => normalize(part)).filter(Boolean);
+      const author = titleParts[1] || title.split(/[：:]/)[0] || '';
+      const timeText = normalize(document.querySelector('.time, .articalInfo .time')?.textContent).replace(/[()]/g, '');
+      const date = timeText || normalize(document.body.innerText.match(/\\b\\d{4}-\\d{2}-\\d{2}(?:\\s+\\d{2}:\\d{2}:\\d{2})?\\b/)?.[0]);
+      const category = normalize(document.querySelector('.articalTag .blog_class a, .blog_class a')?.textContent);
+      const tags = Array.from(document.querySelectorAll('.blog_tag h3, .blog_tag a, .tag a, .artical_tag a'))
+        .map((node) => normalize(node.textContent))
+        .filter(Boolean);
+      const content = normalize(document.querySelector('.articalContent, .blog_content, .content, #sina_keyword_ad_area2')?.textContent).slice(0, 500);
+      const images = Array.from(document.querySelectorAll('.articalContent img, .blog_content img, .content img'))
+        .map((img) => img.getAttribute('src') || img.getAttribute('real_src') || '')
+        .filter((src) => src && !src.includes('icon'))
+        .slice(0, 5);
+      return {
+        title,
+        author,
+        date,
+        category,
+        tags: tags.join(', '),
+        readCount: '',
+        commentCount: '',
+        content: content + (content.length >= 500 ? '...' : ''),
+        images: images.join(', '),
+        url: ${JSON.stringify(url)},
+      };
+    })()
+  `);
+}
+
+export async function loadSinaBlogHot(page: IPage, limit: number): Promise<any[]> {
+  const safeLimit = clampLimit(limit);
+  await page.goto('https://blog.sina.com.cn/');
+  await page.wait(3);
+  const data = await page.evaluate(`
+    (async () => {
+      await new Promise((resolve) => setTimeout(resolve, 1500));
+      const normalize = (value) => (value || '').replace(/\\s+/g, ' ').trim();
+      const limit = ${safeLimit};
+      const abs = (href) => {
+        if (!href) return '';
+        if (href.startsWith('//')) return 'https:' + href;
+        if (href.startsWith('http')) return href;
+        return 'https://blog.sina.com.cn' + (href.startsWith('/') ? '' : '/') + href;
+      };
+      const parseArticle = (doc, fallback) => {
+        const title = normalize(doc.querySelector('.articalTitle h2, .title h2, h1, h2.titName')?.textContent) || fallback.title;
+        const titleParts = normalize(doc.title).split('_').map((part) => normalize(part)).filter(Boolean);
+        const timeText = normalize(doc.querySelector('.time, .articalInfo .time')?.textContent).replace(/[()]/g, '');
+        const articleId = fallback.url.match(/blog_([a-zA-Z0-9]+)\\.html/)?.[1] || '';
+        return {
+          articleId,
+          title,
+          author: titleParts[1] || title.split(/[：:]/)[0] || '',
+          date: timeText || '',
+          readCount: '',
+          description: normalize(doc.querySelector('.articalContent, .blog_content, .content, #sina_keyword_ad_area2')?.textContent).slice(0, 150),
+        };
+      };
+
+      const seeds = [];
+      const seen = new Set();
+      for (const link of Array.from(document.querySelectorAll('.day-hot-rank .art-list a[href*="/s/blog_"], .hot-rank .art-list a[href*="/s/blog_"]'))) {
+        const title = normalize(link.textContent);
+        const url = abs(link.getAttribute('href') || '');
+        if (!title || !url || seen.has(url)) continue;
+        seen.add(url);
+        seeds.push({ rank: seeds.length + 1, title, url });
+        if (seeds.length >= limit) break;
+      }
+
+      const results = [];
+      for (const item of seeds) {
+        let merged = {
+          rank: item.rank,
+          articleId: item.url.match(/blog_([a-zA-Z0-9]+)\\.html/)?.[1] || '',
+          title: item.title,
+          author: '',
+          date: '',
+          readCount: '',
+          description: '',
+          url: item.url,
+        };
+        try {
+          const resp = await fetch(item.url, { credentials: 'include' });
+          if (resp.ok) {
+            const html = await resp.text();
+            const doc = new DOMParser().parseFromString(html, 'text/html');
+            merged = Object.assign(merged, parseArticle(doc, item));
+          }
+        } catch {}
+        results.push(merged);
+      }
+      return results;
+    })()
+  `);
+
+  return Array.isArray(data) ? data : [];
+}
+
+export async function loadSinaBlogSearch(page: IPage, keyword: string, limit: number): Promise<any[]> {
+  const safeLimit = clampLimit(limit);
+  await page.goto(buildSinaBlogSearchUrl(keyword));
+  await page.wait(5);
+  const data = await page.evaluate(`
+    (async () => {
+      const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+      for (let i = 0; i < 20; i += 1) {
+        if (document.querySelector('.result-item')) break;
+        await sleep(500);
+      }
+      const normalize = (value) => (value || '').replace(/\\s+/g, ' ').trim();
+      const limit = ${safeLimit};
+      const items = Array.from(document.querySelectorAll('.result-item'));
+      const results = [];
+      for (const item of items) {
+        const link = item.querySelector('.result-title a[href*="blog.sina.com.cn/s/blog_"]');
+        const title = normalize(link?.textContent);
+        const url = link?.getAttribute('href') || '';
+        if (!title || !url) continue;
+        results.push({
+          rank: results.length + 1,
+          title,
+          author: normalize(item.querySelector('.result-meta .source')?.textContent),
+          date: normalize(item.querySelector('.result-meta .time')?.textContent),
+          description: normalize(item.querySelector('.result-intro')?.textContent).slice(0, 150),
+          url,
+        });
+        if (results.length >= limit) break;
+      }
+      return results;
+    })()
+  `);
+
+  return Array.isArray(data) ? data : [];
+}
+
+export async function loadSinaBlogUser(page: IPage, uid: string, limit: number): Promise<any[]> {
+  const safeLimit = clampLimit(limit);
+  await page.goto(buildSinaBlogUserUrl(uid));
+  await page.wait(3);
+  const data = await page.evaluate(`
+    (async () => {
+      await new Promise((resolve) => setTimeout(resolve, 1000));
+      const normalize = (value) => (value || '').replace(/\\s+/g, ' ').trim();
+      const limit = ${safeLimit};
+      const author = normalize(document.title).split('_').map((part) => normalize(part)).filter(Boolean)[1] || '';
+      const abs = (href) => {
+        if (!href) return '';
+        if (href.startsWith('//')) return 'https:' + href;
+        if (href.startsWith('http')) return href;
+        return 'https://blog.sina.com.cn' + (href.startsWith('/') ? '' : '/') + href;
+      };
+      const results = [];
+      for (const item of Array.from(document.querySelectorAll('.articleList .articleCell'))) {
+        const link = item.querySelector('.atc_title a[href*="/s/blog_"]');
+        const title = normalize(link?.textContent);
+        const url = abs(link?.getAttribute('href') || '');
+        if (!title || !url) continue;
+        results.push({
+          rank: results.length + 1,
+          articleId: url.match(/blog_([a-zA-Z0-9]+)\\.html/)?.[1] || '',
+          title,
+          author,
+          date: normalize(item.querySelector('.atc_tm')?.textContent),
+          readCount: '',
+          description: '',
+          url,
+        });
+        if (results.length >= limit) break;
+      }
+      return results;
+    })()
+  `);
+
+  return Array.isArray(data) ? data : [];
+}

package/src/clis/sinablog/user.ts

@@ -0,0 +1,16 @@
+import { cli, Strategy } from '../../registry.js';
+import { loadSinaBlogUser } from './shared.js';
+
+cli({
+  site: 'sinablog',
+  name: 'user',
+  description: '获取新浪博客用户的文章列表',
+  domain: 'blog.sina.com.cn',
+  strategy: Strategy.COOKIE,
+  args: [
+    { name: 'uid', required: true, positional: true, help: '新浪博客用户ID（如 1234567890）' },
+    { name: 'limit', type: 'int', default: 20, help: '返回的文章数量' },
+  ],
+  columns: ['rank', 'title', 'author', 'date', 'readCount', 'url'],
+  func: async (page, args) => loadSinaBlogUser(page, args.uid, Number(args.limit) || 20),
+});

package/src/clis/substack/feed.ts

@@ -0,0 +1,16 @@
+import { cli, Strategy } from '../../registry.js';
+import { buildSubstackBrowseUrl, loadSubstackFeed } from './shared.js';
+
+cli({
+  site: 'substack',
+  name: 'feed',
+  description: 'Substack 热门文章 Feed',
+  domain: 'substack.com',
+  strategy: Strategy.COOKIE,
+  args: [
+    { name: 'category', default: 'all', help: '文章分类: all, tech, business, culture, politics, science, health' },
+    { name: 'limit', type: 'int', default: 20, help: '返回的文章数量' },
+  ],
+  columns: ['rank', 'title', 'author', 'date', 'readTime', 'url'],
+  func: async (page, args) => loadSubstackFeed(page, buildSubstackBrowseUrl(args.category), Number(args.limit) || 20),
+});

package/src/clis/substack/publication.ts

@@ -0,0 +1,16 @@
+import { cli, Strategy } from '../../registry.js';
+import { loadSubstackArchive } from './shared.js';
+
+cli({
+  site: 'substack',
+  name: 'publication',
+  description: '获取特定 Substack Newsletter 的最新文章',
+  domain: 'substack.com',
+  strategy: Strategy.COOKIE,
+  args: [
+    { name: 'url', required: true, positional: true, help: 'Newsletter URL（如 https://example.substack.com）' },
+    { name: 'limit', type: 'int', default: 20, help: '返回的文章数量' },
+  ],
+  columns: ['rank', 'title', 'date', 'description', 'url'],
+  func: async (page, args) => loadSubstackArchive(page, args.url.replace(/\/$/, ''), Number(args.limit) || 20),
+});

package/src/clis/substack/search.ts

@@ -0,0 +1,91 @@
+import { cli, Strategy } from '../../registry.js';
+
+type SubstackPostResult = {
+  title: string;
+  author: string;
+  date: string;
+  description: string;
+  url: string;
+};
+
+function headers(): HeadersInit {
+  return {
+    'User-Agent': 'Mozilla/5.0',
+    Accept: 'application/json',
+  };
+}
+
+function trim(value: unknown): string {
+  return typeof value === 'string' ? value.replace(/\s+/g, ' ').trim() : '';
+}
+
+function publicationBaseUrl(publication: any): string {
+  if (publication?.custom_domain) return `https://${publication.custom_domain}`;
+  if (publication?.subdomain) return `https://${publication.subdomain}.substack.com`;
+  return '';
+}
+
+async function searchPosts(keyword: string, limit: number): Promise<SubstackPostResult[]> {
+  const url = new URL('https://substack.com/api/v1/post/search');
+  url.searchParams.set('query', keyword);
+  url.searchParams.set('page', '0');
+  url.searchParams.set('includePlatformResults', 'true');
+
+  const resp = await fetch(url, { headers: headers() });
+  if (!resp.ok) throw new Error(`Substack post search failed: HTTP ${resp.status}`);
+
+  const data = await resp.json() as { results?: any[] };
+  const results = Array.isArray(data?.results) ? data.results : [];
+  return results.slice(0, limit).map((item, index) => ({
+    rank: index + 1,
+    title: trim(item?.title),
+    author: trim(item?.publishedBylines?.[0]?.name),
+    date: trim(item?.post_date).split('T')[0] || trim(item?.post_date),
+    description: trim(item?.description || item?.subtitle || item?.truncated_body_text).slice(0, 150),
+    url: trim(item?.canonical_url),
+  }));
+}
+
+async function searchPublications(keyword: string, limit: number): Promise<SubstackPostResult[]> {
+  const url = new URL('https://substack.com/api/v1/profile/search');
+  url.searchParams.set('query', keyword);
+  url.searchParams.set('page', '0');
+
+  const resp = await fetch(url, { headers: headers() });
+  if (!resp.ok) throw new Error(`Substack publication search failed: HTTP ${resp.status}`);
+
+  const data = await resp.json() as { results?: any[] };
+  const results = Array.isArray(data?.results) ? data.results : [];
+  return results.slice(0, limit).map((item, index) => {
+    const publication = item?.primaryPublication || item?.publicationUsers?.[0]?.publication || {};
+    return {
+      rank: index + 1,
+      title: trim(publication?.name || item?.name),
+      author: trim(item?.name),
+      date: '',
+      description: trim(publication?.hero_text || item?.bio).slice(0, 150),
+      url: publicationBaseUrl(publication),
+    };
+  });
+}
+
+cli({
+  site: 'substack',
+  name: 'search',
+  description: '搜索 Substack 文章和 Newsletter',
+  domain: 'substack.com',
+  strategy: Strategy.PUBLIC,
+  browser: false,
+  args: [
+    { name: 'keyword', required: true, positional: true, help: '搜索关键词' },
+    { name: 'type', default: 'posts', choices: ['posts', 'publications'], help: '搜索类型（posts=文章, publications=Newsletter）' },
+    { name: 'limit', type: 'int', default: 20, help: '返回结果数量' },
+  ],
+  columns: ['rank', 'title', 'author', 'date', 'description', 'url'],
+  func: async (_page, args) => {
+    const limit = Math.max(1, Math.min(Number(args.limit) || 20, 50));
+    return args.type === 'publications'
+      ? searchPublications(args.keyword, limit)
+      : searchPosts(args.keyword, limit);
+  },
+});