Home » Programming » Python » Modules » Wordpress Content Uploader
📌 Pin 🔗 Copy Link 📋 Copy Markdown ⬇️ Download
3 min read

WordPress Automated Content Uploader

This utility automates the process of uploading content to a self-hosted WordPress website. It reads text files from a specified directory, treats the first line as the title and the rest as the body, and uploads them as Drafts via the WordPress REST API. It supports uploading as either blog posts or static pages.

Modules Used:

  • requests: To interact with the WordPress REST API.
  • argparse: To handle command-line arguments.
  • os: To navigate the file system.

Prerequisites

  1. WordPress Site: A self-hosted WordPress site (version 4.7+).
  2. Application Password:
    • Go to your WordPress Dashboard -> Users -> Profile.
    • Scroll down to Application Passwords.
    • Enter a name (e.g., "Python Uploader") and click Add New Application Password.
    • Copy the generated password. Do not use your login password.

Installation

pip install requests

The Code

Save this as wp_uploader.py.

import requests
import os
import argparse
import sys

def upload_to_wordpress(folder, site_url, username, app_password, post_type="posts"):
    # 1. Construct API Endpoint
    # Ensure site_url is clean and append the API path
    api_base = site_url.rstrip('/')
    if "/wp-json" not in api_base:
        api_base += "/wp-json/wp/v2"

    endpoint = f"{api_base}/{post_type}"

    # 2. Scan Folder
    if not os.path.exists(folder):
        print(f"Error: Folder '{folder}' not found.")
        return

    files = [f for f in os.listdir(folder) if f.endswith('.txt')]
    if not files:
        print("No .txt files found in the directory.")
        return

    print(f"Found {len(files)} files. Uploading to {endpoint}...")

    # 3. Process and Upload
    for filename in files:
        filepath = os.path.join(folder, filename)

        try:
            with open(filepath, 'r', encoding='utf-8') as f:
                lines = f.readlines()

            if not lines:
                print(f"Skipping empty file: {filename}")
                continue

            # Assumption: First line is Title, rest is Content
            title = lines[0].strip()
            content = "".join(lines[1:])

            post_data = {
                'title': title,
                'content': content,
                'status': 'draft'  # Upload as draft for safety
            }

            print(f"Uploading '{title}'...")

            # Basic Auth using Application Password
            response = requests.post(endpoint, auth=(username, app_password), json=post_data)

            if response.status_code == 201:
                print(f"  [Success] ID: {response.json().get('id')}")
            else:
                print(f"  [Failed] {response.status_code} - {response.text}")

        except Exception as e:
            print(f"Error processing {filename}: {e}")

if __name__ == "__main__":
    parser = argparse.ArgumentParser(description="WordPress Bulk Content Uploader")
    parser.add_argument("folder", help="Folder containing .txt files")
    parser.add_argument("--url", required=True, help="WordPress Site URL (e.g., https://mysite.com)")
    parser.add_argument("--user", required=True, help="WordPress Username")
    parser.add_argument("--password", required=True, help="Application Password")
    parser.add_argument("--type", default="posts", choices=['posts', 'pages'], help="Upload type (default: posts)")

    args = parser.parse_args()

    upload_to_wordpress(args.folder, args.url, args.user, args.password, args.type)

Usage

  1. Prepare Content: Create a folder (e.g., articles) and add .txt files.

    • Format: The first line of the text file will be the Title. Everything else will be the Body.

  2. Run the Script:

    # Upload as Blog Posts (Drafts)
python wp_uploader.py ./articles --url https://example.com --user myusername --password "abcd 1234 efgh 5678"

# Upload as Pages
python wp_uploader.py ./pages --url https://example.com --user myusername --password "..." --type pages

programming/python/python

Created: March 17, 2026 • Last Modified: January 28, 2026