shutterstock-search-mcp 1.0.0 → 1.1.0

package/index.mjs

@@ -1,5 +1,7 @@
 #!/usr/bin/env node
-// MCP mínimo de busca no Shutterstock: devolve o link da página de cada imagem.
+// MCP de busca no Shutterstock: devolve o link da página de cada imagem, priorizando fotos
+// com cara de feed de rede social (lifestyle, luz natural, emoção real) e descartando
+// fundo branco recortado, 3D, ilustração e cenas tristes ou assustadoras.
 // Autenticação: Basic com SHUTTERSTOCK_CONSUMER_KEY e SHUTTERSTOCK_CONSUMER_SECRET (só busca, não licencia).
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -9,27 +11,54 @@ const KEY = process.env.SHUTTERSTOCK_CONSUMER_KEY;
 const SECRET = process.env.SHUTTERSTOCK_CONSUMER_SECRET;
 const API = process.env.SHUTTERSTOCK_API_URL || "https://api.shutterstock.com/v2/images/search";
 
-const server = new McpServer({ name: "shutterstock-search", version: "1.0.0" });
+// Estilo "feed": termos que indicam foto bonita, natural e alegre
+const POSITIVOS = [
+  "happy", "smiling", "smile", "laughing", "joy", "joyful", "fun", "playing", "play", "cheerful",
+  "candid", "lifestyle", "authentic", "real", "natural light", "sunlight", "sunny", "sun", "summer",
+  "golden hour", "sunset", "backlight", "bokeh", "warm", "cozy", "tender", "love", "loving", "hug",
+  "cuddle", "together", "family", "garden", "outdoor", "park", "home", "beach", "sprinkler", "splash",
+];
+// Termos que indicam foto artificial, de estúdio ou com clima negativo
+const NEGATIVOS = [
+  "isolated", "white background", "cut out", "cutout", "3d", "render", "illustration", "vector",
+  "cartoon", "mockup", "template", "concept", "studio shot", "crying", "cry", "sad", "sick", "ill",
+  "fever", "disease", "virus", "injection", "syringe", "needle", "hospital", "doctor", "scared",
+  "fear", "angry", "tired", "exhausted", "stress", "dirty", "dark", "danger",
+];
+const EXCLUSOES = ["isolated", "illustration", "vector", "3d", "crying", "sick"];
+
+function pontuar(texto) {
+  const t = ` ${texto.toLowerCase()} `;
+  let p = 0;
+  for (const w of POSITIVOS) if (t.includes(` ${w}`) || t.includes(`${w} `)) p += 1;
+  for (const w of NEGATIVOS) if (t.includes(` ${w}`) || t.includes(`${w} `)) p -= 4;
+  return p;
+}
+
+const server = new McpServer({ name: "shutterstock-search", version: "1.1.0" });
 
 server.registerTool(
   "buscar_imagem",
   {
     title: "Buscar imagem no Shutterstock",
     description:
-      "Busca fotos no Shutterstock e devolve, para cada resultado, o link da página da imagem (url), a descrição e o id. " +
-      "Use palavras-chave em inglês (3 a 5) descrevendo a cena. Não licencia nem baixa imagens.",
+      "Busca fotos no Shutterstock com estilo de feed de rede social (lifestyle, luz natural, emoção real) e devolve, " +
+      "do melhor para o pior, o link da página da imagem (url), a descrição e uma nota de estilo. Já exclui fundo branco, " +
+      "3D, ilustração e cenas tristes ou assustadoras. Use palavras-chave em inglês (3 a 6) descrevendo a cena. " +
+      "Não licencia nem baixa imagens.",
     inputSchema: {
-      query: z.string().min(1).describe("Palavras-chave em inglês, ex.: 'baby summer heat water splash'"),
-      quantidade: z.number().int().min(1).max(10).default(3).describe("Quantos resultados devolver (1 a 10)"),
-      orientacao: z.enum(["vertical", "horizontal", "qualquer"]).default("vertical"),
+      query: z.string().min(1).describe("Cena em inglês, ex.: 'toddler playing garden sprinkler summer'"),
+      quantidade: z.number().int().min(1).max(10).default(5).describe("Quantos resultados devolver, já ordenados (1 a 10)"),
+      orientacao: z.enum(["vertical", "horizontal", "qualquer"]).default("qualquer"),
     },
   },
   async ({ query, quantidade, orientacao }) => {
     if (!KEY || !SECRET) {
       return { isError: true, content: [{ type: "text", text: "ERRO: SHUTTERSTOCK_CONSUMER_KEY/SECRET não configurados no MCP." }] };
     }
+    const q = [query, ...EXCLUSOES.filter((w) => !query.toLowerCase().includes(`not ${w}`)).map((w) => `NOT ${w}`)].join(" ");
     const params = new URLSearchParams({
-      query, per_page: String(quantidade), sort: "relevance", image_type: "photo", safe: "true", view: "minimal",
+      query: q, per_page: "30", sort: "relevance", image_type: "photo", safe: "true", view: "full",
     });
     if (orientacao !== "qualquer") params.set("orientation", orientacao);
     const auth = Buffer.from(`${KEY}:${SECRET}`).toString("base64");
@@ -40,13 +69,20 @@ server.registerTool(
         return { isError: true, content: [{ type: "text", text: `ERRO HTTP ${res.status}: ${body}` }] };
       }
       const data = await res.json();
-      const resultados = (data.data || []).map((it) => ({
-        url: it.url || `https://www.shutterstock.com/image-photo/${it.id}`,
-        descricao: it.description || "",
-        id: String(it.id),
-      }));
+      const itens = (data.data || []).map((it, pos) => {
+        const desc = it.description || "";
+        const kws = Array.isArray(it.keywords) ? it.keywords.join(" ") : "";
+        const nota = pontuar(desc) * 2 + pontuar(kws) + (it.has_model_release ? 1 : 0) - pos * 0.15;
+        return {
+          url: it.url || `https://www.shutterstock.com/image-photo/${it.id}`,
+          descricao: desc,
+          id: String(it.id),
+          nota_estilo: Math.round(nota * 10) / 10,
+        };
+      });
+      const resultados = itens.sort((a, b) => b.nota_estilo - a.nota_estilo).slice(0, quantidade);
       return {
-        content: [{ type: "text", text: JSON.stringify({ query, total: data.total_count ?? resultados.length, resultados }, null, 1) }],
+        content: [{ type: "text", text: JSON.stringify({ query: q, total: data.total_count ?? itens.length, resultados }, null, 1) }],
       };
     } catch (e) {
       return { isError: true, content: [{ type: "text", text: `ERRO de conexão: ${e.message}` }] };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shutterstock-search-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP mínimo de busca no Shutterstock que devolve o link da página de cada imagem",
   "type": "module",
   "bin": { "shutterstock-search-mcp": "index.mjs" },