@mcptoolshop/registry-stats 0.3.1 → 0.4.1

package/README.ja.md

@@ -3,30 +3,35 @@
 </p>
 
 <p align="center">
-  <img src="assets/logo.png" alt="registry-stats ロゴ" width="280" />
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/registry-stats/readme.png" alt="registry-stats logo" width="400" />
 </p>
 
-<h1 align="center">@mcptoolshop/registry-stats</h1>
+<p align="center">
+  One command. Five registries. All your download stats.
+</p>
 
 <p align="center">
-  1つのコマンド。5つのレジストリ。すべてのダウンロード統計。
+  <a href="https://github.com/mcp-tool-shop-org/registry-stats/actions/workflows/pages.yml"><img src="https://github.com/mcp-tool-shop-org/registry-stats/actions/workflows/pages.yml/badge.svg" alt="CI"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="MIT License"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/registry-stats"><img src="https://img.shields.io/npm/v/@mcptoolshop/registry-stats" alt="npm version"></a>
+  <a href="https://mcp-tool-shop-org.github.io/registry-stats/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
 </p>
 
 <p align="center">
-  <a href="https://mcp-tool-shop-org.github.io/registry-stats/">ドキュメント</a> &middot;
-  <a href="#インストール">インストール</a> &middot;
+  <a href="https://mcp-tool-shop-org.github.io/registry-stats/">Docs</a> &middot;
+  <a href="#install">Install</a> &middot;
   <a href="#cli">CLI</a> &middot;
-  <a href="#設定ファイル">設定</a> &middot;
-  <a href="#プログラマティックapi">API</a> &middot;
-  <a href="#rest-apiサーバー">RESTサーバー</a> &middot;
-  <a href="#ライセンス">ライセンス</a>
+  <a href="#config-file">Config</a> &middot;
+  <a href="#programmatic-api">API</a> &middot;
+  <a href="#rest-api-server">REST Server</a> &middot;
+  <a href="#license">License</a>
 </p>
 
 ---
 
-npm、PyPI、NuGet、VS Code Marketplace、Docker Hubにパッケージを公開している場合、「今月のダウンロード数は？」という質問に答えるために5つの異なるAPIが必要です。このライブラリは、CLIまたはプログラマティックAPIとして、すべてを1つのインターフェースで提供します。
+もし、npm、PyPI、NuGet、VS Code Marketplace、またはDocker Hubに公開している場合、現在、"今月ダウンロード数は何件ですか？"という質問に答えるために、5つの異なるAPIが必要になります。このライブラリは、それらすべてに対して、CLIまたはプログラムAPIとして、単一のインターフェースを提供します。
 
-依存関係ゼロ。ネイティブ`fetch()`を使用。Node 18+。
+依存関係はゼロです。ネイティブの`fetch()`を使用します。Node 18以降が必要です。
 
 ## インストール
 
@@ -34,47 +39,61 @@ npm、PyPI、NuGet、VS Code Marketplace、Docker Hubにパッケージを公開
 npm install @mcptoolshop/registry-stats
 ```
 
-## CLI
+## CLI (コマンドラインインターフェース)
 
 ```bash
-# 単一レジストリのクエリ
+# Query a single registry
 registry-stats express -r npm
+#  npm     | express
+#            month: 283,472,710  week: 67,367,773  day: 11,566,113
 
-# すべてのレジストリを一度にクエリ
+# Query all registries at once
 registry-stats express
 
-# 月次内訳 + トレンド付き時系列
+# Time series with monthly breakdown + trend
 registry-stats express -r npm --range 2025-01-01:2025-06-30
+#  2025-01  142,359,021
+#  2025-02  147,522,528
+#  ...
+#  Total: 448,383,383  Avg/day: 4,982,038  Trend: flat (-0.46%)
 
-# JSON出力
+# Raw JSON output
 registry-stats express -r npm --json
 
-# その他のレジストリ
+# Other registries
 registry-stats requests -r pypi
 registry-stats Newtonsoft.Json -r nuget
 registry-stats esbenp.prettier-vscode -r vscode
 registry-stats library/node -r docker
 
-# 設定ファイルを作成
+# Create a config file
 registry-stats --init
 
-# 設定から実行 — 追跡パッケージをすべて取得
+# Run with config — fetches all tracked packages
 registry-stats
 
