{"_id":"4ge-sitemap","_rev":"4-7c21c06ced1c9dd51ceab08f7ec3b877","name":"4ge-sitemap","dist-tags":{"latest":"0.2.9"},"versions":{"0.2.7":{"name":"4ge-sitemap","version":"0.2.7","license":"MIT","_id":"4ge-sitemap@0.2.7","maintainers":[{"name":"hiro4ge","email":"hiroshige.keita@qlip.co.jp"}],"homepage":"https://github.com/qlip-co-ltd/sitemap-tools","bugs":{"url":"https://github.com/qlip-co-ltd/sitemap-tools/issues"},"bin":{"4ge-sitemap":"bin/sitemap.js"},"dist":{"shasum":"2211980eda4f7df02a814e878f25ebb9ddf4d21e","tarball":"https://registry.npmjs.org/4ge-sitemap/-/4ge-sitemap-0.2.7.tgz","fileCount":31,"integrity":"sha512-ZAA3aRryc1JFuQZxQO4Eoa5AHq7cOUFINp9zKMUFv0QqPQWm85PYsvIDDAdTxUUupO9OU27FahTNLG/wc14orA==","signatures":[{"sig":"MEYCIQDqBf5bOhPXwMGKbTUxrphR/nY5k2QRpZfPbuwWs9QIawIhALbk64ZRI8DnyI58MEsRumsTAaviw8YKHc0owV3C7wY9","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":127840},"type":"module","engines":{"node":">=20"},"gitHead":"4dbd4a18096a889c52af74f88a8578b937106cdc","scripts":{"dev":"tsx src/index.ts","build":"tsc","start":"node dist/index.js","typecheck":"tsc --noEmit","install-browser":"playwright install chromium"},"_npmUser":{"name":"hiro4ge","email":"hiroshige.keita@qlip.co.jp"},"repository":{"url":"git+https://github.com/qlip-co-ltd/sitemap-tools.git","type":"git","directory":"packages/cli"},"_npmVersion":"10.9.2","description":"リニューアル提案用にサイトをクロールして調査 JSON を生成する CLI","directories":{},"_nodeVersion":"22.14.0","dependencies":{"undici":"^7.0.0","cheerio":"^1.0.0","p-queue":"^8.0.1","commander":"^12.1.0","playwright":"^1.50.0","robots-parser":"^3.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.2"},"_npmOperationalInternal":{"tmp":"tmp/4ge-sitemap_0.2.7_1778578461714_0.018587429873963224","host":"s3://npm-registry-packages-npm-production"}},"0.2.9":{"name":"4ge-sitemap","version":"0.2.9","description":"リニューアル提案用にサイトをクロールして調査 JSON を生成する CLI","type":"module","license":"MIT","homepage":"https://github.com/qlip-co-ltd/sitemap-tools","repository":{"type":"git","url":"git+https://github.com/qlip-co-ltd/sitemap-tools.git","directory":"packages/cli"},"publishConfig":{"access":"public"},"engines":{"node":">=20"},"bin":{"4ge-sitemap":"bin/sitemap.js"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","typecheck":"tsc --noEmit","test":"vitest run","start":"node dist/index.js","install-browser":"playwright install chromium"},"dependencies":{"cheerio":"^1.0.0","commander":"^12.1.0","p-queue":"^8.0.1","playwright":"^1.50.0","robots-parser":"^3.0.1","undici":"^7.0.0"},"devDependencies":{"tsx":"^4.19.2","vitest":"^4.1.9"},"_id":"4ge-sitemap@0.2.9","gitHead":"8a027055a08f2f0dc4cc75b6d23bbeb985e54868","bugs":{"url":"https://github.com/qlip-co-ltd/sitemap-tools/issues"},"_nodeVersion":"22.14.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-plB5eGzQI8/pzR6hmfnX+H8iERqSNzqVSU5o+MiZt9p5PIGKbRtzdiZLmcM63Bxc/dl6chd2yld3veRA5J519g==","shasum":"3845a4ff89d892e2abd40d081aa97f24dd921a66","tarball":"https://registry.npmjs.org/4ge-sitemap/-/4ge-sitemap-0.2.9.tgz","fileCount":31,"unpackedSize":131174,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFeUD2l0oxYT5wpyWrUkruZVB+fqdeUXavvSiyIIsEOUAiEAtVWh/kI4pUOtiOQ+UM1xkCNSt8u8Y/9K68RIhBwycjA="}]},"_npmUser":{"name":"hiro4ge","email":"hiroshige.keita@qlip.co.jp"},"directories":{},"maintainers":[{"name":"hiro4ge","email":"hiroshige.keita@qlip.co.jp"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/4ge-sitemap_0.2.9_1783575294112_0.09459197836798205"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-12T08:41:28.899Z","modified":"2026-07-09T05:34:54.379Z","0.0.1":"2026-05-12T08:41:29.172Z","0.2.7":"2026-05-12T09:34:21.870Z","0.2.9":"2026-07-09T05:34:54.257Z"},"bugs":{"url":"https://github.com/qlip-co-ltd/sitemap-tools/issues"},"license":"MIT","homepage":"https://github.com/qlip-co-ltd/sitemap-tools","repository":{"type":"git","url":"git+https://github.com/qlip-co-ltd/sitemap-tools.git","directory":"packages/cli"},"description":"リニューアル提案用にサイトをクロールして調査 JSON を生成する CLI","maintainers":[{"name":"hiro4ge","email":"hiroshige.keita@qlip.co.jp"}],"readme":"# 4ge-sitemap\n\n## 概要\n\n`4ge-sitemap` は URL 1 つでサイト内を巡回し、SEO・構造・パフォーマンスデータを網羅した JSON を生成する CLI ツール。\n網羅的にデータを取得することが目的、分析は別のツールで行う想定。\n\n---\n\n## ツールを作成した理由\n\n### 1. サイト調査する機会が多い\n\nWebサイトリニューアル、UI/UX改善、マーケティング、ブランディング案件。あらゆる場面で「現在どのような情報発信をしているか」を調べる機会が急増。\n\n### 2. 利用ツールの最適解がない\n\n高機能なSEOツールはライセンスが高額。かといって、カスタマイズ性を求めてAIに直接クローリングさせても、試行錯誤のたびにトークンを浪費するだけで、結果も安定しない。\n\n### 3. ビジュアライズよりデータの質\n\n巷のSEOツールや、最近増えてるAIで作った系ツールなどは見やすさはあるものの、データの有用性や深さが足りないことが多く悩ましく感じたので改善したかった。\n\n### 4. トークンの節約と有効活用\n\n費用対効果を最大化させたい。100ページ規模のサイトをしっかり調査させれば、Claude Proレベルでもすぐに上限が来る。「定量のデータ収集」にトークンを消費したくない。泥臭い収集は専用ツールに任せ、その後の「戦略立案や深い調査」にトークンを当てたかった。\n\n---\n\n## 主な特徴\n\n- **AI 解析への最適化**：LLM が理解しやすいJSON階層\n- **オプションが豊富**：様々な--optionを完備\n- **ハイブリッドなクロール**：静的パースとJavaScriptレンダリングを自動切替でモダンサイトもOK\n- **網羅的なデータ**：メタ情報、見出し、OGP、構造化データ、画像など\n- **AI 向けの配慮**：JSON の先頭に `_meta` フィールドを付与。AI にデータを食わせる際、AI 自身が「容量が大きすぎるので絞り込みますか？」とユーザーへ確認を入れるなど、AI でのデータ処理を補助するガイダンスあり。\n\n---\n\n## 使い方\n\n### 1. Node.js の導入\n\n実行には Node.js が必要。\nターミナルで `node -v` を実行し、エラーが出る場合は [Node.js 公式](https://nodejs.org/) などからインストール。\nAIに「Node.js付けるようにしたい」とお願いして案内に従うでもOK　※むしろこちらを推奨\n\n### 2. 実行\n\n```bash\nnpx 4ge-sitemap https://example.com\n```\n\n完了後、デスクトップに JSON が保存されるので、後はAIに突っ込むなど自由に活用できます。\nまずは「データをサクッと見たい」ということであれば、簡易的なビューアーを準備しています。\n[Sitemap Viewer を開く](https://sitemap-tools-omega.vercel.app/)\n\n---\n\n## オプション\n\n### 主要オプション\n\n- **ヘルプ表示**：`npx 4ge-sitemap --help`\n- **出力先指定**：`-o ./result.json` または `--output ./result.json`\n- **JSレンダリング強制**：`--js`\n\n### オプション一覧\n\n| オプション              | 既定値       | 説明                                     |\n| ----------------------- | ------------ | ---------------------------------------- |\n| `-d, --depth <n>`       | 5            | 巡回する階層の深さ上限                   |\n| `--max-pages <n>`       | 5000         | 取得するページ数の上限                   |\n| `-o, --output <path>`   | デスクトップ | 出力ファイルパスの指定                   |\n| `-f, --force`           | off          | 既存ファイルを上書き                     |\n| `-c, --concurrency <n>` | 3            | 並列リクエスト数                         |\n| `--rate-limit <n>`      | 5            | 秒あたりの最大リクエスト数               |\n| `--timeout <ms>`        | 10000        | 1リクエストのタイムアウト時間            |\n| `--js` / `--no-js`      | auto         | JSレンダリングの有無（autoは自動判別）   |\n| `--slim`                | off          | 内部リンク詳細・画像情報を除外して軽量化 |\n| `--no-internal-links`   | -            | 内部リンク詳細のみ省略                   |\n| `--no-images`           | -            | 画像情報のみ省略                         |\n| `--include-subdomain`   | off          | サブドメインもクロール対象に含める       |\n| `--no-respect-robots`   | off          | robots.txt を無視して巡回                |\n| `--user-agent <str>`    | (内蔵)       | User-Agent の上書き                      |\n| `-h, --help`            | -            | ヘルプ表示                               |\n| `-V, --version`         | -            | バージョン表示                           |\n\n---\n\n## 注意・免責・留意事項\n\n- AI 利用料金・サイト負荷・本ツール由来の一切の損害は使用者の責任です。\n- クロール対象サイトの利用規約・robots.txt を確認のうえご利用ください。\n- 私個人的に利用する前提のツールです。業務利用は自己責任でお願いします。\n- MIT License です。本ソフトウェアは無保証で提供されます。\n\n---\n\n## ライセンス\n\n[MIT License](./LICENSE)\n\nCopyright (c) 2026 4ge\n","readmeFilename":"README.md"}