Skip to main content

Common Workflows

This page shows how commands fit together in realistic operating scenarios.

Workflow 1: First Site Audit​

Use this when connecting wp-seo-ops to a site for the first time.

# Initialize config
seo-ops config init
seo-ops config set default_path /var/www/html

# Confirm the site and plugin state
seo-ops inventory

# Run a broad audit
seo-ops audit full --format=md --output=seo-audit.md

# Generate focused reports
seo-ops audit links --format=csv --output=links.csv
seo-ops audit images --format=csv --output=images.csv
seo-ops audit duplicate-content --format=json --output=duplicates.json

Expected outcome:

  • You know which SEO plugin is active.
  • You have a Markdown audit report for humans.
  • You have CSV/JSON exports for deeper review.

Workflow 2: Export And Review Metadata​

Use this before a migration, batch edit, or plugin change.

# Export existing metadata
seo-ops meta export --path=/var/www/html --output=seo-meta-before.csv

# Inspect current metadata coverage
seo-ops audit meta-check --path=/var/www/html --format=csv --output=meta-coverage.csv

Review the CSV files before applying changes.

Workflow 3: Bulk Update SEO Titles And Descriptions​

Start with a CSV such as:

post_id,title,description
123,"New SEO title","New meta description"
124,"Another SEO title","Another meta description"

Preview first:

seo-ops meta bulk updates.csv --path=/var/www/html --dry-run

Apply after review:

seo-ops meta bulk updates.csv --path=/var/www/html

Validate after applying:

seo-ops meta get 123 title --path=/var/www/html
seo-ops audit meta-check --path=/var/www/html --format=table

Workflow 4: Redirect Migration​

Use this when moving redirects from one plugin or spreadsheet into WordPress.

# Export existing redirects first
seo-ops redirect export --path=/var/www/html --output=redirects-before.csv

# Preview incoming redirect file
seo-ops redirect import redirects-new.csv --path=/var/www/html --dry-run

# Apply import
seo-ops redirect import redirects-new.csv --path=/var/www/html

# Confirm result
seo-ops redirect list --path=/var/www/html --format=table
danger

Always export existing redirects before importing or deleting redirect rules. Redirect mistakes can cause traffic loss and broken user journeys.

Workflow 5: Publish And Request Indexing​

Use this after publishing or updating important URLs.

# Submit one URL
seo-ops instant-indexing submit https://example.com/new-page --key=YOUR_INDEXNOW_KEY

# Or submit a CSV batch
seo-ops instant-indexing submit --from-csv=updated-urls.csv --key=YOUR_INDEXNOW_KEY

Then monitor search performance with GSC:

seo-ops analyze gsc-adapter --start-date=2024-01-01 --end-date=2024-01-31 --dimension=page

Workflow 6: Content Pipeline Import​

Use this when planning content from a spreadsheet.

seo-ops content pipeline import pipeline.csv --validate
seo-ops content pipeline import pipeline.csv --name="Q4 SEO Content"

Generate a draft for a selected keyword:

seo-ops content generate "best accounting software" --words=2000 --type=guide --output=best-accounting-software.md

Workflow 7: Pre-Deployment SEO Check​

Use this before major releases, migrations, or theme changes.

seo-ops inventory --path=/var/www/html
seo-ops audit full --path=/var/www/html --format=md --output=predeploy-audit.md
seo-ops audit broken --path=/var/www/html --format=csv --output=broken-links.csv
seo-ops redirect list --path=/var/www/html --format=csv --output=redirects.csv
seo-ops meta export --path=/var/www/html --output=seo-meta.csv

Keep these files as a rollback and comparison baseline.