PkgFoundry
Catalog npm
Back to packageRELEASE DETAILS

0.2.9

npm

4ge-sitemap

リニューアル提案用にサイトをクロールして調査 JSON を生成する CLI

Published9 Jul 2026
Direct dependencies8
Transitive dependenciesNot calculated

README

Current package documentation

4ge-sitemap

概要

4ge-sitemap は URL 1 つでサイト内を巡回し、SEO・構造・パフォーマンスデータを網羅した JSON を生成する CLI ツール。 網羅的にデータを取得することが目的、分析は別のツールで行う想定。

ツールを作成した理由

1. サイト調査する機会が多い

Webサイトリニューアル、UI/UX改善、マーケティング、ブランディング案件。あらゆる場面で「現在どのような情報発信をしているか」を調べる機会が急増。

2. 利用ツールの最適解がない

高機能なSEOツールはライセンスが高額。かといって、カスタマイズ性を求めてAIに直接クローリングさせても、試行錯誤のたびにトークンを浪費するだけで、結果も安定しない。

3. ビジュアライズよりデータの質

巷のSEOツールや、最近増えてるAIで作った系ツールなどは見やすさはあるものの、データの有用性や深さが足りないことが多く悩ましく感じたので改善したかった。

4. トークンの節約と有効活用

費用対効果を最大化させたい。100ページ規模のサイトをしっかり調査させれば、Claude Proレベルでもすぐに上限が来る。「定量のデータ収集」にトークンを消費したくない。泥臭い収集は専用ツールに任せ、その後の「戦略立案や深い調査」にトークンを当てたかった。

主な特徴

  • AI 解析への最適化：LLM が理解しやすいJSON階層
  • オプションが豊富：様々な--optionを完備
  • ハイブリッドなクロール：静的パースとJavaScriptレンダリングを自動切替でモダンサイトもOK
  • 網羅的なデータ：メタ情報、見出し、OGP、構造化データ、画像など
  • AI 向けの配慮：JSON の先頭に _meta フィールドを付与。AI にデータを食わせる際、AI 自身が「容量が大きすぎるので絞り込みますか？」とユーザーへ確認を入れるなど、AI でのデータ処理を補助するガイダンスあり。

使い方

1. Node.js の導入

実行には Node.js が必要。 ターミナルで node -v を実行し、エラーが出る場合は Node.js 公式 などからインストール。 AIに「Node.js付けるようにしたい」とお願いして案内に従うでもOK　※むしろこちらを推奨

2. 実行

npx 4ge-sitemap https://example.com

完了後、デスクトップに JSON が保存されるので、後はAIに突っ込むなど自由に活用できます。 まずは「データをサクッと見たい」ということであれば、簡易的なビューアーを準備しています。 Sitemap Viewer を開く

オプション

主要オプション

  • ヘルプ表示：npx 4ge-sitemap --help
  • 出力先指定：-o ./result.json または --output ./result.json
  • JSレンダリング強制：--js

オプション一覧

オプション既定値説明
-d, --depth <n>5巡回する階層の深さ上限
--max-pages <n>5000取得するページ数の上限
-o, --output <path>デスクトップ出力ファイルパスの指定
-f, --forceoff既存ファイルを上書き
-c, --concurrency <n>3並列リクエスト数
--rate-limit <n>5秒あたりの最大リクエスト数
--timeout <ms>100001リクエストのタイムアウト時間
--js / --no-jsautoJSレンダリングの有無（autoは自動判別）
--slimoff内部リンク詳細・画像情報を除外して軽量化
--no-internal-links-内部リンク詳細のみ省略
--no-images-画像情報のみ省略
--include-subdomainoffサブドメインもクロール対象に含める
--no-respect-robotsoffrobots.txt を無視して巡回
--user-agent <str>(内蔵)User-Agent の上書き
-h, --help-ヘルプ表示
-V, --version-バージョン表示

注意・免責・留意事項

  • AI 利用料金・サイト負荷・本ツール由来の一切の損害は使用者の責任です。
  • クロール対象サイトの利用規約・robots.txt を確認のうえご利用ください。
  • 私個人的に利用する前提のツールです。業務利用は自己責任でお願いします。
  • MIT License です。本ソフトウェアは無保証で提供されます。

ライセンス

MIT License

Copyright (c) 2026 4ge

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 8

Native requirements
8 direct targetsNot calculated transitive count
Package / targetRequirementRelationship
cheerio
Environment
{
  "local_name": "cheerio",
  "alias": false,
  "peer_metadata": null
}
^1.0.0runtime
commander
Environment
{
  "local_name": "commander",
  "alias": false,
  "peer_metadata": null
}
^12.1.0runtime
p-queue
Environment
{
  "local_name": "p-queue",
  "alias": false,
  "peer_metadata": null
}
^8.0.1runtime
playwright
Environment
{
  "local_name": "playwright",
  "alias": false,
  "peer_metadata": null
}
^1.50.0runtime
robots-parser
Environment
{
  "local_name": "robots-parser",
  "alias": false,
  "peer_metadata": null
}
^3.0.1runtime
undici
Environment
{
  "local_name": "undici",
  "alias": false,
  "peer_metadata": null
}
^7.0.0runtime
tsx
Environment
{
  "local_name": "tsx",
  "alias": false,
  "peer_metadata": null
}
^4.19.2development
vitest
Environment
{
  "local_name": "vitest",
  "alias": false,
  "peer_metadata": null
}
^4.1.9development

Distribution files

1 collected
Distribution 1

Source distribution

Source file
Checksums from source
{
  "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="
    }
  ]
}

Repository

PENDING
qlip-co-ltd/sitemap-tools

Shared repository data · GitHub

License detected in repository
Not collected

Metadata history

Meaningful changes
Current collected state Current

Observed since 20 Oct, 20:09 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:0894cd6311dd0f952c970dad726e37ea1c2ff1532d4d1c10467ee54bdfc77cbf

Other collected versions

0.2.712 MayView all collected versions →