amenbo 0.1.4 → 0.2.0

package/README.en.md

@@ -0,0 +1,188 @@
+# amenbo 🐜💧
+
+English | [日本語](./README.md)
+
+**Skims the web without making waves** — a Japanese-web-native MCP server for low-impact, token-efficient web collection.
+
+amenbo (アメンボ / water strider) is an [MCP](https://modelcontextprotocol.io) server for coding agents such as Claude Code and Codex. Like the insect gliding across water without making ripples, it collects information from the web **with minimal load on target sites and minimal tokens** — optimized especially for **Japanese websites**. In shell environments without an MCP client, it also works as a CLI sharing the same core ([Using as a CLI](#using-as-a-cli)).
+
+## Why amenbo
+
+Most general-purpose scraping tools assume the English-speaking web. On Japanese sites they tend to miss content in the following ways — amenbo addresses each of them:
+
+- **Loosely structured sites**: even on Japanese sites full of nested divs and table layouts, the main content area is inferred from rendered geometry (visual placement)
+- **Mojibake**: automatic detection of Shift_JIS / EUC-JP / ISO-2022-JP
+- **Furigana**: strips `<ruby>` reading annotations to prevent duplicated body text
+- **Information rendered as images**: pages built around image-based pricing tables or banners automatically fall back to screenshots when text extraction is poor
+- **Major Japanese sites**: dedicated adapters for Qiita / Zenn / note / Hatena Blog / Yahoo! News / PR TIMES / Japanese Wikipedia
+
+For a measured comparison against similar tools (official fetch MCP / Jina Reader / Playwright MCP / PixelRAG pixelshot), see the article "[エージェントのWeb取得、ツール次第でトークンが5000倍違った話](https://zenn.dev/rererr_engineer/articles/e571e5b6eb1d53)" (Japanese). The benchmark harness and raw logs are in [`bench/`](./bench/).
+
+## How it saves tokens
+
+- **Progressive disclosure**: `mode: outline` first returns only the heading tree with a token estimate per section; fetch just the sections you need via `section`. Long pages are never dumped wholesale into context
+- **CJK-aware content pruning**: removes nav / ads / footers using punctuation density, character-class ratios, and link density
+- **Diff responses**: when refetching a URL, returns `unchanged` if nothing changed, or only the changed sections
+- **Automatic Markdown/screenshot switching**: only pages with a low quality score become screenshots, avoiding the round trip of reading broken Markdown and refetching
+- **CJK token estimation**: Japanese text costs more tokens per character than English, so page-split budgets are computed with per-character-class coefficients
+
+## Low impact on target sites
+
+- **Two-tier fetching**: plain HTTP GET first; only pages that need JS rendering escalate to headless Chromium, so most fetches never launch a browser
+- **Polite crawling**: respects robots.txt and Crawl-Delay; serialized access per domain at 1 req/sec by default. Link discovery prefers sitemap / RSS instead of crawling pages
+- **Honest User-Agent**: identifies itself as a bot. **No anti-bot circumvention is implemented**
+- **Caching**: revalidates with ETag / If-Modified-Since to avoid needless refetches
+
+## Installation
+
+```bash
+npm install -g amenbo
+```
+
+That's enough for plain Markdown fetching (`fetch` / `links`). If you also want browser-based fetching — SPA escalation or screenshots — run this once (a ~170MB download the first time):
+
+```bash
+npx -y amenbo install-browser
+```
+
+Or for development:
+
+```bash
+git clone https://github.com/Rererr/amenbo.git
+cd amenbo
+npm install
+npm run build
+```
+
+### Registering with Claude Code
+
+Add to `.mcp.json` (or your global config):
+
+```json
+{
+  "mcpServers": {
+    "amenbo": {
+      "command": "amenbo"
+    }
+  }
+}
+```
+
+For a local build, use `"command": "node", "args": ["/path/to/amenbo/dist/server.js"]`.
+
+### Teaching your agent how to use it (recommended prompt)
+
+Tool definitions alone don't convey usage conventions like "fetch with progressive disclosure." Paste the following into `CLAUDE.md` or `AGENTS.md` so your agent uses amenbo efficiently:
+
+```markdown
+## Use amenbo for web fetching
+
+- Fetch pages with `fetch` (default mode `auto`). For pages that look long or where only part
+  is needed, first check headings and per-section token counts with `mode: "outline"`,
+  then fetch only the needed sections via `section`
+- Getting `unchanged` / `diff` when refetching the same URL is normal (no change / changed
+  sections only). Use `force_full: true` only when the full text is required
+- When looking for pages within a site, don't guess URLs — enumerate them with `links`
+  (narrow down with `filter`)
+- In environments with a shell, for long pages you only want to keyword-search or for bulk
+  collection of multiple pages, dump via the CLI with `amenbo fetch <url> > page.md` and
+  grep / partially read it (keep the body text out of context).
+  For pages where you want to judge while seeing the structure, MCP's outline → section flow fits better
+- Works on non-Japanese sites too (progressive disclosure, caching, and low-impact fetching are
+  language-independent). However, content extraction is tuned for Japanese, so if body text
+  looks missing on a non-Japanese page, retry with a `selector` or `mode: "screenshot"`
+- If visual information is the goal (pricing tables, layout), use `screenshot`.
+  `scale: 0.5` or so reduces image tokens
+- Fetch failures due to robots.txt denial or anti-bot measures are by design (no circumvention).
+  Report failures to the user as-is
+```
+
+## Using as a CLI
+
+`amenbo` also works as a CLI sharing the same core (fetching, cache, politeness, extraction logic) as the MCP server. Running it with no arguments, or as `amenbo serve`, starts the MCP server as before (`"command": "amenbo"` in `.mcp.json` keeps working), so existing MCP registrations are unaffected.
+
+```bash
+# Fetch a page as Markdown (to stdout)
+amenbo fetch https://example.com/
+
+# For long pages, check just the headings and token counts first
+amenbo fetch https://example.com/ --mode outline
+
+# Dump the output to a file for grep / partial reads (head/sed)
+amenbo fetch https://example.com/ > page.md
+grep -A3 "pricing" page.md
+
+# Enumerate links within a site (sitemap/RSS-first)
+amenbo links https://example.com/ --filter "blog/*"
+
+# Screenshot (tiled PNGs are saved to --out-dir; their paths are listed on stdout)
+amenbo screenshot https://example.com/ --viewport-only --scale 0.5 --out-dir ./shots
+```
+
+See `amenbo <fetch|links|screenshot> --help` for details on each subcommand.
+
+**When to use MCP vs. CLI**:
+
+- **MCP**: the primary path for agents. The browser (Chromium) stays warm within the process, and images such as screenshots can be returned directly into the conversation. Also reaches agents on hosts without a shell, like claude.ai
+- **CLI**: suited to shell scripts, CI, debugging, dumping output to a file for `grep`/partial reads, or use from MCP-incapable agents/toolchains. One command = one process, so the browser launches each time
+
+Cache, diff responses (`unchanged`/`diff`), and rate-control state (robots.txt / per-domain serialized access) are shared between the MCP server and the CLI (both use the same `~/.cache/amenbo`). Cross-process rate control is best-effort, however: per-domain serialization is strictly guaranteed only within each process, so when the MCP server and multiple CLI runs hit the same domain simultaneously, the minimum interval may occasionally be undershot.
+
+## Tools
+
+### `fetch` — fetch a page
+| Parameter | Description |
+|---|---|
+| `url` | Target URL (http/https only; PDF supported) |
+| `mode` | `auto` (default; switches Markdown/screenshot by quality score) / `markdown` / `outline` (heading summary) / `screenshot` |
+| `selector` | CSS selector to narrow down the body content |
+| `section` | Section ID obtained from outline; returns only that section's Markdown |
+| `page` | Page number (default 1) |
+| `max_tokens` | Approximate token cap per page (default 8000) |
+| `force_full` | true disables diff responses and boilerplate removal, always returning the full text |
+
+### `links` — enumerate links
+| Parameter | Description |
+|---|---|
+| `url` | Starting URL |
+| `filter` | Substring match on URL/link text, or a glob using `*` |
+
+Discovery order: sitemap → RSS/Atom → in-page links.
+
+### `screenshot` — capture a screenshot
+| Parameter | Description |
+|---|---|
+| `url` | Target URL (http/https only) |
+| `fullPage` | Default true. false captures only the first viewport |
+| `width` | Tile width in px (default 1280) |
+| `scale` | Resolution scale 0.5–1.0 (default 1.0). Smaller reduces image tokens |
+
+## Environment variables
+
+| Variable | Default | Description |
+|---|---|---|
+| `AMENBO_CACHE_DIR` | `~/.cache/amenbo` | Where the cache (SQLite + PNG) is stored |
+| `AMENBO_CACHE_TTL_MS` | `900000` (15 min) | Cache TTL |
+| `AMENBO_MAX_BODY_BYTES` | `20971520` (20MB) | Maximum fetched body size |
+
+## Security
+
+- **SSRF protection**: rejects non-http/https schemes (`file:`, `ftp:`, etc.). Rejects DNS-resolved destinations that are private / loopback / link-local / reserved addresses. As a DNS rebinding (TOCTOU) countermeasure, actual connections are pinned to the validated IP
+- **Body size cap**: prevents OOM from oversized responses
+
+## Known limitations
+
+- **No HTTP proxy support**: `HTTP_PROXY` / `HTTPS_PROXY` environment variables are not honored. As an SSRF countermeasure, connections are pinned to a validated IP (DNS rebinding protection), which is incompatible with delegating name resolution to an upstream proxy. Networks that require an upstream proxy are currently unsupported
+- **No anti-bot circumvention**: fetch failures due to robots.txt denial or bot countermeasures are by design and reported as-is (see [Low impact on target sites](#low-impact-on-target-sites))
+
+## Development
+
+```bash
+npm run typecheck   # strict type checking
+npm test            # vitest
+npm run build       # build into dist/
+```
+
+## License
+
+[MIT](./LICENSE)

package/README.md

@@ -1,5 +1,7 @@
 # amenbo 🐜💧
 
+[English](./README.en.md) | 日本語
+
 **Skims the web without making waves** — a Japanese-web-native MCP server for low-impact, token-efficient web collection.
 
 amenbo(アメンボ / water strider)は、Claude Code や Codex のようなコーディングエージェント向けの [MCP](https://modelcontextprotocol.io) サーバーです。水面に波を立てずに滑る虫のように、**収集先に負荷をかけず、少ないトークンで** Web から情報を集めます。とりわけ**日本語サイト**に最適化しています。MCP クライアントを持たないシェル環境からは、同じコアを共有する CLI としても使えます([CLIとして使う](#cliとして使う)参照)。
@@ -35,7 +37,12 @@ amenbo(アメンボ / water strider)は、Claude Code や Codex のようなコ
 
 ```bash
 npm install -g amenbo
-# postinstall で Chromium が入ります(SPA描画・スクリーンショット用)
+```
+
+Markdown 取得(通常の `fetch` / `links`)はこれだけで動きます。JS 描画が必要な SPA への昇格やスクリーンショットなど、ブラウザ(Chromium)経由の取得を使う場合のみ、初回に一度だけ実行してください(約 170MB のダウンロード):
+
+```bash
+npx -y amenbo install-browser
 ```
 
 または開発用途:
@@ -158,6 +165,11 @@ sitemap → RSS/Atom → ページ内リンクの順で探索します。
 - **SSRF 対策**：http/https 以外のスキーム(`file:`, `ftp:` 等)を拒否。DNS 解決した接続先が private / loopback / link-local / 予約アドレスなら拒否。DNS rebinding(TOCTOU)対策として実接続を検証済み IP に固定します
 - **ボディサイズ上限**：巨大レスポンスによる OOM を防止
 
+## 既知の制限
+
+- **HTTP プロキシ非対応**：`HTTP_PROXY` / `HTTPS_PROXY` 等の環境変数は尊重しません。SSRF 対策として接続先を検証済み IP に固定する設計(DNS rebinding 対策)と、プロキシへ名前解決を委ねる方式が両立しないためです。上流プロキシ必須のネットワークでは現状ご利用いただけません
+- **anti-bot 回避は実装しません**：robots.txt 拒否やボット対策による取得失敗は仕様です。失敗はそのまま報告します([収集先への低負荷](#収集先への低負荷)参照)
+
 ## 開発
 
 ```bash

package/dist/cache.d.ts

@@ -17,6 +17,7 @@ export interface CacheWriteInput {
     markdown: string;
     metadata: Record<string, unknown>;
 }
+export declare function resolveCacheDir(): string;
 export declare function hashContent(content: string): string;
 /** スクリーンショットのキャッシュキー(url+撮影パラメータの組)を計算する。 */
 export declare function computeScreenshotCacheKey(url: string, width: number, scale: number, fullPage: boolean): string;
@@ -38,6 +39,7 @@ export declare class PageCache {
     private readonly cacheDir;
     private readonly ttlMs;
     private readonly now;
+    private closed;
     constructor(options?: {
         dbPath?: string;
         cacheDir?: string;
@@ -57,7 +59,16 @@ export declare class PageCache {
     }): boolean;
     /** 保存済みスクリーンショットエントリを取得する(TTL判定は isFresh を使う)。 */
     getScreenshot(cacheKey: string): ScreenshotCacheEntry | undefined;
-    /** スクリーンショットのタイル群をファイル保存し、パスをSQLiteへ記録する。 */
+    /**
+     * スクリーンショットのタイル群をファイル保存し、パスをSQLiteへ記録する。
+     *
+     * レビュー指摘対応(Medium): 同一cacheKeyへの再撮影でタイル数が減った場合(旧5枚→新3枚)、
+     * 新しいtile_pathsで上書きされるDB行からは旧tile-3.png/tile-4.pngを参照できなくなり、
+     * pruneExpiredもそれらを認識できず孤立ファイルとしてディスクに残り続けていた。
+     * tileDirはcacheKey単位のディレクトリ(他のcacheKeyのタイルと混在しない)のため、
+     * 書き込み前にディレクトリごと削除してから作り直すことで、枚数が変化しても
+     * 旧タイルを確実に一掃する(初回撮影時はディレクトリが存在しないためforce:trueで無視する)。
+     */
     setScreenshot(input: ScreenshotWriteInput): ScreenshotCacheEntry;
     /** 新規取得結果を保存(既存があれば上書き)する。 */
     set(input: CacheWriteInput): CacheEntry;
@@ -86,5 +97,24 @@ export declare class PageCache {
      * store JSDoc参照)。せめて時刻が巻き戻らないよう、SQL側でMAXを取って単調増加を保証する。
      */
     setHostLastRequestAt(host: string, at: number): void;
+    /**
+     * レビュー指摘対応: オリジン(例 "https://example.com")のrobots.txtキャッシュを返す
+     * (未記録ならnull)。PolitenessManagerのrobotsStoreオプションとして注入し、プロセス間で
+     * robots.txt取得結果を共有するために使う。TTL判定(robotsTtlMs)は呼び出し元(PolitenessManager)
+     * がfetchedAtを見て行う(page cacheのttlMsとは別の時間軸のため、ここでは判定しない)。
+     * 空bodyのrobots.txt(=制限なし)も正しい取得結果として保存されるため、
+     * 「未記録(null)」と「空bodyの記録あり」は区別される。
+     */
+    getRobotsCache(origin: string): {
+        body: string;
+        fetchedAt: number;
+    } | null;
+    /** オリジンのrobots.txt取得結果(本文+取得時刻)を記録する。既存があれば上書きする。 */
+    setRobotsCache(origin: string, body: string, fetchedAt: number): void;
+    /**
+     * 冪等なclose。better-sqlite3のclose()は閉鎖済みでも安全だったが、node:sqliteは
+     * "database is not open" を投げるため、CLIのfinallyとprocess 'exit'ハンドラの両方から
+     * 呼ばれる二重close経路(core.ts参照)を自前のフラグで吸収する。
+     */
     close(): void;
 }

package/dist/cache.js

@@ -1,5 +1,5 @@
 /**
- * cache.ts — better-sqlite3によるURL単位のローカルキャッシュ。
+ * cache.ts — node:sqlite(DatabaseSync)によるURL単位のローカルキャッシュ。
  *
  * 保存場所: $AMENBO_CACHE_DIR または ~/.cache/amenbo/cache.sqlite
  * URL毎にETag/Last-Modified/本文ハッシュ/変換済みMarkdown/取得時刻を保存する。
@@ -21,17 +21,26 @@
  * 短時間に連続実行すると同一ドメインへの最小間隔が守られない。host_requests テーブルへ
  * 最終リクエスト時刻を永続化し、PolitenessManagerのstoreオプションとして注入することで
  * MCPサーバー/CLIの複数プロセス間で共有する(再起動直後の連続アクセスも守れる副次効果あり)。
- * journal_mode=WAL は複数プロセスからの同時アクセスを想定して設定している。
+ * 同じ理由でrobots.txtの取得結果もrobots_cache テーブルへ永続化し、PolitenessManagerの
+ * robotsStoreオプションとして注入する(CLIでの複数ページ一括収集時にコマンド毎の
+ * robots.txt再取得を防ぐ)。journal_mode=WAL は複数プロセスからの同時アクセスを想定して設定している。
+ *
+ * node:sqliteの制約: better-sqlite3はNumber.MAX_SAFE_INTEGERを超えるINTEGER列を読むと
+ * 例外を投げたが、node:sqliteは黙ってbigintを返す(上流の挙動差)。本ファイルの整数列
+ * (fetched_at/last_request_at)は全てDate.now()由来でMAX_SAFE_INTEGERを超えないため、
+ * number型へのキャストのみで安全に扱える。
  */
 import { createHash } from "node:crypto";
 import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
-import Database from "better-sqlite3";
+import { DatabaseSync } from "node:sqlite";
 const DEFAULT_TTL_MS = 15 * 60 * 1000; // 15分
 /** Phase 4テンプレート学習: 定型ブロック判定に使う「直近ページ数」の既定値。 */
 const DEFAULT_TEMPLATE_RECENT_PAGES = 3;
-function resolveCacheDir() {
+// レビュー指摘対応: cli.ts(fetch画像の保存先)がキャッシュディレクトリ解決ロジックを
+// 再利用できるようexportする(AMENBO_CACHE_DIR未指定時の既定値~/.cache/amenboとのずれを防ぐ)。
+export function resolveCacheDir() {
     const dir = process.env.AMENBO_CACHE_DIR ?? join(homedir(), ".cache", "amenbo");
     if (!existsSync(dir)) {
         mkdirSync(dir, { recursive: true });
@@ -50,15 +59,16 @@ export class PageCache {
     cacheDir;
     ttlMs;
     now;
+    closed = false;
     constructor(options = {}) {
         this.cacheDir = options.cacheDir ?? resolveCacheDir();
         if (!existsSync(this.cacheDir)) {
             mkdirSync(this.cacheDir, { recursive: true });
         }
-        this.db = new Database(options.dbPath ?? join(this.cacheDir, "cache.sqlite"));
+        this.db = new DatabaseSync(options.dbPath ?? join(this.cacheDir, "cache.sqlite"));
         this.ttlMs = options.ttlMs ?? DEFAULT_TTL_MS;
         this.now = options.now ?? Date.now;
-        this.db.pragma("journal_mode = WAL");
+        this.db.exec("PRAGMA journal_mode = WAL");
         this.db.exec(`
       CREATE TABLE IF NOT EXISTS pages (
         url TEXT PRIMARY KEY,
@@ -94,6 +104,16 @@ export class PageCache {
         host TEXT PRIMARY KEY,
         last_request_at INTEGER NOT NULL
       )
+    `);
+        // レビュー指摘対応: robots.txtの取得結果をhost_requestsと同じ考え方でプロセス間共有する。
+        // CLIバルク収集(1コマンド=1プロセス)で、コマンド毎にrobots.txtを再取得してしまう
+        // 低負荷原則違反への対応(PolitenessManagerのrobotsStoreオプションとして注入する)。
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS robots_cache (
+        origin TEXT PRIMARY KEY,
+        body TEXT NOT NULL,
+        fetched_at INTEGER NOT NULL
+      )
     `);
         // M3: TTL超過削除・サイズ上限が無くディスクが無制限に増加する問題への対応。
         // 起動(コンストラクタ)のたびにTTL超過エントリを掃除する。
@@ -156,9 +176,19 @@ export class PageCache {
             fetchedAt: row.fetched_at,
         };
     }
-    /** スクリーンショットのタイル群をファイル保存し、パスをSQLiteへ記録する。 */
+    /**
+     * スクリーンショットのタイル群をファイル保存し、パスをSQLiteへ記録する。
+     *
+     * レビュー指摘対応(Medium): 同一cacheKeyへの再撮影でタイル数が減った場合(旧5枚→新3枚)、
+     * 新しいtile_pathsで上書きされるDB行からは旧tile-3.png/tile-4.pngを参照できなくなり、
+     * pruneExpiredもそれらを認識できず孤立ファイルとしてディスクに残り続けていた。
+     * tileDirはcacheKey単位のディレクトリ(他のcacheKeyのタイルと混在しない)のため、
+     * 書き込み前にディレクトリごと削除してから作り直すことで、枚数が変化しても
+     * 旧タイルを確実に一掃する(初回撮影時はディレクトリが存在しないためforce:trueで無視する)。
+     */
     setScreenshot(input) {
         const tileDir = join(this.cacheDir, "screenshots", input.cacheKey);
+        rmSync(tileDir, { recursive: true, force: true });
         mkdirSync(tileDir, { recursive: true });
         const tilePaths = input.tiles.map((buffer, index) => {
             const filePath = join(tileDir, `tile-${index}.png`);
@@ -279,7 +309,37 @@ export class PageCache {
          ON CONFLICT(host) DO UPDATE SET last_request_at = MAX(last_request_at, excluded.last_request_at)`)
             .run({ host, lastRequestAt: at });
     }
+    /**
+     * レビュー指摘対応: オリジン(例 "https://example.com")のrobots.txtキャッシュを返す
+     * (未記録ならnull)。PolitenessManagerのrobotsStoreオプションとして注入し、プロセス間で
+     * robots.txt取得結果を共有するために使う。TTL判定(robotsTtlMs)は呼び出し元(PolitenessManager)
+     * がfetchedAtを見て行う(page cacheのttlMsとは別の時間軸のため、ここでは判定しない)。
+     * 空bodyのrobots.txt(=制限なし)も正しい取得結果として保存されるため、
+     * 「未記録(null)」と「空bodyの記録あり」は区別される。
+     */
+    getRobotsCache(origin) {
+        const row = this.db.prepare("SELECT * FROM robots_cache WHERE origin = ?").get(origin);
+        return row ? { body: row.body, fetchedAt: row.fetched_at } : null;
+    }
+    /** オリジンのrobots.txt取得結果(本文+取得時刻)を記録する。既存があれば上書きする。 */
+    setRobotsCache(origin, body, fetchedAt) {
+        this.db
+            .prepare(`INSERT INTO robots_cache (origin, body, fetched_at)
+         VALUES (@origin, @body, @fetchedAt)
+         ON CONFLICT(origin) DO UPDATE SET
+           body = excluded.body,
+           fetched_at = excluded.fetched_at`)
+            .run({ origin, body, fetchedAt });
+    }
+    /**
+     * 冪等なclose。better-sqlite3のclose()は閉鎖済みでも安全だったが、node:sqliteは
+     * "database is not open" を投げるため、CLIのfinallyとprocess 'exit'ハンドラの両方から
+     * 呼ばれる二重close経路(core.ts参照)を自前のフラグで吸収する。
+     */
     close() {
+        if (this.closed)
+            return;
+        this.closed = true;
         this.db.close();
     }
 }

package/dist/cache.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -11,7 +11,9 @@ export type ParsedCommand = {
     kind: "version";
 } | {
     kind: "help";
-    topic?: "fetch" | "links" | "screenshot";
+    topic?: "fetch" | "links" | "screenshot" | "install-browser";
+} | {
+    kind: "install-browser";
 } | ParsedFetchCommand | ParsedLinksCommand | ParsedScreenshotCommand;
 export interface ParsedFetchCommand {
     kind: "fetch";

package/dist/cli.js

@@ -8,6 +8,8 @@
  * - `amenbo fetch/links/screenshot <url> [options]` は対応するcore.tsのハンドラを呼び、
  *   TextBlockはそのまま標準出力へ、ImageBlock(スクリーンショット/スキャンPDF画像)は
  *   --out-dir配下へファイル保存しパスを列挙する(エージェント/ユーザーがそのまま開けるように)。
+ * - `amenbo install-browser` はChromium遅延化(postinstall廃止)対応で追加したコマンド。
+ *   core.tsは経由せず、installBrowser.tsが同梱playwrightのCLIをspawnする。
  * - 引数パース(parseCliArgs)は純関数として切り出し、ユニットテストできるようにしている。
  * - キャッシュ・差分応答・レート制御の状態はMCPサーバーと同じ ~/.cache/amenbo (cache.ts)を
  *   共有する。CLIは1コマンド=1プロセスのため、politenessのドメイン毎レート制御は
@@ -17,10 +19,13 @@ import { mkdirSync, realpathSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
 import { parseArgs } from "node:util";
 import { fileURLToPath } from "node:url";
+import { resolveCacheDir } from "./cache.js";
 import { cache, formatLinksResponse, handleFetchTool, handleScreenshotTool, politeness, resolvePackageVersion, } from "./core.js";
 import { AmenboError } from "./errors.js";
 import { closeBrowser } from "./fetcher/browser.js";
+import { installBrowser } from "./installBrowser.js";
 import { discoverLinks } from "./links.js";
+import { MAX_SCALE, MIN_SCALE } from "./screenshot.js";
 import { runServer } from "./server.js";
 // ---- 引数パース(純関数。ユニットテスト対象) ----
 /** 引数の使い方が不正な場合に投げる(cli.ts側でusageを表示しexit code 2にする)。 */
@@ -41,6 +46,18 @@ function parsePositiveFloat(raw, flag) {
     }
     return n;
 }
+/**
+ * レビュー指摘対応(Low): --scaleはparsePositiveFloatを通すだけで[0.5,1.0]範囲を検証しておらず、
+ * `--scale 3.0`のような範囲外値がscreenshot.ts clampScaleで黙って1.0にクランプされていた。
+ * MCP側はzod .min(0.5).max(1.0)で明示的にエラーになるため、CLIも同じ強度の検証で揃える。
+ */
+function parseScreenshotScale(raw) {
+    const n = parsePositiveFloat(raw, "--scale");
+    if (n < MIN_SCALE || n > MAX_SCALE) {
+        throw new CliUsageError(`--scaleは${MIN_SCALE}〜${MAX_SCALE}の範囲で指定してください: ${raw}`);
+    }
+    return n;
+}
 function requireUrl(positionals, command) {
     const url = positionals[0];
     if (!url) {
@@ -122,10 +139,19 @@ function parseScreenshotArgs(args) {
         url,
         ...(values["viewport-only"] ? { viewportOnly: true } : {}),
         ...(values.width !== undefined ? { width: parsePositiveInt(values.width, "--width") } : {}),
-        ...(values.scale !== undefined ? { scale: parsePositiveFloat(values.scale, "--scale") } : {}),
+        ...(values.scale !== undefined ? { scale: parseScreenshotScale(values.scale) } : {}),
         ...(values["out-dir"] !== undefined ? { outDir: values["out-dir"] } : {}),
     };
 }
+function parseInstallBrowserArgs(args) {
+    const { values, positionals } = safeParseArgs(args, "install-browser", { help: { type: "boolean", short: "h" } });
+    if (values.help)
+        return { kind: "help", topic: "install-browser" };
+    if (positionals.length > 0) {
+        throw new CliUsageError(`install-browser: 不明な引数です: ${positionals[0]}`);
+    }
+    return { kind: "install-browser" };
+}
 /** CLI引数(process.argv.slice(2)相当)をコマンドへパースする純関数。 */
 export function parseCliArgs(argv) {
     if (argv.length === 0)
@@ -143,6 +169,8 @@ export function parseCliArgs(argv) {
         return parseLinksArgs(rest);
     if (first === "screenshot")
         return parseScreenshotArgs(rest);
+    if (first === "install-browser")
+        return parseInstallBrowserArgs(rest);
     throw new CliUsageError(`不明なコマンドです: ${first}`);
 }
 // ---- ヘルプ/usage文言 ----
@@ -155,6 +183,7 @@ function usageText() {
         "  fetch <url> [options]          ページをMarkdownとして取得する",
         "  links <url> [options]          ページ内のリンクを列挙する(sitemap/RSS優先)",
         "  screenshot <url> [options]     ページのスクリーンショットを撮影する",
+        "  install-browser                スクリーンショット/SPA取得に必要なChromiumをインストールする(初回のみ)",
         "",
         "Options:",
         "  -h, --help       ヘルプを表示する",
@@ -174,7 +203,7 @@ function fetchHelpText() {
         "  --page <n>                                  ページ番号(既定 1)",
         "  --max-tokens <n>                             1ページの概算トークン上限(既定 8000)",
         "  --force-full                                 差分応答(unchanged/diff)と定型ブロック除去を無効化し常に全文を返す",
-        "  --out-dir <dir>                              screenshot切替時の画像保存先(既定 カレントディレクトリ)",
+        "  --out-dir <dir>                              screenshot切替時の画像保存先(既定 $AMENBO_CACHE_DIR/screenshots-cli/、未設定時は ~/.cache/amenbo/screenshots-cli/)",
     ].join("\n");
 }
 function linksHelpText() {
@@ -187,10 +216,20 @@ function screenshotHelpText() {
         "Options:",
         "  --viewport-only     最初のビューポート分のみ撮影する(既定はfullPage)",
         "  --width <n>         タイル幅px(既定 1280)",
-        "  --scale <x>         解像度スケール(既定 1.0)。小さいほど画像トークンが減る",
+        "  --scale <x>         解像度スケール(0.5〜1.0、既定 1.0)。小さいほど画像トークンが減る",
         "  --out-dir <dir>     画像保存先(既定 カレントディレクトリ)",
     ].join("\n");
 }
+function installBrowserHelpText() {
+    return [
+        "amenbo install-browser",
+        "",
+        "スクリーンショット撮影やSPA(JavaScriptレンダリング必須)ページの取得に必要なChromiumを",
+        "インストールする(初回のみ、約170MBのダウンロード)。通常のHTTP取得(fetch/linksの大半)は",
+        "この操作なしで動作する。amenboに同梱されたバージョンのplaywright CLIを使うため、",
+        "バージョン不一致は起こらない。",
+    ].join("\n");
+}
 function helpText(topic) {
     if (topic === "fetch")
         return fetchHelpText();
@@ -198,9 +237,22 @@ function helpText(topic) {
         return linksHelpText();
     if (topic === "screenshot")
         return screenshotHelpText();
+    if (topic === "install-browser")
+        return installBrowserHelpText();
     return usageText();
 }
 // ---- 出力(TextBlockはstdout、ImageBlockはファイル保存) ----
+/**
+ * レビュー指摘対応(Medium・ユーザー確定仕様): `amenbo fetch`(mode auto)が品質低下でscreenshotへ
+ * 自動切替した場合の画像既定保存先。以前はoutDir未指定時にprocess.cwd()を使っており、
+ * リポジトリ直下等カレントディレクトリを黙って汚していた。cache.tsのキャッシュディレクトリ
+ * 解決ロジック(AMENBO_CACHE_DIR ?? ~/.cache/amenbo)を再利用し、その配下のscreenshots-cli/へ
+ * 保存する(実撮影キャッシュのscreenshots/とは別ディレクトリ)。screenshotサブコマンドは
+ * 明示的な視覚確認用途のため対象外(--out-dir未指定時は従来通りcwd)。
+ */
+function resolveFetchScreenshotDir() {
+    return join(resolveCacheDir(), "screenshots-cli");
+}
 /** ファイル名として安全なホスト名(取れなければ"page")。amenbo-<hostname>-<連番>.pngの命名に使う。 */
 function hostnameForFilename(url) {
     try {
@@ -246,7 +298,7 @@ async function dispatch(command) {
             ...(command.forceFull !== undefined ? { force_full: command.forceFull } : {}),
         };
         const blocks = await handleFetchTool(input);
-        writeBlocks(blocks, command.url, command.outDir ?? process.cwd());
+        writeBlocks(blocks, command.url, command.outDir ?? resolveFetchScreenshotDir());
         return;
     }
     if (command.kind === "links") {
@@ -291,6 +343,9 @@ export async function run(argv) {
         return 0;
     }
     try {
+        if (command.kind === "install-browser") {
+            return await installBrowser();
+        }
         await dispatch(command);
         return 0;
     }