利用者ゼロでも付く DL は何件か——自分のパッケージはそれを超えているか
npm download counts include traffic from mirrors, CI and security scanners even when nobody uses a package. npm-floor estimates that floor for your package and tells you whether your real downloads are above it.
npm のパッケージには、誰も使っていなくてもミラー・CI・セキュリティスキャナ(=ボットの分)からの DL が付く。公開初月で数十〜百数十件、版を出すたびに 100〜150 件。npm-floor は、その件数(床)を自分のパッケージについて出し、実測がそこから抜け出しているかを 1 コマンドで答える。
受け取り方
- 「¥980 で購入する」を押すと Stripe の決済画面が開きます(カード等)
- 決済が完了すると、そのままダウンロードページに移ります。npm-floor-dataset.zip をダウンロードしてください
- ZIP を展開して METHOD.md(取り方・列の意味・注意・利用条件)から読んでください。CSV は表計算ソフトでそのまま開けます
- 届かない・開けないときは、下の「特定商取引法に基づく表記」の連絡先へ
道具(CLI)と月別の床の表は MIT で無料です。データセットは、その表の元になった 590 件分の生の日次 DL(公開日 −1〜+45 日・匿名化・除外した系列も印つきで同梱)と、どう集めたかの手順書、床の推移のグラフで、研究・記事・自分のダッシュボード用です。CLI で自分のパッケージを判定するだけなら要りません。
できること
- npx npm-floor <package> で、実測 DL・床・超過・判定が 1 画面で出る。--lang ja で日本語、--json で機械可読
- 床は 2024-01〜2026-07 の月ごとに実測した一次データ(計 563 件・各月 9〜29 件)。npx npm-floor explain で表そのものが見える
- 短期間に版を大量に出して数字を膨らませるパッケージ(version pumping)には注意の行が付く
- npx npm-floor calibrate で表を自分で作り直せる(約 1 時間・再開可)
- Node.js 20 以上・インストール不要(npx)・アカウント不要・MIT。npm の公開 API を読むだけ
- 有償: 表の元になった生の日次データ(匿名化・CSV/JSON)と手順書・推移グラフの ZIP。CLI で自分のパッケージを見るだけなら不要
よくある質問
- 誰も使っていないのに DL が付くのはなぜですか?
- ミラー・CI・セキュリティスキャナ(=ボットの分)からの DL が付くためです。公開初月で数十〜百数十件、版を出すたびに 100〜150 件付きます。
- どう使いますか?
- npx npm-floor <package> で、実測 DL・床・超過・判定が 1 画面で出ます。インストールもアカウントも要りません。
- 床の数字はどこから来ていますか?
- 誰も使っていない実在のパッケージを、2024-01〜2026-07 の月ごとに実測した一次データ(計 563 件)です。npx npm-floor explain で表そのものが見られます。
- 有償のデータセットは必要ですか?
- CLI で自分のパッケージを判定するだけなら要りません。表の元になった生の日次 DL と手順書が要る人(研究・記事・自分のダッシュボード用)向けです。
仕組み
実在する練習用パッケージ(誰も使っていないもの)が公開月ごとに何件 DL されたかを実測した表を同梱。自分のパッケージが窓内に出した版の数と存在した日数から床を組み、実測と比べて「床と区別できない/床を超える/明確に床の上」の 3 段で答える。測り方の全文はパッケージ内の docs/method.md。
開発者向け(コマンドライン版・無料)
無料のコマンドライン版があります(Node.js・MIT ライセンス)。上の有償版とは中身が違います。使い方はnpm のパッケージページにあります。
npx npm-floor --help