jackwener
diff --git a/‎README.md‎
Lines changed: 2 additions & 0 deletions b/‎README.md‎
Lines changed: 2 additions & 0 deletions
diff --git a/‎README.zh-CN.md‎
Lines changed: 2 additions & 0 deletions b/‎README.zh-CN.md‎
Lines changed: 2 additions & 0 deletions
diff --git a/‎docs/.vitepress/config.mts‎
Lines changed: 1 addition & 0 deletions b/‎docs/.vitepress/config.mts‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎docs/adapters/browser/pixiv.md‎
Lines changed: 92 additions & 0 deletions b/‎docs/adapters/browser/pixiv.md‎
Lines changed: 92 additions & 0 deletions
diff --git a/‎docs/adapters/index.md‎
Lines changed: 1 addition & 0 deletions b/‎docs/adapters/index.md‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎src/clis/pixiv/detail.yaml‎
Lines changed: 49 additions & 0 deletions b/‎src/clis/pixiv/detail.yaml‎
Lines changed: 49 additions & 0 deletions
diff --git a/‎src/clis/pixiv/download.test.ts‎
Lines changed: 114 additions & 0 deletions b/‎src/clis/pixiv/download.test.ts‎
Lines changed: 114 additions & 0 deletions
diff --git a/‎src/clis/pixiv/download.ts‎
Lines changed: 91 additions & 0 deletions b/‎src/clis/pixiv/download.ts‎
Lines changed: 91 additions & 0 deletions
@@ -174,6 +174,7 @@ Run `opencli list` for the live registry.
 | **medium** | `feed` `search` `user` | Browser |
 | **sinablog** | `hot` `search` `article` `user` | Browser |
 | **substack** | `feed` `search` `publication` | Browser |
+| **pixiv** | `ranking` `search` `user` `illusts` `detail` `download` | Browser |
 | **tiktok** | `explore` `search` `profile` `user` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `live` `notifications` `friends` | Browser |
 
 
@@ -225,6 +226,7 @@ OpenCLI supports downloading images, videos, and articles from supported platfor
 | **xiaohongshu** | Images, Videos | Downloads all media from a note |
 | **bilibili** | Videos | Requires `yt-dlp` installed |
 | **twitter** | Images, Videos | Downloads from user media tab or single tweet |
+| **pixiv** | Images | Downloads original-quality illustrations, supports multi-page works |
 | **zhihu** | Articles (Markdown) | Exports articles with optional image download |
 | **weixin** | Articles (Markdown) | Exports WeChat Official Account articles |
 
 
@@ -176,6 +176,7 @@ npm install -g @jackwener/opencli@latest
 | **medium** | `feed` `search` `user` | 浏览器 |
 | **sinablog** | `hot` `search` `article` `user` | 浏览器 |
 | **substack** | `feed` `search` `publication` | 浏览器 |
+| **pixiv** | `ranking` `search` `user` `illusts` `detail` `download` | 浏览器 |
 | **tiktok** | `explore` `search` `profile` `user` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `live` `notifications` `friends` | 浏览器 |
 
 
@@ -227,6 +228,7 @@ OpenCLI 支持从各平台下载图片、视频和文章。
 | **小红书** | 图片、视频 | 下载笔记中的所有媒体文件 |
 | **B站** | 视频 | 需要安装 `yt-dlp` |
 | **Twitter/X** | 图片、视频 | 从用户媒体页或单条推文下载 |
+| **Pixiv** | 图片 | 下载原始画质插画，支持多页作品 |
 | **知乎** | 文章（Markdown） | 导出文章，可选下载图片到本地 |
 | **微信公众号** | 文章（Markdown） | 导出微信公众号文章为 Markdown |
 
 