-# レジストリ間の比較
+# Compare across registries
 registry-stats express --compare
-
-# CSVまたはチャート用JSONでエクスポート
+#  express — comparison
+#
+#  Metric        npm         pypi
+#  ─────────────────────────────────
+#  Total         -           -
+#  Month         283,472     47,201
+#  Week          67,367      11,800
+#  Day           11,566      1,686
+
+# Export as CSV or chart-friendly JSON
 registry-stats express -r npm --range 2025-01-01:2025-06-30 --format csv
 registry-stats express -r npm --range 2025-01-01:2025-06-30 --format chart
 
-# REST APIサーバーを起動
+# Start a REST API server
 registry-stats serve --port 3000
 ```
 
 ## 設定ファイル
 
-プロジェクトルートに`registry-stats.config.json`を作成します（または`registry-stats --init`を実行）:
+プロジェクトのルートディレクトリに`registry-stats.config.json`を作成します（または、`registry-stats --init`を実行します）。
 
 ```json
 {
@@ -95,85 +114,104 @@ registry-stats serve --port 3000
 }
 ```
 
-引数なしで`registry-stats`を実行すると、設定されたすべてのパッケージの統計を取得します。CLIはcwdから上方に設定ファイルを検索します。
+設定されたすべてのパッケージの統計情報を取得するには、引数なしで`registry-stats`を実行します。CLIは、現在の作業ディレクトリから上位のディレクトリを検索し、最も近い設定ファイルを見つけます。
+
+設定ファイルは、プログラム的に利用することも可能です。
+
+```typescript
+import { loadConfig, defaultConfig, starterConfig } from '@mcptoolshop/registry-stats';
+
+const config = loadConfig();          // finds nearest config file, or null
+const defaults = defaultConfig();     // returns default Config object
+const template = starterConfig();     // returns starter JSON string
+```
 
-## プログラマティックAPI
+## プログラムAPI
 
 ```typescript
 import { stats, calc, createCache } from '@mcptoolshop/registry-stats';
 
-// 単一レジストリ
+// Single registry
 const npm = await stats('npm', 'express');
 const pypi = await stats('pypi', 'requests');
+const nuget = await stats('nuget', 'Newtonsoft.Json');
+const vscode = await stats('vscode', 'esbenp.prettier-vscode');
+const docker = await stats('docker', 'library/node');
 
-// すべてのレジストリを一度に（Promise.allSettledを使用 — スローしない）
+// All registries at once (uses Promise.allSettled — never throws)
 const all = await stats.all('express');
 
-// 一括 — 複数パッケージ、並行数制限（デフォルト: 5）
+// Bulk — multiple packages, concurrency-limited (default: 5)
 const bulk = await stats.bulk('npm', ['express', 'koa', 'fastify']);
 
-// 時系列（npm + pypiのみ）
+// Time series (npm + pypi only)
 const daily = await stats.range('npm', 'express', '2025-01-01', '2025-06-30');
 
-// 計算
-calc.total(daily);                         // ダウンロード合計
-calc.avg(daily);                           // 日次平均
+// Calculations
+calc.total(daily);                         // sum of all downloads
+calc.avg(daily);                           // daily average
+calc.groupTotals(calc.monthly(daily));     // { '2025-01': 134982, ... }
 calc.trend(daily);                         // { direction: 'up', changePercent: 8.3 }
-calc.movingAvg(daily, 7);                  // 7日間移動平均
-calc.popularity(daily);                    // 0-100 対数スケールスコア
+calc.movingAvg(daily, 7);                  // 7-day moving average
+calc.popularity(daily);                    // 0-100 log-scale score
 
-// エクスポート形式
-calc.toCSV(daily);                         // CSV文字列
-calc.toChartData(daily, 'express');        // { labels: [...], datasets: [...] }
+// Export formats
+calc.toCSV(daily);                         // "date,downloads\n2025-01-01,1234\n..."
+calc.toChartData(daily, 'express');        // { labels: [...], datasets: [{ label, data }] }
 
-// 比較 — レジストリ間で同じパッケージ
+// Comparison — same package across registries
 const comparison = await stats.compare('express');
-await stats.compare('express', ['npm', 'pypi']);
+// → { package: 'express', registries: { npm: {...}, pypi: {...} }, fetchedAt: '...' }
+await stats.compare('express', ['npm', 'pypi']);  // specific registries only
 
