| name | xiaohongshu-prohibited-word |
| description | 检测文案、文件或网页中的小红书违禁词并加粗显示，提供违禁词替换建议和仅替换违禁词后的文案；当用户需要查询小红书平台违禁词、检查小红书笔记文案是否包含敏感词、或希望获得安全替换词和修改后文案时使用。 |
| dependency | {"python":["python-docx==1.1.0","beautifulsoup4==4.12.3","playwright==1.58.0"],"system":["playwright install chromium"]} |
小红书违禁词查询
简介
小红书违禁词查询是一款专为小红书内容创作者、品牌运营和营销人员设计的智能违禁词检测工具，基于 红狐Hub 违禁词检测 API，在笔记发布前快速扫描文案中的敏感词并提供上下文智能替换建议。
通过简单的文案输入，你可以：
- 🔍 违禁词标记 —— 原文中命中词用加粗标出，一眼看到风险点
- 💡 替换建议 —— 每个违禁词配一个结合上下文的替换词 + 更换理由
- ✏️ 优化文案 —— 直接给出一份替换后的可发布版本，复制粘贴就能用
- 📏 长文案分批检测 —— 超过 3000 字自动提醒，支持分批检测后合并结果
触发关键词：小红书违禁词 笔记敏感词 小红书审核 限流词 种草文案合规
功能特性
🎯 核心功能
| 输入方式 | 能力说明 | 使用示例 |
|---|
| 💬 直接贴文案 | 粘贴笔记文案，一键检测 | 帮我看下这段笔记有没有违禁词：这款美白神器真的太有效了…… |
| 📎 上传文件 | 支持 TXT、DOC、DOCX，自动读取检测 | 直接上传文档，无需手动复制 |
| 🖼️ 上传图片 | 自动提取图中文字进行检测 | 上传笔记截图/海报即可 |
| 🌐 粘贴链接 | 自动抓取网页内容检测 | 帮我检测这个网页：https://example.com/article |
✨ 特色亮点
- ⚡ 一站式检测 —— 文本/文件/图片/网页四种输入方式，一次调用完成所有检测
- 🔗 跨平台内容提取 —— 内置 Playwright 无头浏览器，支持 JS 动态渲染的 SPA 页面内容提取
- 🌐 英文误匹配过滤 —— 自动识别英文单词内部子串误判（如 "Glasswing" 中的 "ass"），无需手动排查
- 🔒 数据安全 —— 检测内容通过加密 HTTPS 发送，不在本地存储
- 📄 一键导出 —— 自动生成纯文本优化文案文件并以卡片形式发送，可直接下载使用
限制说明：平台固定为小红书，无需指定。PDF 不支持，需转为图片或文本文件后上传。
一键安装
前置条件
获取 API Key
- 访问 红狐Hub 官网 了解服务详情
- 前往 注册页面 注册账号
- 新注册用户将获赠免费积分，可立即开始使用 API 服务
- 注册登录后，在个人中心获取 API Key，格式为
ak_xxxxxxxx
配置 API Key
脚本按以下优先级自动获取密钥：
| 优先级 | 来源 | 说明 |
|---|
| 1 | 环境变量 REDFOX_API_KEY | 直接读取当前设备环境变量 |
| 2 | Shell 配置文件 | 自动扫描 ~/.zshrc ~/.bashrc ~/.bash_profile ~/.profile ~/.zprofile |
| 3 | 提示配置 | 以上均未找到时，提示用户手动配置 |
配置示例：
export REDFOX_API_KEY=ak_xxxxxxxx
环境变量参考
| 变量名 | 必填 | 说明 |
|---|
REDFOX_API_KEY | 是 | 红狐Hub API 访问密钥，格式 ak_xxxxxxxx |
XHS_SENSITIVE_WORD_API_URL | 否 | 自定义 API 端点地址（默认使用 红狐Hub 官方） |
XHS_SENSITIVE_WORD_VERIFY_SSL | 否 | SSL 证书校验开关，默认 1（开启） |
使用指南
基础使用
💬 直接贴文案 —— 把笔记文案发给助手即可检测
用户：帮我看下这段笔记有没有违禁词：这款美白神器真的太有效了，用了三天就白了一个度
助手输出：🔍 违禁词检测结果 → 💡 修改建议 → ✏️ 优化文案 + 纯文本文件卡片
📎 上传文件 —— 直接上传 TXT、DOC、DOCX 文件，助手自动提取内容检测
🖼️ 上传图片 —— 上传笔记截图或海报，助手提取图中文字后检测（仅提取文字，不分析图片视觉）
🌐 粘贴链接 —— 提供网页 URL，助手自动抓取页面文字内容检测
高级使用
长文案分批检测：超过 3000 字符时，助手会暂停并询问（回复 1=单次仅检测前3000字 / 2=分批检测全部 / 3=取消），分批时自动在自然断句处切割
仅提取文字预览：调用脚本 --extract-only 参数可仅提取文字不检测，返回文本内容和长度
自定义 API 端点：设置 XHS_SENSITIVE_WORD_API_URL 环境变量指向自建检测服务
命令速查
| 输入形态 | 助手动作 |
|---|
| 纯文本 | 计算字数 → 字数闸门 → --content="..." → 三板块输出 |
| 上传 TXT/DOC/DOCX | --file=path --extract-only 查字数 → 按规则检测 → 三板块输出 |
| 上传图片 | 仅提取图中文字 → 计算字数 → --content="提取文字" → 三板块输出 |
粘贴 https://... | --url=... --extract-only 查字数 → 按规则检测 → 三板块输出 |
| 超长文案 | 发出询问语，收到用户明确回复后再继续 |
--content、--file、--url 三者互斥。
完整执行规程（输出模板、格式铁律、示例）详见 references/core_workflow.md，调用脚本和格式化输出前必须读取并严格遵循。
使用场景
场景一：小红书创作者发布前自查
角色：小红书博主、内容创作者
需求：种草笔记发布前快速排查违禁词，避免因极限词、禁宣用语被限流或下架
使用方式：
- 将笔记文案直接粘贴发给助手
- 查看违禁词检测结果和替换建议
- 复制优化后文案或下载纯文本文件直接发布
预期收益：一次改对，安心发布，减少反复修改和审核等待时间
场景二：品牌/电商运营批量扫雷
角色：品牌运营、电商运营
需求：活动海报文案、商品详情页、多篇推广文案批量检测
使用方式：
- 将多段文案整理为 DOC/DOCX 文档上传
- 助手自动提取内容，分批检测全部文案
- 获取每批检测结果和汇总优化文件
预期收益：批量扫雷提升效率，避免活动上线后被投诉下架
场景三：投放/营销话术快速过筛
角色：广告投放、营销人员
需求：多条卖点话术、投放文案快速过审
使用方式：
- 逐条或批量提交投放文案
- 按助手替换建议修改违禁词
- 下载优化后文案提交合规审核
预期收益：缩短审核周期，提高投放素材通过率
场景四：内容审核/增长团队抽查
角色：增长运营、内容审核
需求：落地页、H5 页面纯文本内容合规抽查
使用方式：
- 粘贴落地页或 H5 URL
- 助手自动抓取页面文字检测
- 查看检测结果确认是否存在违规
预期收益：快速完成页面合规抽查，降低违规风险
项目架构
目录结构
xiaohongshu-prohibited-word/
├── SKILL.md # Skill 主文档（本文件）
├── skill-card.md # 技能市场卡片描述
├── _meta.json # 元数据
├── scripts/
│ └── check_sensitive_words.py # 核心检测脚本
│ ├── _get_api_key() # API Key 获取（环境变量 → Shell配置 → 提示）
│ ├── _http_request() # HTTP 请求（urllib 原生，内置重试）
│ ├── extract_from_file() # 文件文本提取（DOC/DOCX/TXT/CSV/MD 等）
│ ├── extract_from_web() # 网页文本提取（Playwright → urllib 回退）
│ └── check_sensitive_words() # 违禁词检测（API 调用 + 结果解析）
└── references/
└── core_workflow.md # 核心工作流（操作步骤、输出模板、格式铁律、示例）
技术栈
| 组件 | 技术 | 说明 |
|---|
| 运行环境 | Python 3.8+ | 标准 Python 环境 |
| HTTP 请求 | urllib.request（标准库） | 原生 HTTP 请求，内置重试与超时处理 |
| 文档解析 | python-docx | Word 文档文本提取 |
| 网页解析 | beautifulsoup4 + playwright | 静态 HTML + JS 动态渲染双引擎 |
| API 服务 | 红狐Hub 违禁词检测 API | HTTPS POST，JSON 格式，X-API-KEY 鉴权 |
常见问答
安装相关
Q1: 提示"缺少依赖库"怎么办？
A: 运行以下命令安装：
pip install python-docx==1.1.0 beautifulsoup4==4.12.3 playwright==1.58.0
playwright install chromium
Q2: 提示"缺少凭证配置"怎么办？
A: 请按以下步骤操作：
- 访问 https://redfox.hk/login?source=github 注册获取 API Key（新用户赠免费积分）
- 配置环境变量：
export REDFOX_API_KEY=ak_xxxxxxxx
- 或在
~/.bashrc / ~/.zshrc 中添加后执行 source ~/.bashrc
使用相关
Q3: 单次能检测多少字？
A: 建议单次 3000 字以内效果最佳。3001~10000 字会询问是否分批检测，超过 10000 字暂不支持。
Q4: 支持 PDF 文件吗？
A: 不支持 PDF。请将 PDF 转为图片或文本文件后重新上传。
Q5: 检测结果能保证百分百准确吗？
A: 检测结果基于红狐Hub违禁词库，仅供参考。请根据企业经营范围和产品实际效果自行核对，最终以小红书平台审核结果为准。
故障排除
Q6: 提示"检测服务暂时不可用"？
A: 脚本已内置自动重试机制。若持续失败，请检查网络、确认 API Key 未过期、或访问 红狐Hub 官网确认服务状态。
Q7: 网页内容提取失败？
A: 请检查网址是否可正常访问。部分需登录或有反爬保护的页面可能无法提取，建议改为复制文字后直接粘贴检测。
Q8: 图片文字提取不准确？
A: 文字提取依赖图片清晰度和字体。建议使用高清晰度截图，避免手写字体和艺术字体。
获取帮助
