ShopClaw.dev - Shopify Product Search API & MCP Skills

Get Your API Key

Connect via MCP

MCP (Model Context Protocol) gives your AI agent native access to ShopClaw tools. Pick your platform:

Paste your API key above to get personalized install commands.

Select a platform above to see install instructions.

Other Agents (Function Calling)

For agents that don't support MCP, use function calling with the ShopClaw REST API.

Use ShopClaw with ChatGPT via Custom GPTs (Actions) or OpenAI function calling in your own app.

Option 1: Custom GPT Action

In the GPT Builder, go to Configure → Actions → Create new action. Set authentication to API Key (Bearer). Or add this system prompt:

System Prompt

You have access to the ShopClaw API for searching Shopify products.

API Endpoint: POST https://www.shopclaw.dev/api/search
Authorization: Bearer sc_your_api_key

Request body:
{
  "query": "search terms",
  "platform": "shopify",
  "limit": 10,
  "filters": { "price_min": 0, "price_max": 999, "vendor": "optional" }
}

When users ask about products, make API calls to search and present results with title, price, URL, and store name.

Option 2: Function Calling (API)

Function Schema

{
  "name": "search_shopify_products",
  "description": "Search across 364M+ Shopify products",
  "parameters": {
    "type": "object",
    "properties": {
      "query": { "type": "string", "description": "Search query" },
      "limit": { "type": "number", "description": "Max results (1-200)" },
      "price_min": { "type": "number", "description": "Min price filter" },
      "price_max": { "type": "number", "description": "Max price filter" },
      "vendor": { "type": "string", "description": "Filter by vendor/brand" }
    },
    "required": ["query"]
  }
}

When ChatGPT calls this function, execute the ShopClaw API request:

Python Handler

import requests

response = requests.post(
    "https://www.shopclaw.dev/api/search",
    headers={
        "Authorization": "Bearer sc_your_api_key",
        "Content-Type": "application/json",
    },
    json={
        "query": "wireless headphones",
        "platform": "shopify",
        "limit": 5,
        "filters": {"price_min": 20, "price_max": 200},
    },
)

data = response.json()
for hit in data["hits"]["hits"]:
    product = hit["_source"]
    print(f"{product['title']} - {product['prices'][0]['price']}")

Available Tools

search_productsShopify $7/1K · TikTok $12/1K

Search products across Shopify (364M+) or TikTok Shop with filters for platform, vendor, price range, and result limit.

Parameters: query (required), platform ("shopify" | "tiktok", default "shopify"), limit, vendor, price_min, price_max

get_product_fieldsFree

Get available searchable and filterable fields in the product index.

Example Prompts

Once connected, just chat naturally. These prompts work with any agent:

“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”

Agent will search and sort/analyze results for you

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

Agent 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 your AI agent about products, it calls ShopClaw.dev's search_products tool (via MCP or function calling). Specify platform: "shopify" or platform: "tiktok" to choose the data source (default: Shopify). The tool searches across 364M+ indexed products and returns results — which your agent then formats and presents naturally. Pricing: Shopify $7/1K searches, TikTok $12/1K searches.

Endpoints

MCP

Remote MCP Server

Streamable HTTP transport for Claude connector, remote agents, and any MCP client.

https://www.shopclaw.dev/api/mcp

Auth: ?key=API_KEY or Bearer header

REST

Search API

Standard REST endpoint for any language or agent framework.

POST https://www.shopclaw.dev/api/search

Auth: Authorization: Bearer API_KEY

npm package: npx -y shopclaw-mcp (local stdio MCP) · Agent discovery: SKILL.md · ai-plugin.json · OpenAPI spec

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

Field	Type	Description
`query`	string	Search query (required)
`platform`	string	"shopify" or "tiktok" (default: "shopify"). Shopify: $7/1K, TikTok: $12/1K
`limit`	number	Max results (default 10, up to 200)
`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": {
    "freeCredit": "4.99",
    "balance": "10.00",
    "maxResults": 200,
    "effectiveLimit": 5,
    "usageThisMonth": 3
  }
}

Pricing

Shopify: $7 per 1,000 searches. TikTok Shop: $12 per 1,000 searches. 10 results per standard search, up to 200 max. Recharge your balance anytime, or subscribe to the $29/mo Agent plan.

Every account starts with $5 of free credit. Qualified users get $5/month replenished. You can also enable auto-recharge with a monthly spending limit.

View Pricing Details

Try It Out

Test the API in your browser with the Playground. Each query deducts from your balance.

Documentation