CrewAI 통합
Scavio는 역할 기반 자율 에이전트를 오케스트레이션하는 프레임워크인 CrewAI를 위한 즉시 사용 가능한 도구 패키지로 제공됩니다. crewai-scavio를 설치하고 CrewAI Agent에 도구를 전달하기만 하면 Google, Amazon, Walmart, YouTube, Reddit, TikTok, Instagram 전반에서 실시간 검색 기능을 부여할 수 있습니다 — 패키지 하나, API 키 하나로, 별도의 HTTP 코드 없이 가능합니다.
전제 조건
- Python 3.10 이상.
- dashboard.scavio.dev에서 발급받은 Scavio API 키.
설치
pip install crewai-scaviocrewai 프레임워크와 scavio Python SDK가 의존성으로 함께 설치됩니다.
API 키 설정
export SCAVIO_API_KEY=sk_live_your_key모든 도구는 환경 변수에서 SCAVIO_API_KEY를 읽습니다. 다음과 같이 명시적으로 전달할 수도 있습니다: ScavioSearchTool(api_key="sk_live_...").
빠른 시작
from crewai import Agent, Crew, Task
from crewai_scavio import ScavioSearchTool
researcher = Agent(
role="Research Analyst",
goal="Find accurate, up-to-date information on any topic",
backstory="An expert researcher who finds reliable sources.",
tools=[ScavioSearchTool()],
verbose=True,
)
task = Task(
description="Research the top 3 trends in AI agents for 2026.",
expected_output="A summary of the top 3 trends with sources.",
agent=researcher,
)
crew = Crew(agents=[researcher], tasks=[task], verbose=True)
print(crew.kickoff())더 많은 제공자 사용
에이전트에 필요한 도구만 가져오세요 — 각 제공자는 자체 도구 클래스입니다:
from crewai_scavio import (
ScavioSearchTool, # Google web search
ScavioAmazonSearchTool, # Amazon product search
ScavioYouTubeSearchTool, # YouTube video search
ScavioRedditSearchTool, # Reddit post search
)
agent = Agent(
role="Market Researcher",
goal="Compare products and gather public sentiment",
tools=[ScavioAmazonSearchTool(), ScavioRedditSearchTool()],
)사용 가능한 도구
7개 제공자에 걸쳐 32개의 도구가 있습니다. 모두 Scavio<Provider><Action>Tool 명명 규칙을 따릅니다.
| 제공자 | 도구 |
|---|---|
ScavioSearchTool | |
| Amazon | ScavioAmazonSearchTool, ScavioAmazonProductTool |
| Walmart | ScavioWalmartSearchTool, ScavioWalmartProductTool |
| YouTube | ScavioYouTubeSearchTool, ScavioYouTubeMetadataTool |
ScavioRedditSearchTool, ScavioRedditPostTool | |
| TikTok | ScavioTikTokProfileTool, ScavioTikTokUserPostsTool, ScavioTikTokVideoTool, ScavioTikTokVideoCommentsTool, ScavioTikTokCommentRepliesTool, ScavioTikTokSearchVideosTool, ScavioTikTokSearchUsersTool |
| 프로필, 게시물, 릴스, 스토리, 게시물 세부 정보, 댓글, 댓글 답글, 사용자 및 해시태그 검색 도구. |
작동 방식
각 도구는 타입이 지정된 인자 스키마를 갖춘 CrewAI BaseTool이므로, 에이전트는 정확한 인자 힌트를 받고 CrewAI는 호출이 실행되기 전에 이를 검증합니다. 호출은 인증, 속도 제한, 요청 형식 지정을 처리하는 scavio Python SDK를 통해 이루어집니다. 결과는 구조화된 데이터로 에이전트에 반환됩니다.
크레딧 비용
대부분의 호출은 1 크레딧이 소요됩니다. Reddit은 2 크레딧, Google은 light_request=false일 때 2 크레딧이 소요됩니다. 요금제 한도는 속도 제한 참조를, 재시도 지침은 오류 참조를 확인하세요.