ContentGuard v0.3.1
Professional content moderation and spam detection for modern applications.
ContentGuard analyzes text for spam, harassment and malicious patterns. It combines a powerful rule engine with optional machine‑learning plugins to deliver fast and accurate results across many languages.
Installation
npm install content-guard
Quick start
const { ContentGuard } = require('content-guard');
const guard = new ContentGuard('moderate');
const result = await guard.analyze('Hello world');
console.log(result.isSpam);
Key features
- Multiple presets from lenient to strict
- Context-aware detection using natural language processing
- Pluggable rule engine with keyboard spam, sentiment and harassment filters
- Optional ML plugins for emoji sentiment, cross‑cultural checks and toxicity analysis
- Unicode confusables normalization to stop obfuscation attacks
- CLI for batch processing and scripting
- Lightweight and fast – suitable for serverless environments
- TypeScript definitions included
v4.5 Variants
ContentGuard v4.5 ships four tuned variants so you can balance speed and accuracy:
| Variant | Accuracy | Avg time | Use case |
|---|
| v4.5-turbo | ~91% | 0.02ms | Real‑time chat and high‑volume streams |
| v4.5-fast | ~91.5% | 0.06ms | API gateways and microservices |
| v4.5-balanced | ~93% | 0.25ms | General production deployments (default) |
| v4.5-large | ~94% | 1.32ms | Enterprise and critical moderation |
Select a variant when creating an instance or via the CLI.
Plugins and use cases
ContentGuard includes a modular plugin system. Enable only what you need:
| Plugin | Description & typical use case |
|---|
| Obscenity | Detects offensive language. Use for community guidelines. |
| Sentiment | Scores tone of text. Great for chat analytics. |
| Harassment | Flags bullying or hateful phrases. Essential for social apps. |
| Social Engineering | Finds phishing or scam attempts. Useful for email filters. |
| Keyboard Spam | Identifies random key mashing. Perfect for form submissions. |
| Emoji Sentiment | Interprets emoji tone. Adds nuance to sentiment analysis. |
| Cross‑Cultural | Checks for culturally sensitive terms. Global deployments. |
| ML Toxicity | Machine‑learning based toxicity scoring. Higher accuracy. |
| Confusables | Normalizes look‑alike Unicode characters. Prevents obfuscation. |
CLI usage
npx content-guard "Some text" --preset strict --variant fast
See the examples/ folder for integration samples.
Configuration
Each preset can be customized. Review lib/presets and adjust plugin weights, thresholds and preprocessing options to match your needs.
License
ContentGuard is released under the MIT License.
Other languages: Español | Français | 中文
