`search_products`

Pack: openbeautyfacts · Endpoint: https://gateway.pipeworx.io/openbeautyfacts/mcp

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, or use one-click install buttons:

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

See Getting Started for client-specific install steps.

search_products