qq-zone-photo

📸 QQ Zone Album Manager

An automated management tool for QQ Zone albums, supporting QR code login, album browsing, photo upload/download, album creation, and other features.

---

🤖 Agent Workflow Examples

Scenario 1: Back up a specified album

用户: "帮我备份 QQ空间的旅行相册"

Scenario 2: Upload photos to a specified album

用户: "把桌面上的 vacation.jpg 上传到我的旅行相册"

Scenario 3: Full backup of all albums

用户: "帮我把 QQ空间所有相册都下载下来"

Scenario 4: Create an album and upload multiple photos

用户: "创建一个叫'2024毕业季'的相册，把这几张照片传上去"

---

📋 AI Agent Calling Guide

Before calling this Skill, the AI Agent must ensure the virtual environment is activated and cookies.json is valid. All command formats:

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

Action Overview

Action	Description	Required Parameters	Optional Parameters
login	QR code login, automatically saves Cookie	--cookies	—
list	List all albums	--cookies	--qq
photos	Browse photos in an album	--album-id --cookies	--qq
upload	Upload photos to an album	--photo --cookies	--album-id --qq
download	Download a single photo	--url --cookies	--output
download-album	Download an entire album	--album-id --cookies	--output --qq
create	Create a new album	--title --cookies	--desc --qq

Calling Examples

# 扫码登录
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

---

⚙️ Configuration

Cookie File Format

Create cookies.json, with the following structure:

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

How to Obtain

• Recommended: Use --action login for QR code login, Cookie is saved automatically
• Manual: Log in to QQ Zone , then extract via browser developer tools (F12 → Application → Cookies)

---

🔒 Security and Privacy

• The Cookie file contains full access permissions for QQ Zone,do not leak or share it
• Credentials are stored locally only and will not be uploaded to any server
• Session Cookies have an expiration time and require re-login after expiration
• This tool uses the unofficial QQ Zone API, and may need adaptation after Tencent updates the interface