Commerceshop.example.com

ShelfSync

ShelfSync exposes a retail storefront as a clean product API. Query the catalog, check live inventory, and read reviews without scraping HTML. Great for price monitoring and shopping agents.

Auth: API key
Latency: ~210ms
Volume: 3.7M / mo
Surfaces: REST · MCP

#retail#products#inventory#pricing

Endpoints

Base URL https://corpus.bifra.dev/shelfsync

GET/products

Search the product catalog.

Parameters

qstring· query

Full-text search query.

categorystring· query

Filter by category slug.

limitnumber· query

Max results (default 20).

Sample response

JSON

{
  "products": [
    {
      "id": "sku_8841",
      "title": "Trailhead Down Jacket",
      "price": { "amount": 189, "currency": "USD" },
      "inStock": true,
      "rating": 4.6
    }
  ]
}

GET/products/{id}

Fetch a single product with full detail and reviews.

Parameters

idstring· pathrequired

Product SKU.

Using the REST API

Call it from your own code, a script, or the terminal. Every response is typed and normalized. Pass your Bifra token as a bearer header.

cURL

curl "https://corpus.bifra.dev/shelfsync/products?q=...&category=...&limit=..." \
  -H "Authorization: Bearer $BIFRA_TOKEN"

Using the MCP server

Add the server to your agent's config and it gets typed tools instead of scraping the site. Works with any MCP-compatible client.

mcp.json

{
  "mcpServers": {
    "shelfsync": {
      "url": "https://corpus.bifra.dev/shelfsync/mcp",
      "headers": { "Authorization": "Bearer ${BIFRA_TOKEN}" }
    }
  }
}

Available tools

search_products
Search the catalog by query and category.
get_product
Fetch full detail for a product.