webfetch

La capa de imágenes centrada en licencias para agentes de IA y humanos.

Un servidor MCP, una CLI y un servidor HTTP que se federan a través de 25 proveedores de imágenes, clasifican los resultados priorizando las licencias y rechazan los resultados UNKNOWN por defecto. Cualquier agente que hable MCP (Claude Code, Cursor, Cline, Continue, Roo Code, Codex) se conecta con una sola línea de configuración. La página de inicio, los precios y el uso alojado se encuentran en getwebfetch.com.

Instalación

El instalador curl | bash también conecta webfetch al archivo ~/.claude/settings.json de Claude Code de forma idempotente. Ejecútalo de nuevo en cualquier momento para actualizar.

Related MCP server: Multimodal MCP

Uso en 30 segundos

CLI:

webfetch search "drake portrait" --limit 5
webfetch artist "Taylor Swift" --kind portrait --min-width 1200
webfetch download <url> --out ./portrait.jpg
printf "drake portrait\nradiohead album\n" | webfetch batch --jsonl --continue-on-error

MCP (desde dentro de cualquier agente que hable MCP):

search_images({ query: "drake portrait", limit: 5 })
search_artist_images({ artist: "Taylor Swift", kind: "portrait" })
download_image({ url: "..." })

Biblioteca TypeScript:

import { searchArtistImages, pickBest, downloadImage } from "webfetch-core";

const { candidates } = await searchArtistImages("Drake", "portrait");
const best = pickBest(candidates, { minWidth: 1200 });
if (best) {
  const { cachedPath, sha256 } = await downloadImage(best.url);
  console.log(best.attributionLine, "->", cachedPath);
}

Qué problema resuelve

Obtener una imagen manualmente tiene cuatro modos de fallo:

1. No conoces la licencia, por lo que no puedes distribuir el resultado de forma segura.

2. No puedes automatizarlo — cada sitio nuevo significa otra tarde de trabajo.

3. La API de búsqueda de imágenes de Google está retirada; el scraping es frágil y roza los límites de los Términos de Servicio.

4. No hay caché compartida — descargas el mismo archivo docenas de veces.

webfetch soluciona los cuatro problemas federando a través de APIs de fuentes directas que tienen términos estables y metadatos de licencia estructurados, clasificando los candidatos priorizando la licencia y exponiendo el resultado como una única herramienta MCP.

Proveedores

Consulta docs/PROVIDERS.md para conocer las limitaciones, límites de tasa y docs/PROVIDER_TUNING.md para elegir según el caso de uso.

Modos local y en la nube

La CLI es local-first: por defecto webfetch search, artist, album, download, probe, license y batch llaman a webfetch-core en el proceso y utilizan las claves de API de los proveedores desde tu entorno. Pasa --cloud o establece WEBFETCH_MODE=cloud para llamar a https://api.getwebfetch.com/v1/* con WEBFETCH_API_KEY o webfetch config set apiKey wf_live_....

Usa el modo local cuando quieras llamadas directas al proveedor y una caché local. Usa el modo en la nube cuando quieras autenticación alojada, claves de proveedor agrupadas, fallback de navegador gestionado, contabilidad de uso o controles de equipo.

Por qué priorizar la licencia

El único resultado que rechazamos por defecto es una imagen que no podemos justificar. Una foto marginalmente mejor bajo una licencia desconocida no tiene valor para un flujo de trabajo que necesita publicarse sin revisión humana. Los empates en relevancia son fáciles de resolver; la procedencia no.

El clasificador ordena por: etiqueta de licencia -> confianza de metadatos -> resolución -> prioridad del proveedor. UNKNOWN se rechaza por defecto (Convención de Berna: la mayor parte de la web tiene todos los derechos reservados a menos que se demuestre lo contrario). Consulta docs/LICENSE_POLICY.md.

Migración: proveedores de stock CC0

Las versiones anteriores de webfetch trataban a Unsplash, Pexels y Pixabay como CC0. Las versiones actuales exponen sus términos de plataforma explícitamente:

La mayoría de los usuarios deberían mantener licensePolicy: "safe-only" porque sigue permitiendo categorías abiertas, de plataforma, editoriales y de kit de prensa, mientras rechaza UNKNOWN. Los flujos de trabajo que solo requieren activos de Creative Commons o de dominio público deben usar licensePolicy: "open-only" y actualizar los protectores de tipo para manejar las tres etiquetas de plataforma por separado.

webfetch vs alternativas

Arquitectura

                             +------------------+
                             |  webfetch-core  |
                             |  (ranker, cache, |
                             |   license coerce)|
                             +---------+--------+
                                       |
          +----------------+-----------+-----------+----------------+
          |                |                       |                |
  +-------v------+  +------v-------+       +-------v------+  +------v-------+
  | webfetch     |  | webfetch-mcp |       | webfetch-    |  | browser      |
  | CLI          |  | (stdio)      |       | server (HTTP)|  | extensions   |
  +-------+------+  +------+-------+       +-------+------+  +------+-------+
          |                |                       |                |
          |                |                       |                |
          +----------------+-----------+-----------+----------------+
                                       |
                 +---------------------v---------------------+
                 |              provider adapters            |
                 |  wikimedia  openverse  unsplash  pexels    |
                 |  pixabay    itunes     mb-caa    spotify   |
                 |  youtube    brave      bing      serpapi   |
                 |  flickr     nasa       met       europeana |
                 |  loc        wellcome   rawpixel  burst     |
                 |  browser + managed-browser + archival opt-in|
                 +-------------------------------------------+

Cada superficie comparte ~/.webfetch/cache/ indexada por SHA-256, por lo que una descarga desde la CLI está disponible instantáneamente para el servidor MCP y viceversa.

Valores predeterminados de seguridad

• licensePolicy: "safe-only" — se permiten categorías abiertas, de licencia de plataforma y editoriales/prensa; se rechaza UNKNOWN.

• safeSearch: "strict".

• Proveedores opcionales (youtube-thumb, bing, serpapi, browser, managed-browser, europeana-archival) desactivados por defecto.

• Límite de 20 MB por descarga, protección de tipo de contenido, lista de bloqueo de hosts.

• robots.txt respetado en sondeos de páginas genéricas.

Hoja de ruta

• webfetch watch — modo demonio para consultas repetidas / actualización incremental.

• API de plugins para traer tu propio proveedor.

• Nivel alojado en getwebfetch.com — claves de proveedor agrupadas, fallback de navegador gestionado, panel de control de uso del equipo.

Contribución

Las incidencias y PR son bienvenidas. Ejecuta bun install && bun test para empezar. Consulta docs/ para obtener documentación de referencia por área.

Licencia

MIT.