Integração Mastra

A Scavio é distribuída como um pacote de ferramentas para o Mastra, o framework de agentes em TypeScript. Instale mastra-scavio, entregue as ferramentas a qualquer Agent do Mastra e ele ganha busca em tempo real no Google, YouTube, Amazon, Walmart, Reddit, TikTok e Instagram — um pacote, uma chave de API.

Pré-requisitos

1. Node.js 20.9 ou posterior e um projeto Mastra (@mastra/core).
2. Uma chave de API do Scavio de dashboard.scavio.dev (novas contas recebem créditos gratuitos, sem cartão de crédito).

Instalar

npm install mastra-scavio @mastra/core zod

Defina sua chave de API

export SCAVIO_API_KEY=sk_live_your_key

As ferramentas leem SCAVIO_API_KEY do ambiente. Você também pode passá-la explicitamente: createScavioTools({ apiKey: "sk_live_..." }).

Início rápido

createScavioTools() retorna todas as ferramentas da Scavio como um objeto indexado que você pode passar diretamente a um 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
});

Use uma única ferramenta

Importe apenas as ferramentas de que você precisa em vez do 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(),
  },
});

Ferramentas disponíveis

Cada ferramenta é criada com o createTool() do Mastra e retorna a resposta JSON estruturada da Scavio.

Use todos os endpoints via MCP

Para a API completa da Scavio (33 endpoints) sem nenhuma instalação, aponte o cliente MCP do Mastra para o servidor Scavio hospedado:

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();

Custos de crédito

A maioria das chamadas custa 1 crédito. O Reddit e o Instagram custam 2 créditos, e o Google custa 2 quando light_request não está definido. Consulte a referência de limites de taxa para os limites de plano e a referência de erros para orientação sobre nova tentativa.

Recursos

• Documentação do Mastra
• mastra-scavio no GitHub
• mastra-scavio no npm
• Início rápido da API Scavio