Mastra 통합

Scavio는 TypeScript 에이전트 프레임워크인 Mastra를 위한 툴 패키지로 제공됩니다. mastra-scavio를 설치하고 그 툴을 임의의 Mastra Agent에 전달하면, Google, YouTube, Amazon, Walmart, Reddit, TikTok, Instagram 전반에서 실시간 검색 기능을 갖추게 됩니다 — 패키지 하나, API 키 하나로 가능합니다.

전제 조건

Node.js 20.9 이상과 Mastra 프로젝트(@mastra/core).
dashboard.scavio.dev에서 발급받은 Scavio API 키 (신규 계정은 신용카드 없이 무료 크레딧을 받습니다).

설치

Bash

npm install mastra-scavio @mastra/core zod

API 키 설정

Bash

export SCAVIO_API_KEY=sk_live_your_key

툴은 환경 변수에서 SCAVIO_API_KEY를 읽습니다. 다음과 같이 명시적으로 전달할 수도 있습니다: createScavioTools({ apiKey: "sk_live_..." }).

빠른 시작

createScavioTools()는 모든 Scavio 툴을 키가 지정된 객체로 반환하며, 이를 곧바로 에이전트에 전달할 수 있습니다:

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

단일 툴 사용

전체 세트 대신 필요한 툴만 가져옵니다:

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

사용 가능한 툴

각 툴은 Mastra의 createTool()로 생성되며, 구조화된 Scavio JSON 응답을 반환합니다.

제공자	툴
Google	`scavioGoogleSearch`
Amazon	`scavioAmazonSearch`, `scavioAmazonProduct`
Walmart	`scavioWalmartSearch`, `scavioWalmartProduct`
YouTube	`scavioYoutubeSearch`, `scavioYoutubeMetadata`
Reddit	`scavioRedditSearch`, `scavioRedditPost`
TikTok	`scavioTiktokSearch`, `scavioTiktokProfile`
Instagram	`scavioInstagramSearch`, `scavioInstagramProfile`

MCP로 모든 엔드포인트 사용

전체 Scavio API(33개 엔드포인트)를 설치 없이 사용하려면, Mastra의 MCP 클라이언트를 호스팅된 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();

크레딧 비용

대부분의 호출은 1 크레딧이 소요됩니다. Reddit과 Instagram은 2 크레딧, Google은 light_request가 설정되지 않았을 때 2 크레딧이 소요됩니다. 요금제 한도는 속도 제한 참조를, 재시도 지침은 오류 참조를 확인하세요.

리소스

Mastra 통합

빠른 시작

createScavioTools()는 모든 Scavio 툴을 키가 지정된 객체로 반환하며, 이를 곧바로 에이전트에 전달할 수 있습니다:

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

단일 툴 사용

전체 세트 대신 필요한 툴만 가져옵니다:

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

사용 가능한 툴

각 툴은 Mastra의 createTool()로 생성되며, 구조화된 Scavio JSON 응답을 반환합니다.

제공자

툴

Google

scavioGoogleSearch

Amazon

scavioAmazonSearch, scavioAmazonProduct

Walmart

scavioWalmartSearch, scavioWalmartProduct

YouTube

scavioYoutubeSearch, scavioYoutubeMetadata

scavioRedditSearch, scavioRedditPost

TikTok

scavioTiktokSearch, scavioTiktokProfile

Instagram

scavioInstagramSearch, scavioInstagramProfile

MCP로 모든 엔드포인트 사용

전체 Scavio API(33개 엔드포인트)를 설치 없이 사용하려면, Mastra의 MCP 클라이언트를 호스팅된 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();