Text Spinner processor for JoomGrabber

The Text Spinner Processor is an advanced tool designed for content rewriting. Traditionally, it was used as a synonym-based article spinner for SEO purposes, making duplicated content appear original to search engines.

With the latest update, the Text Spinner Processor now integrates with both OpenAI's API and Google AI Studio (Gemini), enabling sophisticated text rewriting in any language supported by AI. This ensures higher quality, contextually accurate, and fluent rewritten content, regardless of the input language.

What is Text Spinner Processor

The Text Spinner Processor is a built-in article spinner for JoomGrabber, now enhanced with AI capabilities. It automatically rewrites articles fetched from RSS Feeds before auto-posting, using the power of OpenAI's language models or Google's Gemini models.

• Original Functionality: Previously, the processor relied on predefined synonym lists (spintax) stored in text files to spin words and phrases within articles. Users could customize these lists or create new ones for different languages.
• Updated Functionality: The processor now uses AI APIs to perform more advanced text rewriting. This method goes beyond simple synonym replacement, delivering natural-sounding, context-aware rewritten content that preserves the original meaning.

How to make JoomGrabber spin your text with Text Spinner

AI Service Selection

Choose between two powerful AI services:

• OpenAI (GPT): Uses GPT models for text rewriting
• Google AI Studio (Gemini): Uses Google's Gemini models
• The processor automatically falls back to an available service if your preferred choice isn't configured

Feeding Text for Rewriting

Provide the text field you wish to rewrite to the processor. This can be:

• A description field from your RSS Source
• A fulltext field from the Get Fulltext Processor
• Any other content you want to spin

The processor will then send the text to the selected AI API, which rewrites it, ensuring it is unique and reads naturally.

Customization Options

Spinning Intensity

Control how much the content is rewritten:

• Light (20-30% changes): Minimal rewording while ensuring uniqueness
• Moderate (50-60% changes): Balanced rewriting for good variation
• Heavy (80-90% changes): Extensive rewording while maintaining meaning
• SEO Optimized (60-70% changes): Special mode that optimizes for search engines

HTML Preservation

Toggle to preserve HTML tags and structure during the spinning process. When enabled, the processor:

• Maintains all HTML tags and attributes
• Preserves formatting, links, and media elements
• Only rewrites the text content within tags

Randomization

Add more randomness to the output for less conservative results. When enabled:

• Creates more unique variations each time
• Less predictable output patterns
• Higher temperature for AI processing

Key Features

Multi-Language Support

The processor now supports text rewriting in any language recognized by AI, making it versatile for global use.

Advanced Rewriting

AI APIs provide contextually aware and natural-sounding text rewriting, far superior to traditional synonym-based spinning.

SEO Optimization

The rewritten content appears original to search engines, helping improve your site's SEO rankings. The SEO mode specifically:

• Improves keyword usage naturally
• Enhances readability
• Makes content more engaging

Flexibility and Customization

While AI handles the heavy lifting, you can customize the output through:

• Spinning intensity levels
• HTML preservation settings
• Randomization control
• Choice of AI provider

Error Handling

Robust error management with:

• Automatic fallback between AI services
• Preservation of original content on failure
• Detailed error messages in the stop object
• Debug information available with pdebug=1

How to Configure Your API Keys

OpenAI API Key

To use the Text Spinner Processor with OpenAI's API, you need an API key:

1. Sign Up for OpenAI:

   • Go to OpenAI's website
   • Click on the "Sign Up" button if you do not have an account
   • If you already have an account, click "Log In"

2. Create an Account:

   • Fill in the required details to create your account
   • This may include your name, email address, and payment information

3. Access the API Key:

   • Once logged in, navigate to the API section of your account dashboard
   • Click on "Create API Key" to generate a new API key

4. Copy the API Key:

   • After generating the key, copy it to a secure location
   • You will need this key to authenticate your API requests

Google AI Studio API Key

To use the Text Spinner Processor with Google AI Studio:

1. Visit Google AI Studio:

   • Go to Google AI Studio
   • Sign in with your Google account

2. Create API Key:

   • Navigate to the API section
   • Generate a new API key
   • Copy and save the key securely

Configure in JoomGrabber

1. Go to JoomGrabber and edit your pipe that uses the Text Spinner processor
2. Edit processor settings to add your API Key(s)
3. Select your preferred AI service
4. Configure spinning intensity and other options
5. Save your settings

Input/Output Fields

Input Fields

• text: Text content to be spun/rewritten

Output Fields

• spunText: Rewritten text content
• stop: Error handling object with state and msg properties

Processing Workflow

1. Input Validation

   • Checks for empty input
   • Initializes error handling

2. Service Selection

   • Chooses AI service based on configuration
   • Falls back to available service if needed

3. Prompt Generation

   • Constructs prompt based on settings
   • Applies intensity and preservation rules
   • Includes language detection instructions

4. Content Spinning

   • Sends content to AI service
   • Processes response and validates output
   • Returns spun content

5. Error Handling

   • Returns original text on failure
   • Provides detailed error messages
   • Attempts fallback to alternative service

Best Practices

API Key Management

• Keep your API keys confidential
• Do not share them publicly or hard-code them in publicly accessible code
• Use environment variables or secure storage mechanisms

Content Quality

• Test different spinning intensities to find the right balance
• Use the HTML preservation option for formatted content
• Review output to ensure quality and accuracy
• Use SEO mode for search engine optimization

Performance

• Monitor API usage to manage costs
• Use appropriate intensity levels for your needs
• Enable debugging (pdebug=1) to troubleshoot issues

Troubleshooting

Common Issues

• API Key Errors: Verify your API key is correctly entered
• Service Unavailable: The processor will automatically fall back to the other service
• Content Not Spinning: Check the stop object for error messages
• HTML Breaking: Enable the HTML preservation option

Debug Mode

Enable debugging by adding ?pdebug=1 to your URL to see:

• Input text and parameters
• API requests and responses
• Error messages
• Processing steps

The Text Spinner Processor represents a significant advancement in content rewriting technology, leveraging the power of modern AI to deliver superior results compared to traditional spinning methods.