webfetch

webfetch MCP

MCP に対応するあらゆるエージェント向けの、ライセンス優先の画像検索とダウンロードです。

すべての検索結果には、構造化されたライセンスタグ（CC0、CC_BY、CC_BY_SA、プラットフォームライセンスタグ、EDITORIAL_LICENSED など）、信頼度スコア、すぐに表示に使えるクレジット表記が付属します。25 のプロバイダーに対応し、デフォルトセットには 19 のプロバイダーが含まれています。Wikimedia Commons、Openverse、iTunes、MusicBrainz CAA、NASA、The Met、Library of Congress、Internet Archive、Wellcome Collection、Burst では、API キーは不要です。

---

webfetch MCP を選ぶ理由

ほとんどの画像検索ツールが提供するのは URL だけです。webfetch は URL に加えて、オープン／商用利用可能、プラットフォームライセンス、編集目的のみ、探索目的のみとして分類するために必要な法的メタデータも提供します。MCP レイヤーでは、組み合わせて使える 7 つのツール（検索、アーティスト／アルバム別検索、ハッシュ付きダウンロード、任意の URL のライセンス解決、類似画像検索、ソースページのトリアージ）を公開しているため、エージェントは 1 回の会話ターンでプロンプトからクレジット表記付きアセットまで処理できます。

• 25 のプロバイダーに対応。デフォルトセットには 19 のプロバイダーが含まれ、多くは API キーが不要です
• ライセンス優先のランキング：CC0 が上位に表示され、ヒューリスティックのみの検索結果は信頼度が 0.5 未満にとどまります
• クレジット表記を常に付属：ツールチップやクレジット欄にそのまま使える attributionLine 文字列を提供します
• 無料プランでは Wikimedia と Openverse に API キーは不要。すべてのプロバイダーを利用する場合は、プロバイダーごとに任意のキーを追加できます

---

インストール

1 行でインストール（推奨）

curl -fsSL https://raw.githubusercontent.com/ashlrai/webfetch/main/install/install.sh | bash

bun がない場合はインストールし、サーバーをビルドして、webfetch を $PATH にシンボリックリンクし、MCP の設定ブロックを ~/.claude/settings.json に統合します。

Claude Desktop / Claude Code

~/.claude/settings.json に追加します：

{
  "mcpServers": {
    "webfetch": {
      "command": "bun",
      "args": ["run", "/path/to/webfetch/packages/mcp/src/index.ts"]
    }
  }
}

Cursor

~/.cursor/mcp.json に追加します：

{
  "mcpServers": {
    "webfetch": {
      "command": "bun",
      "args": ["run", "/path/to/webfetch/packages/mcp/src/index.ts"]
    }
  }
}

Cline

Cline の MCP 設定 JSON に貼り付けます（VSCode サイドバー → Cline → MCP Servers）：

{
  "mcpServers": {
    "webfetch": {
      "command": "bun",
      "args": ["run", "/path/to/webfetch/packages/mcp/src/index.ts"],
      "disabled": false,
      "autoApprove": ["search_images", "search_artist_images", "search_album_cover", "probe_page"]
    }
  }
}

/path/to/webfetch をクローン先のパスに置き換えてください（インストーラーのデフォルトは ~/.webfetch/repo です）。

---

ツール

