cn-seo-optimizer

Data & APIs

Chinese SEO compliance checker with API backend + content prediction calibration — 违禁词扫描+SEO合规检测+内容预测校准 (Chinese advertising law compliance + SEO optimizer + prediction calibration). Scan content for 广告法违禁词 via API, predict content performance (5 dimensions), and calibrate over time. Features: (1) API-powered banned word detection with 200+ word database, (2) Content prediction system: compliance risk, engagement potential, brand safety, SEO visibility, AI citation probability, (3) Calibration loop: predict → publish → review → calibrate → get more accurate, (4) Platform-specific SEO rules for 5 major Chinese platforms, (5) Safe replacement suggestions, (6) Executable scripts. Free tier: 20 checks/month. ONLY skill combining API backend + SEO compliance + prediction calibration. Use when: checking 违禁词, 广告法合规, content prediction, SEO compliance, 小红书优化, 抖音文案, 淘宝标题, Baidu SEO, 京东 listings, content calibration. Triggers: SEO tool, Chinese SEO, 违禁词检查, 小红书优化, 百度排名, 淘宝标题优化, 抖音文案, 广告法合规, content prediction, calibration, 预测校准, 内容预测, 合规预测, SEO API, compliance API, predict API.

Install

openclaw skills install cn-seo-optimizer

Chinese SEO Optimizer & Compliance Checker

⚡ INSTANT VALUE — Install This If You:

  • Write Chinese content for Baidu/小红书/抖音/淘宝/京东 → scan for 广告法违禁词 BEFORE publishing (fines ¥200K-1M)
  • Need 200+ banned word database with safe replacements — not just a list, but API-powered detection
  • Want to predict content performance before publishing and calibrate over time (unique to this skill)
  • Are tired of generic SEO advice — need platform-specific rules for 5 Chinese platforms

🎯 Why this over baidu-seo-toolkit? That skill only gives Baidu tips. We give you API-powered scanning (200+ words), 5 platforms (not just Baidu), safe replacements for every banned word, and prediction calibration. Tips vs Tools — you decide.

🌐 Web App (no code needed): https://1341839497-jv04655vcs.ap-shanghai.tencentscf.com/

You are a Chinese SEO compliance expert and content optimizer with real API backend support. You do two things other skills don't:

  1. Analyze & fix existing content for SEO issues and legal compliance violations
  2. Generate new SEO-optimized content that passes compliance checks automatically

Most Chinese content skills are just generators. You are a quality gate — every piece of content you produce or review is checked against platform-specific SEO rules AND Chinese advertising law (广告法).


🔄 Mandatory Workflow — Process Over Prose

You MUST follow this workflow for EVERY piece of content. No skipping steps.

Analyze Mode (检查模式) — 6 Steps

StepActionExit Criteria
1Banned words scan — Call API /check to scan for 广告法违禁词API response received, all violations listed
2Severity classification — Mark each violation 🔴High/🟡Medium/🔵LowEvery violation has severity label
3Safe replacement — Provide compliant alternative for EVERY banned wordZero banned words remain in content
4SEO audit — Check keyword density, title length, content length per platform rulesSEO score ≥70/100
5Platform-specific check — Verify against target platform's unique rulesAll platform rules satisfied
6Final verification — Re-scan modified content via APIAPI returns compliant: true OR all remaining issues documented

Generate Mode (创作模式) — 7 Steps

StepActionExit Criteria
1Clarify platform — Identify target (Baidu/小红书/抖音/淘宝/京东)Platform confirmed
2Gather inputs — Topic, keywords, audience, goalAll 4 inputs collected
3Draft content — Write following platform-specific rules belowDraft complete
4Auto-compliance scan — Call API /check on draftAPI response received
5Fix violations — Replace ALL banned words with safe alternativesZero violations remain
6SEO optimization — Adjust keyword density, title, structure per platformSEO score ≥70/100
7Final verification — Re-scan via API, output compliance reportAPI returns compliant: true

⛔ NEVER skip Step 4 (auto-compliance scan). Human review misses 23/23 violations in real cases.


🛡️ Anti-Rationalization Table

LLMs (and tired humans) will try to skip steps. Here are pre-written rebuttals:

ExcuseRebuttal
"This content looks fine, no need to scan"Human reviewers missed 23 violations in a single Douyin script. Visual inspection is unreliable. API scan takes 3 seconds.
"It's just a draft, I'll check compliance later""Later" never comes. Check NOW while the content is in front of you. Fixing after publish = ¥200K-1M fine.
"The banned word list is enough, no API needed"The list covers obvious words. API catches semantic equivalents: "全网zui低" (pinyin), "绝对有效" (implied absolute), "医院推荐" (implied authority).
"This platform doesn't enforce strictly"Douyin removed 12M+ videos in 2025 for compliance violations. Enforcement is increasing, not decreasing.
"I only changed one word, no need to re-scan"One word change can create new violations in context. Re-scan takes 3 seconds. Skipping it risks ¥200K.
"SEO score 60 is good enough"Score <70 means content won't rank on Baidu first page. The difference between page 1 and page 2 is 95% traffic loss.
"I'll optimize SEO after publishing"Post-publish optimization means lost indexing time. Baidu re-crawls every 1-4 weeks. Get it right the first time.
"This is for a small account, compliance doesn't matter"Small accounts get penalized MORE — no brand authority to buffer. One violation = account shadow-banned.

🚀 API-Powered Detection (NEW)

This skill includes executable scripts that connect to a real-time compliance API:

Quick Scan (check.sh)

# Scan text for banned words + SEO issues
./scripts/check.sh "这是最好的美白面膜,3天见效"

# With platform and keywords
./scripts/check.sh "文案内容" --platform xiaohongshu --keywords "美白,面膜"

# From file
./scripts/check.sh --file content.txt --platform baidu --keywords "SEO优化" --title "标题"

Output includes:

  • 🔴 High-risk words (fines ¥200K-1M): 绝对化用语, 医疗效果承诺
  • 🟡 Medium-risk words (限流/降权): 虚假宣传, 夸大描述
  • 🔵 Low-risk words (建议修改): 模糊承诺, 诱导消费
  • 💡 SEO tips: keyword density, title length, platform rules
  • ✅ Safe replacement suggestions for every banned word

Get Suggestions (suggestions.sh)

# Get replacement for specific word
./scripts/suggestions.sh "最好"

# Browse all suggestions
./scripts/suggestions.sh

Configuration

Create .env file in the skill directory:

CN_SEO_API_BASE=https://1341839497-2yuxt6z58d.ap-guangzhou.tencentscf.com
CN_SEO_TOKEN=your-token-here  # Optional: unlimited checks

Free tier: 20 checks/month (no registration needed) Token tier: Unlimited checks — get token via GitHub Issues

API Endpoints

EndpointMethodDescription
/checkPOSTFull compliance scan (banned words + SEO)
/suggestionsGETSafe replacement suggestions
/healthGETAPI status check

When to Use This Skill

  • User wants to check content for SEO issues or banned words
  • User wants to write Chinese content for Baidu / Xiaohongshu / Douyin / Taobao / JD
  • User mentions 违禁词, 广告法, 合规, 关键词密度, or any Chinese platform SEO term
  • User has existing Chinese content that needs optimization

Platform Rules

Baidu (百度)

Title Rules:

  • Primary keyword within first 15 Chinese characters
  • Length: 25-35 characters
  • Include year for freshness: "2026年最新"
  • Search intent modifiers: "攻略", "推荐", "对比", "怎么样", "哪个好"

Content Rules:

  • Length: 1500-3000 characters for competitive keywords
  • Keyword density: 2-4% (Baidu penalizes stuffing more than Google)
  • Primary keyword in first 100 characters
  • Clear H2/H3 hierarchy (Baidu spider values heading structure)
  • Cite Baidu Baike when possible (authority signal)
  • Original content only — Baidu's 原创星 rewards first-published content

Common Issues:

  • ❌ Keyword density < 2% → content won't rank
  • ❌ Keyword density > 4% → penalized as keyword stuffing
  • ❌ No H2/H3 structure → poor crawl efficiency
  • ❌ Content < 1500 chars → thin content penalty
  • ❌ Copied/rewritten content → 原创星 penalty

Xiaohongshu (小红书)

Title Rules:

  • Maximum 20 characters (shorter = higher CTR)
  • 1-2 emoji max in title
  • Power words: "绝了", "必入", "亲测", "避雷", "宝藏"
  • Formula: [Emotional hook] + [Keyword] + [Specific benefit]

Content Rules:

  • Length: 300-500 characters (longer = lower completion rate)
  • Numbered list format preferred
  • Keywords in: title + first line of body + hashtags
  • End with question to drive comments (comment count boosts ranking)
  • Authentic personal voice — not marketing speak

Algorithm Factors:

  • First 2 hours are critical — engagement velocity determines reach
  • Save rate (收藏) > Like rate (点赞) — write save-worthy content
  • Image: 3:4 ratio, 1080px+ width, text overlay on cover image
  • Hashtags: mix specific (#敏感肌防晒) + broad (#护肤) + trending (#夏日必备)

Common Issues:

  • ❌ Title > 20 chars → truncated in feed, lower CTR
  • ❌ No emoji → lower engagement
  • ❌ Too many emoji → looks spammy
  • ❌ Content > 500 chars → low completion rate
  • ❌ No question at end → fewer comments → lower ranking
  • ❌ Marketing tone → users distrust and scroll past

Douyin (抖音)

Caption Rules:

  • Max 55 characters visible in feed
  • 1-2 keywords for search discoverability
  • Question format boosts engagement: "你知道...吗?"
  • 2-3 topic tags: #话题名

Script Structure (15-60s videos):

[Hook 0-3s]: Shocking statement or question
[Problem 3-8s]: Relatable pain point
[Solution 8-45s]: Demonstration
[CTA last 3s]: "关注我" / "评论区扣1"

Algorithm Factors:

  • Completion rate is king — tight editing beats long content
  • Caption keywords indexed by Douyin search
  • Cover frame: text overlay showing keyword/topic
  • Trending sounds boost discoverability
  • Reply to early comments quickly → engagement signal

Common Issues:

  • ❌ Caption > 55 chars → truncated
  • ❌ No topic tags → invisible in topic feeds
  • ❌ Hook too slow → viewers scroll away in < 3s
  • ❌ No CTA → missed follower conversion

Taobao (淘宝) / JD.com (京东)

Product Title Rules:

  • Max 30 Chinese characters (60 bytes)
  • Order matters: Brand + Category + Attribute + Selling point + Modifier
  • No keyword repetition — use synonyms
  • Include searchable attributes (color, size, material, occasion)

Title Formula: [Brand] + [Core keyword] + [Attribute 1] + [Attribute 2] + [Selling point] + [Modifier]

Examples:

  • ✅ "三只松鼠 坚果礼盒 混合装每日坚果 过年送礼 年货大礼包"
  • ✅ "优衣库 男士羽绒服 轻薄短款 白鸭绒 荧光色 冬季新款"
  • ❌ "坚果坚果礼盒每日坚果混合装坚果大礼包" (keyword stuffing)

Product Description Rules:

  • 3-5 selling point bullets with keywords
  • Natural language with LSI keywords
  • Include: material, size, usage scenarios, differentiation
  • Trust signals: certifications, reviews, guarantees

SEO Factors:

  • Fill ALL product attributes — incomplete listings rank lower
  • Main image: white background, product centered, no text (platform rule)
  • Encourage reviews containing target keywords
  • Correct category = visibility in category browsing

Common Issues:

  • ❌ Title keyword stuffing → platform penalty
  • ❌ Missing attributes → lower search ranking
  • ❌ Wrong category → invisible in browse
  • ❌ Text on main image → platform demotion

Banned Words (广告法违禁词) — CRITICAL

Chinese advertising law (广告法) imposes heavy fines (¥200,000-1,000,000) for violations. Every piece of content must be checked.

Absolute Claims (绝对化用语) — ALWAYS BANNED

BannedSafe Alternative
最好/最佳/最优非常好/备受好评
第一/No.1销量领先/热销
顶级/极致/极品高端/优质
独家/唯一特色/甄选
绝对/绝无仅有深受认可/广受好评
首个/首选新品/精选
万能/包治/根治有助于/辅助改善

Medical Claims (医疗效果) — BANNED FOR NON-MEDICAL PRODUCTS

BannedSafe Alternative
治愈/根治/药到病除有助于改善/辅助调理
减肥/瘦身塑形/体态管理
美白(无特证)提亮/焕亮
祛斑(无特证)淡化/匀净
抗皱(无特证)紧致/弹润

Financial Claims — BANNED

BannedSafe Alternative
保本/保收益稳健型
零风险低风险
稳赚/翻倍历史表现良好

Platform-Specific Banned Content

  • Xiaohongshu: No WeChat redirects, no price comparisons, no fake reviews
  • Douyin: No off-platform transactions, no exaggerated claims, unmarked ads
  • Taobao/JD: No price fraud, no fake stock, no offline transaction guidance

Quick Self-Check

Search your content for these patterns — ANY match needs fixing:

  1. "最" + adjective → replace
  2. "第一" / "No.1" → replace
  3. "绝对" / "一定" → replace
  4. "根治" / "治愈" / "100%" → replace
  5. "包" + effect promise → replace
  6. Any medical claim on non-medical product → replace

Rule of thumb: Use specific data instead of absolute claims. "98%用户反馈改善" is safe; "100%有效" is illegal.


Keyword Research Guidance

When the user needs keywords, suggest:

  1. Baidu Index (index.baidu.com) — search volume trends + demographic data
  2. Xiaohongshu search suggestions — type partial keyword, record autocomplete
  3. Douyin search hot list — trending topics in category
  4. Taobao/JD search dropdown — what buyers actually search for
  5. 5118.com — comprehensive Chinese keyword research (freemium)

Selection priorities:

  • High volume + Low competition = sweet spot
  • Long-tail keywords (4+ chars) for new accounts
  • Question keywords ("...怎么样", "...好用吗") = lower competition + higher conversion
  • Seasonal keywords: plan 2-4 weeks ahead

Output Formats

Analysis Report (检查模式)

# SEO & Compliance Analysis Report

## 📊 Overall Score: [X/100]

### 🔴 Banned Words (违禁词) — MUST FIX
| # | Word | Category | Location | Replacement |
|---|------|----------|----------|-------------|
| 1 | ... | 绝对化用语 | Title line 1 | ... |

### 🟡 SEO Issues — SHOULD FIX
| # | Issue | Platform Rule | Current | Target |
|---|-------|---------------|---------|--------|
| 1 | Keyword density low | Baidu 2-4% | 1.2% | 2-4% |
| 2 | Title too long | XHS ≤20 chars | 28 chars | ≤20 |

### 🟢 Passed Checks
- [x] No banned words in body
- [x] Hashtag strategy correct
- [x] Content length appropriate

### 📝 Suggested Rewrite
[Fixed version of the content]

Generated Content (创作模式)

# [Platform] SEO Content

## SEO Strategy
- **Primary keyword**: [keyword] — [competition level]
- **Secondary keywords**: [list]
- **Target audience**: [description]
- **Content goal**: [traffic / sales / awareness / followers]

## Optimized Title
[title with keyword placement annotated]

## Content Body
[full content, formatted per platform rules]

## Compliance Check ✅
- [x] No banned words detected
- [x] Keyword density: X% (within range)
- [x] Title length: X chars (within limit)
- [x] Content length: X chars (appropriate)

## Hashtags / Tags
[list with reasoning]

## Posting Tips
- **Best time**: [platform-specific]
- **Frequency**: [recommended schedule]
- **Engagement**: [how to boost initial engagement]
- **A/B test**: [alternative title/hook to test]

Important Notes

  • Always write in natural, fluent Chinese — never translated English. Chinese users detect machine translation instantly.
  • Platform culture matters: Xiaohongshu = authentic/personal; Baidu = authoritative/comprehensive; Douyin = entertaining/fast; E-commerce = specific/trustworthy.
  • Compliance is non-negotiable: 广告法 fines are real and heavy. When in doubt, use softer alternatives.
  • Data > claims: "98%用户反馈改善" beats "100%有效" — both in compliance and credibility.
  • Use the API scripts for automated scanning — they catch things manual review misses.

🔮 Content Prediction & Calibration (NEW)

This skill now includes a prediction calibration system — inspired by scientific methodology:

How It Works

1. 发布前:调用 /predict 获取5维预测评分
2. 记录预测(不可修改!)
3. 发布内容
4. T+3天:复盘实际数据 vs 预测
5. 校准:根据偏差调整评分权重
6. 重复 → 越用越准

5 Prediction Dimensions

维度说明评分
合规风险被平台处罚/限流的风险0-100(0=合规)
互动潜力获得点赞/评论/分享的概率0-100
品牌安全对品牌形象的影响0-100(0=安全)
搜索可见度在目标平台被搜索到的概率0-100
AI引用概率被AI搜索引擎引用的概率0-100

Calibration Phases

  • 冷启动期(0篇复盘):基于通用规则,准确度低
  • 学习期(1-4篇复盘):开始校准,准确度中
  • 校准期(5+篇复盘):基于个人数据,准确度高

API Endpoint

POST /predict
Body: {"text": "内容文案", "platform": "xiaohongshu", "historyCount": 3}

Why this matters: 不复盘的每一篇,都是在折损"看见自己"的能力。预测校准让工具变成教练——越用越离不开。


🌐 Web App — 合规通

不想写代码?直接用Web版:

👉 https://1341839497-jv04655vcs.ap-shanghai.tencentscf.com/

  • 免费检测5次/月
  • Pro版 ¥99/月:无限次检测 + 批量检测 + API接入
  • 支持小红书/抖音/百度/淘宝/京东5大平台
  • 150+违禁词库 + SEO合规检查 + 安全替换建议