arcade-scavio 0.1.0__tar.gz

arcade_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/*

arcade_scavio-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+dist/
+build/
+.eggs/
+*.egg
+.venv/
+.env
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.claude/
+.DS_Store

arcade_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.

arcade_scavio-0.1.0/PKG-INFO

@@ -0,0 +1,74 @@
+Metadata-Version: 2.4
+Name: arcade-scavio
+Version: 0.1.0
+Summary: Scavio real-time search tools (Google, Google News, Reddit, YouTube, Amazon) for Arcade.dev / MCP
+Project-URL: Homepage, https://scavio.dev
+Project-URL: Repository, https://github.com/scavio-ai/arcade-scavio
+Project-URL: Documentation, https://scavio.dev/docs/arcade
+Author-email: Scavio <support@scavio.dev>
+License: MIT
+License-File: LICENSE
+Keywords: arcade,arcade-ai,mcp,scavio,search,serp,tavily-alternative,tools
+Requires-Python: >=3.10
+Requires-Dist: arcade-mcp-server<2.0.0,>=1.17.4
+Requires-Dist: scavio>=0.5.0
+Provides-Extra: dev
+Requires-Dist: arcade-mcp[all]<2.0.0,>=1.11.2; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# arcade-scavio
+
+[Scavio](https://scavio.dev) real-time search tools for [Arcade.dev](https://arcade.dev) and MCP — Google, Google News, Reddit, YouTube, and Amazon, with one API key. A cost-effective [Tavily alternative](https://scavio.dev/docs) and [SerpAPI alternative](https://scavio.dev/docs) for Arcade agents.
+
+## Install
+
+```bash
+pip install arcade-scavio
+```
+
+## Tools
+
+An `arcade-mcp-server` toolkit exposing:
+
+| Tool | Description |
+|---|---|
+| `search_google` | Google SERP — real-time organic web results |
+| `search_news` | Google News — recent articles on a topic |
+| `search_reddit` | Reddit posts — community discussion and sentiment |
+| `search_youtube` | YouTube — videos |
+| `search_amazon` | Amazon — product listings |
+
+Each tool reads the `SCAVIO_API_KEY` secret, which Arcade injects securely at call time (the client and LLM never see the value).
+
+## Run standalone
+
+```bash
+export SCAVIO_API_KEY=sk_live_...   # get one at https://dashboard.scavio.dev
+python -m arcade_scavio.server          # stdio
+python -m arcade_scavio.server http     # HTTP+SSE
+```
+
+## Deploy to Arcade Cloud
+
+```bash
+arcade login
+arcade deploy
+```
+
+Arcade discovers the `SCAVIO_API_KEY` secret and hosts it encrypted; the Arcade Engine fulfils authorized tool calls for your users.
+
+## Every endpoint via MCP
+
+Need Walmart, TikTok, Instagram, Maps, Shopping, and more? Scavio also runs a hosted MCP server at [`mcp.scavio.dev`](https://scavio.dev/docs/mcp) with the full tool catalog.
+
+## About Scavio
+
+[Scavio](https://scavio.dev) is a real-time search API built for AI agents — a unified API over Google, YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram that returns clean JSON. A broader, cost-effective [Tavily alternative](https://scavio.dev/docs) and [SerpAPI alternative](https://scavio.dev/docs). See the [Arcade integration docs](https://scavio.dev/docs/arcade).
+
+## Links
+
+- Scavio: https://scavio.dev
+- Docs: https://scavio.dev/docs/arcade
+- Dashboard: https://dashboard.scavio.dev

arcade_scavio-0.1.0/README.md

@@ -0,0 +1,54 @@
+# arcade-scavio
+
+[Scavio](https://scavio.dev) real-time search tools for [Arcade.dev](https://arcade.dev) and MCP — Google, Google News, Reddit, YouTube, and Amazon, with one API key. A cost-effective [Tavily alternative](https://scavio.dev/docs) and [SerpAPI alternative](https://scavio.dev/docs) for Arcade agents.
+
+## Install
+
+```bash
+pip install arcade-scavio
+```
+
+## Tools
+
+An `arcade-mcp-server` toolkit exposing:
+
+| Tool | Description |
+|---|---|
+| `search_google` | Google SERP — real-time organic web results |
+| `search_news` | Google News — recent articles on a topic |
+| `search_reddit` | Reddit posts — community discussion and sentiment |
+| `search_youtube` | YouTube — videos |
+| `search_amazon` | Amazon — product listings |
+
+Each tool reads the `SCAVIO_API_KEY` secret, which Arcade injects securely at call time (the client and LLM never see the value).
+
+## Run standalone
+
+```bash
+export SCAVIO_API_KEY=sk_live_...   # get one at https://dashboard.scavio.dev
+python -m arcade_scavio.server          # stdio
+python -m arcade_scavio.server http     # HTTP+SSE
+```
+
+## Deploy to Arcade Cloud
+
+```bash
+arcade login
+arcade deploy
+```
+
+Arcade discovers the `SCAVIO_API_KEY` secret and hosts it encrypted; the Arcade Engine fulfils authorized tool calls for your users.
+
+## Every endpoint via MCP
+
+Need Walmart, TikTok, Instagram, Maps, Shopping, and more? Scavio also runs a hosted MCP server at [`mcp.scavio.dev`](https://scavio.dev/docs/mcp) with the full tool catalog.
+
+## About Scavio
+
+[Scavio](https://scavio.dev) is a real-time search API built for AI agents — a unified API over Google, YouTube, Amazon, Walmart, Reddit, TikTok, and Instagram that returns clean JSON. A broader, cost-effective [Tavily alternative](https://scavio.dev/docs) and [SerpAPI alternative](https://scavio.dev/docs). See the [Arcade integration docs](https://scavio.dev/docs/arcade).
+
+## Links
+
+- Scavio: https://scavio.dev
+- Docs: https://scavio.dev/docs/arcade
+- Dashboard: https://dashboard.scavio.dev

arcade_scavio-0.1.0/pyproject.toml

@@ -0,0 +1,36 @@
+[project]
+name = "arcade-scavio"
+version = "0.1.0"
+description = "Scavio real-time search tools (Google, Google News, Reddit, YouTube, Amazon) for Arcade.dev / MCP"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Scavio", email = "support@scavio.dev" }]
+keywords = ["arcade", "arcade-ai", "mcp", "scavio", "search", "serp", "tools", "tavily-alternative"]
+dependencies = [
+    "arcade-mcp-server>=1.17.4,<2.0.0",
+    "scavio>=0.5.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "arcade-mcp[all]>=1.11.2,<2.0.0",
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+]
+
+[project.urls]
+Homepage = "https://scavio.dev"
+Repository = "https://github.com/scavio-ai/arcade-scavio"
+Documentation = "https://scavio.dev/docs/arcade"
+
+# Tell Arcade.dev that this package ships Arcade tools
+[project.entry-points.arcade_toolkits]
+scavio = "arcade_scavio"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/arcade_scavio"]

arcade_scavio-0.1.0/src/arcade_scavio/__init__.py

@@ -0,0 +1,3 @@
+from arcade_scavio.server import app
+
+__all__ = ["app"]

arcade_scavio-0.1.0/src/arcade_scavio/server.py

@@ -0,0 +1,95 @@
+"""Scavio real-time search tools for Arcade.dev / MCP.
+
+Exposes Scavio's search across Google, Google News, Reddit, YouTube, and Amazon
+as Arcade tools. The Scavio API key is injected securely by Arcade at call time
+via the SCAVIO_API_KEY secret (the client and LLM never see it).
+
+Run standalone:
+    uv run server.py            # stdio
+    uv run server.py http       # HTTP+SSE
+
+Or deploy to Arcade Cloud with `arcade deploy`.
+"""
+
+from typing import Annotated, Any
+
+from arcade_mcp_server import Context, MCPApp
+from scavio import AsyncScavioClient
+
+app = MCPApp(name="scavio", version="0.1.0")
+
+
+def _client(context: Context) -> AsyncScavioClient:
+    return AsyncScavioClient(api_key=context.get_secret("SCAVIO_API_KEY"))
+
+
+def _nested(data: dict[str, Any], key: str) -> list:
+    inner = data.get("data")
+    if isinstance(inner, dict) and isinstance(inner.get(key), list):
+        return inner[key]
+    return data.get(key) if isinstance(data.get(key), list) else []
+
+
+@app.tool(requires_secrets=["SCAVIO_API_KEY"])
+async def search_google(
+    context: Context,
+    query: Annotated[str, "The search query"],
+    max_results: Annotated[int, "Maximum number of results"] = 10,
+) -> Annotated[list[dict], "Organic results (title, link, snippet)"]:
+    """Search Google in real time with Scavio and return organic results."""
+    async with _client(context) as client:
+        data = await client.google.search(query)
+    return data.get("organic_results", [])[:max_results]
+
+
+@app.tool(requires_secrets=["SCAVIO_API_KEY"])
+async def search_news(
+    context: Context,
+    query: Annotated[str, "The news search query"],
+    max_results: Annotated[int, "Maximum number of results"] = 10,
+) -> Annotated[list[dict], "Google News results"]:
+    """Search Google News for recent articles on a topic with Scavio."""
+    async with _client(context) as client:
+        data = await client.google.news(query=query)
+    results = data.get("news_results") or data.get("results") or []
+    return results[:max_results]
+
+
+@app.tool(requires_secrets=["SCAVIO_API_KEY"])
+async def search_reddit(
+    context: Context,
+    query: Annotated[str, "The Reddit search query"],
+    max_results: Annotated[int, "Maximum number of results"] = 10,
+) -> Annotated[list[dict], "Reddit posts"]:
+    """Search Reddit posts for community discussion and sentiment with Scavio."""
+    async with _client(context) as client:
+        data = await client.reddit.search(query)
+    return _nested(data, "posts")[:max_results]
+
+
+@app.tool(requires_secrets=["SCAVIO_API_KEY"])
+async def search_youtube(
+    context: Context,
+    query: Annotated[str, "The video search query"],
+    max_results: Annotated[int, "Maximum number of results"] = 10,
+) -> Annotated[list[dict], "YouTube videos"]:
+    """Search YouTube for videos with Scavio."""
+    async with _client(context) as client:
+        data = await client.youtube.search(query)
+    return _nested(data, "results")[:max_results]
+
+
+@app.tool(requires_secrets=["SCAVIO_API_KEY"])
+async def search_amazon(
+    context: Context,
+    query: Annotated[str, "The product search query"],
+    max_results: Annotated[int, "Maximum number of results"] = 10,
+) -> Annotated[list[dict], "Amazon products"]:
+    """Search Amazon product listings with Scavio."""
+    async with _client(context) as client:
+        data = await client.amazon.search(query)
+    return _nested(data, "products")[:max_results]
+
+
+if __name__ == "__main__":
+    app.run(transport="stdio")