SmugMug 相册管理
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_15292d5a/yjkj-oo-smugmug 技能。
技能介绍
要解决什么问题
如果你在写一个 Agent 工作流,需要读取 SmugMug 上的相册结构、图片元数据或用户公开资料,直接对接 SmugMug 官方 API 意味着你要自己处理 API Key 保管、请求签名、错误码映射和分页。更麻烦的是,凭证一旦暴露在客户端,泄露面就是整个工作流。这个技能的价值在于把凭证管理收敛到 OOMOL 服务端,Agent 侧只需要关心「我要什么数据」,不需要碰 token。
工作方式
技能通过 oo CLI 调用 SmugMug connector,OOMOL 在服务端注入凭据,客户端永远拿不到明文 token。共暴露 23 个动作,全部是读取类:从 get_album、get_folder_albums、get_image_metadata 到 get_user_root_node、list_child_nodes、search_user_content。
典型的调用路径分两步:先用 oo connector schema 拉取目标动作的 权威输入/输出 schema,避免凭猜构造 payload;再用 oo connector run 传入匹配的 JSON(支持 --data 传字符串或 @file.json),响应统一带 meta.executionId,方便日志追踪。
适用边界
- 只读:23 个动作全部是
get / list / search语义,没有任何写、改、删入口。如果你的工作流需要上传照片或修改相册,这个技能帮不了你。 - 前置条件:用户必须已装好
ooCLI 并完成 OOMOL 登录与 SmugMug 连接(API Key 方式),技能不会主动弹登录页,只在命令真的失败时才回退到首次配置提示。 - 额度:遇到
HTTP 402 / OOMOL_INSUFFICIENT_CREDIT说明 OOMOL 账户余额耗尽,需要去 console 充值后才能继续。
使用场景
- 内容平台工程师把客户 SmugMug 相册接入内部系统时,需要按 folder 路径列出其下所有相册与子相册。
- 摄影作品归档工具开发者想批量读取指定图片的可用尺寸与原始元数据,用于生成多分辨率缩略图。
- Agent 应用开发者在对话工作流中要展示某用户的公开资料和特色相册,并支持按关键词检索其图片。
- 媒体数据分析师做竞品调研时,需要拉取不同 SmugMug 用户的 root node 结构和亮点图片做对比。
适合人员
- 内容平台工程师,需要把客户在 SmugMug 的相册结构接入内部内容管理系统。
- 摄影网站后端开发者,要在作品归档流程中读取图片元数据和可用尺寸。
- Agent 应用开发者,想在对话中让用户浏览和检索其 SmugMug 相册。
- 媒体资产管理研究员,在做跨平台作品库对比时需要批量拉取用户公开资料。