nexscope-ai/nexscope-ecommerce-skills / ecommerce-multimodal-recognize-image
ecommerce.multimodal-recognize-image
VerifiedAnalyze and extract information from images using multimodal AI recognition. Triggered when users want to analyze, describe, or extract information from an image URL — image recognition, image analysis, image description, visual content understanding, OCR text recognition, or visual Q&A. When a user provides an image URL and asks questions about its visual content, this skill should be triggered even if they do not explicitly say "image recognition."
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.0 KB |
| manifest.json | config | 467 B |
| references/api.md | markdown | 5.2 KB |
| scripts/multimodal_recognize_image.py | script | 6.2 KB |
| scripts/upload_image.py | script | 9.6 KB |
scripts/multimodal_recognize_image.py
View on GitHub#!/usr/bin/env python3
"""Standard-library proxy client for /multimodal/recognizeImage.
Usage:
python multimodal_recognize_image.py '<JSON parameters>'
python multimodal_recognize_image.py '<JSON parameters>' --inline # force full stdout output
python multimodal_recognize_image.py '<JSON parameters>' --no-cache # skip local cache
"""
import hashlib
import json
import os
import sys
import time
from urllib.error import HTTPError, URLError
from urllib.request import Request, urlopen
API_PATH = '/api/v1/tools/research/multimodal/recognizeImage'
SLUG = 'ecommerce.multimodal-recognize-image'
SMALL_THRESHOLD = 8000
CACHE_TTL_SEC = 24 * 60 * 60
def _cache_key(params):
raw = json.dumps(params, ensure_ascii=False, sort_keys=True)
return hashlib.sha256(raw.encode("utf-8")).hexdigest()[:16]
def _cache_path(params):
d = os.path.join(os.getcwd(), "nexscope", ".cache", SLUG)
os.makedirs(d, exist_ok=True)
return os.path.join(d, "{}-{}.json".format(SLUG, _cache_key(params)))
def load_cache(params):
p = _cache_path(params)
if not os.path.isfile(p):
return None
if time.time() - os.path.getmtime(p) > CACHE_TTL_SEC:
return None
try:
with open(p, encoding="utf-8") as f:
payload = json.load(f)
if isinstance(payload, dict):
payload.setdefault("_cache", {})["hit"] = True
return payload
except (OSError, json.JSONDecodeError):
return None
def save_cache(params, payload):
try:
with open(_cache_path(params), "w", encoding="utf-8") as f:
json.dump(payload, f, ensure_ascii=False, indent=2)
except OSError:
pass
def _nexscope_root():
for cand in [
os.path.join(os.getcwd(), "nexscope"),
os.path.join(os.path.expanduser("~"), "nexscope"),
]:
try:
os.makedirs(cand, exist_ok=True)
probe = os.path.join(cand, ".w")
open(probe, "w").close()
os.remove(probe)
return os.path.abspath(cand)
except OSError:
continue
import tempfile
return os.path.join(tempfile.gettempdir(), "nexscope")
def resolve_output(ts=None):
if ts is None:
ts = time.time()
date_str = time.strftime("%Y-%m-%d", time.localtime(ts))
sid = os.environ.get("SESSION_ID", "").strip() or time.strftime("%H%M%S", time.localtime(ts))
root = _nexscope_root()
session_dir = os.path.join(root, date_str, sid, "data")
os.makedirs(session_dir, exist_ok=True)
fname = "{}-{}.json".format(SLUG, int(ts * 1_000_000))
return os.path.join(session_dir, fname)
def _find_longest_list(obj, prefix=""):
best = (None, -1, None)
if isinstance(obj, list):
return (prefix, len(obj), obj)
if isinstance(obj, dict):
for k, v in obj.items():
p = "{}.{}".format(prefix, k) if prefix else k
c = _find_longest_list(v, p)
if c[1] > best[1]:
best = c
return best
def summarize(result):
if not isinstance(result, dict):
print("Response type: {}".format(type(result).__name__))
print(json.dumps(result, ensure_ascii=False)[:500])
return
print("Top-level keys: {}".format(list(result.keys())))
for k in ("errcode", "code", "errmsg", "msg", "total", "count", "costToken", "costTime"):
if k in result:
v = result[k]
if isinstance(v, (int, float, bool, str)):
print(" {}: {}".format(k, v))
path, n, lst = _find_longest_list(result)
if path and lst:
print()
print("Longest list: `{}` ({} items)".format(path, n))
print("First {}:".format(min(3, n)))
print(json.dumps(lst[:3], indent=2, ensure_ascii=False))
def call_api(params):
base = os.environ.get("NEXSCOPE_PROXY_BASE", "").strip()
key = os.environ.get("NEXSCOPE_API_KEY", "").strip()
if not base or not key:
raise SystemExit("NEXSCOPE_PROXY_BASE and NEXSCOPE_API_KEY are required")
body = json.dumps(params, ensure_ascii=False).encode("utf-8")
request = Request(base.rstrip("/") + API_PATH, data=body, method="POST", headers={
"Authorization": "Bearer " + key,
"Content-Type": "application/json",
"Accept": "application/json",
})
try:
with urlopen(request, timeout=120) as response:
return json.loads(response.read().decode("utf-8"))
except HTTPError as error:
raw = error.read().decode("utf-8", errors="replace") if error.fp else ""
try:
return json.loads(raw)
except ValueError:
return {"error": "HTTP {}: {}".format(error.code, error.reason), "details": raw}
except URLError as error:
return {"error": "Connection failed: {}".format(error.reason)}
def main():
argv = sys.argv[1:]
inline = False
use_cache = True
opts = []
for a in argv:
if a == "--inline":
inline = True
elif a == "--no-cache":
use_cache = False
else:
opts.append(a)
if len(opts) < 1:
print("Usage: {} '<JSON params>' [--inline] [--no-cache]".format(sys.argv[0]), file=sys.stderr)
sys.exit(1)
try:
params = json.loads(opts[0])
except json.JSONDecodeError as e:
print("Invalid JSON: {}".format(e), file=sys.stderr)
sys.exit(1)
if not isinstance(params, dict):
sys.exit("Params must be JSON object")
result = load_cache(params) if use_cache else None
if result is None:
result = call_api(params)
if use_cache:
save_cache(params, result)
serialized = json.dumps(result, ensure_ascii=False)
out_path = resolve_output()
try:
with open(out_path, "w", encoding="utf-8") as f:
f.write(json.dumps(result, ensure_ascii=False, indent=2))
print("Saved full response: {} ({} bytes)".format(out_path, len(serialized)))
if result.get("_cache", {}).get("hit"):
print("Cache hit")
except OSError as e:
print("Failed to save to {}: {}".format(out_path, e), file=sys.stderr)
if inline or len(serialized.encode("utf-8")) <= SMALL_THRESHOLD:
print(serialized)
else:
summarize(result)
if __name__ == "__main__":
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: 471k | 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 |