Scavio Google

Google Search via Scavio

Search Google and return structured JSON — no HTML parsing required. Covers web, news, images, maps, and lens search types.

When to trigger

Use this skill when the user asks to:

• Look something up on the web or check a current fact
• Find recent news or events
• Search for images, maps, or documentation
• Answer any question that requires real-time or up-to-date information

Do not answer from memory when current information is needed. Search first.

Setup

Get a free API key at https://scavio.dev (1,000 free credits/month, no card required):

export SCAVIO_API_KEY=sk_live_your_key

Workflow

1. Identify the user's intent and pick the right search_type (classic, news, images, maps, lens).
2. Choose light_request: false only if you need knowledge graph, people also ask, or related searches (costs 2 credits vs 1).
3. Call the endpoint with the query and any filters.
4. Return results in a clear, structured response. Cite URLs.

Endpoint

POST https://api.scavio.dev/api/v1/google
Authorization: Bearer $SCAVIO_API_KEY

Parameters

Example

import os, requests

response = requests.post(
    "https://api.scavio.dev/api/v1/google",
    headers={"Authorization": f"Bearer {os.environ['SCAVIO_API_KEY']}"},
    json={"query": "langchain agents tutorial", "country_code": "us", "language": "en"},
)
data = response.json()
# results in data["results"]

Response

{
  "results": [
    {
      "title": "Result title",
      "url": "https://example.com",
      "description": "Snippet...",
      "position": 1
    }
  ],
  "query": "langchain agents tutorial",
  "credits_used": 1,
  "credits_remaining": 999
}

Full mode ("light_request": false) also returns: knowledge_graph, questions (people also ask), related_searches, news_results, top_stories.

Guardrails

• Never fabricate search results or URLs. Only return what the API gives you.
• If the query is time-sensitive, always call the API — do not answer from training data.
• search_type: news only supports device: desktop.
• Cite sources when summarizing results.

Failure handling

• If the API returns an error, report the status code and stop.
• If no results are returned, tell the user and suggest rephrasing.
• If SCAVIO_API_KEY is not set, prompt the user to export it before continuing.

LangChain

pip install scavio-langchain

from scavio_langchain import ScavioSearchTool
tool = ScavioSearchTool(engine="google")