angeo/module-ucp-catalog

UCP catalog.search and catalog.lookup service implementation for Magento 2 / Adobe Commerce — serves the REST endpoints advertised by angeo/module-ucp (spec 2026-04-08).

Maintainers

Package info

github.com/angeo-dev/module-ucp-catalog

Type:magento2-module

pkg:composer/angeo/module-ucp-catalog

Transparency log

Statistics

Installs: 1

Dependents: 0

Suggesters: 0

Stars: 1

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

1.0.1 2026-07-30 20:38 UTC

Requires

  • php: ~8.2.0||~8.3.0
  • angeo/module-ucp: ^1.4
  • magento/framework: >=103.0.6
  • magento/module-catalog: >=104.0.6
  • magento/module-store: >=101.1.6

MIT 7548ad3462e55e98be584c19f157539961737abf

catalogmagento2ucpaeoagentic-commerceuniversal-commerce-protocol

Published on Packagist.org on 2026-07-30 20:44 UTC

This package is not auto-updated.

Last update: 2026-07-30 20:44:57 UTC

README

The execution layer behind the UCP business profile advertised by angeo/module-ucp: implements dev.ucp.shopping.catalog.search and dev.ucp.shopping.catalog.lookup per UCP spec 2026-04-08, so AI agents that discover your store via /.well-known/ucp can actually query your catalog.

Endpoints

Method & path Capability
POST /ucp/v1/catalog/search dev.ucp.shopping.catalog.search
POST /ucp/v1/catalog/lookup dev.ucp.shopping.catalog.lookup

Responses are validated in CI against the official UCP JSON Schemas at the pinned spec tag (see dev/schema-validation/).

Setup

  1. composer require angeo/module-ucp-catalog
  2. bin/magento module:enable Angeo_UcpCatalog && bin/magento setup:upgrade
  3. In Stores -> Configuration -> Angeo -> UCP:
    • enable the profile and declare Catalog Search / Catalog Lookup;
    • set Transport -> REST Endpoint URL to https://yourstore.com/ucp/v1 — the profile then advertises exactly the paths this module serves.

Smoke test

curl -s -X POST https://yourstore.com/ucp/v1/catalog/search \
  -H 'Content-Type: application/json' \
  -d '{"query":"shirt","pagination":{"limit":5}}' | python3 -m json.tool

curl -s -X POST https://yourstore.com/ucp/v1/catalog/lookup \
  -H 'Content-Type: application/json' \
  -d '{"ids":["YOUR-SKU"]}' | python3 -m json.tool

Expected: ucp.version = 2026-04-08, products[] with price_range in minor units, lookup variants carrying inputs correlation. With the module or capability disabled: spec-shaped 404 error body.

License

MIT — see LICENSE.