stillo-0.1.8 is not a library.

stillo

AIネイティブなターミナルブラウザ。Rustで実装。

stillo は distill（蒸留する）から作った造語です。Webページを蒸留して情報だけを抽出するというコンセプトを名前に込めています。

概要

stilloはターミナル上で動作するブラウザです。静的なHTMLページはそのまま取得し、React/Vue等のSPAはChrome CDP・Jina Reader・Firecrawl等へ自動委譲してコンテンツを取得します。取得したページはMarkdown/テキスト/JSONとして出力するか、TUIで対話的にブラウズできます。

インストール

cargo build --release
# バイナリは target/release/stillo に生成されます

使い方

# TUIブラウザとして開く
stillo https://example.com

# Markdownとして標準出力に出力
stillo dump https://example.com

# 出力形式を指定
stillo dump --format json https://example.com
stillo dump --format plain https://example.com

# SPA委譲先を明示
stillo dump --delegate jina https://example.com

# JS委譲を無効化（静的HTMLのみ処理）
stillo dump --no-delegate https://example.com

# タイムアウト秒数を指定（デフォルト30秒）
stillo dump --timeout 60 https://example.com

# 詳細ログを出力（stderrに出力）
stillo dump -v https://example.com

サブコマンド

コマンド	説明	状態
`dump`	ページをMarkdown/テキスト/JSONとして stdout に出力	実装済み
`browse`	TUIブラウザとして起動	実装済み
`qa`	ページについてLLMに質問	Phase 4 予定
`summarize`	ページを要約	Phase 4 予定
`extract`	指定フィールドを抽出	Phase 4 予定
`mcp`	MCPサーバーとして起動	Phase 5 予定

SPA委譲

SPAと判定されたページは以下の優先順位で委譲を試みます（いずれかが成功すれば以降はスキップ）。

Chrome CDP — localhost:9222 でChromeが起動していれば使用
Playwright Daemon — /tmp/stillo-playwright.sock が存在すれば使用
Jina Reader — 常にフォールバック候補（JINA_API_KEY 設定で認証）
Firecrawl — FIRECRAWL_URL と FIRECRAWL_API_KEY が両方設定されていれば使用

全ターゲットが失敗した場合は静的HTMLにフォールバックします。

Chrome CDP を使う場合

# --remote-debugging-port=9222 でChromeを起動しておく
google-chrome --remote-debugging-port=9222 --headless
stillo dump https://your-spa-app.example.com

Jina Reader を使う場合

export JINA_API_KEY=your_api_key
stillo dump https://your-spa-app.example.com

Firecrawl を使う場合

export FIRECRAWL_URL=https://api.firecrawl.dev/
export FIRECRAWL_API_KEY=your_api_key
stillo dump https://your-spa-app.example.com

クレート構成

クレート	役割
`stillo-core`	純粋関数のみ（HTML解析・コンテンツ抽出・Markdown変換）
`stillo-fetcher`	HTTP取得・SPA委譲
`stillo-renderer`	TUI描画
`stillo` (cli)	コマンドライン引数解析・全体オーケストレーション

将来構想

stilloネイティブモード

サーバとクライアントの主従を逆転させるコンセプト。従来のWebはサーバがHTMLでデザインごとコンテンツを送りつけるが、stilloネイティブモードではサーバはデータとセマンティクスのみを返し、表示・デザインはクライアントが全面的にコントロールする。

既存のWebへのフォールバックを維持しつつ、対応サーバにはよりリッチなセマンティクスを返させるオプトイン型の拡張として設計する想定。stillo mcp（Phase 5）と組み合わせ、MCPサーバが変換層を担うことも視野に入れる。

開発

# ビルド
cargo build

# テスト
cargo test

# CDPサポートを有効にしてビルド
cargo build --features stillo-fetcher/cdp

ログレベルは RUST_LOG 環境変数で制御できます（stderrに出力）。

RUST_LOG=debug stillo dump https://example.com

stillo 0.1.8