Documentation

Everything you need to search Shopify products via API or AI agents.

Quick Start

1

Create a free account — get 100 requests/month, no credit card required.

2

Go to Dashboard → API Keys and create an API key.

3

Use the API directly or connect via MCP to Claude.

Use with Claude (MCP)

Connect ShopClaw to Claude Desktop or Claude Code and search Shopify products with natural language — no code needed.

Claude Desktop

Edit your config file at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "shopclaw": {
      "command": "npx",
      "args": ["-y", "tsx", "https://www.shopclaw.dev/mcp/server.ts"],
      "env": {
        "SHOPCLAW_API_KEY": "sc_your_api_key",
        "SHOPCLAW_API_URL": "https://www.shopclaw.dev"
      }
    }
  }
}

Restart Claude Desktop after saving. You'll see a hammer icon with ShopClaw tools available.

Claude Code (CLI)

# Add ShopClaw MCP to your project
claude mcp add shopclaw \
  -e SHOPCLAW_API_KEY=sc_your_api_key \
  -e SHOPCLAW_API_URL=https://www.shopclaw.dev \
  -- npx -y tsx https://www.shopclaw.dev/mcp/server.ts

# Or add globally (available in all projects)
claude mcp add --scope user shopclaw \
  -e SHOPCLAW_API_KEY=sc_your_api_key \
  -e SHOPCLAW_API_URL=https://www.shopclaw.dev \
  -- npx -y tsx https://www.shopclaw.dev/mcp/server.ts

Available MCP Tools

search_products

Search Shopify products with filters for vendor, price range, and result limit.

Parameters: query (required), limit, vendor, price_min, price_max
get_product_fields

Get available searchable and filterable fields in the product index.

Example Prompts

Once connected, just chat naturally with Claude. Here are some things you can ask:

Find me wireless headphones under $50 on Shopify

Searches products with price filter, returns top results with links and images

What Nike products are available on Shopify stores?

Searches with vendor filter for Nike branded products

Compare prices for "yoga mat" across different Shopify stores

Returns multiple results so you can compare pricing across stores

Search for organic coffee beans and show me the cheapest options

Claude will search and sort/analyze results for you

Find trending pet accessories under $30 and summarize the top 5

Claude searches, then uses its own reasoning to summarize findings

Are there any Shopify stores selling mechanical keyboards? Show me what's available with prices.

Open-ended product discovery with structured output

How it works

When you ask Claude about Shopify products, it automatically calls ShopClaw's search_products tool via MCP. The tool sends a request to the ShopClaw API using your API key, searches across 364M+ indexed products, and returns results to Claude — who then formats and presents them in a natural, conversational way. Each search counts as one request against your monthly plan.

REST API

Authentication

All API requests require an API key in the Authorization header.

Authorization: Bearer sc_your_api_key

Search Products

POSThttps://www.shopclaw.dev/api/search

cURL Example

curl -X POST https://www.shopclaw.dev/api/search \
  -H "Authorization: Bearer sc_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "wireless headphones",
    "platform": "shopify",
    "limit": 5,
    "filters": {
      "price_min": 20,
      "price_max": 200
    }
  }'

Request Body

FieldTypeDescription
querystringSearch query (required)
platformstringPlatform filter, default "shopify"
limitnumberMax results (capped by plan: Free=5, Starter=25, Pro=50)
fromnumberOffset for pagination
filtersobjectprice_min, price_max, vendor

Response

{
  "hits": {
    "total": { "value": 12450 },
    "hits": [
      {
        "_source": {
          "title": "Macaron Headphones Wired",
          "brand": "My Store",
          "url": "https://easyb4u.com/products/macaron-headphones",
          "gallery": [{ "url": "https://cdn.shopify.com/..." }],
          "prices": [{ "currency": "USD", "price": 9.99 }],
          "hostnames": ["easyb4u.com"]
        }
      }
    ]
  },
  "_meta": {
    "plan": "free",
    "maxResults": 5,
    "effectiveLimit": 5,
    "usageThisMonth": 3,
    "monthlyLimit": 100
  }
}

Plans & Limits

PlanPriceRequests/MonthMax Results/QueryRate Limit
Free$0100510 req/min
Starter$29/mo10,0002560 req/min
Pro$99/mo100,00050300 req/min
EnterpriseCustomUnlimitedCustomCustom

Try It Out

Test the API in your browser with the Playground. Each query counts against your free plan.