SpamJudge

Description

SpamJudge uses AI large language models to automatically detect and filter spam comments.

Features

  • Supports any API compatible with the OpenAI format
  • Supports both /v1/chat/completions and /v1/response endpoints
  • Customizable AI prompts to adjust scoring criteria based on the characteristics of the website
  • Configurable score thresholds for flexible control over filtering intensity
  • Detailed logging to track the processing of each comment

Workflow

  1. Visitor submits a comment
  2. The plugin intercepts the comment and sends it to the AI for scoring
  3. The AI returns a score between 0 and 100 (0 = spam, 100 = high quality)
  4. The comment is automatically processed based on the score and threshold:
    • Score >= threshold: approved
    • Score < threshold: moved to spam or moved to moderation based on settings
    • Timeout/error: moved to moderation or directly approved based on settings
  5. Detailed logs are recorded for administrators to review

Default system prompt in the current version

You are a spam comment detection system. Your ONLY task is to output a single number between 0 and 100.

SCORING RULES:
- 0-20: Obvious spam (ads, malicious links, gibberish)
- 21-40: Likely spam (suspicious links, bot-like comments)
- 41-60: Uncertain (short comments, borderline content)
- 61-80: Likely legitimate (relevant, thoughtful)
- 81-100: Clearly legitimate (detailed, helpful, on-topic)

CRITICAL INSTRUCTIONS:
1. Output ONLY a number (0-100)
2. NO explanations
3. NO additional text
4. NO punctuation
5. Just the number

Example valid outputs: 85
Example INVALID outputs: "Score: 85", "85 points", "I think it's 85"

If you output anything other than a single number, the system will fail.

Screenshots

  • Log interface
  • Settings interface

Installation

Automatic installation

  1. Log in to the WordPress admin dashboard
  2. Navigate to “ Plugins” > “ Add New”
  3. Search for “ SpamJudge”
  4. Click “ Install Now”
  5. After installation is complete, click “ Activate”

Manual installation

  1. Download the plugin zip file
  2. Log in to the WordPress admin dashboard
  3. Go to “ Plugins” > “ Add New” > “ Upload Plugin”
  4. Select the downloaded zip file
  5. Click “ Install Now”
  6. After the installation is complete, click “ Activate”

FTP Installation

  1. Unzip the plugin zip file
  2. Upload the spamjudge folder to the /wp-content/plugins/ directory via FTP
  3. Log in to the WordPress admin dashboard
  4. Go to the “ Plugins” page
  5. Locate “ SpamJudge” and click “ Activate”

FAQ

Does it require payment?

The plugin itself is free, but you need an AI API key. Most AI API services require payment based on the number of tokens used.

Where will the comment data be sent?

Comment data will be sent to the API you configure for scoring. Make sure to use a trusted API provider and review its privacy policy. The plugin itself does not collect or store any data on third-party servers.

How much additional wait time will be added when submitting a comment?

It adds about 3 seconds, depending on the service provider and model used. Using a non-thinking model can effectively reduce wait time.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“SpamJudge” is open source software. The following people have contributed to this plugin.

Contributors

Translate “SpamJudge” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.1.0(2025-12-03)

  • Compatible with the /v1/responses endpoint
  • Endpoint URL auto-completion
  • Deprecation of “ temperature”

1.0.0(2025-11-01)

  • First version