Intégration Mastra

Scavio est livré comme un package d'outils pour Mastra, le framework d'agents TypeScript. Installez mastra-scavio, confiez les outils à n'importe quel Agent Mastra, et il obtient une recherche en temps réel sur Google, YouTube, Amazon, Walmart, Reddit, TikTok et Instagram — un seul package, une seule clé API.

Prérequis

1. Node.js 20.9 ou ultérieur et un projet Mastra (@mastra/core).
2. Une clé API Scavio depuis dashboard.scavio.dev (les nouveaux comptes reçoivent des crédits gratuits, sans carte bancaire).

Installation

npm install mastra-scavio @mastra/core zod

Définir votre clé API

export SCAVIO_API_KEY=sk_live_your_key

Les outils lisent SCAVIO_API_KEY depuis l'environnement. Vous pouvez aussi la passer explicitement : createScavioTools({ apiKey: "sk_live_..." }).

Démarrage rapide

createScavioTools() renvoie tous les outils Scavio sous forme d'objet à clés que vous pouvez passer directement à un agent :

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

Utiliser un seul outil

Importez uniquement les outils dont vous avez besoin plutôt que l'ensemble complet :

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

Outils disponibles

Chaque outil est créé avec le createTool() de Mastra et renvoie la réponse JSON structurée de Scavio.

Utiliser chaque point de terminaison via MCP

Pour l'API Scavio complète (33 points de terminaison) sans aucune installation, pointez le client MCP de Mastra vers le serveur Scavio hébergé :

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

Coûts en crédits

La plupart des appels coûtent 1 crédit. Reddit et Instagram coûtent 2 crédits, et Google coûte 2 lorsque light_request n'est pas défini. Consultez la référence des limites de débit pour les limites de plan et la référence des erreurs pour les conseils de réessai.

Ressources

• Documentation Mastra
• mastra-scavio sur GitHub
• mastra-scavio sur npm
• Démarrage rapide de l'API Scavio