{"slug":"setup-cms","title":"setup-cms","summary":"Connect a CMS to notfair SEO tools. Guides users through configuring WordPress, Strapi, Contentful, or Ghost — tests the connection, and writes credentials to .env.local. Once set up, seo-analysis automatically cross- references CMS content against Google Search Console data. Use","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-08-25T15:10:39.04689Z","repo":{"url":"https://github.com/nowork-studio/notfair-plugin","stars":3849,"forks":495,"license":"MIT","updatedAt":"2026-09-22T18:08:44Z"},"bodyHtml":"
\n

name: setup-cms\nargument-hint: \"<CMS name: wordpress, strapi, contentful, or ghost>\"\ndescription: >\nConnect a CMS to notfair SEO tools. Guides users through configuring\nWordPress, Strapi, Contentful, or Ghost — tests the connection, and writes\ncredentials to .env.local. Once set up, seo-analysis automatically cross-\nreferences CMS content against Google Search Console data. Use whenever the\nuser says \"connect my CMS\", \"set up WordPress\", \"configure Strapi\", \"add\nContentful\", \"connect Ghost\", or \"CMS setup\". Also trigger if the user asks\nwhy no CMS data appears in a seo-analysis report.\nallowed-tools:

\n\n
\n

/setup-cms

\n

Guide the user through connecting their CMS to notfair's SEO analysis tools.

\n

Once configured, /seo-analysis automatically pulls published content from\nthe CMS and cross-references it against Google Search Console data — finding\ninvisible pages, content gaps, stale articles, and missing SEO fields.

\n
\n

Step 0 — Setup

\n

Read and follow ../shared/preamble.md — it locates the SEO scripts directory. Use $SKILL_SCRIPTS from the preamble for all script calls below.

\n

Step 1 — Detect existing CMS configuration

\n
CMS_TYPE=$(python3 \"$SKILL_SCRIPTS/cms_detect.py\" 2>/dev/null)\nCMS_STATUS=$?\necho \"CMS_TYPE=$CMS_TYPE  EXIT=$CMS_STATUS\"\n
\n\n
\n

Step 2 — Choose a CMS

\n

Ask the user:

\n
\n

\"Which CMS are you connecting? I support:

\n
    \n
  1. WordPress — self-hosted or WordPress.com (uses REST API + Application Password)
    2. \n
  2. Strapi — v4 or v5, self-hosted (uses API Token)
    3. \n
  3. Contentful — cloud headless CMS (uses Delivery API key)
    4. \n
  4. Ghost — Ghost.org or self-hosted (uses Content API key)
    5. \n
\n

Reply with the name or number.\"

\n
\n

Wait for their answer. Map to: wordpress, strapi, contentful, ghost.

\n
\n

Step 3 — Credential setup by CMS

\n

Jump to the sub-section for the chosen CMS.

\n
\n

3A — WordPress

\n

WordPress uses the built-in Application Passwords feature (introduced in WP 5.6).\nThis is the safest way to grant API access — it never exposes your main password\nand can be revoked at any time.

\n

Tell the user:

\n
\n

\"I need three things to connect WordPress:

\n
    \n
  1. Your WordPress URL (e.g. https://myblog.com)
    2. \n
  2. Your WordPress username (the one you log in with)
    3. \n
  3. An Application Password — create one in:\nWordPress Admin → Users → Profile → scroll to Application Passwords\n→ enter a name like \"notfair\" → click Add New → copy the generated password
    4. \n
\n

Paste each value when ready.\"

\n
\n

Collect values one at a time:

\n
    \n
  1. Ask for WP_URL → validate it starts with http:// or https://
    2. \n
  2. Ask for WP_USERNAME
    3. \n
  3. Ask for WP_APP_PASSWORD
    4. \n
  4. Ask for WP_CONTENT_TYPE:\n
    \n

    \"What content type should I analyze? Common values: posts, pages.\nPress Enter to use posts (default), or enter a custom post type slug.\"

    \n
    \n
    5. \n
\n

Once all four are collected, continue to Step 4 (test connection).

\n

Write to .env.local:

\n
WP_URL=<value>\nWP_USERNAME=<value>\nWP_APP_PASSWORD=<value>\nWP_CONTENT_TYPE=<value or posts>\n
\n
\n

3B — Strapi

\n

Tell the user:

\n
\n

\"I need two things to connect Strapi:

\n
    \n
  1. Your Strapi URL (e.g. https://cms.example.com)
    2. \n
  2. A Full-access API Token — create one in:\nStrapi Admin → Settings → Global settings → API Tokens → Create new API Token\n→ Type: Full access → copy the token
    3. \n
\n

Optionally:

\n\n

Paste each value when ready.\"

\n
\n

Collect:

\n
    \n
  1. STRAPI_URL
    2. \n
  2. STRAPI_API_KEY
    3. \n
  3. STRAPI_CONTENT_TYPE (optional, default: articles)
    4. \n
  4. STRAPI_VERSION (optional)
    5. \n
\n

Write to .env.local:

\n
STRAPI_URL=<value>\nSTRAPI_API_KEY=<value>\nSTRAPI_CONTENT_TYPE=<value or articles>\n
\n

Include STRAPI_VERSION=<value> only if the user specified it.

\n
\n

3C — Contentful

\n

Tell the user:

\n
\n

\"I need three things to connect Contentful:

\n
    \n
  1. Space ID — find it in: Contentful → Settings → General Settings → Space ID
    2. \n
  2. Content Delivery API token — find it in:\nSettings → API Keys → [your key] → Content Delivery API - access token\n(If no key exists, create one under Settings → API Keys → Add API Key)
    3. \n
  3. Content type ID — the API identifier for your content type.\nFind it in: Content model → [your type] → API Identifier
    4. \n
\n

Optionally:

\n\n

Paste each value when ready.\"

\n
\n

Collect:

\n
    \n
  1. CONTENTFUL_SPACE_ID
    2. \n
  2. CONTENTFUL_DELIVERY_TOKEN
    3. \n
  3. CONTENTFUL_CONTENT_TYPE
    4. \n
  4. CONTENTFUL_ENVIRONMENT (optional, default: master)
    5. \n
\n

Write to .env.local:

\n
CONTENTFUL_SPACE_ID=<value>\nCONTENTFUL_DELIVERY_TOKEN=<value>\nCONTENTFUL_CONTENT_TYPE=<value>\nCONTENTFUL_ENVIRONMENT=<value or master>\n
\n
\n

3D — Ghost

\n

Tell the user:

\n
\n

\"I need two things to connect Ghost:

\n
    \n
  1. Your Ghost URL (e.g. https://myblog.ghost.io)
    2. \n
  2. Content API key — create one in:\nGhost Admin → Settings → Integrations → Add custom integration\n→ copy the Content API Key
    3. \n
\n

Optionally:

\n\n

Paste each value when ready.\"

\n
\n

Collect:

\n
    \n
  1. GHOST_URL
    2. \n
  2. GHOST_CONTENT_KEY
    3. \n
  3. GHOST_CONTENT_TYPE (optional, default: posts)
    4. \n
\n

Write to .env.local:

\n
GHOST_URL=<value>\nGHOST_CONTENT_KEY=<value>\nGHOST_CONTENT_TYPE=<value or posts>\n
\n
\n

Step 4 — Write .env.local

\n

Find the project's .env.local file. Search for it:

\n
ENV_FILE=\"\"\nfor candidate in \".env.local\" \"$HOME/.env.local\"; do\n  [ -f \"$candidate\" ] && ENV_FILE=\"$candidate\" && break\ndone\n[ -z \"$ENV_FILE\" ] && ENV_FILE=\".env.local\"\necho \"Writing to: $ENV_FILE\"\n
\n

Merge strategy — do not overwrite the entire file. For each env var:

\n
    \n
  1. If the key already exists in the file, replace that line.
    2. \n
  2. If it does not exist, append it to the end.
    3. \n
\n

Read the file first (if it exists), then update key by key, then write back.

\n

If the file doesn't exist yet, create it.

\n

After writing, confirm:

\n
\n

\"Credentials written to [path]. Testing connection now...\"

\n
\n
\n

Step 5 — Test connection

\n

Run the appropriate preflight script and capture the exit code:

\n
# WordPress\npython3 \"$SKILL_SCRIPTS/preflight_wordpress.py\" 2>&1; PREFLIGHT_EXIT=$?\n\n# Strapi\npython3 \"$SKILL_SCRIPTS/preflight_strapi.py\" 2>&1; PREFLIGHT_EXIT=$?\n\n# Contentful\npython3 \"$SKILL_SCRIPTS/preflight_contentful.py\" 2>&1; PREFLIGHT_EXIT=$?\n\n# Ghost\npython3 \"$SKILL_SCRIPTS/preflight_ghost.py\" 2>&1; PREFLIGHT_EXIT=$?\n
\n

The 2>&1 redirect surfaces error messages in the output so you can show them.

\n

PREFLIGHT_EXIT=0 — connection successful. Show the \"OK: …\" line to the user,\nthen continue to Step 6.

\n

PREFLIGHT_EXIT=1 — connection failed. Show the full error output verbatim.\nHelp the user diagnose:

\n\n

Ask: \"Want to fix the credentials and try again (I'll go back to Step 3), or skip CMS setup for now?\"

\n

PREFLIGHT_EXIT=2 → credentials were removed from .env.local between steps. Restart from Step 3.

\n
\n

Step 6 — Confirm and summarize

\n

Once the connection succeeds, show a summary:

\n
CMS connected successfully!\n\n  CMS:          [WordPress/Strapi/Contentful/Ghost]\n  URL:          [cms_url]\n  Content type: [content_type]\n  Published:    [N] entries found\n\nWhat this enables in /seo-analysis:\n  • Cross-reference [N] published articles against Google Search Console data\n  • Find published content with zero GSC impressions (unindexed or invisible)\n  • Identify content gaps: queries ranking 11-30 with no matching article\n  • Flag stale content: articles >6 months old with declining clicks\n  • Audit SEO fields: missing meta titles/descriptions, length violations\n
\n

Then offer:

\n
\n

\"Run /seo-analysis to see a full audit with your CMS content included,\nor type /setup-cms again to connect a different CMS.\"

\n
\n","files":[{"path":"evals/evals.json","sizeBytes":1696,"isText":true},{"path":"SKILL.md","sizeBytes":8820,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"notes-only","suspicious":0,"notes":24,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-08-25T15:11:51.142028Z","sha256":"D25199125A9952D95CFC9DE814519AD1473CB4649977925A09C5BAF9196AD1C3","sizeBytes":4395},"review":null,"source":{"repositoryUrl":"https://github.com/nowork-studio/notfair-plugin","path":"seo/setup-cms","license":"MIT","commit":"f98476822da879fc56b0bb7d1a2bf683b934f98f","subtreeSha":"4D4E00C8817F9F464AB83DFF97C35ED2EAC051A1CDAF5859329192DAA405B2CF","lastSyncedAt":"2026-09-23T13:50:57.861587Z"},"reviewedAt":"2026-08-25T15:13:48.953862Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/nowork-studio/notfair-plugin/tree/main/seo/setup-cms"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install nowork-studio-notfair-plugin@llmmart"},{"target":"git","command":"git clone https://github.com/nowork-studio/notfair-plugin.git"}]}