Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
bighardperson avatar

Qq Zone Photo

  • 8 installs
  • 33 repo stars
  • Updated April 26, 2026
  • bighardperson/computer-science-skills-collection

qq-zone-photo is a Claude skill that manages QQ Zone photo albums (list, browse, upload, download, create) through a Python CLI.

About

This skill automates QQ Zone photo-album management through a Python CLI script. A developer uses it when a user wants to back up, download, upload, or organize photos in their QZone albums. It logs in by QR code and drives seven actions over the unofficial QZone API.

  • Manages QZone (QQ Zone) photo albums: list, browse, upload, download, and create albums
  • Authenticates via QR-code login that auto-saves cookies to cookies.json
  • Uses an unofficial QZone API that may need adapting when Tencent changes endpoints

Qq Zone Photo by the numbers

  • 8 all-time installs (skills.sh)
  • Ranked #1,522 of 2,719 Automation & Workflows skills by installs in the Skillselion catalog
  • Data as of Jul 30, 2026 (Skillselion catalog sync)
At a glance

qq-zone-photo capabilities & compatibility

Free; requires QQ session cookies (QR-code login), no API key

Use cases
web scraping
Runs
Runs locally
Pricing
Free
From the docs

What qq-zone-photo says it does

QQ空间相册的自动化管理工具,支持扫码登录、相册浏览、照片上传/下载、相册创建等功能。
SKILL.md
npx skills add https://github.com/bighardperson/computer-science-skills-collection --skill qq-zone-photo

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs8
repo stars33
Last updatedApril 26, 2026
Repositorybighardperson/computer-science-skills-collection

What it does

Back up, upload, download, and organize photos across QQ Zone albums via a QR-login CLI.

When should I use this skill?

User asks to back up, download, upload, browse, or create QQ Zone photo albums.

What you get

  • Downloaded photo/album files
  • Newly created albums
  • Uploaded photos

By the numbers

  • 7 CLI actions (login, list, photos, upload, download, download-album, create)

Files

SKILL.mdMarkdownGitHub ↗

📸 QQ空间相册管理器

QQ空间相册的自动化管理工具,支持扫码登录、相册浏览、照片上传/下载、相册创建等功能。

---

🤖 Agent 工作流示例

场景一:备份指定相册
用户: "帮我备份 QQ空间的旅行相册"
场景二:上传照片到指定相册
用户: "把桌面上的 vacation.jpg 上传到我的旅行相册"
场景三:全量备份所有相册
用户: "帮我把 QQ空间所有相册都下载下来"
场景四:创建相册并上传多张照片
用户: "创建一个叫'2024毕业季'的相册,把这几张照片传上去"

![](./image/image3.png) ![](./image/image4.png) ![](./image/image5.png)

---

📋 AI Agent 调用指南

AI Agent 在调用本 Skill 前,需确保虚拟环境已激活且 cookies.json 有效。所有命令格式:

source <项目路径>/.venv/bin/activate && python3 <项目路径>/scripts/qzone_photos.py --action <ACTION> [参数]

Action 一览

Action说明必填参数可选参数
login扫码登录,自动保存 Cookie--cookies
list列出所有相册--cookies--qq
photos浏览相册中的照片--album-id --cookies--qq
upload上传照片到相册--photo --cookies--album-id --qq
download下载单张照片--url --cookies--output
download-album下载整个相册--album-id --cookies--output --qq
create创建新相册--title --cookies--desc --qq

调用示例

# 扫码登录
python3 scripts/qzone_photos.py --action login --cookies cookies.json

# 列出相册
python3 scripts/qzone_photos.py --action list --cookies cookies.json

# 浏览照片
python3 scripts/qzone_photos.py --action photos --album-id "ALBUM_ID" --cookies cookies.json

# 上传照片
python3 scripts/qzone_photos.py --action upload --photo "/path/to/image.jpg" --album-id "ALBUM_ID" --cookies cookies.json

# 下载整个相册
python3 scripts/qzone_photos.py --action download-album --album-id "ALBUM_ID" --output ./downloads --cookies cookies.json

# 创建新相册
python3 scripts/qzone_photos.py --action create --title "我的新相册" --cookies cookies.json

---

⚙️ 配置

Cookie 文件格式

创建 cookies.json,结构如下:

{
  "qq_number": "123456789",
  "p_skey": "your_p_skey_value",
  "skey": "your_skey_value",
  "uin": "o0123456789"
}

![](./image/image1.png) ![](./image/image2.png)

获取方式

  • 推荐:使用 --action login 扫码登录,Cookie 自动保存
  • 手动:登录 QQ空间 后,通过浏览器开发者工具(F12 → Application → Cookies)提取

---

🔒 安全与隐私

  • Cookie 文件包含 QQ空间完整访问权限,请勿泄露或分享
  • 凭证仅存储在本地,不会上传到任何服务器
  • 会话 Cookie 有时效性,过期后需重新登录
  • 本工具使用 QQ空间非官方 API,腾讯更新接口后可能需要适配

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.