Shopify Admin Page Content Audit

Purpose

Scans all store pages and blog articles for missing or thin content (short body, missing SEO title/description, empty body). Thin content pages are penalized by search engines and create a poor customer experience. Read-only — no mutations. Complements seo-metadata-audit (which covers products and collections).

Prerequisites

• Authenticated Shopify CLI session: shopify store auth --store --scopes read_content
• API scopes: read_content

Parameters

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | store | string | yes | — | Store domain (e.g., mystore.myshopify.com) | | minbodylength | integer | no | 100 | Flag pages with body content shorter than this (characters) | | include_unpublished | bool | no | false | Also audit unpublished pages and articles | | format | string | no | human | Output format: human or json |

Safety

> ℹ️ Read-only skill — no mutations are executed. Safe to run at any time.

Workflow Steps

1. OPERATION: pages — query

Inputs: first: 250, select title, body, bodySummary, seo, publishedAt, pagination cursor Expected output: All pages with content and SEO data

1. OPERATION: articles — query

Inputs: first: 250, select title, body, seo, publishedAt, blog { title }, pagination cursor Expected output: All blog articles with content data

1. Flag: empty body, body ║

║ Started: ║ ╚══════════════════════════════════════════════╝

**After each step**, emit:

[N/TOTAL] → Params: → Result:

**On completion**, emit:

For `format: human` (default):

══════════════════════════════════════════════ PAGE CONTENT AUDIT Pages scanned: | Issues: Articles scanned: | Issues:

Issues: Page: "" — empty body Article: "" — missing SEO description Output: contentaudit.csv ══════════════════════════════════════════════

For `format: json`, emit:
```json
{
  "skill": "page-content-audit",
  "store": "",
  "pages_scanned": 0,
  "articles_scanned": 0,
  "issues_found": 0,
  "output_file": "content_audit_.csv"
}

Output Format

CSV file content_audit_.csv with columns: type, id, title, handle, published_at, body_length, has_seo_title, has_seo_description, issue

Error Handling

| Error | Cause | Recovery | |-------|-------|----------| | THROTTLED | API rate limit exceeded | Wait 2 seconds, retry up to 3 times | | No pages or articles | Minimal store | Exit with 0 results |

Best Practices

• A page with fewer than 300 words is generally considered "thin content" by search engines — use min_body_length: 1500 (characters ≈ ~250 words) as a starting threshold.
• The About, FAQ, and Contact pages are high-trust pages that should never be empty — prioritize these.
• Run after any CMS migration or theme change that may have wiped page content.
• Pair with seo-metadata-audit for a complete SEO audit covering products, collections, pages, and blog articles in one workflow.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: 40RTY-ai
• Source: 40RTY-ai/shopify-admin-skills
• License: MIT
• Homepage: http://skills.40rty.ai

Install and usage instructions live in the source repository linked above.