Scavio + smolagents

What is smolagents?

Hugging Face's lightweight framework for building AI agents. Minimal, code-first approach to agent development.

How It Works

Scavio connects to smolagents via a custom tool definition. Once connected, your smolagents agent can search Google, Amazon, YouTube, and Walmart in real time. Each search returns structured JSON -- no HTML parsing, no scraping infrastructure.

Setup

pip install smolagents requests

Code Example

Here is a complete smolagents integration with Scavio:

from smolagents import tool, CodeAgent, HfApiModel
import requests
import json

@tool
def scavio_search(query: str) -> str:
    """Search the web for real-time results using Scavio API."""
    response = requests.post(
        "https://api.scavio.dev/api/v1/search",
        headers={"x-api-key": "your_scavio_api_key", "Content-Type": "application/json"},
        json={"query": query},
    )
    return json.dumps(response.json())

agent = CodeAgent(tools=[scavio_search], model=HfApiModel())
result = agent.run("Find the best noise cancelling headphones")
print(result)

Full Working Example

A production-ready example with error handling:

from smolagents import tool, CodeAgent, HfApiModel
import requests
import json

@tool
def scavio_search(query: str) -> str:
    """Search the web for real-time results using Scavio API."""
    response = requests.post(
        "https://api.scavio.dev/api/v1/search",
        headers={"x-api-key": "your_scavio_api_key", "Content-Type": "application/json"},
        json={"query": query},
    )
    return json.dumps(response.json())

agent = CodeAgent(tools=[scavio_search], model=HfApiModel())
result = agent.run("Find the best noise cancelling headphones")
print(result)

Available Platforms

Once connected, your smolagents agent has access to all four Scavio platforms:

• Google — Web search with knowledge graph, PAA, and AI overviews
• Amazon — Product search with prices, ratings, and reviews
• Reddit — Community, posts & threaded comments from any subreddit
• YouTube — Video search with transcripts and metadata
• Walmart — Product search with pricing and fulfillment data
• LinkedIn — Post, profile, and company discovery via search
• TikTok — Trending video, creator, and product discovery
• Shopify — Cross-store product discovery and enrichment
• X (Twitter) — Post and profile discovery via search
• Apple App Store — App discovery, ranking, and review data
• Google Play Store — Android app discovery and ranking data
• Google Reviews — Business review extraction with ratings and responses
• Google Scholar — Academic paper search with citation counts
• Google Ads Transparency — Competitor ad creative and transparency data via SERP
• Reddit Comments Tree — Deep threaded comment fetch for brand monitoring
• YouTube Shorts — Shorts-specific search with metadata
• YouTube Playlists — Playlist discovery and removal tracking
• Google Jobs — Live jobs-board search for recruiting
• Amazon Bestsellers — Bestseller rank-change feed across categories

Pricing

Scavio offers a free tier with 50 credits on signup (1 credit per search). No credit card required. This is enough to build and test your smolagents integration. Paid plans start at $30/month for higher volumes.