chore: import upstream snapshot with attribution

clis/substack/search.js

@@ -0,0 +1,79 @@
+import { CommandExecutionError } from '@jackwener/opencli/errors';
+import { cli, Strategy } from '@jackwener/opencli/registry';
+function headers() {
+    return {
+        'User-Agent': 'Mozilla/5.0',
+        Accept: 'application/json',
+    };
+}
+function trim(value) {
+    return typeof value === 'string' ? value.replace(/\s+/g, ' ').trim() : '';
+}
+function publicationBaseUrl(publication) {
+    if (publication?.custom_domain)
+        return `https://${publication.custom_domain}`;
+    if (publication?.subdomain)
+        return `https://${publication.subdomain}.substack.com`;
+    return '';
+}
+async function searchPosts(keyword, limit) {
+    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 CommandExecutionError(`Substack post search failed: HTTP ${resp.status}`);
+    const data = await resp.json();
+    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, limit) {
+    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 CommandExecutionError(`Substack publication search failed: HTTP ${resp.status}`);
+    const data = await resp.json();
+    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',
+    access: 'read',
+    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 (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);
+    },
+});