🚀 AIエージェントに渡すHTMLを事前圧縮し、APIコストを大幅に削減！ 「コピペ・置くだけ」で使える、テスト検証済み Agent Skill パック（ワンコイン 500円）

「Claude Code」「Antigravity CLI」「Cursor」などのAIエージェントにWebスクレイピングやデータ収集を依頼したとき、以下のようなお悩みはありませんか？

・😱 生のHTML（数万トークン）をそのまま読み込んでAPIコストが一瞬で膨らむ

・🌀 大量の <script> / <style> / 広告コードのノイズに埋もれ、AIがデータを読み間違える

・💥 「DOM要素が見つかりません」とAIが何度も試行錯誤し、無駄な通信と時間を消費する

本Skillパックは、AIエージェントに事前処理モジュール（Node.jsゼロ依存）と行動プロンプトを読み込ませることで、AIに渡すデータ量を大きく削減し、安定してデータを取得できるようにする拡張パックです。

✨ 本Skillパックの5大特長

1. 💰 AIに渡す文字数を大幅削減（実測 97.5%）

数万文字におよぶ生のHTMLからスクリプト・スタイル・SVG・コメントを除去し、純粋なテキストに事前圧縮してAIへ渡します。

▼ 実測値（2026年8月・zenn.dev/faq にて計測）

　39,384文字 → 991文字（97.5%削減）

※ 文字数ベースの実測値です。削減率はページ構造により変動します。同梱コードで、ご自身の対象サイトでも計測できます。

※ HTMLはトークン効率が悪いため、トークンベースではさらに削減幅が大きくなる傾向がありますが、本数値は文字数での計測です。

2. ⚡ SPA（Single Page Application）をブラウザ無しで攻略

Next.js / Nuxt / Remix 等が静的HTML内に埋め込んでいる初期JSON（__NEXT_DATA__ 等）を直接パース。重いPlaywrightを起動せずに構造化データを抽出します。

▼ 実測例：Zenn（Next.js製）の記事ページから __NEXT_DATA__ の11,074文字の構造化JSONを取得。

　publishedAt / commentsCount / articleType など、テキスト抽出では得られないフィールドまで取得できました。

3. 🎯 JSON-LD & OGP の優先取得

サイト側が「正確である」と意図して置いている構造化データを優先的に抽出。AIの推測ミスを減らします。属性順序が逆のmetaタグ、壊れたJSON-LDにも対応済みです。

4. 📦 ゼロ依存 ＆ 単体テストで検証済み

Node.js 18 標準機能のみで動作（外部npmパッケージ不要）。

▼ `npm test` の実測出力（2026-08-10 / Playwright 導入環境）

　tests 49 / pass 49 / fail 0 / skipped 0

　※ Playwright 導入環境にて実ブラウザテスト2件を含む全49件のパスを確認済みです（未導入環境では 47パス / 2スキップ）。

5. 🛡 エージェント用コンプライアンス（robots.txt / レート制限）内蔵

robots.txt の確認やアクセス間隔の調整をAIに実行させる行動ルールを SKILL.md に定義しています。

🎁 パッケージ同梱ファイル内容（全8ファイル）

解凍してプロジェクトの `.agents/skills/` ディレクトリに置くだけで利用可能です。

・SKILL.md — AIエージェント（Claude Code / Antigravity / Cursor等）が自動参照するプロンプト＆行動規範

・scripts/extractor.js — ノイズ除去・メタデータ/JSON-LD/埋め込みJSON・テーブル抽出モジュール（ゼロ依存）

・scripts/extractor.test.js — 単体テスト33件（すべてブラウザ不要・全パス）

・scripts/fetch-rendered.js — Playwright連携用モジュール（JavaScript動的描画サイト用・任意）

・scripts/fetch-rendered.test.js — Playwright連携のテスト16件（14件スタブ検証＋2件実ブラウザ検証・全16件パス確認済み）

・PLAYWRIGHT.md — 動的サイトの待機戦略・無限スクロール・トラブルシューティングガイド

・package.json — `"type": "module"` 設定済み

・LICENSE.txt — 利用許諾条件

⚙️ 動作要件・仕様

・Node.js 18 以上

・外部npm依存パッケージ：不要（ゼロ依存で動作します）

・モジュール形式：ES Modules (ESM)

・Playwright は「任意」です。導入しなくても extractor.js は全機能が動作し、テストも失敗ゼロで通過します。

　動的描画サイト向けの `fetch-rendered.js` を使う場合のみ、以下を実行してください。

　　npx playwright install --with-deps chromium

⚠️ ご購入前にご確認ください（できないこと）

・Cloudflare 等の強いBot防御・CAPTCHAがあるサイトの回避機能は含まれません。

・ログインが必要なサイトは、セッションCookieや認証トークンをご自身で設定いただく必要があります。

・DOMパーサーではなく正規表現による実装のため、極端に不正なHTMLでは抽出精度が落ちる場合があります。

・スクレイピング対象サイトの利用規約・robots.txt・著作権および適用法令の遵守は、利用者の責任において行っていただきます。

📜 利用ライセンス・注意事項

・個人利用・商用利用ともに可能です（購入者ご自身のプロジェクト・開発業務にてご使用いただけます）。

・プログラムコードの改変・カスタマイズは自由に行っていただけます。

・本商品（改変物を含む）の二次配布、転売、オークションへの出品、パブリックリポジトリや共有サイトへの無断公開は禁止いたします。

・購入者ご自身が開発した成果物に本商品を部品として組み込み、その成果物を販売・公開することは可能です。

・詳細な条件は同梱の LICENSE.txt に記載しています。

アップデート履歴

[2026-08-10: v1.1.0] 初回リリース

[2026-08-11: v1.1.1] LICENSE.txt を追加