-// キャッシュ（5分TTL、インメモリ）
+// Caching (5 min TTL, in-memory)
 const cache = createCache();
-await stats('npm', 'express', { cache });
+await stats('npm', 'express', { cache });  // fetches
+await stats('npm', 'express', { cache });  // cache hit
 ```
 
-## レジストリサポート
+## レジストリのサポート
 
-| レジストリ | パッケージ形式 | 時系列 | 利用可能データ |
-|----------|---------------|--------|----------------|
-| `npm` | `express`, `@scope/pkg` | あり（549日） | lastDay, lastWeek, lastMonth |
-| `pypi` | `requests` | あり（180日） | lastDay, lastWeek, lastMonth, total |
-| `nuget` | `Newtonsoft.Json` | なし | total |
-| `vscode` | `publisher.extension` | なし | total（インストール数）、rating、trends |
-| `docker` | `namespace/repo` | なし | total（プル数）、stars |
+| レジストリ | パッケージ形式 | 時系列データ | 利用可能なデータ |
+| ---------- | --------------- | ------------- | ---------------- |
+| `npm` | `express`, `@scope/pkg` | はい (549日間) | lastDay (直近1日), lastWeek (直近1週間), lastMonth (直近1ヶ月) |
+| `pypi` | `requests` | はい (180日間) | lastDay (直近1日), lastWeek (直近1週間), lastMonth (直近1ヶ月), total (合計) |
+| `nuget` | `Newtonsoft.Json` | No | total (合計) |
+| `vscode` | `publisher.extension` | No | total (インストール数), rating (評価), trends (傾向) |
+| `docker` | `namespace/repo` | No | total (ダウンロード数), stars (スター数) |
 
 ## 組み込みの信頼性
 
-- 429/5xxエラーに対する指数バックオフ付き自動リトライ
-- `Retry-After`ヘッダーの尊重
-- 一括リクエストの並行数制限
-- オプションのTTLキャッシュ（プラグイン可能 — `StatsCache`インターフェースでRedis/ファイルバックエンドを利用可能）
+- 429/5xxエラーが発生した場合、指数関数的なバックオフによる自動再試行
+- `Retry-After`ヘッダーを尊重
+- 大量リクエストに対する同時実行数の制限
+- オプションのTTLキャッシュ (プラグイン可能。`StatsCache`インターフェースを通じて、独自のRedis/ファイルバックエンドを提供)
 
 ## REST APIサーバー
 
-マイクロサービスとして実行、または独自のサーバーに組み込み:
+マイクロサービスとして実行するか、独自のサーバーに組み込むことができます。
 
 ```bash
+# CLI
 registry-stats serve --port 3000
 ```
 
 ```
-GET /stats/:package              # すべてのレジストリ
-GET /stats/:registry/:package    # 単一レジストリ
+GET /stats/:package              # all registries
+GET /stats/:registry/:package    # single registry
 GET /compare/:package?registries=npm,pypi
 GET /range/:registry/:package?start=YYYY-MM-DD&end=YYYY-MM-DD&format=json|csv|chart
 ```
 
+カスタムサーバーまたはサーバーレス環境でのプログラム的な利用方法。
+
 ```typescript
 import { createHandler, serve } from '@mcptoolshop/registry-stats';
 
-// クイックスタート
+// Option 1: Quick start
 serve({ port: 3000 });
 
-// カスタムサーバー
+// Option 2: Bring your own server
 import { createServer } from 'node:http';
 const handler = createHandler();
 createServer(handler).listen(3000);
