clawfetch

@clawfetch/mcp

ClawFetch 用の MCP（Model Context Protocol）サーバーです。AI エージェント向けの Web インテリジェンス API を提供します。

MCP 互換クライアント（Claude Desktop、Cursor、Windsurf、OpenClaw など）から、ClawFetch の Web インテリジェンスツールにすぐにアクセスできます。ページを Markdown として取得したり、JavaScript を多用する SPA をレンダリングしたり、17 種類以上のサイトから構造化データを抽出したり、複数のソースを使ってトピックを調査したり、ドメインから企業情報を充実させたり、ドメインの空き状況を確認したりできます。

支払いは x402 protocol を通じて自動的に処理されます。Base 上の USDC を使用します。API キーや請求ダッシュボードは不要です。

アクセスと支払い

公開ホスト型の MCP エンドポイントは廃止されており、HTTP 410 Gone を返します。以下の手順で MCP をローカルで実行するか、https://api.clawfetch.ai を直接呼び出してください。有料ツールの呼び出しには、Base 上で USDC を入金したご自身のウォレットを使用します。ClawFetch がリクエスト料金を負担することはありません。

💻 セルフホストモード

支払い用ウォレットを完全に管理できる、ご自身のインスタンスを実行します。

インストール

npm install -g @clawfetch/mcp

設定（stdio — ローカル MCP クライアント向け）

MCP クライアントの設定に追加します（例：Claude Desktop）。

{
  "mcpServers": {
    "clawfetch": {
      "command": "clawfetch-mcp",
      "env": {
        "CLAWFETCH_PRIVATE_KEY": "0xYOUR_ETHEREUM_PRIVATE_KEY"
      }
    }
  }
}

秘密鍵は x402 の少額決済（Base 上の USDC）の署名に使用されます。対応するアドレスに、Base メインネット上の USDC を入金してください。

HTTP サーバーとして実行

リモートクライアント向けに、MCP サーバーを HTTP 経由で公開します。

CLAWFETCH_PRIVATE_KEY=0x... CLAWFETCH_TRANSPORT=http CLAWFETCH_PORT=3001 clawfetch-mcp

Streamable HTTP トランスポート（MCP 仕様準拠）を使用して、http://localhost:3001/mcp でサーバーを起動します。デフォルトでは 127.0.0.1 にバインドされ、ループバックの Host ヘッダーのみを受け付けるため、Web ページからの DNS リバインディング攻撃を防ぎます。リモートクライアントに公開するには、CLAWFETCH_HOST=0.0.0.0 を設定し、公開ホスト名を CLAWFETCH_ALLOWED_HOSTS に列挙してください。

HTTP エンドポイント

エンドポイント	メソッド	説明
/mcp	POST	セッションを初期化します。Mcp-Session-Id ヘッダーを返します
/mcp	GET	サーバーからクライアントへの通知用 SSE ストリーム（セッション ID が必要です）
/mcp	DELETE	セッションを終了します
/health	GET	サーバーのヘルスチェック（JSON）

セッションの流れ

1. 初期化： JSON-RPC の initialize リクエストで POST /mcp を実行し、Mcp-Session-Id ヘッダーを取得します
2. ツールの呼び出し： Mcp-Session-Id ヘッダーと JSON-RPC の tools/call リクエストを指定して POST /mcp を実行します
3. ストリーミング： SSE 通知を受け取るには GET /mcp?sessionId=... を実行します（任意）
4. 終了： Mcp-Session-Id ヘッダーを指定して DELETE /mcp を実行します

ツール

ツール	説明	料金
fetch_url	任意の URL をクリーンな Markdown として取得します	$0.001
render_page	JavaScript を多用するページ（SPA、React アプリ）をレンダリングします	$0.005
extract_data	17 種類以上のサイトから構造化データを抽出します	$0.008
research_topic	引用付きで複数のソースを使って調査します	$0.02
check_domains	ドメイン名の空き状況を確認します	$0.003
suggest_domains	利用可能なドメインの候補を生成します	$0.003
parse_document	Office ドキュメント（docx/pptx/xlsx/pdf/…）を解析して Markdown に変換します	$0.005
enrich_company	ドメインから企業プロフィールを作成します。ソーシャルアカウント、メールアドレス、技術スタック、主要ページが含まれます	$0.02
list_extractors	対応する構造化データ抽出ツールを一覧表示します	$0.001
health_check	API のヘルスステータスを確認します	無料
wallet_info	支払い用ウォレットのアドレスを表示します	無料

対応する抽出ツール

GitHub のリポジトリ／プロフィール、npm パッケージ、PyPI パッケージ、Twitter/X プロフィール、LinkedIn プロフィール／企業、YouTube 動画／チャンネル、Product Hunt、Hacker News、Reddit、Crunchbase、Wikipedia などに対応しています。

list_extractors を使用すると、利用可能なすべての種類とそのスキーマを確認できます。

環境変数

変数	必須	デフォルト	説明
CLAWFETCH_PRIVATE_KEY	はい*	—	x402 決済用の Ethereum 秘密鍵（0x プレフィックス付き）
CLAWFETCH_BASE_URL	いいえ	https://api.clawfetch.ai	API ベース URL
CLAWFETCH_TRANSPORT	いいえ	stdio	トランスポート：stdio または http
CLAWFETCH_HOST	いいえ	127.0.0.1	HTTP サーバーのバインドアドレス
CLAWFETCH_ALLOWED_HOSTS	いいえ	localhost,127.0.0.1,[::1]	HTTP トランスポートで許可する Host ヘッダーのカンマ区切りリスト（DNS リバインディング対策）
CLAWFETCH_PORT	いいえ	3001	HTTP サーバーのポート
CLAWFETCH_TIMEOUT_MS	いいえ	60000	リクエストのタイムアウト（ミリ秒）
CLAWFETCH_DEBUG	いいえ	false	デバッグログを有効化（1 または true）

* ツールの呼び出しに必須です。この値がなくてもサーバーは起動し、ツール、リソース、プロンプトを一覧表示するため（レジストリから確認できます）、呼び出しのたびにセットアップ手順を返します。このキーはローカル設定に保存し、ClawFetch の Web サイトには決して送信しないでください。

開発

git clone https://github.com/clawfetch/clawfetch-mcp.git
cd clawfetch-mcp
npm install
npm run build
npm test

ライセンス

MIT