The scam detection engine that analyzes messages, URLs, crypto addresses, and phone numbers — before you click, send, or lose money.
Scammers cast a wide net. Most people rely on gut feeling to spot them. Scam Shield gives you an instant risk score on anything suspicious — a DM, a link, a crypto wallet, a phone number. Paste it in, get an answer.
Works as a Telegram bot, CLI tool, or API. Drop it into your workflow, your family group chat, or your product.
- Instant risk scoring — 0–100 score with matched pattern explanations
- Multi-surface detection — Messages, URLs, crypto addresses, phone numbers
- 100+ scam patterns — Continuously updated detection rules
- Zero friction — No signup, no install — just paste and check
- Multiple interfaces — Telegram bot, CLI, or embeddable API
- Free tier included — 10 checks/day, no credit card required
- Receive something suspicious — a DM, a link, a crypto wallet, a phone number
- Paste it into Scam Shield — via Telegram bot, CLI, or API call
- Auto-detection kicks in — identifies whether it's a message, URL, crypto address, or phone number (or specify manually)
- Get your answer — instant risk score (0–100) with every matched pattern explained
- Make an informed decision — block, ignore, or proceed with caution
| Surface | Patterns | Examples |
|---|---|---|
| 🚨 Urgency/fear tactics | Messages | "Act now!", "Expires soon!", "Limited time!" |
| 💰 Financial manipulation | Messages | "Guaranteed returns!", "Double your money!" |
| 👮 Authority impersonation | Messages | "IRS", "FBI", "Your account is suspended" |
| 💕 Romance scams | Messages | "I love you", "I'm stranded", "Send money" |
| ₿ Crypto scams | Messages, Crypto | "Connect your wallet", "Free airdrop", "Double your BTC" |
| 🎣 Phishing | Messages, URLs | "Click here to verify", typosquatting, suspicious TLDs |
| 🧠 Social engineering | Messages | "Keep this secret", "Trust me", "Not a scam" |
| 📞 Phone scams | Phones | Premium rates, spoofed numbers, scam area codes |
| 💎 Dust attacks | Crypto | Burn addresses, known scam tokens |
Scam Shield runs as a Telegram bot. Check anything suspicious instantly:
- Open @ScamShieldBot on Telegram
- Forward a suspicious message or paste a link/number/address
- Get instant risk score with explanations
- No app install, no account — just open and paste
Every day, millions of people receive messages from "princes," "IRS agents," and "lottery winners." Scam losses topped $1.1 trillion globally in 2023. Scam Shield gives you a fighting chance — instant analysis that works even when you're tired, distracted, or emotionally manipulated.
The ROI is simple: One prevented scam pays for months of Premium.
- Everyone — You get scam messages daily. Now you can check them instantly.
- Families — Protect less tech-savvy relatives. Forward suspicious messages and get a verdict.
- Small businesses — Verify leads, invoices, and links before acting on them.
- Developers — Drop the API into your product to add scam detection in minutes.
- Crypto users — Check wallet addresses and token contracts before connecting or sending.
# Analyze a message
echo "Congratulations! You won $10,000! Click here to claim!" | node scanner.js "$(cat)" message | node format.js
# Check a URL
node scanner.js "https://secure-login.xyz/verify" url | node format.js
# Check a crypto address
node scanner.js "0x1234..." crypto | node format.js
# Auto-detect input type
node scanner.js "suspicious message or url or address" | node format.js| Score | Category | Meaning |
|---|---|---|
| 70-100 | 🚨 HIGH_RISK | Strong scam indicators. Do not engage. |
| 40-69 | Some red flags. Verify before acting. | |
| 15-39 | ⚡ LOW_RISK | Minor indicators. Usually safe. |
| 0-14 | ✅ CLEAN | No scam indicators detected. |
📊 SCAM SHIELD ANALYSIS
🔍 Input Type: Message
🚨 Risk Score: 85/100 (HIGH_RISK)
Matched Patterns:
• "Congratulations! You won" → Prize/lottery scam
• "Click here to claim" → Phishing attempt
• "$10,000" → Unrealistic prize value
• "Act now!" → Urgency/fear tactics
⚠️ VERDICT: Do not engage. This is a classic prize scam.
Prerequisites: Node.js 18+ and npm.
# Clone and install
git clone https://github.com/Clawthority/scam-shield.git
cd scam-shield
npm install
# Set up environment (optional — works without API keys for basic checks)
cp .env.example .env
# Edit .env with your config
# Run a quick test
node scanner.js "Congratulations! You won $10,000!" message | node format.js| Tier | Price | Features |
|---|---|---|
| Free | $0 | 10 checks/day via Telegram |
| Premium | $5/month | Unlimited checks, family protection |
| Business API | $100/month | Unlimited API calls, webhook integration |
| Enterprise | $500/month | White-label, custom patterns, priority support |
- Scam Academy — Train yourself to spot scams with interactive simulations. Scam Shield detections feed directly into Scam Academy training scenarios.
- 100+ scam patterns — Continuously updated detection rules across all surfaces
- Phone number detection — Check suspicious phone numbers against known scam patterns
- CLI and API — Multiple interfaces for developers and power users
Issues and PRs welcome. To add new scam patterns, edit the pattern files in patterns/ and run the test suite:
npm testMIT