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
- Install AUTO-blogger - Follow our installation guide
- Configure credentials - Set up WordPress and API keys
- Launch the application - Run
autoblogorpython3 gui_blogger.py - Start automating - Use the GUI to configure and run automation tasks
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
$ 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
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:
{
"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
Content Discovery
Enter target URLs or use automated discovery to find content
Content Extraction
Extract article content, images, and metadata
AI Rewriting
Rewrite content using OpenAI with SEO optimization
Image Processing
Download, optimize, and embed relevant images
WordPress Publishing
Automatically publish to your WordPress site
Command Line Usage
# 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
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:
# 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
🤝 Contributing
We welcome contributions to AUTO-blogger! Here's how to get started:
Development Setup
# 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
# 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