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

<details> <summary><strong>For Claude Code</strong></summary>

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

</details> <details> <summary><strong>For Claude.ai (Web)</strong></summary>

1. Download this repository as ZIP
2. Extract and upload the skill folder via Claude.ai → Settings → Skills → Upload custom skill

</details> <details> <summary><strong>For Codex CLI</strong></summary>

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

</details>

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)

# 4. Publish
result = wp.publish_content(
    title="My Article Title",
    content=gutenberg_content,
    category_names=["Tutorials"],
    auto_generate_tags=True,
    status="draft"  # Start with draft to preview
)

print(f"Preview URL: {result['preview_url']}")
print(f"Edit URL: {result['edit_url']}")

Workflow Overview

┌─────────────────────────────────────────────────────────────────┐
│                    WordPress Publishing Workflow                 │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  1. CONNECT    ─→  Authenticate with WordPress site             │
│       │                                                         │
│       ▼                                                         │
│  2. ANALYZE    ─→  Load categories, analyze content for match   │
│       │                                                         │
│       ▼                                                         │
│  3. GENERATE   ─→  Create SEO-optimized tags from 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          │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Usage Guide

Connection Setup

from scripts.wp_publisher import WordPressPublisher

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

# Test and verify connection
user_info = wp.test_connection()
print(f"Connected as: {user_info['name']}")
print(f"Role: {user_info.get('roles', ['unknown'])[0]}")

Category Management

List All Categories

categories = wp.get_categories_with_details()
for cat in categories:
    print(f"[{cat['id']}] {cat['name']} ({cat['count']} posts)")

Smart Category Selection

The system analyzes your content and suggests the best matching category:

# Get categories from site
categories = wp.get_categories_with_details()

# Let the system suggest the best match
best_category = wp.suggest_category(
    content=article_content,
    title=article_title,
    available_categories=categories
)

print(f"Suggested: {best_category['name']}")

Category Matching Logic:

1. Exact match: Title/content contains category name (highest priority)
2. Keyword match: Category slug matches topic keywords
3. Parent category: Falls back to broader parent if no match
4. Create new: Creates category if none fit (with user approval)

Create a New Category

new_cat = wp.create_category(
    name="Cloud Hosting",
    description="Articles about cloud hosting services",
    slug="cloud-hosting"
)

Tag Generation

Automatic SEO Tags

tags = wp.generate_seo_tags(
    content=article_content,
    title=article_title,
    max_tags=10
)
# Returns: ['n8n hosting', 'workflow automation', 'self-hosted', ...]

Tag Generation Rules:

1. Primary keyword: Always includes main topic from title
2. Entity extraction: Identifies brand names, products mentioned
3. Key phrases: Extracts 2-3 word combinations that appear multiple times
4. Topic patterns: Matches against common industry terms

Get or Create Tags

# Automatically creates tags if they don't exist
tag_ids = wp.get_or_create_tags(['hosting', 'automation', 'tutorial'])

Content Conversion

Markdown to Gutenberg

from scripts.content_to_gutenberg import convert_to_gutenberg

markdown = """
# Heading

Paragraph with **bold** and *italic*.

- List item 1
- List item 2

| Header A | Header B |
|----------|----------|
| Cell 1   | Cell 2   |
"""

gutenberg_content = convert_to_gutenberg(markdown)

Supported Conversions

Create Specific Blocks

from scripts.content_to_gutenberg import (
    create_table_block,
    create_image_block,
    create_button_block,
    create_columns_block
)

# Create a table
table = create_table_block(
    headers=['Plan', 'Price', 'Features'],
    rows=[
        ['Basic', '$10', '5GB Storage'],
        ['Pro', '$25', '50GB Storage'],
    ],
    striped=True
)

# Create a button
button = create_button_block(
    text="Get Started",
    url="https://example.com/signup",
    style="fill",
    align="center"
)

Publishing Posts

Create a Draft

draft = wp.create_draft(
    title="My Article",
    content=gutenberg_content,
    categories=[category_id],
    tags=tag_ids,
    excerpt="A brief description for SEO"
)

print(f"Preview: {draft['preview_url']}")
print(f"Edit: {draft['edit_url']}")

Publish Directly

result = wp.publish_content(
    title="My Article",
    content=gutenberg_content,
    category_names=["Tutorials"],
    tag_names=["python", "automation"],
    status="publish",
    excerpt="A brief description",
    slug="my-custom-url-slug"
)

print(f"Live URL: {result['live_url']}")

Schedule for Later

from datetime import datetime, timedelta

publish_date = datetime.now() + timedelta(days=7)

result = wp.publish_content(
    title="Scheduled Post",
    content=content,
    status="future",
    date=publish_date.isoformat()
)

Preview and Verification

Preview Checklist

Before publishing, verify:

• Title displays correctly
• All headings render (H2, H3, H4)
• Tables render with proper formatting
• Lists display correctly (bullet and numbered)
• Code blocks have syntax highlighting
• Images load properly
• Links are clickable
• Category shows correctly
• Tags display in post

