# Puhnasti public AI catalog access

This site exposes read-only public catalog data for AI agents.

Base URL: https://puhnasti.com.ua/

Do not use private OpenCart admin or REST Admin API endpoints. They require
secrets and may expose write actions. Use only the public catalog surfaces
listed below.

## Search products

Use this endpoint to search products, categories, and manufacturers:

GET https://puhnasti.com.ua/index.php?route=extension/module/up_search_live&search={query}

Parameters:
- search: required search text, at least 2 characters.

Response:
- categories: public category matches with id, name, href.
- manufacturers: public brand matches with id, name, href.
- products: public product matches with id, name, href, price, special price,
  code, stock text, image when available.
- search_url: human-readable HTML search page URL.
- corrected_query: optional corrected search text.

Example:

GET https://puhnasti.com.ua/index.php?route=extension/module/up_search_live&search=royal%20canin

## Read product details

After search, open products[].href. Product pages expose public product data as
schema.org Product JSON-LD in:

script[type="application/ld+json"]

Read the Product object for name, description, image, brand, model, sku, price,
currency, availability, aggregate rating, and canonical product URL.

## Bulk catalog feeds

For bulk catalog reading, use these public Google Merchant XML feeds:

GET https://puhnasti.com.ua/index.php?route=extension/feed/google_merchant_feed&feed_id=53
GET https://puhnasti.com.ua/index.php?route=extension/feed/google_merchant_feed&feed_id=3

Feeds may include id, title, description, link, image, price, sale price,
availability, brand, GTIN, MPN, category, and product_detail attributes.

## WebMCP runtime

Pages include AI-ready metadata and JavaScript for WebMCP-compatible runtimes.
When supported by the browser or agent, tools are registered through:

navigator.modelContext.registerTool

Runtime tool names:
- puhnasti_search_products
- puhnasti_get_product_details
- puhnasti_get_catalog_feeds

If navigator.modelContext is unavailable, use the HTTP endpoints above or the
fallback window.PuhnastiAI JavaScript object in a normal browser runtime.

Structured manifest:

GET https://puhnasti.com.ua/.well-known/ai-catalog.json