Documentation

Complete guide to using AUTO-blogger for WordPress automation and content management.

Getting Started

AUTO-blogger is a powerful WordPress automation tool that combines web scraping, AI content rewriting, and automated posting capabilities.

Quick Start

  1. Install AUTO-blogger - Follow our installation guide
  2. Configure credentials - Set up WordPress and API keys
  3. Launch the application - Run autoblog or python3 gui_blogger.py
  4. Start automating - Use the GUI to configure and run automation tasks
First Time Setup:

Make sure you have your WordPress site credentials and OpenAI API key ready before starting.

🔐 Authentication

AUTO-blogger requires several API keys and credentials to function properly:

WordPress Credentials

Site URL

Your WordPress site URL (e.g., https://yourblog.com)

Username & Password

WordPress admin username and password, or application password for enhanced security

OpenAI API Key

API Key

Get your API key from OpenAI Platform

Environment Variable
$ export OPENAI_API_KEY="your-api-key-here"

Getty Images API (Optional)

API Key

For enhanced image search and embedding capabilities

Register at Getty Images Developer Portal

Security Note:

Never commit API keys to version control. Use environment variables or secure configuration files.

⚙️ Configuration

Configure AUTO-blogger through the GUI or configuration files:

GUI Configuration

The main interface provides tabs for different configuration areas:

🌐 WordPress Settings

  • Site URL and credentials
  • Post categories and tags
  • Publishing preferences

🤖 AI Settings

  • OpenAI model selection
  • Content rewriting parameters
  • SEO optimization settings

🔍 Scraping Settings

  • Target websites and URLs
  • Content extraction rules
  • Rate limiting and delays

Configuration Files

Advanced users can edit configuration files directly:

config.json
{
  "wordpress": {
    "site_url": "https://yourblog.com",
    "username": "admin",
    "password": "your-password"
  },
  "openai": {
    "api_key": "your-openai-key",
    "model": "gpt-3.5-turbo",
    "max_tokens": 2000
  },
  "scraping": {
    "delay_between_requests": 2,
    "max_retries": 3,
    "timeout": 30
  }
}

📖 Usage Guide

Learn how to use AUTO-blogger's main features:

Basic Workflow

1

Content Discovery

Enter target URLs or use automated discovery to find content

2

Content Extraction

Extract article content, images, and metadata

3

AI Rewriting

Rewrite content using OpenAI with SEO optimization

4

Image Processing

Download, optimize, and embed relevant images

5

WordPress Publishing

Automatically publish to your WordPress site

Command Line Usage

CLI Commands
# Launch GUI
$ autoblog

# Run with specific config
$ autoblog --config /path/to/config.json

# Test installation
$ autoblog --test

# Batch processing
$ autoblog --batch --input urls.txt

# Debug mode
$ autoblog --debug

Features Guide

Content Scraping

Supported Sources

  • News websites and blogs
  • RSS feeds
  • Social media posts
  • Custom URL lists

Extraction Capabilities

  • Article text and formatting
  • Images and media
  • Metadata and SEO tags
  • Author and publication info

AI Content Rewriting

Rewriting Options

  • Paraphrasing and restructuring
  • SEO keyword optimization
  • Tone and style adjustment
  • Length modification

Quality Controls

  • Plagiarism detection
  • Readability scoring
  • Fact-checking prompts
  • Manual review options

WordPress Integration

Publishing Features

  • Automatic post creation
  • Category and tag assignment
  • Featured image setting
  • SEO metadata optimization

Scheduling Options

  • Immediate publishing
  • Scheduled posting
  • Draft creation
  • Bulk operations

Getty Images Integration

Image Search

  • Keyword-based search
  • Category filtering
  • License type selection
  • Quality and size options

Embedding Features

  • Automatic image embedding
  • Caption generation
  • Alt text optimization
  • Responsive sizing

API Reference

For developers who want to integrate or extend AUTO-blogger:

Core Classes

ContentScraper

Handles web scraping and content extraction

from scraper import ContentScraper

scraper = ContentScraper()
content = scraper.extract_content(url)
print(content.title, content.text, content.images)

AIRewriter

AI-powered content rewriting and optimization

from ai_rewriter import AIRewriter

rewriter = AIRewriter(api_key="your-key")
rewritten = rewriter.rewrite_content(
    content=original_text,
    style="professional",
    seo_keywords=["automation", "wordpress"]
)

WordPressPublisher

WordPress API integration for automated publishing

from wordpress_publisher import WordPressPublisher

publisher = WordPressPublisher(
    site_url="https://yourblog.com",
    username="admin",
    password="password"
)

post_id = publisher.create_post(
    title="Your Post Title",
    content="Post content here",
    categories=["Technology"],
    tags=["automation", "ai"]
)

Configuration API

Configuration Management
from config_manager import ConfigManager

# Load configuration
config = ConfigManager.load_config("config.json")

# Update settings
config.set("wordpress.site_url", "https://newsite.com")
config.save()

# Environment variables
config.load_from_env()

Troubleshooting

Common Issues

WordPress Connection Failed

Symptoms: Cannot connect to WordPress site

Solutions:

  • Verify site URL format (include https://)
  • Check username and password
  • Ensure WordPress REST API is enabled
  • Check for security plugins blocking API access

OpenAI API Errors

Symptoms: AI rewriting fails or returns errors

Solutions:

  • Verify API key is correct and active
  • Check API usage limits and billing
  • Reduce content length if hitting token limits
  • Try different model (gpt-3.5-turbo vs gpt-4)

Scraping Blocked

Symptoms: Cannot extract content from websites

Solutions:

  • Increase delay between requests
  • Use different user agents
  • Check for CAPTCHA or anti-bot measures
  • Respect robots.txt and rate limits

Chrome/Selenium Issues

Symptoms: Browser automation fails

Solutions:

  • Update Chrome to latest version
  • Check ChromeDriver compatibility
  • Run in headless mode for server environments
  • Increase timeout values

Debug Mode

Enable debug mode for detailed logging:

Debug Commands
# Enable debug logging
$ export DEBUG=true
$ autoblog --debug

# Check log files
$ tail -f logs/autoblog.log

# Test individual components
$ python3 -m pytest tests/ -v

Getting Help

📧 Email Support

Contact: AryanVBW@gmail.com

🐛 GitHub Issues

Report bugs: GitHub Issues

💬 Community

Join discussions and get community support

🤝 Contributing

We welcome contributions to AUTO-blogger! Here's how to get started:

Development Setup

Development Environment
# Fork and clone the repository
$ git clone https://github.com/yourusername/AUTO-blogger.git
$ cd AUTO-blogger

# Create development environment
$ python3 -m venv dev-env
$ source dev-env/bin/activate

# Install development dependencies
$ pip install -r requirements-dev.txt

# Install pre-commit hooks
$ pre-commit install

Contribution Guidelines

  • Follow PEP 8 style guidelines
  • Write tests for new features
  • Update documentation
  • Create detailed pull request descriptions

Testing

Running Tests
# Run all tests
$ pytest

# Run with coverage
$ pytest --cov=autoblogger

# Run specific test file
$ pytest tests/test_scraper.py

# Run integration tests
$ pytest tests/integration/

Changelog

v2.1.0 - Latest

Released: January 2025

✨ New Features

  • Getty Images API integration
  • Enhanced UI with radio buttons and tooltips
  • Non-interactive installation mode
  • Auto-update functionality

🐛 Bug Fixes

  • Fixed installation script hanging issues
  • Resolved create_launchers function error
  • Improved error handling in scraping module

Improvements

  • Optimized installation process
  • Better dependency management
  • Enhanced documentation

v2.0.0

Released: December 2024

✨ New Features

  • Complete GUI redesign
  • OpenAI GPT-4 integration
  • Advanced SEO optimization
  • Batch processing capabilities

v1.5.0

Released: November 2024

✨ New Features

  • WordPress REST API integration
  • Automated image processing
  • Content scheduling