Documentation
Everything you need to search Shopify products via API or AI agents.
Quick Start
Create a free account — get 100 requests/month, no credit card required.
Go to Dashboard → API Keys and create an API key.
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_productsSearch Shopify products with filters for vendor, price range, and result limit.
query (required), limit, vendor, price_min, price_maxget_product_fieldsGet 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_keySearch Products
https://www.shopclaw.dev/api/searchcURL 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
| Field | Type | Description |
|---|---|---|
query | string | Search query (required) |
platform | string | Platform filter, default "shopify" |
limit | number | Max results (capped by plan: Free=5, Starter=25, Pro=50) |
from | number | Offset for pagination |
filters | object | price_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
| Plan | Price | Requests/Month | Max Results/Query | Rate Limit |
|---|---|---|---|---|
| Free | $0 | 100 | 5 | 10 req/min |
| Starter | $29/mo | 10,000 | 25 | 60 req/min |
| Pro | $99/mo | 100,000 | 50 | 300 req/min |
| Enterprise | Custom | Unlimited | Custom | Custom |
Try It Out
Test the API in your browser with the Playground. Each query counts against your free plan.