OpenSenseNova/SenseNova-Skills / skills/sn-ppt-tools
sn-ppt-tools
VerifiedUse when another PPT Skill needs web search, image search or download, or image generation and the host Agent's equivalent native capability is absent or has failed.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 3.0 KB |
| references/capability-policy.md | markdown | 2.9 KB |
| scripts/env_config.py | script | 2.6 KB |
| scripts/fetch_image.py | script | 4.5 KB |
| scripts/image_generate.py | script | 8.5 KB |
| scripts/image_search.py | script | 4.4 KB |
| scripts/web_search.py | script | 5.3 KB |
scripts/web_search.py
View on GitHub#!/usr/bin/env python3
"""Small Serper-compatible web-search fallback for the PPT Skill family."""
from __future__ import annotations
import argparse
import json
import os
from typing import Any
from urllib import error, parse, request
from env_config import load_ppt_env
DEFAULT_BASE_URL = "https://google.serper.dev"
DEFAULT_TIMEOUT_SECONDS = 30
ENV_LOAD = load_ppt_env()
def _first_env(*names: str) -> str:
for name in names:
value = os.environ.get(name, "").strip()
if value:
return value
return ""
def _emit(status: str, **payload: Any) -> None:
print(json.dumps({"status": status, "provider": "bundled", **payload}, ensure_ascii=False))
def _valid_url(value: str) -> bool:
parsed = parse.urlparse(value)
return parsed.scheme in {"http", "https"} and bool(parsed.netloc)
def _configuration() -> tuple[str, str]:
explicit_url = _first_env("SN_PPT_WEB_SEARCH_URL")
if explicit_url:
url = explicit_url
else:
base = _first_env("SN_PPT_SEARCH_BASE_URL", "SERPER_BASE_URL") or DEFAULT_BASE_URL
url = f"{base.rstrip('/')}/search"
key = _first_env(
"SN_PPT_WEB_SEARCH_API_KEY",
"SN_PPT_SEARCH_API_KEY",
"SERPER_API_KEY",
)
return url, key
def _parser() -> argparse.ArgumentParser:
parser = argparse.ArgumentParser(description="Run bundled PPT web search.")
parser.add_argument("query", nargs="?", help="Search query.")
parser.add_argument(
"--query",
dest="query_option",
help="Alias for the positional query.",
)
parser.add_argument("--num", type=int, default=None, help="Maximum result count.")
parser.add_argument("--count", type=int, default=None, help="Alias for --num.")
parser.add_argument("--page", type=int, default=1, help="Search result page.")
parser.add_argument("--gl", default="", help="Optional country bias.")
parser.add_argument("--hl", default="", help="Optional language bias.")
return parser
def _resolved_query_and_num(
parser: argparse.ArgumentParser,
args: argparse.Namespace,
) -> tuple[str, int]:
query_values = [
value.strip()
for value in (args.query, args.query_option)
if value and value.strip()
]
if not query_values:
parser.error("a query is required (positional QUERY or --query QUERY)")
if len(set(query_values)) > 1:
parser.error("positional QUERY and --query must match when both are provided")
if args.num is not None and args.count is not None and args.num != args.count:
parser.error("--num and --count must match when both are provided")
result_count = args.num if args.num is not None else args.count
return query_values[0], 10 if result_count is None else result_count
def _post(url: str, key: str, payload: dict[str, Any]) -> dict[str, Any]:
body = json.dumps(payload).encode("utf-8")
req = request.Request(
url,
data=body,
headers={"Content-Type": "application/json", "X-API-KEY": key},
method="POST",
)
timeout = float(
os.environ.get("SN_PPT_TOOL_TIMEOUT_SECONDS", str(DEFAULT_TIMEOUT_SECONDS))
)
with request.urlopen(req, timeout=timeout) as response:
raw = response.read().decode("utf-8", errors="replace")
data = json.loads(raw)
if not isinstance(data, dict):
raise ValueError("search endpoint returned a non-object response")
return data
def main(argv: list[str] | None = None) -> int:
parser = _parser()
args = parser.parse_args(argv)
query, result_count = _resolved_query_and_num(parser, args)
url, key = _configuration()
missing = []
if not key:
missing.append("api_key")
if not _valid_url(url):
missing.append("url")
if missing:
_emit("unavailable", reason="missing or invalid configuration", missing=missing)
return 2
payload: dict[str, Any] = {
"q": query,
"num": max(1, result_count),
"page": max(1, args.page),
}
if args.gl:
payload["gl"] = args.gl
if args.hl:
payload["hl"] = args.hl
try:
data = _post(url, key, payload)
raw_items = data.get("organic")
if not isinstance(raw_items, list):
raw_items = []
results = []
for item in raw_items:
if not isinstance(item, dict):
continue
result_url = str(item.get("link") or "").strip()
results.append(
{
"title": str(item.get("title") or "").strip(),
"url": result_url,
"source": str(item.get("source") or "").strip()
or (parse.urlparse(result_url).hostname or ""),
"snippet": str(item.get("snippet") or "").strip(),
"date": str(item.get("date") or "").strip(),
}
)
_emit("ok", results=results, count=len(results))
return 0
except error.HTTPError as exc:
detail = exc.read().decode("utf-8", errors="replace")[:500]
_emit("failed", reason=f"HTTP {exc.code}", detail=detail)
except (error.URLError, TimeoutError, json.JSONDecodeError, ValueError, OSError) as exc:
_emit("failed", reason=type(exc).__name__, detail=str(exc)[:500])
return 1
if __name__ == "__main__":
raise SystemExit(main())
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |