Documentation - AUTO-blogger | Complete User Guide & API Reference
Author: AryanVBW
Description: Complete documentation for AUTO-blogger including configuration guides, usage instructions, API references, and troubleshooting. Master WordPress automation with AI integration.
Keywords: auto blogger documentation, wordpress automation guide, ai content generation tutorial, openai gemini api, getty images integration, seo optimization guide

# 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