GMCThe Google Merchant Center CLI

Validate feeds offline, diagnose the silent setup trap, and move off the retiring Content API — one typed CLI, built for CI.

Get started

CLI reference

View on GitHub

Typed Merchant API

A fully typed client for the entire Merchant API — all 12 GA sub-APIs (accounts, products, data sources, inventory, promotions, regions, reports, notifications, quota, issues, conversions, local feeds, and order tracking). Rate limiting, retry/backoff, and pagination are built in, so you don't hand-roll them.

gmc doctor

Diagnoses the silent GCP-registration / API-not-enabled trap that quietly breaks Merchant API access.

Offline preflight

gmc preflight scans your feed for required-attribute, format, disapproval-trigger, and SEO-optimization issues locally — no API call — so you catch a rejection before upload.

Content API → Merchant API

gmc migrate moves you off the retiring Content API — scope/auth audit, product transform (price→micros, field remap), and a feed-label safety check.

Feeds as code

Pull your catalog to version-controllable JSON, review the diff, and push it back — products, inventory, and promotions. Your feed lives in Git.

GitHub Action

The first-party GitHub Action (uses: yasserstudio/gmc@v1) runs preflight in CI with inline PR annotations on diffs, a findings summary table in the Actions tab, and structured outputs for downstream steps.

MCP server

gmc mcp exposes 12 tools over the Model Context Protocol — products, preflight, diagnostics, and more — so AI assistants like Claude Desktop, Cursor, and VS Code Copilot can work with your Merchant Center data.

Built for CI

Block a bad feed from shipping: every command speaks --json and returns a classed exit code, so a GitHub Action or GitLab job can fail the build on a disapproval or a performance drop.

🚀 GMC v1.0 is now publicly launched — stable, on npm, and covering all 12 GA Merchant API sub-APIs. Read the announcement →