@@ -73,6 +73,7 @@ export default defineConfig({
                 { text: 'Douban', link: '/adapters/browser/douban' },
                 { text: 'Sina Blog', link: '/adapters/browser/sinablog' },
                 { text: 'Substack', link: '/adapters/browser/substack' },
+                { text: 'Pixiv', link: '/adapters/browser/pixiv' },
               ],
             },
             {
 
@@ -0,0 +1,92 @@
+# Pixiv
+
+**Mode**: 🔐 Browser · **Domain**: `www.pixiv.net`
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli pixiv ranking` | Daily/weekly/monthly illustration rankings |
+| `opencli pixiv search <query>` | Search illustrations by keyword or tag |
+| `opencli pixiv user <uid>` | View artist profile info |
+| `opencli pixiv illusts <user-id>` | List illustrations by artist |
+| `opencli pixiv detail <id>` | View illustration details |
+| `opencli pixiv download <illust-id>` | Download original-quality images |
+
+## Usage Examples
+
+### Ranking
+
+```bash
+# Daily rankings (default)
+opencli pixiv ranking --limit 10
+
+# Weekly / monthly rankings
+opencli pixiv ranking --mode weekly
+opencli pixiv ranking --mode monthly
+
+# R18 rankings
+opencli pixiv ranking --mode daily_r18
+opencli pixiv ranking --mode weekly_r18
+
+# Other modes: rookie, original, male, female
+opencli pixiv ranking --mode rookie
+```
+
+### Search
+
+```bash
+# Search by keyword or tag
+opencli pixiv search "初音ミク" --limit 20
+
+# Filter by content rating
+opencli pixiv search "風景" --mode safe       # Safe-for-work only
+opencli pixiv search "風景" --mode r18        # R18 only
+opencli pixiv search "風景" --mode all        # All (default)
+
+# Sort by popularity
+opencli pixiv search "VOCALOID" --order popular_d
+
+# All sort options: date_d (newest), date (oldest), popular_d, popular_male_d, popular_female_d
+
+# Pagination
+opencli pixiv search "オリジナル" --page 2 --limit 30
+```
+
+### User & Illustrations
+
+```bash
+# View artist profile
+opencli pixiv user 11
+
+# List artist's illustrations (newest first)
+opencli pixiv illusts 11 --limit 10
+
+# View illustration details (tags, stats, type)
+opencli pixiv detail 12345678
+```
+
+### Download
+
+```bash
+# Download all images from an illustration
+opencli pixiv download 12345678
+
+# Download to a custom directory
+opencli pixiv download 12345678 --output ./my-images
+```
+
+### Output Formats
+
+```bash
+# JSON output
+opencli pixiv ranking -f json
+
+# Verbose mode
+opencli pixiv search "test" -v
+```
+
+## Prerequisites
+
+- Chrome running and **logged into** pixiv.net
+- [Browser Bridge extension](/guide/browser-bridge) installed
@@ -36,6 +36,7 @@ Run `opencli list` for the live registry.
 | **[medium](/adapters/browser/medium)** | `feed` `search` `user` | 🔐 Browser |
 | **[sinablog](/adapters/browser/sinablog)** | `hot` `search` `article` `user` | 🔐 Browser |
 | **[substack](/adapters/browser/substack)** | `feed` `search` `publication` | 🔐 Browser |
+| **[pixiv](/adapters/browser/pixiv)** | `ranking` `search` `user` `illusts` `detail` `download` | 🔐 Browser |
 | **[tiktok](/adapters/browser/tiktok)** | `explore` `search` `profile` `user` `following` `follow` `unfollow` `like` `unlike` `comment` `save` `unsave` `live` `notifications` `friends` | 🔐 Browser |
 
 ## Public API Adapters
 
@@ -0,0 +1,49 @@
+site: pixiv
+name: detail
+description: View illustration details (tags, stats, URLs)
+domain: www.pixiv.net
+strategy: cookie
+browser: true
+
+args:
+  id:
+    type: str
+    required: true
+    positional: true
+    description: Illustration ID
+
+pipeline:
+  - navigate: https://www.pixiv.net
+
+  - evaluate: |
+      (async () => {
+        const id = ${{ args.id | json }};
+        const res = await fetch(
+          'https://www.pixiv.net/ajax/illust/' + id,
+          { credentials: 'include' }
+        );
+        if (!res.ok) {
+          if (res.status === 401 || res.status === 403) throw new Error('Authentication required — please log in to Pixiv in Chrome');
+          if (res.status === 404) throw new Error('Illustration not found: ' + id);
+          throw new Error('Pixiv request failed (HTTP ' + res.status + ')');
+        }
+        const data = await res.json();
+        const b = data?.body;
+        if (!b) throw new Error('Illustration not found');
+        return [{
+          illust_id: b.illustId,
+          title: b.illustTitle,
+          author: b.userName,
+          user_id: b.userId,
+          type: b.illustType === 0 ? 'illust' : b.illustType === 1 ? 'manga' : b.illustType === 2 ? 'ugoira' : String(b.illustType),
+          pages: b.pageCount,
+          bookmarks: b.bookmarkCount,
+          likes: b.likeCount,
+          views: b.viewCount,
+          tags: (b.tags?.tags || []).map(t => t.tag).join(', '),
+          created: b.createDate?.split('T')[0] || '',
+          url: 'https://www.pixiv.net/artworks/' + b.illustId
+        }];
+      })()
+
+columns: [illust_id, title, author, type, pages, bookmarks, likes, views, tags, created, url]
@@ -0,0 +1,114 @@
+import { beforeAll, beforeEach, describe, expect, it, vi } from 'vitest';
+import type { CliCommand } from '../../registry.js';
+import { getRegistry } from '../../registry.js';
+import { AuthRequiredError, CommandExecutionError } from '../../errors.js';
+import { createPageMock } from './test-utils.js';
+
+// Mock download dependencies before importing the adapter
+const { mockHttpDownload, mockMkdirSync } = vi.hoisted(() => ({
+  mockHttpDownload: vi.fn(),
+  mockMkdirSync: vi.fn(),
+}));
+
+vi.mock('../../download/index.js', () => ({
+  formatCookieHeader: vi.fn().mockReturnValue('cookie=value'),
+  httpDownload: mockHttpDownload,
+}));
+
+vi.mock('node:fs', () => ({
+  mkdirSync: mockMkdirSync,
+}));
+
+// Now import the adapter (after mocks are set up)
+await import('./download.js');
+
+let cmd: CliCommand;
+
+beforeAll(() => {
+  cmd = getRegistry().get('pixiv/download')!;
+  expect(cmd?.func).toBeTypeOf('function');
+});
+
+describe('pixiv download', () => {
+  beforeEach(() => {
+    mockHttpDownload.mockReset();
+    mockMkdirSync.mockReset();
+  });
+
+  it('throws CommandExecutionError on invalid illust ID', async () => {
+    const page = createPageMock([]);
+
+    await expect(cmd.func!(page, { 'illust-id': 'abc', output: '/tmp/test' })).rejects.toThrow(CommandExecutionError);
+  });
+
+  it('throws AuthRequiredError on 403', async () => {
+    const page = createPageMock([{ __httpError: 403 }]);
+
+    await expect(cmd.func!(page, { 'illust-id': '12345', output: '/tmp/test' })).rejects.toThrow(AuthRequiredError);
+  });
+
+  it('throws CommandExecutionError on 404', async () => {
+    const page = createPageMock([{ __httpError: 404 }]);
+
+    await expect(cmd.func!(page, { 'illust-id': '12345', output: '/tmp/test' })).rejects.toThrow(CommandExecutionError);
+  });
+
+  it('throws CommandExecutionError on non-auth HTTP failure', async () => {
+    const page = createPageMock([{ __httpError: 500 }]);
+
+    await expect(cmd.func!(page, { 'illust-id': '12345', output: '/tmp/test' })).rejects.toThrow(CommandExecutionError);
+  });
+
+  it('returns failure when no images found', async () => {
+    const page = createPageMock([{ body: [] }]);
+
+    const result = (await cmd.func!(page, { 'illust-id': '12345', output: '/tmp/test' })) as any[];
+    expect(result).toEqual([{ index: 0, type: '-', status: 'failed', size: 'No images found' }]);
+  });
+
+  it('downloads images with Referer header', async () => {
+    mockHttpDownload.mockResolvedValue({ success: true, size: 1024000 });
+
+    const page = createPageMock([
+      {
+        body: [
+          { urls: { original: 'https://i.pximg.net/img-original/img/2025/01/01/00/00/00/12345_p0.png' } },
+          { urls: { original: 'https://i.pximg.net/img-original/img/2025/01/01/00/00/00/12345_p1.jpg' } },
+        ],
+      },
+    ]);
+
+    const result = (await cmd.func!(page, { 'illust-id': '12345', output: '/tmp/test' })) as any[];
+
+    expect(result).toHaveLength(2);
+    expect(result[0]).toMatchObject({ index: 1, type: 'image', status: 'success' });
+    expect(result[1]).toMatchObject({ index: 2, type: 'image', status: 'success' });
+
+    // Verify Referer header was passed
+    expect(mockHttpDownload).toHaveBeenCalledTimes(2);
+    const firstCallOpts = mockHttpDownload.mock.calls[0][2];
+    expect(firstCallOpts.headers).toEqual({ Referer: 'https://www.pixiv.net/' });
+  });
+
+  it('handles individual download failures gracefully', async () => {
+    mockHttpDownload
+      .mockResolvedValueOnce({ success: true, size: 512000 })
+      .mockRejectedValueOnce(new Error('Connection timeout'));
+
+    const page = createPageMock([
+      {
+        body: [
+          { urls: { original: 'https://i.pximg.net/img/12345_p0.png' } },
+          { urls: { original: 'https://i.pximg.net/img/12345_p1.png' } },
+        ],
+      },
+    ]);
+
+    const result = (await cmd.func!(page, { 'illust-id': '12345', output: '/tmp/test' })) as any[];
+
+    expect(result).toHaveLength(2);
+    expect(result[0].status).toBe('success');
+    expect(result[1].status).toBe('failed');
+    expect(result[1].size).toBe('Connection timeout');
+  });
+});
@@ -0,0 +1,91 @@
+/**
+ * Pixiv download — download all images from an illustration.
+ *
+ * Pixiv's CDN (i.pximg.net) requires Referer: https://www.pixiv.net/ header.
+ * Uses the /ajax/illust/{id}/pages API to get original-quality image URLs.
+ */
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { cli, Strategy } from '../../registry.js';
+import { formatCookieHeader, httpDownload } from '../../download/index.js';
+import { formatBytes } from '../../download/progress.js';
+import { CommandExecutionError } from '../../errors.js';
+import { pixivFetch } from './utils.js';
+
+cli({
+  site: 'pixiv',
+  name: 'download',
+  description: 'Download illustration images from Pixiv',
+  domain: 'www.pixiv.net',
+  strategy: Strategy.COOKIE,
+  args: [
+    { name: 'illust-id', positional: true, required: true, help: 'Illustration ID' },
+    { name: 'output', default: './pixiv-downloads', help: 'Output directory' },
+  ],
+  columns: ['index', 'type', 'status', 'size'],
+
+  func: async (page, kwargs) => {
+    const illustId = String(kwargs['illust-id'] ?? '');
+    const output = String(kwargs.output ?? './pixiv-downloads');
+
+    if (!/^\d+$/.test(illustId)) {
+      throw new CommandExecutionError(`Invalid illustration ID: ${illustId}`);
+    }
+
+    // pixivFetch handles navigate + error checking; returns the response body directly
+    const pages: any[] = await pixivFetch(page, `/ajax/illust/${illustId}/pages`, {
+      notFoundMsg: `Illustration not found: ${illustId}`,
+    }) || [];
+
+    if (pages.length === 0) {
+      return [{ index: 0, type: '-', status: 'failed', size: 'No images found' }];
+    }
+
+    // Extract cookies for authenticated downloads
+    const cookies = formatCookieHeader(await page.getCookies({ domain: 'pixiv.net' }));
+
+    // Create output directory
+    const outputDir = path.join(output, illustId);
+    fs.mkdirSync(outputDir, { recursive: true });
+
+    const results = [];
+
+    for (let i = 0; i < pages.length; i++) {
+      const p = pages[i];
+      const url = p.urls?.original || p.urls?.regular || '';
+      if (!url) {
+        results.push({ index: i + 1, type: 'image', status: 'failed', size: 'No URL' });
+        continue;
+      }
+
+      try {
+        const ext = path.extname(new URL(url).pathname) || '.jpg';
+        const filename = `${illustId}_p${i}${ext}`;
+        const destPath = path.join(outputDir, filename);
+
+        const result = await httpDownload(url, destPath, {
+          cookies,
+          headers: { Referer: 'https://www.pixiv.net/' },
+          timeout: 60000,
+        });
+
+        results.push({
+          index: i + 1,
+          type: 'image',
+          status: result.success ? 'success' : 'failed',
+          size: result.success ? formatBytes(result.size) : (result.error || 'unknown error'),
+        });
+      } catch (err: any) {
+        results.push({
+          index: i + 1,
+          type: 'image',
+          status: 'failed',
+          size: err.message,
+        });
+      }
+    }
+
+    return results;
+  },
+});
Original file line number	Diff line number	Diff line change
`@@ -73,6 +73,7 @@ export default defineConfig({`
`73`	`73`	`{ text: 'Douban', link: '/adapters/browser/douban' },`
`74`	`74`	`{ text: 'Sina Blog', link: '/adapters/browser/sinablog' },`
`75`	`75`	`{ text: 'Substack', link: '/adapters/browser/substack' },`
	`76`	`+ { text: 'Pixiv', link: '/adapters/browser/pixiv' },`
`76`	`77`	`],`
`77`	`78`	`},`
`78`	`79`	`{`