Skip to main content
Glama

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 clasifican AUTH_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

Proyecto y alcance

Requisitos, casos de uso y límites

Arquitectura

Componentes y ejecución sin servidor propio

Fuentes e idiomas

Proveedores y cuatro idiomas obligatorios

Contratos REST/MCP

Interfaces y metadatos previstos

Roadmap

Hitos, pruebas y condiciones de cierre

QA y operación

Verificación, controles y costos

Especificación completa

Documento integral original, conservado sin cambios de contenido

Identidad visual

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 tools
download_clipDownload clip URLB
Read-only

Return verified GitHub Releases MP4 URL, not bytes.

Inputs: clip_id (required). Returns: url, clip_id

get_clipGet clipB
Read-only

Return catalogue metadata for one verified clip.

Inputs: clip_id (required). Returns: clip

get_job_statusGet job statusC
Read-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 statusesB
Read-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

    B3.2/5.0

    Scored across 6 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search and read screen recordings from Clipy, including transcripts, AI summaries, and key moments with frames.
      34
      400 npm
      5
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      4
      51
      MIT