google-adk-scavio 0.1.0__tar.gz

google_adk_scavio-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,44 @@
+name: Publish
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+jobs:
+  pypi:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Check if version is new
+        id: check
+        run: |
+          NAME=$(grep -m1 '^name' pyproject.toml | sed -E 's/.*"(.*)".*/\1/')
+          VERSION=$(grep -m1 '^version' pyproject.toml | sed -E 's/.*"(.*)".*/\1/')
+          echo "version=$VERSION"
+          if curl -fsSL "https://pypi.org/pypi/$NAME/$VERSION/json" > /dev/null 2>&1; then
+            echo "new=false" >> "$GITHUB_OUTPUT"
+            echo "$NAME $VERSION already on PyPI, skipping"
+          else
+            echo "new=true" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Install build tools
+        if: steps.check.outputs.new == 'true'
+        run: pip install build twine
+
+      - name: Build
+        if: steps.check.outputs.new == 'true'
+        run: python -m build
+
+      - name: Publish to PyPI
+        if: steps.check.outputs.new == 'true'
+        env:
+          TWINE_USERNAME: __token__
+          TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+        run: twine upload dist/*

google_adk_scavio-0.1.0/.gitignore

@@ -0,0 +1,5 @@
+.venv/
+dist/
+__pycache__/
+*.egg-info/
+.pytest_cache/

google_adk_scavio-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Scavio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

google_adk_scavio-0.1.0/PKG-INFO

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: google-adk-scavio
+Version: 0.1.0
+Summary: Scavio real-time search tools (Google, YouTube, Amazon, Walmart, Reddit) for Google ADK (Agent Development Kit)
+Project-URL: Homepage, https://scavio.dev
+Project-URL: Repository, https://github.com/scavio-ai/google-adk-scavio
+Project-URL: Documentation, https://scavio.dev/docs/google-adk
+Author-email: Scavio <support@scavio.dev>
+License: MIT
+License-File: LICENSE
+Keywords: adk,agent-development-kit,agents,google-adk,scavio,search,serp,tavily-alternative
+Requires-Python: >=3.10
+Requires-Dist: google-adk>=1.0
+Requires-Dist: scavio>=0.5.0
+Provides-Extra: test
+Requires-Dist: pytest>=7.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# google-adk-scavio
+
+[Scavio](https://scavio.dev) real-time search tools for [Google ADK](https://google.github.io/adk-docs/) (Agent Development Kit) — Google, YouTube, Amazon, Walmart, and Reddit, with one API key.
+
+## Install
+
+```bash
+pip install google-adk-scavio
+```
+
+## Setup
+
+Get a Scavio API key from the [Scavio Dashboard](https://dashboard.scavio.dev) (new accounts get 50 free signup credits, no credit card). Set `SCAVIO_API_KEY` or pass `api_key=` to the factory.
+
+## Usage
+
+```python
+from google.adk.agents import Agent
+from google_adk_scavio import create_scavio_tools
+
+root_agent = Agent(
+    name="search_assistant",
+    model="gemini-2.5-flash",
+    instruction="Search the web, news, shopping sites, and Reddit with the Scavio tools.",
+    tools=create_scavio_tools(),  # reads SCAVIO_API_KEY
+)
+```
+
+Expose only the providers you need:
+
+```python
+tools = create_scavio_tools(
+    enable_google=True,
+    enable_reddit=True,
+    enable_youtube=False,
+    enable_amazon=False,
+    enable_walmart=False,
+)
+```
+
+## Tools
+
+`create_scavio_tools()` returns plain typed Python functions; ADK wraps each one in a `FunctionTool` automatically. Each returns the structured Scavio JSON response as a dict; errors come back as `{"error": "..."}` rather than raising, so a failed call never crashes the run.
+
+| Tool | Description | Credits |
+|---|---|---|
+| `scavio_google_search` | Google web results (organic, knowledge graph, AI overview) | 1 |
+| `scavio_google_news` | Google News articles | 1 |
+| `scavio_youtube_search` | YouTube videos, channels, playlists | 1 |
+| `scavio_youtube_metadata` | Full metadata for a video by id | 1 |
+| `scavio_amazon_search` | Amazon product search | 1 |
+| `scavio_amazon_product` | Amazon product details by ASIN | 1 |
+| `scavio_walmart_search` | Walmart product search | 1 |
+| `scavio_walmart_product` | Walmart product details by product id | 1 |
+| `scavio_reddit_search` | Reddit posts or comments search | 2 |
+| `scavio_reddit_post` | Reddit post with threaded comments by URL | 2 |
+
+## Use every endpoint via MCP
+
+For the full Scavio API (TikTok, Instagram, Google Maps, Shopping, Trends, and more), point ADK at the hosted MCP server. Requires ADK's MCP extra: `pip install "google-adk[mcp]"`.
+
+```python
+from google.adk.agents import Agent
+from google.adk.tools.mcp_tool import McpToolset, StreamableHTTPConnectionParams
+
+scavio = McpToolset(
+    connection_params=StreamableHTTPConnectionParams(
+        url="https://mcp.scavio.dev/mcp",
+        headers={"x-api-key": "sk_live_..."},
+    )
+)
+
+root_agent = Agent(name="search_assistant", model="gemini-2.5-flash", tools=[scavio])
+```
+
+## Links
+
+- Scavio: https://scavio.dev
+- Docs: https://scavio.dev/docs/google-adk
+- Dashboard: https://dashboard.scavio.dev
+
+## License
+
+MIT

google_adk_scavio-0.1.0/README.md

@@ -0,0 +1,84 @@
+# google-adk-scavio
+
+[Scavio](https://scavio.dev) real-time search tools for [Google ADK](https://google.github.io/adk-docs/) (Agent Development Kit) — Google, YouTube, Amazon, Walmart, and Reddit, with one API key.
+
+## Install
+
+```bash
+pip install google-adk-scavio
+```
+
+## Setup
+
+Get a Scavio API key from the [Scavio Dashboard](https://dashboard.scavio.dev) (new accounts get 50 free signup credits, no credit card). Set `SCAVIO_API_KEY` or pass `api_key=` to the factory.
+
+## Usage
+
+```python
+from google.adk.agents import Agent
+from google_adk_scavio import create_scavio_tools
+
+root_agent = Agent(
+    name="search_assistant",
+    model="gemini-2.5-flash",
+    instruction="Search the web, news, shopping sites, and Reddit with the Scavio tools.",
+    tools=create_scavio_tools(),  # reads SCAVIO_API_KEY
+)
+```
+
+Expose only the providers you need:
+
+```python
+tools = create_scavio_tools(
+    enable_google=True,
+    enable_reddit=True,
+    enable_youtube=False,
+    enable_amazon=False,
+    enable_walmart=False,
+)
+```
+
+## Tools
+
+`create_scavio_tools()` returns plain typed Python functions; ADK wraps each one in a `FunctionTool` automatically. Each returns the structured Scavio JSON response as a dict; errors come back as `{"error": "..."}` rather than raising, so a failed call never crashes the run.
+
+| Tool | Description | Credits |
+|---|---|---|
+| `scavio_google_search` | Google web results (organic, knowledge graph, AI overview) | 1 |
+| `scavio_google_news` | Google News articles | 1 |
+| `scavio_youtube_search` | YouTube videos, channels, playlists | 1 |
+| `scavio_youtube_metadata` | Full metadata for a video by id | 1 |
+| `scavio_amazon_search` | Amazon product search | 1 |
+| `scavio_amazon_product` | Amazon product details by ASIN | 1 |
+| `scavio_walmart_search` | Walmart product search | 1 |
+| `scavio_walmart_product` | Walmart product details by product id | 1 |
+| `scavio_reddit_search` | Reddit posts or comments search | 2 |
+| `scavio_reddit_post` | Reddit post with threaded comments by URL | 2 |
+
+## Use every endpoint via MCP
+
+For the full Scavio API (TikTok, Instagram, Google Maps, Shopping, Trends, and more), point ADK at the hosted MCP server. Requires ADK's MCP extra: `pip install "google-adk[mcp]"`.
+
+```python
+from google.adk.agents import Agent
+from google.adk.tools.mcp_tool import McpToolset, StreamableHTTPConnectionParams
+
+scavio = McpToolset(
+    connection_params=StreamableHTTPConnectionParams(
+        url="https://mcp.scavio.dev/mcp",
+        headers={"x-api-key": "sk_live_..."},
+    )
+)
+
+root_agent = Agent(name="search_assistant", model="gemini-2.5-flash", tools=[scavio])
+```
+
+## Links
+
+- Scavio: https://scavio.dev
+- Docs: https://scavio.dev/docs/google-adk
+- Dashboard: https://dashboard.scavio.dev
+
+## License
+
+MIT

google_adk_scavio-0.1.0/google_adk_scavio/__init__.py

@@ -0,0 +1,6 @@
+"""Scavio search tools for Google ADK (Agent Development Kit)."""
+
+from .tools import create_scavio_tools
+
+__all__ = ["create_scavio_tools"]
+__version__ = "0.1.0"

google_adk_scavio-0.1.0/google_adk_scavio/tools.py

@@ -0,0 +1,179 @@
+"""Scavio search tools for Google ADK (Agent Development Kit).
+
+Build the tools with `create_scavio_tools()` and pass them to an ADK Agent:
+
+    from google.adk.agents import Agent
+    from google_adk_scavio import create_scavio_tools
+
+    agent = Agent(name="search_assistant", model="gemini-2.5-flash", tools=create_scavio_tools())
+
+The factory returns plain Python functions with typed parameters and docstrings;
+ADK wraps each one in a FunctionTool automatically. Each provider is gated by an
+``enable_*`` flag. Tools return the Scavio JSON response as a dict.
+"""
+
+import os
+from typing import Any, Callable, Dict, Optional
+
+try:
+    from scavio import ScavioClient
+except ImportError as exc:  # pragma: no cover
+    raise ImportError("`scavio` not installed. Please install using `pip install scavio`") from exc
+
+
+def _run(call: Callable[[], Dict[str, Any]]) -> Dict[str, Any]:
+    """Run a Scavio SDK call, returning its JSON dict or an {"error": ...} dict."""
+    try:
+        return call()
+    except Exception as exc:  # noqa: BLE001 - surface errors to the agent
+        return {"error": str(exc)}
+
+
+def create_scavio_tools(
+    api_key: Optional[str] = None,
+    *,
+    enable_google: bool = True,
+    enable_youtube: bool = True,
+    enable_amazon: bool = True,
+    enable_walmart: bool = True,
+    enable_reddit: bool = True,
+) -> list:
+    """Build Scavio search tools for a Google ADK Agent.
+
+    Args:
+        api_key: Scavio API key. Falls back to the SCAVIO_API_KEY env var.
+        enable_google: Register the Google tools. Defaults to True.
+        enable_youtube: Register the YouTube tools. Defaults to True.
+        enable_amazon: Register the Amazon tools. Defaults to True.
+        enable_walmart: Register the Walmart tools. Defaults to True.
+        enable_reddit: Register the Reddit tools. Defaults to True.
+
+    Returns:
+        A list of plain functions ready to pass as ``tools=`` to an ADK Agent.
+    """
+    client = ScavioClient(api_key=api_key or os.getenv("SCAVIO_API_KEY"))
+    tools: list = []
+
+    if enable_google:
+        def scavio_google_search(query: str, gl: Optional[str] = None, hl: Optional[str] = None) -> dict:
+            """Search Google for real-time web results (organic results, knowledge graph, AI overview). Costs 1 credit.
+
+            Args:
+                query: The search query.
+                gl: Two-letter ISO country code for the search, e.g. us.
+                hl: Two-letter language code for the results, e.g. en.
+            """
+            _p = {"gl": gl, "hl": hl}
+            return _run(lambda: client.google.search(query, **{k: v for k, v in _p.items() if v is not None}))
+        tools.append(scavio_google_search)
+
+        def scavio_google_news(query: str, gl: Optional[str] = None, hl: Optional[str] = None) -> dict:
+            """Search Google News for current news articles on a topic. Costs 1 credit.
+
+            Args:
+                query: The news search query.
+                gl: Two-letter ISO country code for the search, e.g. us.
+                hl: Two-letter language code for the results, e.g. en.
+            """
+            _p = {"query": query, "gl": gl, "hl": hl}
+            return _run(lambda: client.google.news(**{k: v for k, v in _p.items() if v is not None}))
+        tools.append(scavio_google_news)
+
+    if enable_youtube:
+        def scavio_youtube_search(query: str, upload_date: Optional[str] = None, type: Optional[str] = None, duration: Optional[str] = None, sort_by: Optional[str] = None) -> dict:
+            """Search YouTube for videos, channels, or playlists. Costs 1 credit.
+
+            Args:
+                query: The video search query.
+                upload_date: Upload date filter: last_hour, today, this_week, this_month, this_year.
+                type: Result type: video, channel, playlist.
+                duration: Duration filter: short, medium, long.
+                sort_by: Sort order: relevance, date, view_count, rating.
+            """
+            _p = {"upload_date": upload_date, "type": type, "duration": duration, "sort_by": sort_by}
+            return _run(lambda: client.youtube.search(query, **{k: v for k, v in _p.items() if v is not None}))
+        tools.append(scavio_youtube_search)
+
+        def scavio_youtube_metadata(video_id: str) -> dict:
+            """Fetch full metadata for a YouTube video by id. Costs 1 credit.
+
+            Args:
+                video_id: YouTube video id, e.g. dQw4w9WgXcQ.
+            """
+            return _run(lambda: client.youtube.metadata(video_id))
+        tools.append(scavio_youtube_metadata)
+
+    if enable_amazon:
+        def scavio_amazon_search(query: str, domain: Optional[str] = None, country: Optional[str] = None, sort_by: Optional[str] = None, start_page: Optional[int] = None) -> dict:
+            """Search Amazon for products matching a query. Costs 1 credit.
+
+            Args:
+                query: The product search query.
+                domain: Amazon domain suffix, e.g. com or co.uk.
+                country: Two-letter country code for localization.
+                sort_by: Sort order: featured, price_low_to_high, price_high_to_low, average_review, most_recent, bestsellers.
+                start_page: First result page to return (1-based).
+            """
+            _p = {"domain": domain, "country": country, "sort_by": sort_by, "start_page": start_page}
+            return _run(lambda: client.amazon.search(query, **{k: v for k, v in _p.items() if v is not None}))
+        tools.append(scavio_amazon_search)
+
+        def scavio_amazon_product(asin: str, domain: Optional[str] = None, country: Optional[str] = None) -> dict:
+            """Fetch full Amazon product details by ASIN. Costs 1 credit.
+
+            Args:
+                asin: Amazon Standard Identification Number, e.g. B09XS7JWHH.
+                domain: Amazon domain suffix, e.g. com or co.uk.
+                country: Two-letter country code for localization.
+            """
+            _p = {"domain": domain, "country": country}
+            return _run(lambda: client.amazon.product(asin, **{k: v for k, v in _p.items() if v is not None}))
+        tools.append(scavio_amazon_product)
+
+    if enable_walmart:
+        def scavio_walmart_search(query: str, sort_by: Optional[str] = None, min_price: Optional[int] = None, max_price: Optional[int] = None, start_page: Optional[int] = None) -> dict:
+            """Search Walmart for products matching a query. Costs 1 credit.
+
+            Args:
+                query: The product search query.
+                sort_by: Sort order: best_match, price_low, price_high, best_seller.
+                min_price: Minimum price filter in USD.
+                max_price: Maximum price filter in USD.
+                start_page: First result page to return (1-based).
+            """
+            _p = {"sort_by": sort_by, "min_price": min_price, "max_price": max_price, "start_page": start_page}
+            return _run(lambda: client.walmart.search(query, **{k: v for k, v in _p.items() if v is not None}))
+        tools.append(scavio_walmart_search)
+
+        def scavio_walmart_product(product_id: str) -> dict:
+            """Fetch full Walmart product details by product id. Costs 1 credit.
+
+            Args:
+                product_id: Walmart product id.
+            """
+            return _run(lambda: client.walmart.product(product_id))
+        tools.append(scavio_walmart_product)
+
+    if enable_reddit:
+        def scavio_reddit_search(query: str, type: Optional[str] = None, sort: Optional[str] = None) -> dict:
+            """Search Reddit posts or comments. Costs 2 credits.
+
+            Args:
+                query: The Reddit search query.
+                type: Result type: posts or comments.
+                sort: Sort order: relevance, new, hot, top, comments.
+            """
+            _p = {"type": type, "sort": sort}
+            return _run(lambda: client.reddit.search(query, **{k: v for k, v in _p.items() if v is not None}))
+        tools.append(scavio_reddit_search)
+
+        def scavio_reddit_post(url: str) -> dict:
+            """Fetch a Reddit post and its threaded comments by URL. Costs 2 credits.
+
+            Args:
+                url: Full URL of the Reddit post.
+            """
+            return _run(lambda: client.reddit.post(url))
+        tools.append(scavio_reddit_post)
+
+    return tools

google_adk_scavio-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "google-adk-scavio"
+version = "0.1.0"
+description = "Scavio real-time search tools (Google, YouTube, Amazon, Walmart, Reddit) for Google ADK (Agent Development Kit)"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Scavio", email = "support@scavio.dev" }]
+keywords = ["google-adk", "adk", "agent-development-kit", "agents", "scavio", "search", "serp", "tavily-alternative"]
+dependencies = [
+    "google-adk>=1.0",
+    "scavio>=0.5.0",
+]
+
+[project.urls]
+Homepage = "https://scavio.dev"
+Repository = "https://github.com/scavio-ai/google-adk-scavio"
+Documentation = "https://scavio.dev/docs/google-adk"
+
+[project.optional-dependencies]
+test = ["pytest>=7.0"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["google_adk_scavio"]

google_adk_scavio-0.1.0/tests/test_tools.py

@@ -0,0 +1,145 @@
+"""Tests for google-adk-scavio. The Scavio SDK client is mocked; no key or network used,
+except the env-gated live test at the bottom."""
+
+import os
+
+import pytest
+
+import google_adk_scavio.tools as tools_mod
+from google_adk_scavio import create_scavio_tools
+
+ALL_TOOL_NAMES = {
+    "scavio_google_search",
+    "scavio_google_news",
+    "scavio_youtube_search",
+    "scavio_youtube_metadata",
+    "scavio_amazon_search",
+    "scavio_amazon_product",
+    "scavio_walmart_search",
+    "scavio_walmart_product",
+    "scavio_reddit_search",
+    "scavio_reddit_post",
+}
+
+
+class _Recorder:
+    def __init__(self, calls):
+        self._calls = calls
+
+    def __getattr__(self, method):
+        def _call(*args, **kwargs):
+            self._calls.append((method, args, kwargs))
+            return {"ok": True, "method": method, "args": args, "kwargs": kwargs}
+
+        return _call
+
+
+class _FakeClient:
+    def __init__(self, *args, **kwargs):
+        self.calls = []
+        for ns in ("google", "youtube", "amazon", "walmart", "reddit"):
+            setattr(self, ns, _Recorder(self.calls))
+
+
+class _RaisingClient:
+    def __init__(self, *args, **kwargs):
+        class _Boom:
+            def __getattr__(self, method):
+                def _call(*a, **kw):
+                    raise RuntimeError("scavio exploded")
+
+                return _call
+
+        for ns in ("google", "youtube", "amazon", "walmart", "reddit"):
+            setattr(self, ns, _Boom())
+
+
+def _build(monkeypatch, **kwargs):
+    monkeypatch.setattr(tools_mod, "ScavioClient", _FakeClient)
+    return create_scavio_tools(api_key="test", **kwargs)
+
+
+def _get(tools, name):
+    return next(t for t in tools if t.__name__ == name)
+
+
+def test_all_tools_register(monkeypatch):
+    tools = _build(monkeypatch)
+    names = [t.__name__ for t in tools]
+    assert len(names) == len(set(names)) == 10
+    assert set(names) == ALL_TOOL_NAMES
+
+
+def test_provider_gating(monkeypatch):
+    tools = _build(
+        monkeypatch,
+        enable_google=False,
+        enable_youtube=False,
+        enable_amazon=False,
+        enable_walmart=False,
+        enable_reddit=True,
+    )
+    assert {t.__name__ for t in tools} == {"scavio_reddit_search", "scavio_reddit_post"}
+
+
+def test_google_search_sends_gl_hl(monkeypatch):
+    g = _get(_build(monkeypatch), "scavio_google_search")
+    out = g("ai agents", gl="fr", hl="fr")
+    assert isinstance(out, dict)
+    assert out["method"] == "search"
+    assert out["args"] == ("ai agents",)
+    assert out["kwargs"] == {"gl": "fr", "hl": "fr"}
+
+
+def test_google_search_drops_none(monkeypatch):
+    g = _get(_build(monkeypatch), "scavio_google_search")
+    out = g("ai agents")
+    assert out["args"] == ("ai agents",)
+    assert out["kwargs"] == {}
+
+
+def test_google_news_sends_query_kwarg(monkeypatch):
+    n = _get(_build(monkeypatch), "scavio_google_news")
+    out = n("openai", gl="us")
+    assert out["method"] == "news"
+    assert out["args"] == ()
+    assert out["kwargs"] == {"query": "openai", "gl": "us"}
+
+
+def test_amazon_product_uses_asin(monkeypatch):
+    p = _get(_build(monkeypatch), "scavio_amazon_product")
+    out = p("B000000000")
+    assert out["method"] == "product"
+    assert out["args"] == ("B000000000",)
+
+
+def test_errors_wrapped_not_raised(monkeypatch):
+    monkeypatch.setattr(tools_mod, "ScavioClient", _RaisingClient)
+    tools = create_scavio_tools(api_key="test")
+    g = _get(tools, "scavio_google_search")
+    assert g("boom") == {"error": "scavio exploded"}
+
+
+def test_adk_function_tool_wraps(monkeypatch):
+    """ADK must be able to wrap every tool function as a FunctionTool."""
+    from google.adk.tools import FunctionTool
+
+    tools = _build(monkeypatch)
+    wrapped = [FunctionTool(t) for t in tools]
+    assert {w.name for w in wrapped} == ALL_TOOL_NAMES
+    assert all(w.description for w in wrapped)
+
+
+@pytest.mark.skipif("SCAVIO_API_KEY" not in os.environ, reason="requires live API key")
+def test_live_google_search():
+    """One live call against api.scavio.dev (set SCAVIO_API_KEY to run)."""
+    tools = create_scavio_tools(
+        enable_youtube=False, enable_amazon=False, enable_walmart=False, enable_reddit=False
+    )
+    g = _get(tools, "scavio_google_search")
+    out = g("scavio search api for ai agents", gl="us", hl="en")
+    assert "error" not in out, out.get("error")
+    assert out.get("organic_results"), out
+    first = out["organic_results"][0]
+    assert first["link"].startswith("http")
+    assert first["title"]