BetterReviews Skill for AI Agents

Last updated: October 2, 2026

The BetterReviews skill teaches AI agents how to interact with your store's review API. Install it in Claude Code or any AI coding assistant that supports the SKILL.md format.

What the Skill Does

  • Send review links to customers and get shareable hub URLs
  • Moderate reviews — approve, reject, or delete
  • Optimize product descriptions with AI and publish to Shopify ENTITLEMENT
  • Analyze your brand — tone, values, positioning from your store URL ENTITLEMENT
  • Generate content — FAQs, SEO descriptions, feature lists from reviews ENTITLEMENT
  • Connect review platforms — Okendo, Judge.me, Yotpo import and webhooks
  • Configure settings — toggle automation, set delays, configure the auto-moderation preset
  • Search and analyze reviews — keywords, sentiment, natural language Q&A
  • Find the best reviews for a product — SQL-ranked for marketing use or by helpfulness, no AI cost
  • Record product claims — link supporting reviews with quoted evidence and reserve the topic for chat collection (rolling out) ENTITLEMENT

Plan availability: capabilities tagged ENTITLEMENT are entitlement-gated; calls from a store without the required entitlement return 403 entitlement_required. Better and Studio include these capabilities; the Free plan does not (review groups and API access themselves are on Free). On legacy plans (no longer sold), they are available on Growth and above, and on legacy Pro and Enterprise; stores on the legacy Starter plan do not have them. See Pricing.

Install in Claude Code

Option 1: Download and extract (recommended)

Run this single command in your project root:

curl -fSL https://betterreviews.app/downloads/betterreviews-api-skill.tar.gz | tar -xz -C "$(mkdir -p .claude/skills && echo .claude/skills)" && echo "Installed to .claude/skills/betterreviews-api/"

Option 2: Manual setup

Create the directory .claude/skills/betterreviews-api/ in your project and copy the SKILL.md and reference files from the GitHub repository.

Direct download (.tar.gz, 43KB)

Option 3: MCP (tools instead of curl)

BetterReviews is also an MCP server. In Claude Code:

claude mcp add --transport http betterreviews https://api.betterreviews.app/api/v1/mcp \
  --header "X-API-Key: YOUR_API_KEY"

For Claude Desktop, add the same URL and header under mcpServers in claude_desktop_config.json. For a claude.ai custom connector (which cannot send headers), mint a read-only connector URL instead and paste it as the connector URL — treat that URL as a password. Tool list, connector-URL rules and revocation are on the MCP page.

Setup

  1. Open the BetterReviews app in Shopify admin
  2. Go to Settings → Developer
  3. Click Create token (Read & Write permissions)
  4. Copy the token and store it securely — it is only shown once
  5. When your AI agent asks for the API key, provide the token

Example Usage

Once installed, ask your AI agent things like:

  • "Send a review link to [email protected] for product 7125386199075"
  • "Show me all pending reviews"
  • "Approve all 5-star reviews"
  • "Does our review corpus support the claim that the mug keeps coffee hot for 6 hours?"
  • "What are my review stats for the last 7 days?"
  • "Optimize the product description for our best seller"
  • "Analyze our brand positioning"
  • "Connect our Okendo account"
  • "Turn on automated review collection with a 5-day delay"

Skill Files

The package contains these files:

betterreviews-api/
  SKILL.md                         # Overview, auth, common workflows
  reference/
    review-requests.md             # Send links, list, cancel
    reviews.md                     # List, moderate, stats, search
    claims.md                      # Product claims, evidence links, collection
    conversations.md               # Chat funnel stats
    groups.md                      # Review groups (shared review pools)
    optimizations.md               # AI product descriptions lifecycle
    brand-content.md               # Brand analysis, SEO, FAQ generation
    integrations.md                # Okendo, Judge.me, Yotpo connections
    products.md                    # Product catalog, metrics, lookup
    settings.md                    # Collection + moderation config

API Reference

For the full endpoint documentation (also readable by AI agents via URL), see the API Reference.