@@ -202,6 +240,18 @@ registerProvider(cargo);
 await stats('cargo', 'serde');
 ```
 
+## ウェブサイト
+
+ドキュメント/ランディングページは`site/`にあります。
+
+- 開発: `npm run site:dev`
+- ビルド: `npm run site:build`
+- プレビュー: `npm run site:preview`
+
 ## ライセンス
 
 MIT
+
+---
+
+<a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>によって作成されました。

package/README.md

@@ -3,15 +3,20 @@
 </p>
 
 <p align="center">
-  <img src="assets/logo.png" alt="registry-stats logo" width="280" />
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/registry-stats/readme.png" alt="registry-stats logo" width="400" />
 </p>
 
-<h1 align="center">@mcptoolshop/registry-stats</h1>
-
 <p align="center">
   One command. Five registries. All your download stats.
 </p>
 
+<p align="center">
+  <a href="https://github.com/mcp-tool-shop-org/registry-stats/actions/workflows/pages.yml"><img src="https://github.com/mcp-tool-shop-org/registry-stats/actions/workflows/pages.yml/badge.svg" alt="CI"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="MIT License"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/registry-stats"><img src="https://img.shields.io/npm/v/@mcptoolshop/registry-stats" alt="npm version"></a>
+  <a href="https://mcp-tool-shop-org.github.io/registry-stats/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
+</p>
+
 <p align="center">
   <a href="https://mcp-tool-shop-org.github.io/registry-stats/">Docs</a> &middot;
   <a href="#install">Install</a> &middot;
@@ -246,3 +251,7 @@ Docs / landing page lives in `site/`.
 ## License
 
 MIT
+
+---
+
+Built by <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>

package/README.pt-BR.md

@@ -3,30 +3,35 @@
 </p>
 
 <p align="center">
-  <img src="assets/logo.png" alt="logo registry-stats" width="280" />
+  <img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/registry-stats/readme.png" alt="registry-stats logo" width="400" />
 </p>
 
-<h1 align="center">@mcptoolshop/registry-stats</h1>
+<p align="center">
+  One command. Five registries. All your download stats.
+</p>
 
 <p align="center">
-  Um comando. Cinco registros. Todas as suas estatísticas de download.
+  <a href="https://github.com/mcp-tool-shop-org/registry-stats/actions/workflows/pages.yml"><img src="https://github.com/mcp-tool-shop-org/registry-stats/actions/workflows/pages.yml/badge.svg" alt="CI"></a>
+  <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="MIT License"></a>
+  <a href="https://www.npmjs.com/package/@mcptoolshop/registry-stats"><img src="https://img.shields.io/npm/v/@mcptoolshop/registry-stats" alt="npm version"></a>
+  <a href="https://mcp-tool-shop-org.github.io/registry-stats/"><img src="https://img.shields.io/badge/Landing_Page-live-blue" alt="Landing Page"></a>
 </p>
 
 <p align="center">
   <a href="https://mcp-tool-shop-org.github.io/registry-stats/">Docs</a> &middot;
-  <a href="#instalação">Instalação</a> &middot;
+  <a href="#install">Install</a> &middot;
   <a href="#cli">CLI</a> &middot;
-  <a href="#arquivo-de-configuração">Configuração</a> &middot;
-  <a href="#api-programática">API</a> &middot;
-  <a href="#servidor-rest-api">Servidor REST</a> &middot;
-  <a href="#licença">Licença</a>
+  <a href="#config-file">Config</a> &middot;
+  <a href="#programmatic-api">API</a> &middot;
+  <a href="#rest-api-server">REST Server</a> &middot;
+  <a href="#license">License</a>
 </p>
 
 ---
 
-Se você publica no npm, PyPI, NuGet, VS Code Marketplace ou Docker Hub, atualmente precisa de cinco APIs diferentes para responder "quantos downloads eu tive este mês?" Esta biblioteca oferece uma interface unificada — como CLI ou API programática.
+Se você publica no npm, PyPI, NuGet, VS Code Marketplace ou Docker Hub, atualmente você precisa de cinco APIs diferentes para responder à pergunta "quantos downloads eu obtive este mês?". Esta biblioteca oferece uma única interface para todas elas — como uma interface de linha de comando (CLI) ou uma API programática.
 
-Zero dependências. Usa `fetch()` nativo. Node 18+.
+Sem dependências. Utiliza a função nativa `fetch()`. Node 18+.
 
 ## Instalação
 
@@ -34,47 +39,61 @@ Zero dependências. Usa `fetch()` nativo. Node 18+.
 npm install @mcptoolshop/registry-stats
 ```
 
