xiaohongshu-prohibited-word

小紅書禁止語チェック

概要

小紅書禁止語チェックは、小紅書のコンテンツクリエイター、ブランド運営担当者、マーケティング担当者向けに設計された、禁止語を検出するスマートツールです。紅狐Hubの禁止語検出APIを利用し、投稿前に文案内のセンシティブな語句をすばやくスキャンして、文脈に応じた置き換え案を提示します。

文案を入力するだけで、次のことができます。

• 🔍 禁止語のマーク —— 該当する語句を原文内で太字にし、リスク箇所をひと目で確認できます
• 💡 置き換え案 —— 禁止語ごとに、文脈に合った置き換え語と変更理由を提示します
• ✏️ 文案の最適化 —— 置き換え後の投稿可能なバージョンをそのまま提示するので、コピーしてすぐに使えます
• 📏 長文案の分割検出 —— 3000文字を超えると自動で通知し、分割検出後に結果を統合できます

トリガーキーワード：小紅書禁止語 投稿のセンシティブワード 小紅書の審査 表示制限ワード 商品紹介文のコンプライアンス

機能

🎯 コア機能

入力方法	機能の説明	使用例
💬 文案を直接貼り付け	投稿文案を貼り付けて、ワンクリックで検出	この投稿に禁止語がないか確認してください：この美白のすごいアイテム、本当に効果抜群です……
📎 ファイルをアップロード	TXT、DOC、DOCXに対応し、自動で読み取って検出	ドキュメントをアップロードするだけで、手動でコピーする必要はありません
🖼️ 画像をアップロード	画像内のテキストを自動抽出して検出	投稿のスクリーンショットやポスターをアップロードするだけです
🌐 リンクを貼り付け	ウェブページの内容を自動取得して検出	このウェブページを検出してください：https://example.com/article

✨ 特長

• ⚡ ワンストップ検出 —— テキスト／ファイル／画像／ウェブページの4種類の入力方法に対応し、1回の呼び出しですべての検出を実行します
• 🔗 クロスプラットフォームのコンテンツ抽出 —— Playwrightのヘッドレスブラウザーを内蔵し、JSで動的にレンダリングされるSPAページのコンテンツ抽出に対応します
• 🌐 英単語の誤マッチを除外 —— 英単語の内部にある部分文字列の誤検出（例：「Glasswing」内の「ass」）を自動で識別し、手動で確認する必要はありません
• 🔒 データセキュリティ —— 検出対象のコンテンツは暗号化HTTPS経由で送信され、ローカルには保存されません
• 📄 ワンクリックでエクスポート —— 最適化済みの文案をプレーンテキストファイルとして自動生成し、カード形式で送信します。そのままダウンロードして使えます

制限事項：プラットフォームは小紅書に固定されているため、指定は不要です。PDFには対応していません。画像またはテキストファイルに変換してからアップロードしてください。

ワンクリックインストール

前提条件

• Python 3.8+
• Pythonの依存関係をインストール：

  pip install python-docx==1.1.0 beautifulsoup4==4.12.3 playwright==1.58.0
  

• Chromiumブラウザーをインストール：

  playwright install chromium
  

API Keyの取得

1. 紅狐Hub公式サイトにアクセスして、サービスの詳細を確認します
2. 登録ページにアクセスして、アカウントを登録します
3. 新規登録ユーザーには無料クレジットが付与されるため、すぐにAPIサービスを利用できます
4. 登録してログインした後、個人センターで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（有効）です

使い方ガイド

基本的な使い方

💬 文案を直接貼り付け —— 投稿文案をアシスタントに送るだけで検出できます

ユーザー：この投稿に禁止語がないか確認してください：この美白のすごいアイテム、本当に効果抜群です。3日使っただけで肌がワントーン白くなりました

アシスタントの出力：🔍 禁止語の検出結果 → 💡 修正案 → ✏️ 最適化済み文案 ＋ プレーンテキストファイルのカード

📎 ファイルをアップロード —— TXT、DOC、DOCXファイルを直接アップロードすると、アシスタントが内容を自動抽出して検出します

🖼️ 画像をアップロード —— 投稿のスクリーンショットやポスターをアップロードすると、アシスタントが画像内のテキストを抽出して検出します（テキストの抽出のみで、画像の見た目は分析しません）

🌐 リンクを貼り付け —— ウェブページのURLを指定すると、アシスタントがページ内のテキストを自動取得して検出します

応用的な使い方

長文案の分割検出：3000文字を超える場合、アシスタントは処理を一時停止して確認します（1＝最初の3000文字のみを一括検出／2＝分割して全文を検出／3＝キャンセル）。分割する場合は、自然な文の区切りで自動的に分割します

テキストのみを抽出してプレビュー：スクリプトの --extract-only パラメーターを呼び出すと、検出せずにテキストのみを抽出し、テキスト内容と文字数を返します

