SEO WordPress Manager Skill Skill

SEO WordPress Manager Skill

Purpose

This skill manages Yoast SEO metadata in WordPress sites via the WPGraphQL API. It enables batch updates of:

SEO titles
Meta descriptions
Focus keyphrases
Open Graph metadata

When to Use This Skill

User asks to "update SEO titles" or "fix meta descriptions"
User wants to batch process WordPress posts for SEO
User mentions Yoast SEO optimization
User needs to update SEO metadata across multiple posts

Prerequisites

WordPress Setup Required

WPGraphQL plugin installed and activated
WPGraphQL for Yoast SEO extension installed
Application Password created for authentication

Yoast SEO GraphQL Mutations

Add this to your theme's functions.php to enable mutations:

// Enable Yoast SEO mutations via WPGraphQL
add_action('graphql_register_types', function() {
    register_graphql_mutation('updatePostSeo', [
        'inputFields' => [
            'postId' => ['type' => 'Int', 'description' => 'Post ID'],
            'title' => ['type' => 'String', 'description' => 'SEO Title'],
            'metaDesc' => ['type' => 'String', 'description' => 'Meta Description'],
            'focusKeyphrase' => ['type' => 'String', 'description' => 'Focus Keyphrase'],
        ],
        'outputFields' => [
            'success' => ['type' => 'Boolean'],
            'post' => ['type' => 'Post'],
        ],
        'mutateAndGetPayload' => function($input) {
            $post_id = absint($input['postId']);

            if (!current_user_can('edit_post', $post_id)) {
                throw new \GraphQL\Error\UserError('You do not have permission to edit this post.');
            }

            if (isset($input['title'])) {
                update_post_meta($post_id, '_yoast_wpseo_title', sanitize_text_field($input['title']));
            }
            if (isset($input['metaDesc'])) {
                update_post_meta($post_id, '_yoast_wpseo_metadesc', sanitize_textarea_field($input['metaDesc']));
            }
            if (isset($input['focusKeyphrase'])) {
                update_post_meta($post_id, '_yoast_wpseo_focuskw', sanitize_text_field($input['focusKeyphrase']));
            }

            return [
                'success' => true,
                'post' => get_post($post_id),
            ];
        }
    ]);
});

Configuration

Create a config.json in the skill directory:

{
  "wordpress": {
    "graphql_url": "https://your-site.com/graphql",
    "username": "your-username",
    "app_password": "your-app-password"
  },
  "batch": {
    "size": 10,
    "delay_seconds": 1
  },
  "state_file": "./seo_update_progress.json"
}

Or use environment variables:

WP_GRAPHQL_URL
WP_USERNAME
WP_APP_PASSWORD

Workflow

Step 1: Analyze Posts for SEO Issues

python scripts/analyze_seo.py --all --output analysis.json

This fetches posts and identifies SEO issues (missing titles, too long descriptions, etc.). Output includes instructions for Claude to generate optimized SEO content.

Step 2: Generate Optimized SEO Content

Claude analyzes the analysis.json output and generates a changes.json file with:

Optimized SEO titles (50-60 chars)
Compelling meta descriptions (150-160 chars)
Relevant focus keyphrases

Step 3: Preview Changes (Dry Run)

python scripts/preview_changes.py --input changes.json

Step 4: Apply Updates

python scripts/yoast_batch_updater.py --input changes.json --apply

Step 5: Resume if Interrupted

python scripts/yoast_batch_updater.py --resume

Input Format

The skill expects a JSON file with changes:

{
  "updates": [
    {
      "post_id": 123,
      "post_title": "Original Post Title",
      "current": {
        "seo_title": "Old Title | Site Name",
        "meta_desc": "Old description"
      },
      "new": {
        "seo_title": "New Optimized Title | Site Name",
        "meta_desc": "New compelling meta description under 160 chars"
      }
    }
  ]
}

Output

The skill produces:

Preview report showing before/after for each post
Progress state file for resuming interrupted batches
Final report with success/failure counts

Safety Features

Dry-run mode by default - preview before applying
Confirmation prompt before batch updates
Progress tracking - resume interrupted sessions
Rate limiting - configurable delay between API calls
Backup - logs current values before changing

Example Usage

User: "Update the meta descriptions for all posts in the 'tutorials' category to be more compelling"

Claude will:

Run analyze_seo.py to fetch posts and identify SEO issues
Analyze each post's content and current SEO data
Generate optimized titles, descriptions, and keyphrases
Create a changes.json file with the improvements
Run preview_changes.py to show before/after comparison
Ask for confirmation
Run yoast_batch_updater.py --apply to apply changes
Report results with success/failure counts

Agent Skills: SEO WordPress Manager Skill

Skill Files