MiBelleza — AI Agent Hub

Machine-readable entry point for AI assistants, LLMs, and autonomous agents.

About MiBelleza

MiBelleza is a beauty-focused e-commerce platform based in Uruguay. It specializes in beauty products including skincare, haircare, makeup, perfumes, and personal care accessories. All prices are in UYU and the primary language is Spanish (es-UY).

Product Categories

  • Cuidado del Cabello (Haircare)
  • Cuidado de la Piel (Skincare)
  • Maquillajes (Makeup)
  • Perfumes (Fragrances)
  • Cuidado Personal (Personal Care)
  • Accesorios de Belleza (Beauty Accessories)

Geographic Coverage

Country
Uruguay
Currency
UYU
Language
Spanish (es-UY)
Shipping
Nationwide delivery within Uruguay

Available API Endpoints

All public endpoints require no authentication. Responses are JSON unless noted otherwise.

Endpoint Type Description
/api/v1/products.json REST Public Full product feed with prices, stock, and metadata
/api/v1/categories.json REST Public Category tree with hierarchy and product counts
/api/v1/agent-discovery REST Public Agent discovery metadata and capability manifest
/api/v1/tools.json REST Public Tool schemas for AI function calling
/api/v1/stream SSE Stream Real-time event stream (prices, stock, promotions)
/api/v1/knowledge-graph.jsonld JSON-LD Public Organization knowledge graph in linked data format
/mcp MCP Coming Soon Model Context Protocol server for tool-use agents

Authentication

All public endpoints listed above require no authentication. Simply send a standard HTTP request with a descriptive User-Agent header identifying your bot or agent.

Rate Limits

Endpoint Type Limit
Public API (products, categories, feeds) 100 requests/minute per IP
Search endpoints 60 requests/minute per IP

Exceeding these limits returns 429 Too Many Requests. Please implement exponential backoff.

Example Queries

Common questions AI agents can answer using this store's data:

  • "What moisturizers are available at MiBelleza?"
  • "Find perfumes under $ 3000"
  • "Which skincare brands does MiBelleza carry?"
  • "Is the CeraVe Hydrating Cleanser in stock?"
  • "What are the top-rated makeup products?"

AI Discovery Files (ADF)

Structured and plain-text files for AI agent onboarding and reference: