wordpress-publisher

WordPress Publisher Skill for Claude

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
• Configuration
• Quick Start
• Workflow Overview
• Usage Guide
  • Connection Setup
  • Category Management
  • Tag Generation
  • Content Conversion
  • Publishing Posts
  • Preview and Verification
• API Reference
• Gutenberg Blocks Reference
• CLI Usage
• Error Handling
• Best Practices
• Contributing
• Changelog
• License

Installation

Via Claude Code Marketplace (Recommended)

# Add the marketplace
/plugin marketplace add Asif2BD/WordPress-Publishing-Skill-For-Claude

# Install the skill
/plugin install wordpress-publisher@wordpress-publisher-marketplace

Via SkillsMP

Search for "wordpress-publisher" on SkillsMP and follow the installation instructions.

Manual Installation

# Clone to your skills directory
git clone https://github.com/Asif2BD/WordPress-Publishing-Skill-For-Claude.git ~/.claude/skills/wordpress-publisher

# Clone to Codex skills directory
git clone https://github.com/Asif2BD/WordPress-Publishing-Skill-For-Claude.git ~/.codex/skills/wordpress-publisher

Standalone Python Usage

# Clone the repository
git clone https://github.com/Asif2BD/WordPress-Publishing-Skill-For-Claude.git
cd WordPress-Publishing-Skill-For-Claude

# Install dependencies
pip install requests

# Test the installation
python scripts/wp_publisher.py --help

Configuration

WordPress Requirements

1. WordPress Version: 5.0+ (Gutenberg editor required)
2. REST API: Must be enabled (enabled by default)
3. User Role: Editor or Administrator
4. Application Password: Required for authentication

Creating an Application Password

1. Log into your WordPress admin panel
2. Go to Users → Profile
3. Scroll to Application Passwords section
4. Enter a name: Claude Publisher
5. Click Add New Application Password
6. Copy the generated password (shown only once, spaces are optional)

Note: Application passwords are different from your regular WordPress password. They provide API access without exposing your main credentials.

Quick Start

from scripts.wp_publisher import WordPressPublisher
from scripts.content_to_gutenberg import convert_to_gutenberg

# 1. Connect to WordPress
wp = WordPressPublisher(
    site_url="https://yoursite.com",
    username="your_username",
    password="xxxx xxxx xxxx xxxx xxxx xxxx"  # Application password
)

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

# 3. Convert your content to Gutenberg
markdown_content = """
# My Article Title

This is a **bold** statement with *italic* text.

## Features

- Feature one
- Feature two
- Feature three

| Column A | Column B |
|----------|----------|
| Data 1   | Data 2   |
"""

gutenberg_content = convert_to_gutenberg(markdown_content)