-## CLI
+## Interface de Linha de Comando (CLI)
 
 ```bash
-# Consultar um único registro
+# Query a single registry
 registry-stats express -r npm
+#  npm     | express
+#            month: 283,472,710  week: 67,367,773  day: 11,566,113
 
-# Consultar todos os registros
+# Query all registries at once
 registry-stats express
 
-# Série temporal com detalhamento mensal + tendência
+# Time series with monthly breakdown + trend
 registry-stats express -r npm --range 2025-01-01:2025-06-30
+#  2025-01  142,359,021
+#  2025-02  147,522,528
+#  ...
+#  Total: 448,383,383  Avg/day: 4,982,038  Trend: flat (-0.46%)
 
-# Saída JSON
+# Raw JSON output
 registry-stats express -r npm --json
 
-# Outros registros
+# Other registries
 registry-stats requests -r pypi
 registry-stats Newtonsoft.Json -r nuget
 registry-stats esbenp.prettier-vscode -r vscode
 registry-stats library/node -r docker
 
-# Criar arquivo de configuração
+# Create a config file
 registry-stats --init
 
-# Executar com configuração — busca todos os pacotes rastreados
+# Run with config — fetches all tracked packages
 registry-stats
 
-# Comparar entre registros
+# Compare across registries
 registry-stats express --compare
-
-# Exportar como CSV ou JSON para gráficos
+#  express — comparison
+#
+#  Metric        npm         pypi
+#  ─────────────────────────────────
+#  Total         -           -
+#  Month         283,472     47,201
+#  Week          67,367      11,800
+#  Day           11,566      1,686
+
+# Export as CSV or chart-friendly JSON
 registry-stats express -r npm --range 2025-01-01:2025-06-30 --format csv
 registry-stats express -r npm --range 2025-01-01:2025-06-30 --format chart
 
-# Iniciar servidor REST API
+# Start a REST API server
 registry-stats serve --port 3000
 ```
 
 ## Arquivo de Configuração
 
-Crie um `registry-stats.config.json` na raiz do projeto (ou execute `registry-stats --init`):
+Crie um arquivo `registry-stats.config.json` na raiz do seu projeto (ou execute `registry-stats --init`):
 
 ```json
 {
@@ -95,85 +114,104 @@ Crie um `registry-stats.config.json` na raiz do projeto (ou execute `registry-st
 }
 ```
 
-Execute `registry-stats` sem argumentos para obter estatísticas de todos os pacotes configurados. O CLI procura o arquivo de configuração subindo a partir do diretório atual.
+Execute `registry-stats` sem argumentos para obter as estatísticas de todos os pacotes configurados. A CLI procura o arquivo de configuração a partir do diretório atual.
+
+A configuração também está disponível programaticamente:
+
+```typescript
+import { loadConfig, defaultConfig, starterConfig } from '@mcptoolshop/registry-stats';
+
+const config = loadConfig();          // finds nearest config file, or null
+const defaults = defaultConfig();     // returns default Config object
+const template = starterConfig();     // returns starter JSON string
+```
 
 ## API Programática
 
 ```typescript
 import { stats, calc, createCache } from '@mcptoolshop/registry-stats';
 
-// Registro único
+// Single registry
 const npm = await stats('npm', 'express');
 const pypi = await stats('pypi', 'requests');
+const nuget = await stats('nuget', 'Newtonsoft.Json');
+const vscode = await stats('vscode', 'esbenp.prettier-vscode');
+const docker = await stats('docker', 'library/node');
 
-// Todos os registros (usa Promise.allSettled — nunca lança erro)
+// All registries at once (uses Promise.allSettled — never throws)
 const all = await stats.all('express');
 
-// Em massa — múltiplos pacotes, concorrência limitada (padrão: 5)
+// Bulk — multiple packages, concurrency-limited (default: 5)
 const bulk = await stats.bulk('npm', ['express', 'koa', 'fastify']);
 
-// Série temporal (apenas npm + pypi)
+// Time series (npm + pypi only)
 const daily = await stats.range('npm', 'express', '2025-01-01', '2025-06-30');
 
-// Cálculos
-calc.total(daily);                         // total de downloads
-calc.avg(daily);                           // média diária
+// Calculations
+calc.total(daily);                         // sum of all downloads
+calc.avg(daily);                           // daily average
+calc.groupTotals(calc.monthly(daily));     // { '2025-01': 134982, ... }
 calc.trend(daily);                         // { direction: 'up', changePercent: 8.3 }
-calc.movingAvg(daily, 7);                  // média móvel de 7 dias
-calc.popularity(daily);                    // pontuação 0-100 escala logarítmica
+calc.movingAvg(daily, 7);                  // 7-day moving average
+calc.popularity(daily);                    // 0-100 log-scale score
 
