# Qq Url Guard

> Use when sending replies to QQ where URL-like text (for example xx.xx, USER.md, markdown links, or http URLs) may trigger code 40034028 and get blocked.

- Skill: `peiiii/qq-url-guard` (Agent Skill)
- Install (CLI): `npx skillmds@latest add peiiii/qq-url-guard`
- Raw SKILL.md: https://api.skillmd.com/api/skills/peiiii/qq-url-guard/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: peiiii (https://skillmd.com/u/peiiii)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/peiiii/qq-url-guard

---


# QQ URL Guard

Use this skill for QQ outbound replies (private/group/guild) when content may contain URL-like tokens.

## Why

QQ may reject messages with:
- `code(40034028)`
- `请求参数不允许包含url`

Common risky patterns:
- `xx.xx` (domain-like text)
- `USER.md` / `README.md` (file-like token treated as URL)
- markdown links: `[text](https://...)`
- plain URLs: `https://...` / `www...`

## Output Rules

1. Prefer plain text over markdown for QQ replies.
2. Avoid raw URL-like strings in final QQ message.
3. Replace risky parts with safe placeholders when needed:
   - URL -> `[link]`
   - `.md` token -> `[file]`
4. Keep the sentence readable after replacement.

## Safe Rewrite Examples

- `Source: USER.md` -> `Source: [file]`
- `详情见 https://example.com` -> `详情见 [link]`
- `[文档](https://example.com)` -> `文档（链接已省略）`

## Operator Hint

If QQ send fails with `40034028`, retry with sanitized plain text immediately.