SuperAPI AI Directory

qq-email-operator

Office & productivity

View repository

Updated 10-15 08:01

About this skill

QQ Mail Operation Skill
  • Author: Daniel Li
  • Copyright © Daniel Li. All rights reserved.

When to use this skill

  • Read QQ Mail inbox
  • Search emails from a specific sender/subject
  • Reply to emails (English/Chinese)
  • Send new emails
  • View email details (body, attachment information)

Prerequisites

  1. IMAP/SMTP service is enabled for QQ Mail
  2. Authorization code has been stored in pass:
    • pass show email/qq/<邮箱地址> or
    • pass show email/qq/<QQ号>

Server configuration

Protocol Server Port SSL
IMAP imap.qq.com 993 ✅
SMTP smtp.qq.com 465 ✅ SSL
SMTP smtp.qq.com 587 ✅ STARTTLS

Usage

1. Read recent emails

python3 ~/clawd/skills/qq-email-operator/scripts/qq_email.py list --account REDACTED_EMAIL --limit 10

2. Search for specific emails

python3 ~/clawd/skills/qq-email-operator/scripts/qq_email.py search --account REDACTED_EMAIL --from "vince@example.com"
python3 ~/clawd/skills/qq-email-operator/scripts/qq_email.py search --account REDACTED_EMAIL --subject "keyword"

3. Read email body

python3 ~/clawd/skills/qq-email-operator/scripts/qq_email.py read --account REDACTED_EMAIL --id 948

4. Reply to email

python3 ~/clawd/skills/qq-email-operator/scripts/qq_email.py reply \
  --account REDACTED_EMAIL \
  --id 948 \
  --body "Your reply text here" \
  --sender-name "Daniel Li"

5. Send new email

python3 ~/clawd/skills/qq-email-operator/scripts/qq_email.py send \
  --account REDACTED_EMAIL \
  --to "recipient@example.com" \
  --subject "Subject" \
  --body "Email body" \
  --sender-name "Daniel Li"

Trigger words

  • "View QQ Mail"
  • "Read QQ emails"
  • "Reply to QQ emails"
  • "Send QQ email"
  • "Search QQ emails"
  • "QQ Mail operation"
  • "reply to email"
  • "send email via QQ"

Security policy

Operation Permission
Read email list 🟢 Automatic
Read email body 🟢 Automatic
Search emails 🟢 Automatic
Reply to email 🟡 Confirmation required
Send new email 🟡 Confirmation required
Delete email 🔴 Prohibited

Configured accounts

Email pass path Status
REDACTED_EMAIL email/qq/2067089451 ✅ Verified

Notes

  • Authorization code ≠ QQ password; it must be generated separately in QQ Mail settings
  • Connecting to QQ Mail from overseas servers may require a proxy
  • For SMTP sending, port 465 (SSL) is recommended
  • Replies automatically set the In-Reply-To and References headers to maintain the email thread