{"skill":{"slug":"gzh-prohibited-word","displayName":"公众号违禁词检测","summary":"扫描公众号文案、文件或网页中的违禁词与敏感表述，标注风险并提供合规替换建议，帮你安全过审、避免删文限流。","description":"---\r\nname: wechat-prohibited-word\r\ndescription: 扫描公众号文案、文件或网页中的违禁词与敏感表述，标注风险并提供合规替换建议，帮你安全过审、避免删文限流。\r\ndependency:\r\n  python:\r\n    - requests>=2.28.0\r\n    - python-docx==1.1.0\r\n    - beautifulsoup4==4.12.3\r\n    - playwright==1.58.0\r\n  system:\r\n    - playwright install chromium\r\n---\r\n\r\n# 公众号违禁词查询\r\n\r\n## 简介\r\n\r\n**公众号违禁词查询**是一款专为公众号内容创作者和运营人员设计的合规检测工具，基于官方违禁词库实时同步，覆盖广告法、医疗美容、金融风险等 10+ 类目。\r\n\r\n通过简单的文案输入，你可以：\r\n- 🔍 快速扫描文案中的违禁词与敏感表述，**加粗**标注风险位置\r\n- 💡 获取每个违禁词的向上文语境的替换建议\r\n- ✏️ 直接拿到一份替换后的合规文案，复制即可发布\r\n- 📎 自动生成纯文本文件，方便存档和协作\r\n\r\n适用于公众号运营、新媒体编辑、品牌市场团队、设计师等需要确保文案合规发布的场景。\r\n\r\n本 Skill 基于 Python 脚本，通过 API 调用远端违禁词检测服务，支持文本、文件、网页、图片四种输入方式。\r\n\r\n---\r\n\r\n## 功能特性\r\n\r\n### 核心功能\r\n\r\n| 功能 | 说明 |\r\n|------|------|\r\n| **违禁词扫描** | 基于官方违禁词库，覆盖广告法极限词、医疗美容、金融风险、教育培训等 10+ 类目 |\r\n| **风险标注** | 命中违禁词在原文中**加粗**显示，同时汇总违禁词类型与数量 |\r\n| **智能替换** | 每个违禁词提供结合上下文的替换表达，附更换理由，不是机械同义词替换 |\r\n| **优化文案生成** | 直接输出替换后的完整合规版本，替换处**加粗**标记，保持原文语气和风格 |\r\n\r\n### 特色亮点\r\n\r\n- **四种输入方式**：支持直接粘贴文案、上传 TXT/DOC/DOCX 文件、上传图片自动提取文字、粘贴网页链接\r\n- **长文案分批检测**：超过 3000 字自动提醒，支持按自然断句处切割分批检测，结果自动合并\r\n- **英文误匹配过滤**：内置英文单词识别，不会把 \"Glasswing\" 中的 \"ass\" 误判为违禁词\r\n- **网络异常容错**：API 请求遇到 5xx、超时、连接失败时自动重试，无需手动干预\r\n- **数据隐私保护**：文案通过加密连接发送至检测服务，不在本地存储\r\n\r\n---\r\n\r\n## 一键安装\r\n\r\n### 前置条件\r\n- **Python 3.7+** 运行环境\r\n- **pip** 包管理器\r\n- 已注册 [红狐Hub](https://redfox.hk/) 账号并获取 API Key\r\n\r\n### 安装步骤\r\n\r\n1. 将本 Skill 文件夹放入你的平台 Skill 目录\r\n2. 安装 Python 依赖：\r\n\r\n```bash\r\npip install requests python-docx beautifulsoup4 playwright\r\nplaywright install chromium\r\n```\r\n\r\n3. 配置 API Key（见下方）\r\n\r\n### API Key 配置\r\n\r\n#### 获取 API Key\r\n1. 访问 [红狐Hub 官网](https://redfox.hk/) 了解服务详情\r\n2. 前往 [注册页面](https://redfox.hk/login) 注册账号\r\n3. **新注册用户将获赠免费积分**，可立即开始使用 API 服务\r\n4. 注册登录后，在个人中心获取 API Key，格式为 `ak_xxxxxxxx`\r\n\r\n#### 配置方式\r\n\r\n| 配置方式 | 操作 | 说明 |\r\n|----------|------|------|\r\n| 环境变量（推荐） | `export REDFOX_API_KEY=ak_xxxxxxxx` | 在当前终端会话生效 |\r\n| Shell 配置文件 | 将上述 export 语句写入 `~/.bashrc` 或 `~/.zshrc`，执行 `source ~/.bashrc` | 永久生效，脚本自动读取 |\r\n\r\n> 脚本获取 Key 的优先级：环境变量 `REDFOX_API_KEY` → Shell 配置文件自动扫描 → 提示用户配置\r\n\r\n---\r\n\r\n## 使用指南\r\n\r\n### 基础使用\r\n\r\n#### 方式一：直接粘贴文案\r\n最常用的方式，适合快速检测草稿：\r\n\r\n> **用户**：帮我看下这篇公众号草稿有没有违禁词：这款美白神器真的太有效了，用了三天就白了一个度\r\n>\r\n> **助手**：自动检测并输出违禁词标注、替换建议表和优化后文案\r\n\r\n#### 方式二：上传文件\r\n支持 TXT、DOC、DOCX 格式，直接上传即可自动读取检测。\r\n\r\n#### 方式三：上传图片\r\n上传海报截图或推文截图，系统自动提取图中文字进行检测（仅提取文字内容，不分析图片视觉风格）。\r\n\r\n#### 方式四：粘贴网页链接\r\n提供文章 URL，系统自动抓取页面正文内容进行检测。\r\n\r\n**注意事项**：\r\n- 平台固定为公众号，无需手动指定\r\n- 单次建议不超过 3000 字，超过会询问你是否分批检测\r\n- 超过 10000 字的内容暂不支持，建议手动分批\r\n- PDF 文件不支持，请转为图片或文本文件后上传\r\n\r\n### 命令速查\r\n\r\n| 命令 | 用途 |\r\n|------|------|\r\n| `python scripts/check_sensitive_words.py --content=\"文案\"` | 检测文本内容 |\r\n| `python scripts/check_sensitive_words.py --file=/path/file.txt` | 检测文件内容 |\r\n| `python scripts/check_sensitive_words.py --url=https://...` | 检测网页内容 |\r\n| `python scripts/check_sensitive_words.py --file=/path/file.txt --extract-only` | 仅提取文本，不检测 |\r\n\r\n---\r\n\r\n## 使用场景\r\n\r\n### 场景一：公众号推文发布前自查\r\n**角色**：公众号运营\r\n\r\n**需求**：推文发出前确认没有极限词、禁用宣传用语，避免被平台删改或封号\r\n\r\n**使用方式**：\r\n1. 写完推文后直接粘贴到对话中\r\n2. 查看违禁词标注结果\r\n3. 复制优化文案替换原文发布\r\n\r\n**预期效果**：提前排除合规风险，降低删文概率\r\n\r\n---\r\n\r\n### 场景二：多篇短文案批量预审\r\n**角色**：新媒体编辑\r\n\r\n**需求**：日常产出多篇短文，需要在发布前统一过一遍合规检查\r\n\r\n**使用方式**：\r\n1. 将多篇文案合并为一个 TXT 文件上传\r\n2. 系统自动分批检测全部内容\r\n3. 下载合并后的优化文案文件\r\n\r\n**预期效果**：一次完成多篇检测，提升审稿效率\r\n\r\n---\r\n\r\n### 场景三：活动落地页文案抽查\r\n**角色**：品牌/市场团队\r\n\r\n**需求**：H5 页面、活动落地页上线前确认文案无违规风险\r\n\r\n**使用方式**：\r\n1. 提供页面 URL\r\n2. 系统自动抓取正文并检测\r\n3. 按替换建议修正违规表述\r\n\r\n**预期效果**：避免活动页面因违规词被举报或下架\r\n\r\n---\r\n\r\n### 场景四：海报/推文图文字合规检查\r\n**角色**：设计师\r\n\r\n**需求**：海报中的营销文案需要确保不触犯广告法\r\n\r\n**使用方式**：\r\n1. 上传海报截图\r\n2. 系统提取图中文字进行检测\r\n3. 确认替换方案后修改设计稿\r\n\r\n**预期效果**：在设计阶段即排除文字风险，减少返工\r\n\r\n---\r\n\r\n## 项目架构\r\n\r\n### 目录结构\r\n```\r\nwechat-prohibited-word/\r\n├── SKILL.md                  # Skill 说明文档（本文件）\r\n├── scripts/\r\n│   └── check_sensitive_words.py  # 核心检测脚本\r\n└── references/\r\n    └── core_workflow.md      # Agent 执行规程（输出模板、格式铁律等）\r\n```\r\n\r\n### 技术栈\r\n\r\n| 组件 | 技术 | 说明 |\r\n|------|------|------|\r\n| 运行环境 | Python 3.7+ | 脚本执行环境 |\r\n| HTTP 请求 | requests | 标准 HTTP 库，调用检测 API |\r\n| 文档解析 | python-docx | Word 文档 (.doc/.docx) 文本提取 |\r\n| 网页解析 | beautifulsoup4 + playwright | 静态 HTML 解析 + JS 动态页面渲染 |\r\n| API 服务 | 红狐Hub | 官方违禁词库，POST+JSON 方式调用 |\r\n\r\n### 数据流转\r\n```\r\n用户输入（文本/文件/网页/图片）\r\n    → 脚本提取文本内容\r\n    → HTTPS POST 发送至红狐Hub API\r\n    → API 匹配违禁词库，返回标注结果\r\n    → 脚本过滤英文误匹配，格式化输出 JSON\r\n    → Agent 按模板呈现三板块结果 + 写入优化文案文件\r\n```\r\n\r\n---\r\n\r\n## 常见问答\r\n\r\n### 安装配置\r\n\r\n**Q: 安装依赖时报错怎么办？**\r\nA: 请确认 Python 版本≥3.7，并依次执行：\r\n```bash\r\npip install --upgrade pip\r\npip install requests python-docx beautifulsoup4 playwright\r\nplaywright install chromium\r\n```\r\n\r\n**Q: 提示 \"未配置 REDFOX_API_KEY\" 怎么办？**\r\nA: 请按以下步骤处理：\r\n1. 访问 [redfox.hk](https://redfox.hk/) 注册账号\r\n2. 在个人中心复制 API Key（格式 `ak_xxxxxxxx`）\r\n3. 执行 `export REDFOX_API_KEY=ak_xxxxxxxx` 或写入 `~/.bashrc`\r\n\r\n---\r\n\r\n### 功能使用\r\n\r\n**Q: 支持检测哪些类型的违禁词？**\r\nA: 覆盖广告法极限词（\"最好\"\"第一\"等）、医疗美容禁宣用语、金融收益承诺、教育培训夸大宣传、虚假广告用语、诱导分享话术等 10+ 类目。\r\n\r\n**Q: 长文案怎么处理？**\r\nA: 3000 字以内直接检测；超过 3000 字会自动询问是否分批检测，在自然断句处切割保证语义完整；超过 10000 字建议手动分批。\r\n\r\n**Q: 英文内容会被误判吗？**\r\nA: 不会。脚本内置英文误匹配过滤，正常英文单词中的子串不会被标记为违禁词。\r\n\r\n---\r\n\r\n### 故障排除\r\n\r\n**Q: 检测接口超时或报错？**\r\nA: 脚本内置自动重试机制（最多 2 次），若仍然失败请稍后重试。持续异常请联系服务提供商。\r\n\r\n**Q: 网页内容提取失败？**\r\nA: 部分需要登录或有反爬机制的页面无法提取。建议直接复制页面文字后粘贴检测。\r\n\r\n**Q: 上传的文件无法识别？**\r\nA: 支持的文本文件格式：TXT、DOC、DOCX、CSV、MD、LOG、JSON、XML、HTML。PDF 不支持，请转为图片或文本文件。\r\n\r\n---\r\n\r\n### 获取帮助\r\n\r\n如有其他问题，可通过以下方式获取支持：\r\n- 🌐 访问 [红狐Hub](https://redfox.hk/) 查看文档\r\n- 📧 邮件联系服务提供商\r\n\r\n---\r\n\r\n> **Agent 执行规程**：进行检测、格式化输出前，**必须先读取并严格遵循** [`references/core_workflow.md`](references/core_workflow.md) **全文**。该文档包含输出模板、格式铁律、分批询问话术、异常处理表等完整执行细节。\r\n","topics":["文案"],"tags":{"latest":"1.0.2"},"stats":{"comments":0,"downloads":494,"installsAllTime":18,"installsCurrent":1,"stars":1,"versions":3},"createdAt":1778316194096,"updatedAt":1780630667041},"latestVersion":{"version":"1.0.2","createdAt":1780630667041,"changelog":"**微信号、Skill 改版与说明文档优化**\n\n- Skill 名称由「gzh-prohibited-word」更名为「wechat-prohibited-word」并全新梳理说明文档。\n- 说明文档（SKILL.md）大幅更新：结构重构，突出产品功能、API Key 配置方式、实际场景应用、常见问题答疑。\n- 增加详细的安装配置指南、功能速览、目录结构及 Q&A，内容更易理解和部署。\n- 新增 README.md、README.en.md，方便多语言和开源发布。\n- 移除 sample 配置文件和旧版 skill-card.md，无业务功能变更。","license":"MIT-0"},"metadata":null,"owner":{"handle":"if530770","userId":"s17dj64hf08x3mak1j99vesphd84gs9c","displayName":"if530770","image":"https://avatars.githubusercontent.com/u/46310539?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780631604050}}