qqmail-1.0.0

Name: qqmail-1.0.0
Author: virgo777

311stars25forks

How to install qqmail-1.0.0?

virgo777/buddyme/qqmail-1.0.0

$npx -y skills add virgo777/buddyme --skill qqmail-1.0.0

Installs into the current project.

Summary

Manage QQ Mail (QQ邮箱) via IMAP/SMTP. Use when the user wants to read, send, search, or manage emails from their QQ mailbox. Supports reading inbox, sending emails with attachments, searching by subject/sender/date, and listing folders.

Files · 1

View on GitHub

SKILL.md

1	# QQ Mail Manager
2
3	Manage QQ邮箱 via standard IMAP/SMTP protocols using Python scripts.
4
5	## Prerequisites
6
7	The user must enable IMAP/SMTP in QQ Mail settings and obtain an authorization code (授权码):
8	1. Log in to mail.qq.com → Settings (设置) → Account (账户)
9	2. Enable IMAP/SMTP service
10	3. Generate an authorization code (授权码) — this is NOT the QQ password
11
12	## Configuration
13
14	The skill reads credentials from environment variables:
15	- `QQMAIL_USER` — 5847713@qq.com
16	- `QQMAIL_AUTH_CODE` — jyzviigffggncbbg
17
18	## Available Operations
19
20	### Read recent emails
21	```bash
22	python3 {baseDir}/scripts/qqmail.py inbox --limit 10
23	```
24	Shows: sender, subject, date, and a text preview of each email.
25
26	### Read a specific email by index
27	```bash
28	python3 {baseDir}/scripts/qqmail.py read --index 1
29	```
30	Shows the full email content (text body).
31
32	### Send an email
33	```bash
34	python3 {baseDir}/scripts/qqmail.py send --to "recipient@example.com" --subject "Hello" --body "Email content here"
35	```
36
37	### Send with attachment
38	```bash
39	python3 {baseDir}/scripts/qqmail.py send --to "recipient@example.com" --subject "Report" --body "See attached" --attachment "/path/to/file.pdf"
40	```
41
42	### Search emails
43	```bash
44	python3 {baseDir}/scripts/qqmail.py search --subject "keyword"
45	python3 {baseDir}/scripts/qqmail.py search --from "sender@example.com"
46	python3 {baseDir}/scripts/qqmail.py search --since "2026-01-01"
47	python3 {baseDir}/scripts/qqmail.py search --subject "meeting" --since "2026-02-01" --limit 5
48	```
49
50	### List mail folders
51	```bash
52	python3 {baseDir}/scripts/qqmail.py folders
53	```
54
55	### Read from a specific folder
56	```bash
57	python3 {baseDir}/scripts/qqmail.py inbox --folder "Sent Messages" --limit 5
58	```
59
60	## Error Handling
61
62	- If authentication fails: verify QQMAIL_USER and QQMAIL_AUTH_CODE are set correctly.
63	- If IMAP is not enabled: guide the user to enable it in QQ Mail settings.
64	- Connection errors may indicate network issues or proxy requirements.
65
66	## Notes
67
68	- QQ Mail IMAP server: `imap.qq.com:993` (SSL)
69	- QQ Mail SMTP server: `smtp.qq.com:465` (SSL)
70	- All scripts use Python 3 standard library only (no pip install needed).
71	- Email content is decoded with charset detection for proper Chinese display.

People who liked this also viewed

6 picks

Type

qqmail-1.0.0

311stars25forks

View on GitHub

How to install qqmail-1.0.0?

virgo777/buddyme/qqmail-1.0.0

$npx -y skills add virgo777/buddyme --skill qqmail-1.0.0

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# QQ Mail Manager
2
3	Manage QQ邮箱 via standard IMAP/SMTP protocols using Python scripts.
4
5	## Prerequisites
6
7	The user must enable IMAP/SMTP in QQ Mail settings and obtain an authorization code (授权码):
8	1. Log in to mail.qq.com → Settings (设置) → Account (账户)
9	2. Enable IMAP/SMTP service
10	3. Generate an authorization code (授权码) — this is NOT the QQ password
11
12	## Configuration
13
14	The skill reads credentials from environment variables:
15	- `QQMAIL_USER` — 5847713@qq.com
16	- `QQMAIL_AUTH_CODE` — jyzviigffggncbbg
17
18	## Available Operations
19
20	### Read recent emails
21	```bash
22	python3 {baseDir}/scripts/qqmail.py inbox --limit 10
23	```
24	Shows: sender, subject, date, and a text preview of each email.
25
26	### Read a specific email by index
27	```bash
28	python3 {baseDir}/scripts/qqmail.py read --index 1
29	```
30	Shows the full email content (text body).
31
32	### Send an email
33	```bash
34	python3 {baseDir}/scripts/qqmail.py send --to "recipient@example.com" --subject "Hello" --body "Email content here"
35	```
36
37	### Send with attachment
38	```bash
39	python3 {baseDir}/scripts/qqmail.py send --to "recipient@example.com" --subject "Report" --body "See attached" --attachment "/path/to/file.pdf"
40	```
41
42	### Search emails
43	```bash
44	python3 {baseDir}/scripts/qqmail.py search --subject "keyword"
45	python3 {baseDir}/scripts/qqmail.py search --from "sender@example.com"
46	python3 {baseDir}/scripts/qqmail.py search --since "2026-01-01"
47	python3 {baseDir}/scripts/qqmail.py search --subject "meeting" --since "2026-02-01" --limit 5
48	```
49
50	### List mail folders
51	```bash
52	python3 {baseDir}/scripts/qqmail.py folders
53	```
54
55	### Read from a specific folder
56	```bash
57	python3 {baseDir}/scripts/qqmail.py inbox --folder "Sent Messages" --limit 5
58	```
59
60	## Error Handling
61
62	- If authentication fails: verify QQMAIL_USER and QQMAIL_AUTH_CODE are set correctly.
63	- If IMAP is not enabled: guide the user to enable it in QQ Mail settings.
64	- Connection errors may indicate network issues or proxy requirements.
65
66	## Notes
67
68	- QQ Mail IMAP server: `imap.qq.com:993` (SSL)
69	- QQ Mail SMTP server: `smtp.qq.com:465` (SSL)
70	- All scripts use Python 3 standard library only (no pip install needed).
71	- Email content is decoded with charset detection for proper Chinese display.

People who liked this also viewed

6 picks

Type