{"skill":{"slug":"xhs-prohibited-word","displayName":"小红书违禁词检测","summary":"检测文案、文件或网页中的小红书违禁词并加粗显示，提供违禁词替换建议和仅替换违禁词后的文案；当用户需要查询小红书平台违禁词、检查小红书笔记文案是否包含敏感词、或希望获得安全替换词和修改后文案时使用。","description":"---\r\nname: xiaohongshu-prohibited-word\r\ndescription: 检测文案、文件或网页中的小红书违禁词并加粗显示，提供违禁词替换建议和仅替换违禁词后的文案；当用户需要查询小红书平台违禁词、检查小红书笔记文案是否包含敏感词、或希望获得安全替换词和修改后文案时使用。\r\ndependency:\r\n  python:\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小红书违禁词查询是一款专为小红书内容创作者、品牌运营和营销人员设计的智能违禁词检测工具，基于 红狐Hub 违禁词检测 API，在笔记发布前快速扫描文案中的敏感词并提供上下文智能替换建议。\r\n\r\n通过简单的文案输入，你可以：\r\n- 🔍 **违禁词标记** —— 原文中命中词用加粗标出，一眼看到风险点\r\n- 💡 **替换建议** —— 每个违禁词配一个结合上下文的替换词 + 更换理由\r\n- ✏️ **优化文案** —— 直接给出一份替换后的可发布版本，复制粘贴就能用\r\n- 📏 **长文案分批检测** —— 超过 3000 字自动提醒，支持分批检测后合并结果\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| 🌐 粘贴链接 | 自动抓取网页内容检测 | `帮我检测这个网页：https://example.com/article` |\r\n\r\n### ✨ 特色亮点\r\n\r\n- **⚡ 一站式检测** —— 文本/文件/图片/网页四种输入方式，一次调用完成所有检测\r\n- **🔗 跨平台内容提取** —— 内置 Playwright 无头浏览器，支持 JS 动态渲染的 SPA 页面内容提取\r\n- **🌐 英文误匹配过滤** —— 自动识别英文单词内部子串误判（如 \"Glasswing\" 中的 \"ass\"），无需手动排查\r\n- **🔒 数据安全** —— 检测内容通过加密 HTTPS 发送，不在本地存储\r\n- **📄 一键导出** —— 自动生成纯文本优化文案文件并以卡片形式发送，可直接下载使用\r\n\r\n**限制说明**：平台固定为小红书，无需指定。PDF 不支持，需转为图片或文本文件后上传。\r\n\r\n## 一键安装\r\n\r\n### 前置条件\r\n\r\n- Python 3.8+\r\n- 安装 Python 依赖：\r\n  ```bash\r\n  pip install python-docx==1.1.0 beautifulsoup4==4.12.3 playwright==1.58.0\r\n  ```\r\n- 安装 Chromium 浏览器：\r\n  ```bash\r\n  playwright install chromium\r\n  ```\r\n\r\n### 获取 API Key\r\n\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### 配置 API Key\r\n\r\n脚本按以下优先级自动获取密钥：\r\n\r\n| 优先级 | 来源 | 说明 |\r\n|--------|------|------|\r\n| 1 | 环境变量 `REDFOX_API_KEY` | 直接读取当前设备环境变量 |\r\n| 2 | Shell 配置文件 | 自动扫描 `~/.zshrc` `~/.bashrc` `~/.bash_profile` `~/.profile` `~/.zprofile` |\r\n| 3 | 提示配置 | 以上均未找到时，提示用户手动配置 |\r\n\r\n**配置示例**：\r\n\r\n```bash\r\nexport REDFOX_API_KEY=ak_xxxxxxxx\r\n```\r\n\r\n### 环境变量参考\r\n\r\n| 变量名 | 必填 | 说明 |\r\n|--------|------|------|\r\n| `REDFOX_API_KEY` | 是 | 红狐Hub API 访问密钥，格式 `ak_xxxxxxxx` |\r\n| `XHS_SENSITIVE_WORD_API_URL` | 否 | 自定义 API 端点地址（默认使用 红狐Hub 官方） |\r\n| `XHS_SENSITIVE_WORD_VERIFY_SSL` | 否 | SSL 证书校验开关，默认 `1`（开启） |\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**🌐 粘贴链接** —— 提供网页 URL，助手自动抓取页面文字内容检测\r\n\r\n### 高级使用\r\n\r\n**长文案分批检测**：超过 3000 字符时，助手会暂停并询问（回复 1=单次仅检测前3000字 / 2=分批检测全部 / 3=取消），分批时自动在自然断句处切割\r\n\r\n**仅提取文字预览**：调用脚本 `--extract-only` 参数可仅提取文字不检测，返回文本内容和长度\r\n\r\n**自定义 API 端点**：设置 `XHS_SENSITIVE_WORD_API_URL` 环境变量指向自建检测服务\r\n\r\n### 命令速查\r\n\r\n| 输入形态 | 助手动作 |\r\n|---|---|\r\n| 纯文本 | 计算字数 → 字数闸门 → `--content=\"...\"` → 三板块输出 |\r\n| 上传 TXT/DOC/DOCX | `--file=path --extract-only` 查字数 → 按规则检测 → 三板块输出 |\r\n| 上传图片 | 仅提取图中文字 → 计算字数 → `--content=\"提取文字\"` → 三板块输出 |\r\n| 粘贴 `https://...` | `--url=... --extract-only` 查字数 → 按规则检测 → 三板块输出 |\r\n| 超长文案 | 发出询问语，**收到用户明确回复后再继续** |\r\n\r\n`--content`、`--file`、`--url` 三者互斥。\r\n\r\n> **完整执行规程**（输出模板、格式铁律、示例）详见 [`references/core_workflow.md`](references/core_workflow.md)，调用脚本和格式化输出前必须读取并严格遵循。\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\n1. 将多段文案整理为 DOC/DOCX 文档上传\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\n1. 逐条或批量提交投放文案\r\n2. 按助手替换建议修改违禁词\r\n3. 下载优化后文案提交合规审核\r\n\r\n**预期收益**：缩短审核周期，提高投放素材通过率\r\n\r\n### 场景四：内容审核/增长团队抽查\r\n\r\n**角色**：增长运营、内容审核\r\n\r\n**需求**：落地页、H5 页面纯文本内容合规抽查\r\n\r\n**使用方式**：\r\n1. 粘贴落地页或 H5 URL\r\n2. 助手自动抓取页面文字检测\r\n3. 查看检测结果确认是否存在违规\r\n\r\n**预期收益**：快速完成页面合规抽查，降低违规风险\r\n\r\n## 项目架构\r\n\r\n### 目录结构\r\n\r\n```\r\nxiaohongshu-prohibited-word/\r\n├── SKILL.md                          # Skill 主文档（本文件）\r\n├── skill-card.md                     # 技能市场卡片描述\r\n├── _meta.json                        # 元数据\r\n├── scripts/\r\n│   └── check_sensitive_words.py      # 核心检测脚本\r\n│       ├── _get_api_key()            #   API Key 获取（环境变量 → Shell配置 → 提示）\r\n│       ├── _http_request()           #   HTTP 请求（urllib 原生，内置重试）\r\n│       ├── extract_from_file()       #   文件文本提取（DOC/DOCX/TXT/CSV/MD 等）\r\n│       ├── extract_from_web()        #   网页文本提取（Playwright → urllib 回退）\r\n│       └── check_sensitive_words()   #   违禁词检测（API 调用 + 结果解析）\r\n└── references/\r\n    └── core_workflow.md              # 核心工作流（操作步骤、输出模板、格式铁律、示例）\r\n```\r\n\r\n### 技术栈\r\n\r\n| 组件 | 技术 | 说明 |\r\n|------|------|------|\r\n| **运行环境** | Python 3.8+ | 标准 Python 环境 |\r\n| **HTTP 请求** | `urllib.request`（标准库） | 原生 HTTP 请求，内置重试与超时处理 |\r\n| **文档解析** | `python-docx` | Word 文档文本提取 |\r\n| **网页解析** | `beautifulsoup4` + `playwright` | 静态 HTML + JS 动态渲染双引擎 |\r\n| **API 服务** | 红狐Hub 违禁词检测 API | HTTPS POST，JSON 格式，X-API-KEY 鉴权 |\r\n\r\n\r\n## 常见问答\r\n\r\n### 安装相关\r\n\r\n**Q1: 提示\"缺少依赖库\"怎么办？**\r\n\r\nA: 运行以下命令安装：\r\n```bash\r\npip install python-docx==1.1.0 beautifulsoup4==4.12.3 playwright==1.58.0\r\nplaywright install chromium\r\n```\r\n\r\n**Q2: 提示\"缺少凭证配置\"怎么办？**\r\n\r\nA: 请按以下步骤操作：\r\n1. 访问 https://redfox.hk/login 注册获取 API Key（新用户赠免费积分）\r\n2. 配置环境变量：`export REDFOX_API_KEY=ak_xxxxxxxx`\r\n3. 或在 `~/.bashrc` / `~/.zshrc` 中添加后执行 `source ~/.bashrc`\r\n\r\n### 使用相关\r\n\r\n**Q3: 单次能检测多少字？**\r\n\r\nA: 建议单次 3000 字以内效果最佳。3001~10000 字会询问是否分批检测，超过 10000 字暂不支持。\r\n\r\n**Q4: 支持 PDF 文件吗？**\r\n\r\nA: 不支持 PDF。请将 PDF 转为图片或文本文件后重新上传。\r\n\r\n**Q5: 检测结果能保证百分百准确吗？**\r\n\r\nA: 检测结果基于红狐Hub违禁词库，仅供参考。请根据企业经营范围和产品实际效果自行核对，最终以小红书平台审核结果为准。\r\n\r\n### 故障排除\r\n\r\n**Q6: 提示\"检测服务暂时不可用\"？**\r\n\r\nA: 脚本已内置自动重试机制。若持续失败，请检查网络、确认 API Key 未过期、或访问 红狐Hub 官网确认服务状态。\r\n\r\n**Q7: 网页内容提取失败？**\r\n\r\nA: 请检查网址是否可正常访问。部分需登录或有反爬保护的页面可能无法提取，建议改为复制文字后直接粘贴检测。\r\n\r\n**Q8: 图片文字提取不准确？**\r\n\r\nA: 文字提取依赖图片清晰度和字体。建议使用高清晰度截图，避免手写字体和艺术字体。\r\n\r\n### 获取帮助\r\n\r\n- 🌐 红狐Hub 官网：[https://redfox.hk/](https://redfox.hk/)\r\n- 📧 联系邮箱：graves9758@gmail.com\r\n","tags":{"latest":"1.0.6","xiaohongshu check hot":"1.0.3"},"stats":{"comments":0,"downloads":585,"installsAllTime":0,"installsCurrent":0,"stars":1,"versions":7},"createdAt":1778298206562,"updatedAt":1780630212605},"latestVersion":{"version":"1.0.6","createdAt":1780630212605,"changelog":"**Changelog for version 1.0.6:**\n\n- Added English and Chinese README files (README.md, README.en.md) for improved documentation and user guidance.\n- Enhanced skill documentation (SKILL.md): expanded feature descriptions, usage scenarios, detailed installation and API key configuration steps, troubleshooting, and FAQs.\n- Updated the project name to \"xiaohongshu-prohibited-word\" and clarified capabilities, triggers, and limitations.\n- Added detailed workflow, technical stack, and directory structure explanations.","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":1780631565347}}