Integracion con Mastra

Scavio se distribuye como un paquete de herramientas para Mastra, el framework de agentes en TypeScript. Instala mastra-scavio, entrega las herramientas a cualquier Agent de Mastra y obtendra busqueda en tiempo real en Google, YouTube, Amazon, Walmart, Reddit, TikTok e Instagram — un paquete, una clave API.

Requisitos previos

1. Node.js 20.9 o posterior y un proyecto de Mastra (@mastra/core).
2. Una clave API de Scavio obtenida en dashboard.scavio.dev (las cuentas nuevas reciben creditos gratis, sin tarjeta de credito).

Instalacion

npm install mastra-scavio @mastra/core zod

Configura tu clave API

export SCAVIO_API_KEY=sk_live_your_key

Las herramientas leen SCAVIO_API_KEY del entorno. Tambien puedes pasarla de forma explicita: createScavioTools({ apiKey: "sk_live_..." }).

Inicio rapido

createScavioTools() devuelve todas las herramientas de Scavio como un objeto con claves que puedes entregar directamente a un agente:

import { Agent } from "@mastra/core/agent";
import { createScavioTools } from "mastra-scavio";

export const agent = new Agent({
  id: "web-search-agent",
  name: "Web Search Agent",
  model: "openai/gpt-5.5",
  instructions: "Search the web, shopping sites, and social platforms with Scavio.",
  tools: createScavioTools(), // reads SCAVIO_API_KEY
});

Usa una sola herramienta

Importa solo las herramientas que necesitas en lugar del conjunto completo:

import { Agent } from "@mastra/core/agent";
import { createScavioGoogleSearchTool, createScavioRedditSearchTool } from "mastra-scavio";

export const agent = new Agent({
  id: "research-agent",
  model: "openai/gpt-5.5",
  instructions: "Research with Google and Reddit before answering, and cite sources.",
  tools: {
    googleSearch: createScavioGoogleSearchTool(),
    redditSearch: createScavioRedditSearchTool(),
  },
});

Herramientas disponibles

Cada herramienta se crea con createTool() de Mastra y devuelve la respuesta JSON estructurada de Scavio.

Usa todos los endpoints via MCP

Para la API completa de Scavio (33 endpoints) sin instalar nada, apunta el cliente MCP de Mastra al servidor alojado de Scavio:

import { MCPClient } from "@mastra/mcp";

const mcp = new MCPClient({
  id: "scavio",
  servers: {
    scavio: {
      url: new URL("https://mcp.scavio.dev/mcp"),
      requestInit: { headers: { "x-api-key": process.env.SCAVIO_API_KEY! } },
    },
  },
});

const tools = await mcp.listTools();

Costos en creditos

La mayoria de las llamadas cuestan 1 credito. Reddit e Instagram cuestan 2 creditos, y Google cuesta 2 cuando light_request no esta configurado. Consulta la referencia de limites de tasa para los limites por plan y la referencia de errores para orientacion sobre reintentos.

Recursos

• Documentacion de Mastra
• mastra-scavio en GitHub
• mastra-scavio en npm
• Inicio rapido de la API de Scavio