← 返回 Skills 市场
dennisooki

OpenSubtitles Read-only

作者 Magolo Dennis Ooki · GitHub ↗ · v1.0.4
cross-platform ✓ 安全检测通过
411
总下载
0
收藏
0
当前安装
4
版本数
在 OpenClaw 中安装
/install opensubtitles
功能描述
Read-only OpenSubtitles skill to search and download subtitles via API, then extract scene context by timestamp to answer user questions regarding a show in...
安全使用建议
This skill appears to do what it claims: it calls the OpenSubtitles API, optionally logs in to obtain a token for downloads, saves .srt files to a local cache, and extracts subtitle text around a timestamp. Before installing: (1) Understand that the skill needs your OPENSUBTITLES_API_KEY and a User-Agent string — treat the API key like any sensitive credential and don't share it; (2) if you plan to use downloads, you may need to supply username/password or a token — those are only required for login/download and are optional otherwise; (3) the scripts will create and read files under {baseDir}/storage/subtitles — ensure you are comfortable with subtitle files being stored there; (4) ensure awk is available on systems that will run subtitle-context.sh (the top-level check in one script omitted awk); (5) although this is read-only and enforces a storage-directory check to avoid arbitrary file reads, follow the guardrails (don’t log keys, don’t share tokens). If you want extra assurance, inspect/run the included scripts in a restricted environment (or review their output on a single test query) before granting the API key to an agent.
功能分析
Type: OpenClaw Skill Name: opensubtitles Version: 1.0.4 This OpenClaw skill bundle is benign. The `SKILL.md` provides clear guardrails for the AI agent, explicitly instructing it to avoid arbitrary file access and prevent logging/exposing sensitive credentials. The `opensubtitles-api.sh` script safely constructs API requests using `jq` for URL and JSON encoding, mitigating shell injection risks. Crucially, `subtitle-context.sh` implements robust path validation, ensuring that subtitle files are only read from the designated `{baseDir}/storage/subtitles/` directory and have a `.srt` extension, preventing arbitrary file reads. There is no evidence of malicious intent, data exfiltration, or unauthorized actions.
能力评估
Purpose & Capability
Name/description (OpenSubtitles read-only subtitle search/download and context extraction) match the required binaries (curl, jq, awk), the declared environment variables (API key and User-Agent), and the included scripts which call the OpenSubtitles API and extract .srt context. Optional credentials (username/password/token) are appropriate for login/download flows.
Instruction Scope
SKILL.md and the scripts keep behavior within the stated scope: API calls only target the OpenSubtitles endpoints, downloads are saved to a localized cache, subtitle reads are constrained to the storage directory, and guardrails explicitly forbid logging/exposing secrets. The agent instructions do ask it to append remaining download quota to user responses (a UI/response behavior, not an exfiltration risk).
Install Mechanism
This is an instruction-only skill with shell scripts included; there is no install spec that downloads or executes external code. No high-risk installation behavior detected.
Credentials
Requested env vars (OPENSUBTITLES_API_KEY and OPENSUBTITLES_USER_AGENT) are proportional and expected. Optional login creds/token are reasonable for download flows. Minor inconsistency: SKILL metadata lists awk as a required binary, and subtitle-context.sh uses awk, but the API script's internal dependency check only verifies curl and jq (it omits awk). This is an implementation oversight but not a malign issue.
Persistence & Privilege
The skill does not request always:true or any elevated platform privileges. It stores downloaded subtitles under its own storage path as expected and does not modify other skills or global configuration.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install opensubtitles
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /opensubtitles 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.4
Nomenclature updates
v1.0.3
Security enhancement-stricter read paths for subtitles enforced
v1.0.1
Updated nomenclature and description
v1.0.0
Initial release
元数据
Slug opensubtitles
版本 1.0.4
许可证
累计安装 0
当前安装数 0
历史版本数 4
常见问题

OpenSubtitles Read-only 是什么?

Read-only OpenSubtitles skill to search and download subtitles via API, then extract scene context by timestamp to answer user questions regarding a show in... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 411 次。

如何安装 OpenSubtitles Read-only?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install opensubtitles」即可一键安装,无需额外配置。

OpenSubtitles Read-only 是免费的吗?

是的,OpenSubtitles Read-only 完全免费(开源免费),可自由下载、安装和使用。

OpenSubtitles Read-only 支持哪些平台?

OpenSubtitles Read-only 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 OpenSubtitles Read-only?

由 Magolo Dennis Ooki(@dennisooki)开发并维护,当前版本 v1.0.4。

💬 留言讨论