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/image_search.py
View on GitHub#!/usr/bin/env python3
"""Small Serper-compatible image-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_IMAGE_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('/')}/images"
key = _first_env(
"SN_PPT_IMAGE_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 image search.")
parser.add_argument("query", help="Image search query.")
parser.add_argument("--num", type=int, default=10, help="Maximum result count.")
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 _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("image-search endpoint returned a non-object response")
return data
def main() -> int:
args = _parser().parse_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": args.query,
"num": max(1, args.num),
"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("images")
if not isinstance(raw_items, list):
raw_items = data.get("results")
if not isinstance(raw_items, list):
raw_items = []
results = []
for item in raw_items:
if not isinstance(item, dict):
continue
page_url = str(item.get("link") or item.get("url") or "").strip()
results.append(
{
"title": str(item.get("title") or "").strip(),
"image_url": str(
item.get("imageUrl") or item.get("image_url") or ""
).strip(),
"page_url": page_url,
"thumbnail_url": str(item.get("thumbnailUrl") or "").strip(),
"source": str(item.get("source") or item.get("domain") or "").strip()
or (parse.urlparse(page_url).hostname or ""),
}
)
_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 |