カスタムAPIエンドポイント：XHS_SENSITIVE_WORD_API_URL 環境変数を設定して、自前の検出サービスを指定します

コマンド早見表

入力形式	アシスタントの動作
プレーンテキスト	文字数を計算 → 文字数ゲート → --content="..." → 3つのセクションを出力
TXT/DOC/DOCXをアップロード	--file=path --extract-only で文字数を確認 → ルールに従って検出 → 3つのセクションを出力
画像をアップロード	画像内のテキストのみ抽出 → 文字数を計算 → --content="抽出したテキスト" → 3つのセクションを出力
https://... を貼り付け	--url=... --extract-only で文字数を確認 → ルールに従って検出 → 3つのセクションを出力
長すぎる文案	確認メッセージを送信し、ユーザーから明確な返答を受け取ってから続行

--content、--file、--url は相互に排他的です。

完全な実行手順（出力テンプレート、厳守すべき書式、例）は references/core_workflow.md を参照してください。スクリプトの呼び出しと出力の書式設定を行う前に必ず読み、厳密に従ってください。

💳 クレジット不足時のチャージ（Alipayへの引き継ぎ）

scripts/check_sensitive_words.py の終了コードの意味：0 ＝ 正常終了（パラメーター／認証／インターフェースのエラーもJSONの status=error として出力され、終了コードは0のままです）；3 ＝ クレジット不足のためチャージが必要。以下の手順に従って引き継ぎます。

スクリプトが終了コード3で終了し、stdoutに ===PAYMENT_REQUIRED_JSON_START=== ブロックを出力した場合、現在のAPI Keyのクレジットが不足しています（インターフェースの code=3210。3201 にも対応）。レスポンスボディの data には、構造化された決済情報が含まれます：cashierUrl（Alipayの決済ページリンク）、amount（注文金額、元）、goodsName（商品名）、outTradeNo（注文番号）。

事前確認、alipay-bot trigger-payment-signal → submit-payment → poll-payment-status の連携手順、ウォレットの紐付け処理、決済引き継ぎルールおよびエラー処理については、references/alipay-recharge.md にまとめています（他のskillでも再利用できる共通手順です）。submit-payment の後、Agentが poll-payment-status --out-shake-no <查询单号> を使って決済コールバックの着金を自動的に監視するため、ユーザーが手動で確認する必要はありません。着金（outcome=success）後、ユーザーが最初に指定した検索パラメーターで scripts/check_sensitive_words.py を自動的に再実行し、結果を出力します。

使用シーン

シーン1：小紅書クリエイターによる投稿前のセルフチェック

役割：小紅書ブロガー、コンテンツクリエイター

ニーズ：商品紹介投稿の公開前に禁止語をすばやく確認し、極端な表現や使用が禁止されている宣伝文句による表示制限や削除を防ぎます

使用方法：

1. 投稿文案をそのままアシスタントに貼り付けます
2. 禁止語の検出結果と置き換え案を確認します
3. 最適化済みの文案をコピーするか、プレーンテキストファイルをダウンロードしてそのまま公開します

期待される効果：一度の修正で安心して公開でき、何度も修正する手間や審査待ち時間を削減できます

シーン2：ブランド／EC運営でまとめてチェック

役割：ブランド運営担当者、EC運営担当者

ニーズ：キャンペーンポスターの文案、商品詳細ページ、複数のプロモーション文案をまとめて検出します

使用方法：

1. 複数の文案をDOC/DOCXドキュメントにまとめてアップロードします
2. アシスタントが内容を自動抽出し、すべての文案を分割して検出します
3. 各回の検出結果と、最適化内容をまとめたファイルを取得します

期待される効果：まとめてチェックして効率を高め、キャンペーン開始後の苦情や掲載停止を防ぎます

场景三：投放/营销话术快速过筛

角色：广告投放、营销人员

需求：多条卖点话术、投放文案快速过审

使用方式：

1. 逐条或批量提交投放文案
2. 按助手替换建议修改违禁词
3. 下载优化后文案提交合规审核

预期收益：缩短审核周期，提高投放素材通过率

场景四：内容审核/增长团队抽查

角色：增长运营、内容审核

需求：落地页、H5 页面纯文本内容合规抽查

使用方式：

1. 粘贴落地页或 H5 URL
2. 助手自动抓取页面文字检测
3. 查看检测结果确认是否存在违规

预期收益：快速完成页面合规抽查，降低违规风险

项目架构

目录结构

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: 请按以下步骤操作：

1. 访问 https://redfox.hk/login?source=github 注册获取 API Key（新用户赠免费积分）
2. 配置环境变量：export REDFOX_API_KEY=ak_xxxxxxxx
3. 或在 ~/.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: 文字提取依赖图片清晰度和字体。建议使用高清晰度截图，避免手写字体和艺术字体。

获取帮助

• 🌐 红狐Hub 官网：https://redfox.hk/?source=github
• 📧 联系邮箱：[email protected]