distill-mcp

Distill MCP サーバー

あらゆるウェブページから、ナビゲーション、広告、スクリプトを除いたメインコンテンツのみを、すっきりした Markdown として AI エージェントに提供します。Distill は robots.txt と AI による利用のオプトアウトを尊重します。

サーバーはオープンソース（MIT）です。有料の Distill API を呼び出しますが、無料プランもあります。

• RapidAPI または api.market で取得した、ご自身のキーを使用します。
• ツールの呼び出しごとに、プランのリクエストを 1 回分消費します。
• 無料の Basic プランは月 15 回までで、厳格な上限があるため、料金が発生することはありません。

1. キーを取得する

マーケットプレイス
RapidAPI	プラン
api.market	ストア

2. MCP クライアントにサーバーを追加する

サーバーは uv を使い、ローカルで stdio 経由で動作します。キーは環境に設定してください。

JSON 設定（Claude Desktop、Cursor、VS Code など、ほとんどのクライアントで使用できます）：

{
  "mcpServers": {
    "distill": {
      "command": "uvx",
      "args": ["--from", "bytestay-distill-mcp", "distill-mcp"],
      "env": { "RAPIDAPI_KEY": "your-rapidapi-key" }
    }
  }
}

Claude Code：

claude mcp add distill --env RAPIDAPI_KEY=your-rapidapi-key -- uvx --from bytestay-distill-mcp distill-mcp

環境変数

変数	意味
RAPIDAPI_KEY	RapidAPI キー
API_MARKET_KEY	api.market キー。RAPIDAPI_KEY が設定されていない場合に使用されます
HFL_MARKETPLACE	両方のキーが設定されている場合に使用する rapidapi または apimarket

キーがなくてもサーバーは起動します。最初のツール呼び出し時に、キーの取得先が案内されます。

Glama にも掲載されています：

3. ツール

ツール	機能
fetch_markdown(url, max_chars=20000, include_links=True, include_images=False, include_tables=True)	ページを取得し、タイトル、著者、日付、言語とともに、メインコンテンツを Markdown として返します
html_to_markdown(html, base_url=None, …)	手元にある HTML に対して同じ処理を行います。ページの取得は行いません

サイトが取得を拒否した場合（robots.txt、noai ディレクティブ、ボット対策など）、status にその旨が示され、note でエージェントに指示を尊重するよう求めます。別の方法でページを取得しないでください。利用規約で禁止されています。

成功時の status は ok です。それ以外の値（robots_txt、opted_out、blocked、not_html、http_error、unreachable）は、コンテンツがない理由を示します。

各ツールは API の JSON レスポンスを返します。

• マーケットプレイスから報告された場合、今月のプランで残っているリクエスト数 quota_remaining が追加されます。
• エラーは、次に取るべき対応とともに、平易な言葉で説明されます。
  • キーが拒否された場合は、登録用リンクが表示されます。
  • クォータに達した場合は、プランが表示されます。
  • API が処理できなかった入力の場合は、API が示す理由が表示されます。

プライバシー

• ローカルファイルは、ツールにそのパスを指定した場合にのみ読み込まれます。その 1 回のリクエストのために API に送信されます。
• API は入力をメモリ上で処理し、保存しません。プライバシーポリシーをご覧ください。
• キーは、選択したマーケットプレイスにのみ送信されます。

制限事項

• html のサイズは最大 5 MB です。
• HTML ページのみ対応しています。PDF などのファイルは拒否されます（ドキュメントには Unfold を使用してください）。
• サーバーには Python 3.10 以降が必要です（uv がインストールします）。

開発

uv venv && uv pip install -e ".[dev]"
.venv/bin/pytest            # unit tests, no network; 100% coverage required
.venv/bin/ruff check src tests scripts

scripts/e2e_stdio.py distill は、クライアントと同様に stdio 経由でサーバーを実行し、実際の API に対してツールを呼び出します。RAPIDAPI_KEY または API_MARKET_KEY が必要です。

ライセンス

MIT。Distill 自体は、無料プランもある有料 API で、ByteStay が運営しています。