CrewAI統合
Scavioは、役割を演じる自律エージェントをオーケストレーションするためのフレームワークである CrewAI向けの、すぐに使えるツールパッケージとして提供されています。crewai-scavioをインストールし、いずれかのツールをCrewAIのAgentに渡すだけで、Google、Amazon、Walmart、YouTube、Reddit、TikTok、Instagramを横断したリアルタイム検索を付与できます。— 1つのパッケージ、1つの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を経由し、SDKが認証、レート制限、リクエストのフォーマットを処理します。結果は構造化データとしてエージェントに返されます。
クレジットコスト
ほとんどの呼び出しは1クレジットです。Redditは2クレジット、Googleはlight_request=falseの場合に2クレジットかかります。プランごとの上限については レート制限のリファレンスを、リトライのガイダンスについては エラーのリファレンスを参照してください。