ツール	説明	主なパラメーター
search_images	25 のプロバイダーを横断して検索します。ライセンスとクレジット表記付きで上位候補を返します。ダウンロードは行いません。大量のバッチ処理には CLI への引き継ぎを使用してください：webfetch batch --jsonl。	query、providers[]、licensePolicy、minWidth、minHeight
search_artist_images	種類に応じてプロバイダーを振り分ける、アーティスト画像に特化した検索です：portrait、album、logo、performing。	artist、kind、providers[]
search_album_cover	MusicBrainz CAA、iTunes、Spotify を利用した、標準的なアルバムアートワークの検索です。検索結果は EDITORIAL_LICENSED です。	artist、album
download_image	URL からローカルディスクキャッシュにダウンロードします。20 MB の上限、コンテンツタイプの検証、SHA-256 ハッシュ、ホストブロックリストを適用します。	url、maxBytes、cacheDir
fetch_with_license	ホストのヒューリスティックとページメタデータ（<link rel=license>、dc.rights、OG タグ）を使って、任意の URL のライセンスを解決します。	url、probe（バイトデータもダウンロードします）
find_similar	参照 URL を使って類似画像を逆検索します。SERPAPI_KEY が必要です。手がかりを返すため、公開前に確認してください。	url、providers[]
probe_page	ウェブページ上のすべての <img> を、推定寸法と画像ごとのヒューリスティックなライセンスとともに列挙します。robots.txt を尊重します。	url、respectRobots

ライセンスタグ

検索結果には、次のいずれかのタグが付与されます：CC0 · PUBLIC_DOMAIN · CC_BY · CC_BY_SA · UNSPLASH_LICENSE · PEXELS_LICENSE · PIXABAY_LICENSE · EDITORIAL_LICENSED · PRESS_KIT_ALLOWLIST · UNKNOWN（デフォルトで除外されます）。プラットフォームライセンスや編集目的のライセンスを認めない場合は、open-only を使用してください。

移行に関する注意：Unsplash、Pexels、Pixabay は、CC0 として報告されなくなりました。 エージェントは UNSPLASH_LICENSE、PEXELS_LICENSE、 PIXABAY_LICENSE をプラットフォームライセンスの検索結果として扱い、クリエイティブ・コモンズ／パブリックドメインの検索結果とはみなさないでください。

バッチハンドオフ

MCP ツールは、エージェントからの対話的な呼び出しを想定しています。数百、数千件のクエリを処理する場合は、エージェントから CLI に引き継いでください。

webfetch batch --file queries.txt --jsonl --continue-on-error --candidates 3

入力行は query または query<TAB>provider-a,provider-b です。各出力行には、index、query、status、candidateCount、candidates、top、downloads、およびプロバイダーの診断情報が含まれます。

---

認証／環境変数

プロバイダー	環境変数	無料枠あり？
Wikimedia Commons	—	あり（キー不要）
Openverse	—	あり（キー不要）
Unsplash	UNSPLASH_ACCESS_KEY	デモキーはレート制限あり
Pexels	PEXELS_API_KEY	無料枠あり
Pixabay	PIXABAY_API_KEY	無料枠あり
Spotify	SPOTIFY_CLIENT_ID + SPOTIFY_CLIENT_SECRET	開発者アプリが必要
Brave Search	BRAVE_API_KEY	無料枠あり
SerpApi	SERPAPI_KEY	find_similar に必須
Bright Data managed browser	BRIGHTDATA_API_TOKEN	サーバー／クラウドのフォールバックとして任意

MusicBrainz CAA と iTunes ではキーは不要です。キーが不足しているプロバイダーは問題なくスキップされ、ほかのプロバイダーからは引き続き応答が返されます。

---

プロンプトの例

インストール後、Claude Code または Cursor で次のプロンプトを試してください。

Find me a CC-licensed portrait of Miles Davis I can use on an album liner page.

Search for album artwork for "Kind of Blue" by Miles Davis and show me the attribution line.

Probe the page at https://commons.wikimedia.org/wiki/File:Miles_Davis.jpg and tell me if I can use it commercially.

---

要件

• Node ≥ 18 または Bun ≥ 1.0
• 基本的な使用には API キーは不要です（Wikimedia と Openverse で編集用途のニーズの大半を満たせます）

---

リンク

• ランディングサイトとドキュメント：getwebfetch.com
• 1 行でインストールできるガイド：docs/QUICKSTART.md
• プロバイダー対応状況の一覧：docs/PROVIDERS.md
• ライセンスポリシーの詳細：docs/LICENSE_POLICY.md
• エージェント別インストールガイド：Claude Code · Cursor · Cline
• 問題の報告：github.com/ashlrai/webfetch/issues