Publish After Preview

# After previewing and approving the draft
result = wp.publish_post(draft['post_id'])
print(f"Published: {result['live_url']}")

Verify Published Post

verification = wp.verify_published_post(post_id)
print(f"Status: {verification['status']}")
print(f"URL: {verification['url']}")
print(f"Categories: {verification['categories']}")
print(f"Tags: {verification['tags']}")

API Reference

WordPressPublisher Class

Connection Methods

Category Methods

Tag Methods

Post Methods

Media Methods

WordPress REST API Endpoints

Post Statuses

Gutenberg Blocks Reference

Basic Blocks

Paragraph:

<!-- wp:paragraph -->
<p>Your paragraph text here.</p>
<!-- /wp:paragraph -->

Heading (H2 default):

<!-- wp:heading -->
<h2 class="wp-block-heading">Heading Text</h2>
<!-- /wp:heading -->

Heading (other levels):

<!-- wp:heading {"level":3} -->
<h3 class="wp-block-heading">H3 Heading</h3>
<!-- /wp:heading -->

List Blocks

Unordered:

<!-- wp:list -->
<ul><li>Item 1</li><li>Item 2</li></ul>
<!-- /wp:list -->

Ordered:

<!-- wp:list {"ordered":true} -->
<ol><li>First</li><li>Second</li></ol>
<!-- /wp:list -->

Table Block

<!-- wp:table -->
<figure class="wp-block-table"><table>
  <thead><tr><th>Header 1</th><th>Header 2</th></tr></thead>
  <tbody><tr><td>Cell 1</td><td>Cell 2</td></tr></tbody>
</table></figure>
<!-- /wp:table -->

Important: Tables must be wrapped in <figure class="wp-block-table"> or they won't render correctly.

Code Block

<!-- wp:code {"language":"python"} -->
<pre class="wp-block-code"><code lang="python">def hello():
    print("Hello World")</code></pre>
<!-- /wp:code -->

Image Block

<!-- wp:image {"sizeSlug":"large","linkDestination":"none"} -->
<figure class="wp-block-image size-large">
  <img src="https://example.com/image.jpg" alt="Description"/>
</figure>
<!-- /wp:image -->

Quote Block

<!-- wp:quote -->
<blockquote class="wp-block-quote">
  <p>Quote text here.</p>
  <cite>— Attribution</cite>
</blockquote>
<!-- /wp:quote -->

For complete block reference, see references/gutenberg-blocks.md.

CLI Usage

Test Connection

python scripts/wp_publisher.py \
  --url https://yoursite.com \
  --user admin \
  --password "xxxx xxxx xxxx xxxx" \
  --test

List Categories

python scripts/wp_publisher.py \
  --url https://yoursite.com \
  --user admin \
  --password "xxxx" \
  --list-categories

Publish Article

python scripts/wp_publisher.py \
  --url https://yoursite.com \
  --user admin \
  --password "xxxx" \
  --publish article.html \
  --title "My Article" \
  --category "Tutorials" \
  --auto-tags \
  --status draft

Convert Markdown to Gutenberg

python scripts/content_to_gutenberg.py article.md article.html

Validate Gutenberg Content

python scripts/content_to_gutenberg.py --validate article.html

Error Handling

Common Errors

Error Classes

from scripts.wp_publisher import (
    APIError,
    AuthenticationError,
    PermissionError,
    NotFoundError,
    ServerError
)

try:
    wp.publish_content(...)
except AuthenticationError:
    print("Check your credentials")
except PermissionError:
    print("User needs higher privileges")
except NotFoundError:
    print("Resource not found")
except ServerError:
    print("WordPress server error")
except APIError as e:
    print(f"API error: {e}")

Best Practices

1. Always preview first - Create as draft, verify rendering, then publish
2. Use application passwords - Never use your regular WordPress password
3. Select appropriate categories - Helps with site organization and SEO
4. Generate relevant tags - Improves search engine discoverability
5. Validate Gutenberg blocks - Ensure proper block structure before publishing
6. Keep excerpts under 160 chars - Optimal for search snippets
7. Use descriptive slugs - Include primary keyword in URL
8. Test tables carefully - Tables are most prone to rendering issues

Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

git clone https://github.com/Asif2BD/WordPress-Publishing-Skill-For-Claude.git
cd WordPress-Publishing-Skill-For-Claude
pip install -r requirements-dev.txt

Running Tests

pytest tests/

Code Style

We follow PEP 8. Format your code with:

black scripts/

Changelog

See CHANGELOG.md for version history and updates.

License

This project is licensed under the GPL v3 License - see the LICENSE file for details.

---

Support

• Issues: GitHub Issues
• Discussions: GitHub Discussions

Author

M Asif Rahman

• Website: MAsifRahman.com
• GitHub: @Asif2BD

Acknowledgments

• WordPress REST API Team
• Gutenberg Block Editor Team
• Claude AI by Anthropic

---

<p align="center"> Made with ❤️ by <a href="https://MAsifRahman.com">M Asif Rahman</a> </p>