Flickr Claw

使用捆绑脚本进行Flickr认证、导出、下载和元数据编辑。

安全与隐私

• - 本技能将Flickr凭证和OAuth令牌保存在本地机器上。
• 捆绑脚本仅与官方Flickr OAuth和REST端点通信。
• 本技能本身不会将Flickr凭证、令牌、相册数据或照片元数据发送给任何第三方服务。
• 在信任该脚本之前，请先审查捆绑的Python脚本，特别是在使用具有写入权限的令牌之前。

前提条件

使用本技能前需准备以下内容：

• - 用户自己的Flickr应用提供的Flickr API密钥和密钥
• Python
• requests-oauthlib
• 本地凭证文件 ~/.openclaw/flickr-app-credentials.json

安装Python依赖：

bash
pip install requests-oauthlib

凭证文件格式：

json
{
apikey: YOURFLICKRAPIKEY,
apisecret: YOURFLICKRAPISECRET
}

快速开始

从工作区根目录运行：

跨平台形式

bash
python skills/flickr-claw/scripts/flickr_skill.py --check-auth
python skills/flickr-claw/scripts/flickr_skill.py --list-albums
python skills/flickr-claw/scripts/flickrskill.py --album-photos --album-id ALBUMID --out ./flickralbumphotos.csv

Windows PowerShell形式

powershell
python .\skills\flickr-claw\scripts\flickr_skill.py --check-auth
python .\skills\flickr-claw\scripts\flickr_skill.py --list-albums
python .\skills\flickr-claw\scripts\flickrskill.py --album-photos --album-id ALBUMID --out .\flickralbumphotos.csv

如果 --check-auth 因缺少凭证或令牌而失败，请使用 references/workflow.md 中的授权流程。

工作流程

1. 1. 确认 ~/.openclaw/flickr-app-credentials.json 中存在凭证。
2. 在执行较大操作前先运行 --check-auth。
3. 使用 --list-albums 查找所需的相册/照片集ID。
4. 当需要从特定相册而不是最近上传的照片中操作时，使用 --album-photos 或 --download-album。
5. 仅用于导出操作时使用只读令牌。
6. 编辑标签、标题或描述时使用写入令牌。
7. 除非需要完全替换，否则优先使用 --add-tags 而非 --set-tags。
8. 在实际查看图片前使用 --download-latest 或 --download-album。
9. 在添加标签/审查后删除本地下载的图片副本，除非用户明确要求保留。
10. 写入操作后偶尔会遇到Flickr界面延迟；可通过API验证或稍后刷新确认。

元数据指南

• - 除非要求清理，否则保留有用的现有位置和事件标签。
• 当用户需要实际图像理解时，通过真实图像审查添加主题/内容标签。
• 保持标签具体且可搜索：主题、场景、材质、环境、光线、地点。
• 避免推测性标签。
• 除非用户要求不同风格，否则优先使用简短描述性标题和简单事实性描述。

命令

检查认证

bash
python skills/flickr-claw/scripts/flickr_skill.py --check-auth

列出相册

bash
python skills/flickr-claw/scripts/flickr_skill.py --list-albums

导出相册中的照片

bash
python skills/flickr-claw/scripts/flickrskill.py --album-photos --album-id ALBUMID --out ./flickralbumphotos.csv

下载相册用于本地审查

bash
python skills/flickr-claw/scripts/flickrskill.py --download-album --album-id ALBUMID --out-dir ./flickr-album-downloads

开始写入认证

bash
python skills/flickr-claw/scripts/flickr_skill.py --start-auth --perms write

完成认证

bash
python skills/flickr-claw/scripts/flickr_skill.py --finish-auth --verifier CODE

审计最近上传

bash
python skills/flickr-claw/scripts/flickrskill.py --audit --days 30 --out ./flickrrecentuploadsaudit.csv

下载最新图片用于本地审查

bash
python skills/flickr-claw/scripts/flickr_skill.py --download-latest --count 10 --days 30 --out-dir ./flickr-latest-downloads

为照片添加标签

bash
python skills/flickr-claw/scripts/flickrskill.py --add-tags --photo-id PHOTOID --tags harbor, waterfront, blue-sky

替换照片的所有标签

bash
python skills/flickr-claw/scripts/flickrskill.py --set-tags --photo-id PHOTOID --tags harbor waterfront cityscape

仅设置标题

bash
python skills/flickr-claw/scripts/flickrskill.py --set-title --photo-id PHOTOID --title Urban waterfront scene

仅设置描述

bash
python skills/flickr-claw/scripts/flickrskill.py --set-description --photo-id PHOTOID --description View across an urban waterfront with clear weather and industrial details.

同时设置标题和描述

bash
python skills/flickr-claw/scripts/flickrskill.py --set-meta --photo-id PHOTOID --title Urban waterfront scene --description View across an urban waterfront with clear weather and industrial details.

发布范围

包含：

• - 认证流程
• 认证验证
• 相册列表/导出/下载
• 最近上传审计导出
• 最近图片下载
• 标签/标题/描述编辑

排除：

• - 真实的API密钥或密钥
• OAuth令牌
• 请求令牌文件
• 用户特定的审计CSV、清单或下载的图片
• 当通用示例可用时的账户特定示例

资源

• - scripts/flickr_skill.py — Flickr辅助脚本，支持认证、验证、相册/最近导出、下载和元数据编辑。
• references/workflow.md — 设置详情和命令示例。