seo-wordpress-publish

WordPress Publish

Publish articles to WordPress via the REST API from Markdown files or direct content.

Invocation

/seo-wordpress-publish <file.md>
/seo-wordpress-publish <file.md> --site https://example.com --status publish
/seo-wordpress-publish <file.md> --status scheduled --date 2026-05-01T09:00:00

Prerequisites

WordPress credentials must be configured in ~/.config/claude-seo/wordpress.json:

{
  "site_url": "https://your-site.com",
  "username": "your-username",
  "application_password": "xxxx xxxx xxxx xxxx"
}

Generate an Application Password in WordPress: Users > Profile > Application Passwords.

Workflow

1. Read Markdown file -- Parse frontmatter (YAML) and body content
2. Convert Markdown to HTML -- Preserve headings, lists, code blocks, images
3. Authenticate -- Connect via Application Password (Basic Auth over HTTPS)
4. Create or update post -- POST to /wp/v2/posts (or PUT for updates)
5. Set categories and tags -- Look up by name, create if they don't exist
6. Set featured image -- Upload via /wp/v2/media if featured_image path given
7. Set SEO meta -- Auto-configure Yoast or RankMath title + description via REST API
8. Set status -- draft (default), publish, or future (scheduled)
9. Return post URL and ID -- Confirm publication with direct link

Supported Frontmatter Fields

---
title: "Mon article SEO optimise"
description: "Meta description pour les moteurs de recherche (max 160 chars)"
category: "Marketing Digital"
tags:
  - SEO
  - WordPress
  - Content Marketing
featured_image: "./images/hero.jpg"
status: draft          # draft | publish | future
date: "2026-05-01T09:00:00"   # Required if status is 'future'
slug: "mon-article-seo"
---

Field	Required	Default	Description
title	Yes	--	Post title (H1)
description	Recommended	--	Meta description for SEO plugins
category	Recommended	Uncategorized	Primary category name
tags	Optional	[]	List of tag names
featured_image	Recommended	--	Path to image file (local or URL)
status	Optional	draft	Post status
date	Optional	now	Publish date (ISO 8601), required for scheduled
slug	Optional	auto	URL slug