clipoteca
Provides search and ingestion of Bilibili video clips into the Clipoteca catalog, subject to Bilibili's restrictions on requests from some datacenter IPs.
Provides search and ingestion of Instagram Reels clips into the Clipoteca catalog when accessible.
Provides search and ingestion of Internet Archive media clips into the Clipoteca catalog.
Provides search and ingestion of NASA media clips into the Clipoteca catalog.
Provides search and ingestion of Odysee video clips into the Clipoteca catalog.
Provides search and ingestion of PeerTube video clips into the Clipoteca catalog; used for published real clips.
Provides search and ingestion of Pexels stock video clips into the Clipoteca catalog; used for published real clips.
Provides search and ingestion of Pixabay stock video clips into the Clipoteca catalog.
Provides search and ingestion of Snapchat video clips into the Clipoteca catalog when accessible.
Provides search and ingestion of TikTok video clips into the Clipoteca catalog when accessible.
Provides search and ingestion of Wikimedia Commons media clips into the Clipoteca catalog.
Provides search and ingestion of YouTube video clips into the Clipoteca catalog when accessible.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@clipoteca Find me a vertical 9:16 rain clip under 10 seconds and get its file."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Una biblioteca comunitaria de clips, pensada para personas y agentes de IA.
Multilingüe · Abierta · Reutilizable · Hasta 20 segundos
📋 Roadmap · 🧭 Arquitectura · 🌐 Fuentes e idiomas · 🎨 Identidad · 🤝 Colaborar
Estado v1.0.0: Worker desplegado y flujos E2E reales comprobados. Servicio: clipoteca-worker.sc-plasticov.workers.dev, con API REST
/v1/*y MCP Streamable HTTP/mcp. Hay 8 clips reales publicados en el catálogo, con material de Pexels, PeerTube y un aporte comunitario (Issue #26,clip-000008). La ingesta admite consultas ES/EN/ZH/RU. Los proveedores que requieren credenciales ausentes se clasificanAUTH_REQUIRED; Bilibili bloquea solicitudes desde determinadas IP de centros de datos. La verificación real no equivale a disponibilidad universal de las 15 fuentes ni a costos facturados conocidos. Ver evidencias v1 y operación M10.
Uso
Buscar clips públicos desde la API REST (el filtro aspect_ratio usa URL encoding):
curl --fail-with-body -sS 'https://clipoteca-worker.sc-plasticov.workers.dev/v1/clips?q=lluvia&aspect_ratio=9%3A16'Conectar un cliente MCP compatible con HTTP remoto usando la dirección https://clipoteca-worker.sc-plasticov.workers.dev/mcp. Ejemplo de configuración para un cliente que acepta mcpServers:
{
"mcpServers": {
"clipoteca": {
"url": "https://clipoteca-worker.sc-plasticov.workers.dev/mcp"
}
}
}Para aportar una escena, abre el formulario «Aportar escena» en GitHub Issues, indica una URL HTTPS directa a MP4/WebM/OGV y los datos de procedencia. El Issue se procesa automáticamente; no requiere permisos de escritura del repositorio. Ver guía de colaboración.
Related MCP server: Video Query MCP Server
La idea
Buscar una escena no debería significar encontrarla y descargarla de cero una y otra vez.
Clipoteca está diseñada para que un agente solicite, por ejemplo, «lluvia, vertical 9:16». El sistema consultará su catálogo y, cuando haga falta, buscará en fuentes externas usando cuatro idiomas, procesará clips nuevos de hasta 20 segundos y conservará sus archivos en GitHub Releases para futuras consultas.
Cuatro idiomas, una biblioteca
Español | English | 中文 | Русский |
lluvia | rain | 下雨 | дождь |
Metadatos ES | Metadata EN | Búsqueda ZH | Búsqueda RU |
Las búsquedas externas en español, inglés, chino y ruso son requisitos obligatorios, no características opcionales. Todos los clips se catalogarán con títulos, descripciones y etiquetas en español e inglés, conservando el idioma y fuente de origen.
Componentes de v1
Componente | Responsabilidad |
API REST + MCP | Buscar clips por concepto, duración, proporción, orientación y fuente; obtener sus archivos |
Motor multilingüe | Ejecutar búsquedas paralelas ES/EN/ZH/RU con límites y fallos aislados |
Ingesta automática | Descargar material nuevo accesible, deduplicar, normalizar con FFmpeg y generar miniaturas |
Catálogo público | Metadatos ES/EN, 9:16 o 16:9, resolución, FPS, duración y procedencia |
GitHub Releases | Almacenar los clips procesados y hacerlos recuperables sin buscar dos veces |
Stack: Cloudflare Workers + TypeScript (API y MCP), GitHub Actions + Python/FFmpeg (procesamiento), GitHub Releases y catálogo JSON. No se necesita un servidor Oracle ni una web Astro.
Fuentes del roadmap
Stock: Pexels, Pixabay. Archivos: Wikimedia Commons, Internet Archive, NASA. Video: YouTube, RuTube, PeerTube, Odysee, VK Video, Bilibili. Redes: Douyin, TikTok, Instagram Reels y Snapchat.
Cada fuente tendrá un adaptador con capacidades y estados verificables. La posibilidad técnica de descargar archivos varía entre plataformas; no se considera integrado un proveedor solo por figurar en esta lista.
Leer matriz de fuentes e idiomas
Ruta de trabajo
El roadmap tiene 11 hitos, de M0 a M10: estructura inicial, catálogo y Releases, FFmpeg, motor multilingüe obligatorio, grupos de proveedores, API/MCP, publicación automática, aportes comunitarios y validación final.
Consultar el roadmap completo con criterios de aceptación
Documentación técnica
Documento | Contenido |
Requisitos, casos de uso y límites | |
Componentes y ejecución sin servidor propio | |
Proveedores y cuatro idiomas obligatorios | |
Interfaces y metadatos previstos | |
Hitos, pruebas y condiciones de cierre | |
Verificación, controles y costos | |
Documento integral original, conservado sin cambios de contenido | |
Mascota Klipi, paleta y SVG |
Conoce a Klipi
Klipi es el explorador de fotogramas de la biblioteca: un personaje original que combina el contorno de una película, un botón de reproducción y una lupa para descubrir escenas.
Los SVG originales del banner, logotipo, isotipo, mascota y tarjeta social están incluidos en este repositorio.
Colaboración y licencia
El proyecto se publica con licencia MIT, compatible con desarrollar en el futuro funciones de créditos, servicios comerciales u otras modalidades de acceso. La implementación de créditos no forma parte de esta primera fase; los recursos almacenados públicamente en GitHub no se vuelven privados por incorporar créditos a una API.
Puedes proponer ideas y mejoras. Las políticas comunitarias para los clips y sus aportes se debatirán posteriormente.
Una escena encontrada. Una biblioteca que crece.
Available Tools
6 toolsdownload_clipDownload clip URLBRead-only
Return verified GitHub Releases MP4 URL, not bytes.
Inputs: clip_id (required). Returns: url, clip_id
get_clipGet clipBRead-only
Return catalogue metadata for one verified clip.
Inputs: clip_id (required). Returns: clip
get_job_statusGet job statusCRead-only
Fetch durable job record or a typed not_found.
Inputs: request_id (required). Returns: terms, status, attempt, request_id, +5 more
list_sourcesList public source statusesBRead-only
Read credential-presence status snapshot without exposing any values.
Inputs: no named parameters. Returns: kind, sources
search_and_importSearch and importC
Queue asynchronous import; requires write token.
Inputs: query (required), max_results, aspect_ratio. Returns: status, request_id
search_clipsSearch clipsC
Search verified clips; optionally queue an import.
Inputs: query (required), fps, limit, cursor, +7 more. Returns: clips, status, request_id, next_cursor
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
search_clips and search_and_import are the closest pair, but the descriptions clearly separate read-only search from a write-token-gated async import queue. get_clip, download_clip, get_job_status, and list_sources each target a distinct resource or action with no real overlap.
All six tools use snake_case verb_noun form (search_clips, get_clip, download_clip, get_job_status, list_sources), which is highly predictable. The only deviation is search_and_import, which embeds a conjunction rather than a single verb.
Six tools is well-scoped for a clip catalogue with an asynchronous import pipeline; each tool maps to a necessary step (discover, inspect, download, import, poll, check credentials). Nothing appears redundant or padded.
The surface covers discovery, metadata retrieval, download, async import, job polling, and credential status, which is solid lifecycle coverage for a read-mostly catalogue. Minor gaps exist: no way to list or cancel outstanding jobs, and no browse/list-all tool beyond search.
Maintenance
Related MCP Connectors
Search your video library with natural language and retrieve relevant moments through MCP.
Search video footage an editor shared with you by what's on screen, what's said or who's in it.
Video knowledge base for agents: search your library's transcripts, keyframes and on-screen text.
Video how-to search for AI agents: 2,000+ video skills, tutorials and FFmpeg recipes. No key.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI agents to search and read screen recordings from Clipy, including transcripts, AI summaries, and key moments with frames.34400 npm5MIT
- FlicenseNot gradedqualityDmaintenanceEnables natural language search through personal video collections, returning AI-generated descriptions and direct URLs to relevant 30-second video clips.-
- AlicenseNot gradedqualityCmaintenanceEnables MCP clients and AI agents to search and retrieve images and videos from a stock media library, with filtering by media type, orientation, category, dimensions, colors, safe search, ordering, and pagination.90 npmMIT
- AlicenseAqualityCmaintenanceEnables agents to search the Internet Archive for public-domain b-roll, visually inspect scenes via keyframe images, and extract frame-accurate verified clips. Every extracted clip is saved with a provenance record capturing source, license, exact segment and ready-to-paste attribution.451MIT