content-guard

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 | 中文