SEO Performance Report (action v1)

SEO Performance Report - GitHub Action v1

Composite action that runs any tool from the @automatelab/seo-performance-mcp MCP and writes the result (markdown or JSON) to a file you can pipe into a GitHub Issue, Discussion, PR, or any other workflow step.

Quick start

- uses: AutomateLab-tech/seo-performance-mcp@v1
  with:
    tool: cohort.report
    format: markdown
    input: '{"window": 90, "min_age_days": 90, "limit": 20}'
    gsc-service-account-json: ${{ secrets.GSC_SERVICE_ACCOUNT_JSON }}
    gsc-site-url: ${{ secrets.GSC_SITE_URL }}
    posts-sitemap-url: ${{ secrets.POSTS_SITEMAP_URL }}

Complete example that posts a weekly cohort report as a GitHub Issue: examples/weekly-cohort-report.yml.

Inputs

• tool (required) - one of: cohort.report, posts.list, posts.snapshot, posts.decay_curve, posts.verdict, posts.refresh_brief, posts.cite_loss, gsc.quick_wins.
• input - JSON string for tool input. Defaults to {}.
• format - json or markdown. Defaults to markdown.
• output-file - explicit output path (otherwise written under $RUNNER_TEMP).
• mcp-version - pinned npm version of the underlying MCP. Defaults to 0.4.0.
• Per-adapter env passthroughs: gsc-service-account-json, gsc-site-url, matomo-*, ga4-*, clarity-*, posts-sitemap-url, posts-list, ghost-admin-api-*, citation-intelligence-url.

Outputs

• result - the tool output (multi-line).
• result-file - the file path it was written to.
• rows - number of rows (cohort.report only, format: json).

What does this action do?

Unifies Google Search Console + Matomo + GA4 + Microsoft Clarity + AI-citation tracking into a deterministic verdict per blog post (refresh / expand / merge / kill / double_down / hold) with reason codes and a 0-1 confidence score. Read-only - never mutates posts.

Released from tag v0.4.0. v1 is the floating major that Marketplace consumers should pin to.

v0.4.0 - seo-perf-cli + GitHub Action

What's new

• seo-perf-cli - new bin in the npm package. Run any MCP tool as a one-shot CLI without speaking JSON-RPC: npx -p @automatelab/seo-performance-mcp seo-perf-cli cohort.report --input '{"window":90}' --format markdown. Same env vars as the MCP server. json and markdown outputs; markdown supported for cohort.report and posts.refresh_brief.
• action.yml - composite GitHub Action. Wraps the CLI so you can run a weekly cohort report from CI and pipe the markdown to a GitHub Issue / Discussion / PR. Outputs: result (multi-line), result-file, rows (for cohort.report).
• examples/weekly-cohort-report.yml - reference workflow that runs every Monday and opens an Issue with the cohort.report markdown.
• README: new 'Use as a GitHub Action' and 'Use as a one-shot CLI' sections.

Usage from CI

- uses: AutomateLab-tech/seo-performance-mcp@v1
  with:
    tool: cohort.report
    format: markdown
    input: '{"window": 90, "min_age_days": 90, "limit": 20}'
    gsc-service-account-json: ${{ secrets.GSC_SERVICE_ACCOUNT_JSON }}
    gsc-site-url: ${{ secrets.GSC_SITE_URL }}
    posts-sitemap-url: ${{ secrets.POSTS_SITEMAP_URL }}

Full diff

cda59f2..3ec6716

v0.1.0 - initial release

First public release of @automatelab/seo-performance-mcp.

Post-publish SEO performance MCP. Unifies Google Search Console, Matomo, GA4, Clarity, and AI-citation signals per URL and emits a verdict (refresh / expand / merge / kill / double_down / hold) per post with reason codes.

Install

npm install -g @automatelab/seo-performance-mcp
# or run on demand
npx @automatelab/seo-performance-mcp

See the README for install and usage details.

Tool surface

• list_posts
• snapshot
• decay_curve
• verdict
• refresh_brief
• cohort_report
• cite_loss
• quick_wins

npm

https://www.npmjs.com/package/@automatelab/seo-performance-mcp