feat(skills): integra consulta ao Media Bank D7-MB-001

This commit is contained in:
2026-04-08 23:18:22 +01:00
parent 940c3903aa
commit 82063391dd
4 changed files with 149 additions and 0 deletions
@@ -204,6 +204,43 @@ Anatomia: [Verbo Accao] + [Beneficio Imediato] + [Reducao Friccao]
---
## Media Bank (D7-MB-001)
**Quando consultar:** antes de sugerir ou inserir imagens de suporte em artigos, ebooks, whitepapers ou landing pages. Reutilizar matéria-prima local é preferível a geração IA ou stock externo.
**Workflow tentativa-primeiro:**
1. Pesquisar via MCP `media-bank`:
```
mcp__media-bank__search_media(
query="<tema do conteúdo em EN>",
type="image",
tema="<um dos 9 temas>",
orientation="landscape",
min_quality=7,
min_width=1200,
exclude_used_in_last_days=30,
limit=5
)
```
2. Avaliar candidatos por `description_en` + `quality_score`.
3. Se ≥1 adequado → usar `path_local`; derivar `alt` text a partir de `description_en` traduzido para PT-PT.
4. Se nenhum → fallback para geração IA.
5. Marcar uso: `mcp__media-bank__mark_used(asset_id, {type:"content-piece", ref:"<slug>", date:"<YYYY-MM-DD>"})`.
**Fallback REST** (se MCP indisponível):
```bash
SK=$(grep SERVICE_KEY /media/ealmeida/Dados/Hub/05-Projectos/Banco-Imagens-Videos/scripts/.env | cut -d= -f2)
curl -s "https://mem.descomplicar.pt/rest/v1/media_bank_assets?type=eq.image&orientation=eq.landscape&quality_score=gte.7&deleted_at=is.null&order=quality_score.desc&limit=5" \
-H "apikey: $SK" -H "Authorization: Bearer $SK"
```
**Regra inviolável:** matéria-prima local. Usar como input para composição — NUNCA inserir o ficheiro raw directamente em publicação pública sem edição/contextualização.
Ver `Hub/06-Operacoes/Procedimentos/D7-Tecnologia/MCP/PROC-Media-Bank.md` (D7-MB-001) para detalhes.
---
## Healing Log
Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
+36
View File
@@ -157,6 +157,42 @@ Exemplo agencia marketing:
---
## Media Bank (D7-MB-001)
**Quando consultar:** antes de criar posts Instagram, carrosséis, stories ou posts LinkedIn/Facebook que precisem de imagem ou vídeo curto. Reutiliza matéria-prima já curada em vez de gerar do zero.
**Workflow tentativa-primeiro:**
1. Pesquisar via MCP `media-bank`:
```
mcp__media-bank__search_media(
query="<tema do post em EN>",
type="image", # ou "video" para reels/stories
tema="<um dos 9 temas>",
orientation="square", # Instagram feed; "portrait" para stories/reels
min_quality=7,
exclude_used_in_last_days=30,
limit=5
)
```
2. Avaliar candidatos por `description_en` + `quality_score`.
3. Se ≥1 adequado → usar `path_local` como base para composição (Canva/design-engine) com overlay de texto, branding e CTA.
4. Se nenhum → fallback para geração IA.
5. Marcar uso: `mcp__media-bank__mark_used(asset_id, {type:"social-post", ref:"<plataforma>-<data>", date:"<YYYY-MM-DD>"})`.
**Fallback REST** (se MCP indisponível):
```bash
SK=$(grep SERVICE_KEY /media/ealmeida/Dados/Hub/05-Projectos/Banco-Imagens-Videos/scripts/.env | cut -d= -f2)
curl -s "https://mem.descomplicar.pt/rest/v1/media_bank_assets?type=eq.image&orientation=eq.square&quality_score=gte.7&deleted_at=is.null&order=quality_score.desc&limit=5" \
-H "apikey: $SK" -H "Authorization: Bearer $SK"
```
**Regra inviolável:** matéria-prima local. Usar como input para composição — NUNCA publicar o ficheiro raw como post sem edição (branding, texto, aspect ratio).
Ver `Hub/06-Operacoes/Procedimentos/D7-Tecnologia/MCP/PROC-Media-Bank.md` (D7-MB-001) para detalhes.
---
## Healing Log
Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
+39
View File
@@ -297,6 +297,45 @@ Para conteudo detalhado, consultar:
---
## Media Bank (D7-MB-001)
**Quando consultar:** antes de produzir vídeos Remotion — para B-roll, clips de abertura, backgrounds e transições. Reutilizar matéria-prima evita regeneração IA cara e mantém consistência visual.
**Workflow tentativa-primeiro:**
1. Pesquisar via MCP `media-bank`:
```
mcp__media-bank__search_media(
query="<descrição EN da cena/tema>",
type="video",
tema="<um dos 9 temas>",
orientation="landscape",
min_quality=7,
min_width=1920,
min_duration=3,
max_duration=15,
exclude_used_in_last_days=30,
limit=5
)
```
2. Avaliar candidatos por `description_en`, duração e `quality_score`.
3. Se ≥1 adequado → usar `path_local` como input directo no Remotion (`<Video src={staticFile(...)} />` ou importar para assets).
4. Se nenhum → fallback para geração IA (Replicate/Runway) ou imagens estáticas animadas.
5. Marcar uso: `mcp__media-bank__mark_used(asset_id, {type:"remotion-video", ref:"<projecto>", date:"<YYYY-MM-DD>"})`.
**Fallback REST** (se MCP indisponível):
```bash
SK=$(grep SERVICE_KEY /media/ealmeida/Dados/Hub/05-Projectos/Banco-Imagens-Videos/scripts/.env | cut -d= -f2)
curl -s "https://mem.descomplicar.pt/rest/v1/media_bank_assets?type=eq.video&orientation=eq.landscape&quality_score=gte.7&deleted_at=is.null&order=quality_score.desc&limit=5" \
-H "apikey: $SK" -H "Authorization: Bearer $SK"
```
**Regra inviolável:** matéria-prima local. Usar como input para composição Remotion — NUNCA servir o ficheiro raw publicamente sem edição/montagem.
Ver `Hub/06-Operacoes/Procedimentos/D7-Tecnologia/MCP/PROC-Media-Bank.md` (D7-MB-001) para detalhes.
---
## Healing Log
Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.
+37
View File
@@ -230,6 +230,43 @@ Para conteudo detalhado, consultar:
---
## Media Bank (D7-MB-001)
**Quando consultar:** antes de criar thumbnail base (imagem de fundo) ou de seleccionar cutaways/B-roll para vídeos YouTube. Reutilizar matéria-prima local poupa tempo e mantém coerência visual.
**Workflow tentativa-primeiro:**
1. Pesquisar via MCP `media-bank`:
```
mcp__media-bank__search_media(
query="<tema do vídeo em EN>",
type="image", # ou "video" para cutaways
tema="<um dos 9 temas>",
orientation="landscape",
min_quality=7,
min_width=1280, # mínimo para thumbnail YT (1280x720)
exclude_used_in_last_days=30,
limit=5
)
```
2. Avaliar candidatos por `description_en` + `quality_score`.
3. Se ≥1 adequado → usar `path_local` como base do thumbnail (composição em Canva/Photoshop/design-engine) ou como cutaway no Remotion.
4. Se nenhum → fallback para geração IA.
5. Marcar uso: `mcp__media-bank__mark_used(asset_id, {type:"youtube-thumb", ref:"<video_id>", date:"<YYYY-MM-DD>"})`.
**Fallback REST** (se MCP indisponível):
```bash
SK=$(grep SERVICE_KEY /media/ealmeida/Dados/Hub/05-Projectos/Banco-Imagens-Videos/scripts/.env | cut -d= -f2)
curl -s "https://mem.descomplicar.pt/rest/v1/media_bank_assets?type=eq.image&orientation=eq.landscape&width=gte.1280&quality_score=gte.7&deleted_at=is.null&order=quality_score.desc&limit=5" \
-H "apikey: $SK" -H "Authorization: Bearer $SK"
```
**Regra inviolável:** matéria-prima local. Usar como input para composição do thumbnail — NUNCA publicar o ficheiro raw como thumbnail final sem edição (título, CTA, branding).
Ver `Hub/06-Operacoes/Procedimentos/D7-Tecnologia/MCP/PROC-Media-Bank.md` (D7-MB-001) para detalhes.
---
## Healing Log
Registo de erros conhecidos e como evitá-los. Lido automaticamente antes de executar.