wordpress-publisher

# WordPress Publisher

Publish content directly to WordPress sites using the REST API with full Gutenberg block formatting, automatic category selection, SEO tag generation, and preview capabilities.

## Complete Workflow Overview

```
1. CONNECT    → Authenticate with WordPress site
2. ANALYZE    → Load categories from site, analyze content for best match
3. GENERATE   → Create SEO-optimized tags based on content
4. CONVERT    → Transform markdown/HTML to Gutenberg blocks
5. PREVIEW    → Create draft and verify rendering
6. PUBLISH    → Publish or schedule the post
7. VERIFY     → Confirm live post renders correctly
```

---

## Step 1: Connection Setup

### Get Credentials
Ask user for:
- WordPress site URL (e.g., `https://example.com`)
- WordPress username
- Application password (NOT regular password)

### How to Create Application Password
Guide user:
1. Go to **Users → Profile** in WordPress admin
2. Scroll to **Application Passwords** section
3. Enter name: `Claude Publisher`
4. Click **Add New Application Password**
5. Copy the generated password (shown only once, with spaces)

### Test Connection
```python
from scripts.wp_publisher import WordPressPublisher

wp = WordPressPublisher(
    site_url="https://example.com",
    username="admin",
    password="xxxx xxxx xxxx xxxx xxxx xxxx"  # Application password
)

# Test connection
user_info = wp.test_connection()
print(f"Connected as: {user_info['name']}")
```

---

## Step 2: Load and Select Categories

### Auto-Load Categories from Site
```python
# Get all categories from the WordPress site
categories = wp.get_categories_with_details()

# Returns list like:
# [
#   {'id': 1, 'name': 'Uncategorized', 'slug': 'uncategorized', 'count': 5},
#   {'id': 2, 'name': 'Tutorials', 'slug': 'tutorials', 'count': 12},
#   {'id': 3, 'name': 'Cloud Hosting', 'slug': 'cloud-hosting', 'count': 8},
# ]
```

### Smart Category Selection
The system analyzes content and selects the most appropriate category:

```python
# Analyze...

# WordPress Publisher Skill for Claude

[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
[![Claude Skill](https://img.shields.io/badge/Claude-Skill-blueviolet)](https://claude.ai)
[![SkillsMP](https://img.shields.io/badge/SkillsMP-Listed-blue)](https://skillsmp.com)
[![WordPress](https://img.shields.io/badge/WordPress-REST%20API-21759B)](https://developer.wordpress.org/rest-api/)
[![Version](https://img.shields.io/badge/version-1.0.0-green)](https://github.com/Asif2BD/WordPress-Publishing-Skill-For-Claude/releases)

A Claude skill that enables direct publishing to WordPress sites via the REST API with full Gutenberg block support, automatic category selection, SEO tag generation, and preview capabilities.

## Features

- **Direct WordPress Publishing**: Create, update, and manage posts via REST API
- **Gutenberg Block Support**: Full conversion of Markdown/HTML to WordPress Gutenberg blocks
- **Smart Category Selection**: Auto-load categories from your site and intelligently match content
- **SEO Tag Generation**: Automatically generate relevant tags for better discoverability
- **Preview Workflow**: Create drafts, preview, then publish with confidence
- **Media Management**: Upload and attach featured images
- **Scheduled Publishing**: Schedule posts for future publication
- **CLI Support**: Use from command line for automation

## Table of Contents

- [Installation](#installation)
- [Configuration](#configuration)
- [Quick Start](#quick-start)
- [Workflow Overview](#workflow-overview)
- [Usage Guide](#usage-guide)
  - [Connection Setup](#connection-setup)
  - [Category Management](#category-management)
  - [Tag Generation](#tag-generation)
  - [Content Conversion](#content-conversion)
  - [Publishing Posts](#publishing-posts)
  - [Preview and Verification](#preview-and-verification)
- [API Reference](#api-reference)
- [Gutenberg Blocks Reference](#gutenberg-blocks-reference)
- [CLI Usage](#cli-usage)
-...