AIに読ませるページのノイズを除き、トークン消費を減らす「ctxpack」
- 公開
- 正式公開 2026-06-08(Zenn 告知は 2026-06-10)
- 作り手
- atani(個人)
- 対応
- CLI(Homebrew)・Windows(winget)
- 価格
- 無料(MIT ライセンス)
- 評価
- GitHub のスター 6(2026-10-10)
どんなアプリか
ctxpack は、ノイズの多い Web ページや HTML、Markdown を、AI エージェントが扱いやすい小さなコンテキストに変えるコマンドラインのツールです。ナビゲーションやスクリプト、クッキーのバナー、フッターといったページの飾りを取り除き、役に立つ構造は残したうえで、減らせたトークン数を積み上げて記録します。
CtxPack is designed as a tool an agent can call before reading a URL.
atani さん、ctxpack の GitHub の README
読み込めるのは URL、手元の HTML や Markdown のファイル、標準入力です。出力は Markdown か、エージェントのツール呼び出し向けの JSON から選べます。JSON の出力には毎回トークンの節約量が入ります。
--query に作業の内容を渡すと、関係する節がページの上のほうへ移ります。内容はすべて残したまま、簡単な関連度の点数で節を並べ替える仕組みです。
入れ方は Homebrew、Windows の winget、Go でソースから入れる方法の3通りが案内されています。
料金とデータの置き場所
MIT ライセンスで公開されています。
実行の記録は手元の ~/.ctxpack/stats.jsonl に残ります。--no-record を付けるとその回は記録されず、ctxpack reset --yes で記録を消せます。外部の読み取り API には頼らない作りです。
同じ分野のアプリ
| 名前 | 型 | 仕掛け | 対応 | 料金 |
|---|---|---|---|---|
| ctxpack | Web ページの前処理 | ページのノイズを除いて小さな Markdown / JSON にし、節約トークン数を記録 | CLI(Homebrew / winget) | 無料(MIT) |
| mikke | ノート検索 | 日本語 Markdown ノートを関連度順に全文検索。AI エージェントに使わせる前提 | CLI(単一バイナリ) | 無料(MIT) |
| ccteams | エージェント設定 | Claude Code のサブエージェント「チーム」を1コマンドでプロジェクトに適用 | CLI(npm)/ Claude Code プラグイン | 無料(MIT) |
| mdroll | Markdown ビューア | 見出しが大きく表示され、GFM に対応したターミナル用ビューア | ターミナル | 無料(MIT) |
入れる前に
対象は静的な HTML と Markdown です。JavaScript で描画するページ、強いボット対策や CAPTCHA のあるページ、ログインが要るページ、PDF や DOCX は今のところ対象外です。JavaScript で描画するページは検出され、終了コード 3 で知らせます。
トークン数は特定のモデルに合わせた正確な数ではなく、前後を比べるための概算です。ひらがな・カタカナ・漢字は1文字およそ 0.8 トークンとして数えます。
README では現状を初期の MVP としていて、記事やドキュメントのようなページと手元の HTML で最もよく動くと説明されています。
v0.2.x までは Python のパッケージでした。pip や uv tool install で入れていた場合は、Homebrew などの入れ方に切り替える必要があります。コマンドの使い方と記録の形式は変わっていません。