Title: Raptor Content Refiner
Author: Amr Issa
Published: <strong>May 29, 2026</strong>
Last modified: October 2, 2026

---

Search plugins

![](https://s.w.org/plugins/geopattern-icon/raptor-content-refiner.svg)

# Raptor Content Refiner

 By [Amr Issa](https://profiles.wordpress.org/amr267/)

[Download](https://downloads.wordpress.org/plugin/raptor-content-refiner.1.0.1.zip)

 * [Details](https://test.wordpress.org/plugins/raptor-content-refiner/#description)
 * [Reviews](https://test.wordpress.org/plugins/raptor-content-refiner/#reviews)
 *  [Installation](https://test.wordpress.org/plugins/raptor-content-refiner/#installation)
 * [Development](https://test.wordpress.org/plugins/raptor-content-refiner/#developers)

 [Support](https://wordpress.org/support/plugin/raptor-content-refiner/)

## Description

Raptor Content Refiner adds a manual “Refine Content” button to both the Gutenberg
block editor and the Classic Editor. When you click it, the plugin sends your content
to an AI service that restructures it into a clean, SEO-friendly, and easy-to-read
format.

**What it does:**

 * Removes unnecessary HTML tags, messy markup, and redundant elements
 * Applies proper heading hierarchy (H1 through H6 in logical order)
 * Structures content into clean paragraphs, lists, and blockquotes
 * Eliminates inline styles, empty tags, deprecated attributes, and div soup
 * Improves readability, visual clarity, and on-page SEO
 * Preserves the original meaning, intent, images, and hyperlinks

**Key features:**

 * Works with posts, pages, and any custom post type
 * Never runs automatically — you are always in control
 * Supports both Gutenberg (block editor) and Classic Editor
 * Compatible with WordPress 6.6 through 7.1 and later
 * On WordPress 7.0+, integrates with the built-in AI Client and Connectors API
 * On WordPress 6.6–6.9, provides its own settings page for API key configuration
 * Supports OpenAI, Anthropic, and Google AI providers

### External Services

This plugin connects to third-party AI services to process and restructure your 
content. **No data is sent automatically.** External API calls are made only when
you manually click the “Refine Content” button.

**Data transmitted:** Only the HTML content of the post you are editing is sent 
to the AI service. No personal data, metadata, or site information is transmitted.

Depending on your configuration, the plugin may connect to one of the following 
services:

#### OpenAI

 * Service: OpenAI API (https://openai.com)
 * API Endpoint: https://api.openai.com/v1/chat/completions
 * Terms of Use: https://openai.com/policies/terms-of-use
 * Privacy Policy: https://openai.com/policies/privacy-policy

#### Anthropic

 * Service: Anthropic API (https://www.anthropic.com)
 * API Endpoint: https://api.anthropic.com/v1/messages
 * Terms of Service: https://www.anthropic.com/legal/consumer-terms
 * Privacy Policy: https://www.anthropic.com/legal/privacy

#### Google AI

 * Service: Google AI Gemini API (https://ai.google.dev)
 * API Endpoint: https://generativelanguage.googleapis.com/v1beta/models/
 * Terms of Service: https://policies.google.com/terms
 * Privacy Policy: https://policies.google.com/privacy

On WordPress 7.0+, the plugin uses the built-in WordPress AI Client and Connectors
API. The specific AI service used depends on which connector the site administrator
has configured in Settings > Connectors.

### Source Code and Build Process

This plugin’s JavaScript is bundled with @wordpress/scripts (webpack-based). The
human-readable source files are included in the `src/` directory inside the deployed
plugin, and `package.json` documents the build tool and its dependencies.

To rebuild the assets from source:

 1. Install Node.js dependencies: `npm install`
 2. Build the assets: `npm run build`

This regenerates `build/index.js`, `build/index.asset.php`, `build/style-index.css`,
and `build/style-index-rtl.css` from the files in `src/`.

The Classic Editor JavaScript (`assets/classic-editor.js`) and CSS (`assets/classic-
editor.css`) are not bundled and are loaded directly — no build step is required
for those files.

## Installation

 1. Upload the `raptor-content-refiner` folder to the `/wp-content/plugins/` directory.
 2. Activate the plugin through the “Plugins” menu in WordPress.
 3. Configure your AI provider:
 4.  * **WordPress 7.0+**: Go to Settings > Connectors and configure your AI provider
       there. The plugin will use it automatically.
     * **WordPress 6.6–6.9**: Go to Settings > Raptor Content Refiner and enter your
       API key for your preferred AI provider (OpenAI, Anthropic, or Google).
 5. Open any post, page, or custom post type in the editor.
 6. In the Gutenberg editor, find the “Raptor Content Refiner” panel in the document
    settings sidebar. In the Classic Editor, find the “Refine Content” button above
    the editor.
 7. Click the button and wait for your content to be restructured.

## FAQ

### Does this plugin modify my content automatically?

No. The plugin only runs when you manually click the “Refine Content” button. Your
content is never modified without your explicit action.

### Does it work with custom post types?

Yes. The plugin works with any post type that uses the standard WordPress editor.

### What AI providers are supported?

On WordPress 7.0+, any provider configured through the Connectors API is supported.
On earlier versions, the plugin supports OpenAI, Anthropic, and Google AI directly.

### Will it change the meaning of my content?

No. The AI is instructed to preserve the original meaning, intent, facts, and tone.
It only restructures the HTML formatting and markup.

### Can I undo the changes?

Yes. In the Gutenberg editor, use Ctrl+Z (Cmd+Z on Mac) to undo. In the Classic 
Editor, use the undo button or keyboard shortcut. The changes are not saved until
you click “Update” or “Publish”.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Raptor Content Refiner” is open source software. The following people have contributed
to this plugin.

Contributors

 *   [ Amr Issa ](https://profiles.wordpress.org/amr267/)

[Translate “Raptor Content Refiner” into your language.](https://translate.wordpress.org/projects/wp-plugins/raptor-content-refiner)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/raptor-content-refiner/),
check out the [SVN repository](https://plugins.svn.wordpress.org/raptor-content-refiner/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/raptor-content-refiner/)
by [RSS](https://plugins.trac.wordpress.org/log/raptor-content-refiner/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 1.0.1

 * Tested up to WordPress 7.1
 * WordPress 7.0+: 120-second request timeout and 8192 token limit for the built-
   in AI Client
 * WordPress 7.0+: Refine Content now works with reasoning models that do not accept
   a temperature setting
 * Clear error messages for disabled AI features, missing provider, invalid API 
   key, rate limits, network failures, and content that is too long
 * Editors show a notice and a disabled button when AI features are disabled on 
   the site
 * Fixed the Settings > Connectors link
 * Updated default models: OpenAI gpt-6-luna, Anthropic claude-sonnet-5-5, Google
   gemini-3.5-flash-lite (retired Anthropic/Google defaults are switched automatically)
 * OpenAI: uses max_completion_tokens; reasoning models get reasoning_effort instead
   of temperature
 * Google: API key sent in the x-goog-api-key header instead of the URL; default
   temperature for Gemini 3
 * Block editor: dynamic, layout, synced-pattern, embed and media blocks are no 
   longer rewritten; only text blocks are refined and all other blocks are kept 
   exactly as they are
 * Block editor: the result is discarded if the AI drops part of the layout or if
   you edit the post while refining; saving is paused during a refine
 * Markdown code fences and stray html/body wrappers are removed from AI output
 * REST endpoint: invalid parameter types return a 400 instead of a server error;
   logged-out requests return 401 and unknown posts 404
 * Settings: saving can no longer wipe stored settings, and the saved API key is
   never printed back into the page
 * Minimum WordPress version is now 6.6 (required by the block editor script)
 * Editor script loads only in the post editor (not in the Widgets, Customizer or
   Site Editor screens)
 * Added script translations for the block editor and translatable Classic Editor
   strings
 * Classic Editor: button also appears for users without media upload access, new-
   post guard fixed, and an “Undo refine” link after refining
 * Uninstalling the plugin removes its saved settings

#### 1.0.0

 * Initial release
 * Gutenberg block editor integration with sidebar panel
 * Classic Editor integration with toolbar button
 * Support for OpenAI, Anthropic, and Google AI providers
 * WordPress 7.0 AI Client compatibility
 * Fallback settings page for WordPress 6.6–6.9

## Meta

 *  Version **1.0.1**
 *  Last updated **19 hours ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.6 or higher **
 *  Tested up to **7.1.2**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/raptor-content-refiner/)
 * Tags
 * [AI](https://test.wordpress.org/plugins/tags/ai/)[content](https://test.wordpress.org/plugins/tags/content/)
   [formatting](https://test.wordpress.org/plugins/tags/formatting/)[Readability](https://test.wordpress.org/plugins/tags/readability/)
   [seo](https://test.wordpress.org/plugins/tags/seo/)
 *  [Advanced View](https://test.wordpress.org/plugins/raptor-content-refiner/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/raptor-content-refiner/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/raptor-content-refiner/reviews/)

## Contributors

 *   [ Amr Issa ](https://profiles.wordpress.org/amr267/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/raptor-content-refiner/)