Nitpicker は、Web サイトをクロールしてページ情報・リンク・リソース・HTML スナップショットを .nitpicker アーカイブに保存し、分析やレポート出力まで行うツールキットです。
ヘッドレスブラウザでページをレンダリングし、遅延読み込みされるコンテンツも取得対象にします。アーキテクチャの索引（全体地図・境界・依存方向・不変条件・Reading paths）は ARCHITECTURE.md、実装詳細は各ソースの JSDoc を参照してください。
npx @nitpicker/cli crawl https://example.com
npx @nitpicker/cli analyze ./example.com.nitpicker --all
npx @nitpicker/cli report ./example.com.nitpicker --sheet <Google Sheets URL> --all必要に応じて、保存済みアーカイブを JSON で調べたり、ローカルビューアで確認できます。
npx @nitpicker/cli query ./example.com.nitpicker summary --pretty
npx @nitpicker/cli viewer ./example.com.nitpickerCLI の詳細な使い方と全オプションは @nitpicker/cli README を参照してください。
.nitpicker は crawl が生成するアーカイブファイルです。クロール結果、レンダリング後の HTML スナップショット、リンク、ネットワークリソース、画像情報、分析結果などを保存します。
このファイルは analyze / report / query / viewer の入力になります。保存形式やスキーマの概要は ARCHITECTURE.md の「アーカイブ（DB スキーマ概要）」、定義の正は packages/@nitpicker/crawler/src/archive/init-schema.ts を参照してください。
| パッケージ | 用途 |
|---|---|
| @nitpicker/cli | クロール、分析、レポート、クエリ、ビューアを実行するCLI |
| @nitpicker/crawler | ヘッドレスブラウザによるクロールとアーカイブ生成 |
| @nitpicker/core | analyzeプラグインを実行する分析エンジン |
| @nitpicker/query | .nitpicker アーカイブのクエリ関数 |
| @nitpicker/report-google-sheets | Google Sheets向けレポート出力 |
| @nitpicker/mcp-server | MCP経由でアーカイブを問い合わせるサーバー |
| @nitpicker/viewer | .nitpicker アーカイブを閲覧するローカルビューア |
| @nitpicker/types | 共有TypeScript型定義 |
| @nitpicker/analyze-axe | axe-coreによるアクセシビリティ分析プラグイン |
| @nitpicker/analyze-lighthouse | Lighthouseによるパフォーマンス分析プラグイン |
| @nitpicker/analyze-markuplint | markuplintによるHTML検証プラグイン |
| @nitpicker/analyze-textlint | textlintによる日本語文章校正プラグイン |
| @nitpicker/analyze-search | キーワード・CSSセレクタ検索プラグイン |
| test-server | E2Eテスト用サーバー |
Apache-2.0