-// Formatos de exportação
-calc.toCSV(daily);                         // string CSV
-calc.toChartData(daily, 'express');        // { labels: [...], datasets: [...] }
+// Export formats
+calc.toCSV(daily);                         // "date,downloads\n2025-01-01,1234\n..."
+calc.toChartData(daily, 'express');        // { labels: [...], datasets: [{ label, data }] }
 
-// Comparação — mesmo pacote entre registros
+// Comparison — same package across registries
 const comparison = await stats.compare('express');
-await stats.compare('express', ['npm', 'pypi']);
+// → { package: 'express', registries: { npm: {...}, pypi: {...} }, fetchedAt: '...' }
+await stats.compare('express', ['npm', 'pypi']);  // specific registries only
 
-// Cache (TTL 5 min, em memória)
+// Caching (5 min TTL, in-memory)
 const cache = createCache();
-await stats('npm', 'express', { cache });
+await stats('npm', 'express', { cache });  // fetches
+await stats('npm', 'express', { cache });  // cache hit
 ```
 
-## Suporte de Registros
+## Suporte a Registros
 
-| Registro | Formato do pacote | Série temporal | Dados disponíveis |
-|----------|------------------|----------------|-------------------|
-| `npm` | `express`, `@scope/pkg` | Sim (549 dias) | lastDay, lastWeek, lastMonth |
-| `pypi` | `requests` | Sim (180 dias) | lastDay, lastWeek, lastMonth, total |
-| `nuget` | `Newtonsoft.Json` | Não | total |
-| `vscode` | `publisher.extension` | Não | total (instalações), rating, trends |
-| `docker` | `namespace/repo` | Não | total (pulls), stars |
+| Registro | Formato do pacote | Séries temporais | Dados disponíveis |
+| ---------- | --------------- | ------------- | ---------------- |
+| `npm` | `express`, `@scope/pkg` | Sim (549 dias) | último dia, última semana, último mês |
+| `pypi` | `requests` | Sim (180 dias) | último dia, última semana, último mês, total |
+| `nuget` | `Newtonsoft.Json` | No | total |
+| `vscode` | `publisher.extension` | No | total (instalações), avaliação, tendências |
+| `docker` | `namespace/repo` | No | total (downloads), estrelas |
 
 ## Confiabilidade Integrada
 
-- Retry automático com backoff exponencial em erros 429/5xx
+- Tentativa automática com retrocesso exponencial em caso de erros 429/5xx
 - Respeita os cabeçalhos `Retry-After`
-- Limitação de concorrência para requisições em massa
-- Cache TTL opcional (extensível — use Redis/arquivo via interface `StatsCache`)
+- Limitação de concorrência para solicitações em lote
+- Cache TTL opcional (plugável — utilize seu próprio backend Redis/arquivo através da interface `StatsCache`)
 
-## Servidor REST API
+## Servidor de API REST
 
-Execute como microsserviço ou integre ao seu servidor:
+Execute como um microserviço ou incorpore em seu próprio servidor:
 
 ```bash
+# CLI
 registry-stats serve --port 3000
 ```
 
 ```
-GET /stats/:package              # todos os registros
-GET /stats/:registry/:package    # registro único
+GET /stats/:package              # all registries
+GET /stats/:registry/:package    # single registry
 GET /compare/:package?registries=npm,pypi
 GET /range/:registry/:package?start=YYYY-MM-DD&end=YYYY-MM-DD&format=json|csv|chart
 ```
 
+Uso programático para servidores personalizados ou sem servidor:
+
 ```typescript
 import { createHandler, serve } from '@mcptoolshop/registry-stats';
 
-// Início rápido
+// Option 1: Quick start
 serve({ port: 3000 });
 
-// Servidor personalizado
+// Option 2: Bring your own server
 import { createServer } from 'node:http';
 const handler = createHandler();
 createServer(handler).listen(3000);
@@ -202,6 +240,18 @@ registerProvider(cargo);
 await stats('cargo', 'serde');
 ```
 
+## Website
+
+A documentação e a página inicial estão localizadas em `site/`.
+
+- Desenvolvimento: `npm run site:dev`
+- Construção: `npm run site:build`
+- Visualização: `npm run site:preview`
+
 ## Licença
 
 MIT
+
+---
+
+Criado por <a href="https://mcp-tool-shop.github.io/">MCP Tool Shop</a>