webfetch

io.github.ashlrai由 GitHub 帳號 ashlrai 發布v0.1.5更新於 Nov 3, 2026

License-first federated image search with attribution, dimensions, and download tooling.

已驗證STDIO僅桌面網頁搜尋與抓取媒體與設計

概覽

AI 產生的概覽

為代理提供聯合圖片搜尋與下載，回傳授權標籤、信心分數與可直接使用的署名文字。

可以做什麼
  • 跨 25 個供應商搜尋圖片，支援授權政策、尺寸篩選與署名資訊
  • 依類型搜尋藝人圖片，並查找標準專輯封面
  • 將圖片下載到本機快取，含大小上限、內容類型檢查與 SHA-256 雜湊
  • 解析任意網址的授權，並列出網頁上的圖片及其推測授權
  • 以參考圖進行反向圖片搜尋，找出相似圖片
適用情境
適合需要為網頁、簡報或唱片內頁尋找可重複使用的圖片，並判斷結果是開放授權、平台授權、僅限編輯用途或僅供探索，同時附上署名文字的情境。
執行需求
透過 npm 套件 getwebfetch-mcp 以 stdio 在本機執行，需要 Node 18 以上或 Bun 1.0 以上。使用 Wikimedia Commons 與 Openverse 的基本功能不需金鑰。選用金鑰：UNSPLASH_ACCESS_KEY、PEXELS_API_KEY、PIXABAY_API_KEY、BRAVE_API_KEY、SERPAPI_KEY（反向圖片搜尋必需）；README 另列出 Spotify 與 Bright Data 的變數。需要網路連線。
安裝前請注意
選用的供應商金鑰以環境變數傳入，屬於機密資訊。download_image 會將檔案寫入本機快取目錄。probe_page 與 fetch_with_license 會抓取第三方網頁與圖片，反向圖片搜尋結果僅為線索，需自行查證。README 的一行安裝指令會下載並執行遠端腳本並修改代理設定檔，建議改為手動設定。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 webfetch，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

webfetch MCP

License-first image search and download for any MCP-speaking agent.

Every result ships with a structured license tag (CC0, CC_BY, CC_BY_SA, platform-license tags, EDITORIAL_LICENSED, ...), a confidence score, and a ready-to-render attribution line. Covers 25 providers, with 19 in the default set — no API key needed for Wikimedia Commons, Openverse, iTunes, MusicBrainz CAA, NASA, The Met, Library of Congress, Internet Archive, Wellcome Collection, and Burst.

Why webfetch MCP?

Most image-search tools give you URLs. webfetch gives you URLs plus the legal metadata needed to classify them as open/commercial reusable, platform-license, editorial-only, or exploration-only. The MCP layer exposes seven composable tools — search, specialize by artist/album, download with a hash, resolve an arbitrary URL's license, reverse-image-search, and triage a source page — so an agent can go from prompt to attributed asset in a single conversation turn.

  • 25 providers, 19 in the default set and many requiring no key at all
  • License-first ranking: CC0 floats to the top; heuristic-only results stay below 0.5 confidence
  • Attribution always included: one attributionLine string, ready for a tooltip or credits footer
  • Free tier needs no API key for Wikimedia and Openverse; full provider coverage adds optional keys per provider

Install

One-line (recommended)

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

Installs bun if missing, builds the server, symlinks webfetch onto $PATH, and merges the MCP block into ~/.claude/settings.json.

Claude Desktop / Claude Code

Add to ~/.claude/settings.json:

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

Cursor

Add to ~/.cursor/mcp.json:

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

Cline

Paste into Cline's MCP settings JSON (VSCode sidebar → Cline → MCP Servers):

json
{  "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"]    }  }}

Replace /path/to/webfetch with your clone path (default after installer: ~/.webfetch/repo).

Tools

ToolDescriptionKey params
search_imagesFederated search across 25 providers. Returns the top candidates with license + attribution. Does not download. For large batches, use CLI handoff: webfetch batch --jsonl.query, providers[], licensePolicy, minWidth, minHeight
search_artist_imagesSpecialized artist image search with kind-aware provider routing: portrait, album, logo, performing.artist, kind, providers[]
search_album_coverCanonical album artwork via MusicBrainz CAA + iTunes + Spotify. Results are EDITORIAL_LICENSED.artist, album
download_imageDownload a URL to local disk cache. 20 MB cap, content-type guard, SHA-256 hash, host blocklist enforced.url, maxBytes, cacheDir
fetch_with_licenseResolve license for any URL via host heuristics + page metadata (<link rel=license>, dc.rights, OG tags).url, probe (also download bytes)
find_similarReverse-image-search a reference URL. Requires SERPAPI_KEY. Returns leads — verify before shipping.url, providers[]
probe_pageEnumerate every <img> on a webpage with inferred dimensions and per-image heuristic license. Respects robots.txt.url, respectRobots

License tags

Results carry one of: CC0 · PUBLIC_DOMAIN · CC_BY · CC_BY_SA · UNSPLASH_LICENSE · PEXELS_LICENSE · PIXABAY_LICENSE · EDITORIAL_LICENSED · PRESS_KIT_ALLOWLIST · UNKNOWN (rejected by default). Use open-only when platform/editorial licenses are not acceptable.

Migration note: Unsplash, Pexels, and Pixabay are no longer reported as CC0. Agents should treat UNSPLASH_LICENSE, PEXELS_LICENSE, and PIXABAY_LICENSE as platform-license results, not Creative Commons/public domain results.

Batch handoff

MCP tools are meant for interactive agent calls. For hundreds or thousands of queries, have the agent hand off to the CLI:

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

Input lines are query or query<TAB>provider-a,provider-b. Each output line contains index, query, status, candidateCount, candidates, top, downloads, and provider diagnostics.

Auth / env vars

ProviderEnv varFree tier?
Wikimedia Commons—Yes (no key)
Openverse—Yes (no key)
UnsplashUNSPLASH_ACCESS_KEYDemo key rate-limited
PexelsPEXELS_API_KEYFree tier available
PixabayPIXABAY_API_KEYFree tier available
SpotifySPOTIFY_CLIENT_ID + SPOTIFY_CLIENT_SECRETDev app required
Brave SearchBRAVE_API_KEYFree tier available
SerpApiSERPAPI_KEYRequired for find_similar
Bright Data managed browserBRIGHTDATA_API_TOKENOptional server/cloud fallback

MusicBrainz CAA and iTunes require no key. Missing keys cause the provider to skip gracefully — other providers still respond.

Demo prompts

Try these in Claude Code or Cursor after installing:

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.

Requirements

  • Node ≥ 18 or Bun ≥ 1.0
  • No API key required for basic use (Wikimedia + Openverse cover most editorial needs)

Links

來源：packages/mcp/README.md，提交 656d37f

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.5最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分