XFetch Mcp

XFetch MCP サーバー

ウェブコンテンツの取得に特化した拡張版 Model Context Protocol サーバー（強化版の fetch）です。このサーバーを使うと、通常の fetch では対応できない Cloudflare などのセキュリティシステムで保護されたページを含む、あらゆるウェブページから LLM がコンテンツを取得して処理できます。

主な機能

• 🚀 保護システムの回避：Cloudflare などのセキュリティシステムで保護されたウェブサイトのコンテンツにアクセスできます
• 🌐 JavaScript レンダリング：JavaScript の実行が必要な動的ウェブサイトからコンテンツを取得できます
• 🎯 CSS セレクター：CSS セレクターを使って、ウェブページから特定のコンテンツを抽出できます
• ⏱️ 動的コンテンツの読み込み：取得前に動的コンテンツの読み込みを待機します
• 📝 Markdown 変換：HTML を自動的に Markdown に変換し、LLM が扱いやすくします
• 🔄 分割読み込み：start_index パラメーターを使って、長いページを分割して読み込めます

利用可能なツール

• xfetch - 高度な機能を備えたウェブコンテンツ取得ツール
  • url （文字列、必須）：取得する URL
  • max_length （整数、任意）：返す最大文字数（デフォルト：5000）
  • start_index （整数、任意）：コンテンツを開始する文字インデックス（デフォルト：0）
  • raw （ブール値、任意）：Markdown に変換せず、生のコンテンツを取得します（デフォルト：false）
  • render （ブール値、任意）：動的コンテンツ向けの JavaScript レンダリングを有効にします（デフォルト：false）
  • selector （文字列、任意）：特定のコンテンツを抽出する CSS セレクター
  • timeout （整数、任意）：動的コンテンツの読み込みを待機する時間（秒、1～10 秒）

プロンプト

• xfetch
  • URL を取得し、その内容を Markdown として抽出します
  • 引数：
    • url （文字列、必須）：取得する URL
    • render （ブール値、任意）：JavaScript レンダリングを有効にします
    • selector （文字列、任意）：コンテンツ抽出に使用する CSS セレクター
    • timeout （整数、任意）：動的コンテンツの読み込みタイムアウト

インストール

pip を使用する場合

pip install mcp-server-xfetch

uv を使用する場合（推奨）

uv を使用する場合、特別なインストールは必要ありません。

uvx mcp-server-xfetch

設定

Claude.app の設定

Claude の設定に追加します。

"mcpServers": {
  "xfetch": {
    "command": "uvx",
    "args": ["mcp-server-xfetch"]
  }
}

"mcpServers": {
  "xfetch": {
    "command": "python",
    "args": ["-m", "mcp_server_xfetch"]
  }
}

API トークン

XFetch サービスには、2 種類の利用プランがあります。

無料プラン

パッケージには、無料での利用を制限付きで可能にするデフォルトの API トークンが含まれています。次の用途に適しています。

• テストと評価
• 個人プロジェクト
• 小規模な非営利利用

ただし、無料プランにはレート制限があり、安定性に問題が生じることがあります。

商用／本番環境での利用

特に次の用途では、安定した信頼性の高いサービスをご利用ください。

• 商用プロジェクト
• 本番環境
• 大量のリクエスト
• 稼働時間の保証とサポート

xfetch.ai にアクセスして、次の手順を行ってください。

1. 商用アカウントに登録します
2. 専用 API トークンを取得します
3. プレミアム機能とサポートを利用します

トークンを取得したら、次のいずれかの方法で設定できます。

# Option 1: Environment variable (recommended)
export XFETCH_API_TOKEN=your_token_here

# Option 2: Command line argument
python -m mcp_server_xfetch --api-token=your_token_here

または、Claude の設定で指定します。

"mcpServers": {
  "xfetch": {
    "command": "python",
    "args": ["-m", "mcp_server_xfetch", "--api-token=your_token_here"]
  }
}

使用例

基本的な使い方

# Simple fetch with markdown conversion
{
    "url": "https://example.com"
}

JavaScript レンダリング

# Fetch from a dynamic website
{
    "url": "https://dynamic-site.com",
    "render": true,
    "timeout": 5  # Wait up to 5 seconds for content to load
}

コンテンツの抽出

# Extract specific content using CSS selector
{
    "url": "https://news-site.com",
    "selector": "article.main-content",
    "render": true
}

長いコンテンツの読み込み

# First request
{
    "url": "https://long-article.com",
    "max_length": 5000
}

# Continue reading from where it left off
{
    "url": "https://long-article.com",
    "start_index": 5000,
    "max_length": 5000
}

デバッグ

MCP Inspector を使ってサーバーをデバッグできます。

npx @modelcontextprotocol/inspector uvx mcp-server-xfetch

コントリビューション

コントリビューションを歓迎します。新機能の追加、バグの修正、ドキュメントの改善など、皆さまのご協力をお待ちしています。

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. 変更をコミットします
4. ブランチにプッシュします
5. プルリクエストを作成します

ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細は LICENSE ファイルをご覧ください。

サポート

• ドキュメント：xfetch.ai
• 問題：GitHub Issues
• メール：[email protected]