Skip to main content

Getting Started with Colter

Start a Shopify Recommendation Audit, or install the CLI for Colter's compatible technical capabilities.

TL;DR: Merchants start with the Recommendation Audit. Developers can install the CLI with npm install -g @getcolter/cli and use the compatible check, fix, test, lens, and verify capabilities where the audit or implementation evidence calls for them.

What Colter Does

Colter sells one merchant product: the Recommendation Audit. Paste a Shopify product link and Colter tells you how to improve the page. The buyer question is optional and can be saved for a later comparison with a real answer from a named AI tool; it does not affect the checked-page average or fix selection.

Check, Fix, Test, Lens, and Verify are stable technical capabilities. Use them only when the audit or an explicitly broader technical task calls for them; do not treat them as separate merchant products.

Fastest Path

No install:

Run Recommendation Audit

CLI baseline:

npm install -g @getcolter/cli
colter check https://your-store.com
colter fix https://your-store.com --dry-run

Hosted Test:

export COLTER_API_KEY=col_live_...
colter test https://your-store.com

No install:

npx @getcolter/cli check https://your-store.com

Demo target:

colter check example-store.com

Protocols

  • UCP for declared UCP commerce capabilities
  • ACP for declared ACP commerce capabilities
  • MCP for agent tool access
  • WebMCP for browser-side tool discovery

Installation

Install with npm:

npm install -g @getcolter/cli
colter --version

Install with Go:

go install github.com/mfbahc/agentic-com/cmd/colter@latest

Minimal Config

Most check flows need no config. If you want saved defaults, create colter.yaml:

version: "1"

store:
  url: "https://your-store.com"

fix:
  output_dir: "./colter-fixes"

Pick Your Path

RoleStart here
DeveloperFor Developers
AgencyFor Agencies
MerchantFor Merchants
AI agent builderMCP Tools
  1. Start with the Recommendation Audit for one public Shopify product page.
  2. If you want a later answer comparison, save a real buyer question. The question does not affect the page check.
  3. Make the first change Colter recommends.
  4. Use Check, Fix, Test, Verify, or Lens only for the broader technical work each capability documents.

Troubleshooting

If colter is not on your path:

npx @getcolter/cli check https://your-store.com

If the store blocks requests:

colter check https://your-store.com -v

Next Steps