`search_products`

Pack: openbeautyfacts · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/search_products for the schema, then POST the same URL with its arguments for the data.

Search cosmetics and personal care products by name or keyword in Open Beauty Facts. Returns matching beauty products with barcode, name, brand, categories, and image. Useful for finding ingredients and details of shampoos, lotions, makeup, deodorants, and other personal-care items. Example: search_products(“shampoo”).

Parameters

Name	Type	Required	Description
`query`	string	yes	Product name or keyword (e.g., “shampoo”, “lipstick”)
`page_size`	number	no	Number of results to return (default: 20, max: 50)

Example call

Arguments

{
  "query": "shampoo"
}

curl

curl -X POST https://gateway.pipeworx.io/openbeautyfacts/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_products","arguments":{"query":"shampoo"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search_products', {
  "query": "shampoo"
});

More examples

{
  "query": "lipstick",
  "page_size": 30
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the openbeautyfacts pack

{
  "mcpServers": {
    "openbeautyfacts": {
      "url": "https://gateway.pipeworx.io/openbeautyfacts/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_products