Integrazione Mastra

Scavio è disponibile come pacchetto di strumenti per Mastra, il framework di agenti in TypeScript. Installa mastra-scavio, affida gli strumenti a qualsiasi Agent di Mastra e ottieni ricerca in tempo reale su Google, YouTube, Amazon, Walmart, Reddit, TikTok e Instagram — un pacchetto, una chiave API.

Prerequisiti

1. Node.js 20.9 o successivo e un progetto Mastra (@mastra/core).
2. Una chiave API Scavio da dashboard.scavio.dev (i nuovi account ricevono crediti gratuiti, senza carta di credito).

Installazione

npm install mastra-scavio @mastra/core zod

Imposta la tua chiave API

export SCAVIO_API_KEY=sk_live_your_key

Gli strumenti leggono SCAVIO_API_KEY dall'ambiente. Puoi anche passarla esplicitamente: createScavioTools({ apiKey: "sk_live_..." }).

Guida rapida

createScavioTools() restituisce tutti gli strumenti Scavio come un oggetto con chiavi che puoi passare direttamente 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 un singolo strumento

Importa solo gli strumenti che ti servono invece dell'intero set:

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

Strumenti disponibili

Ogni strumento è creato con createTool() di Mastra e restituisce la risposta JSON strutturata di Scavio.

Usa ogni endpoint tramite MCP

Per l'intera API di Scavio (33 endpoint) senza alcuna installazione, punta il client MCP di Mastra al server Scavio in hosting:

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

Costi in crediti

La maggior parte delle chiamate costa 1 credito. Reddit e Instagram costano 2 crediti, e Google costa 2 quando light_request non è impostato. Consulta il riferimento sui limiti di velocità per i limiti dei piani e il riferimento sugli errori per indicazioni sui tentativi.

Risorse

• Documentazione Mastra
• mastra-scavio su GitHub
• mastra-scavio su npm
• Guida rapida API Scavio