Back to Directory
Magpie favicon

Magpie

Live

Open-source boilerplate for building niche Shopify Global Catalog product finders on UCP with a Python backend and single-file HTML UI.

Magpie is an open-source starter kit for building niche product-search sites on Shopify's Universal Commerce Protocol. It ships as DollScout, a live collector-Barbie finder, but the engine is domain-agnostic: developers retarget it by editing a single configuration file for hobbies such as vinyl, fountain pens, trading cards, or diecast cars.

The project uses the Shopify UCP CLI for global catalog search, then layers a lightweight Python HTTP server and vanilla HTML interface on top. It includes taxonomy chips, price and in-stock filters, cursor pagination, similarity search, quick-view modals, wishlist state, SEO routes, rate limiting, cache warming, and production deployment files for Fly.io. The model is search-and-referral: result cards link shoppers to the merchant's own product pages and checkout, while Magpie never takes payment or holds inventory.

Why This Matters for UCP

Magpie shows how the Shopify Global Catalog can power focused, high-intent product discovery experiences without each merchant doing custom integration work.

UCP Capabilities

product discovery

UCP Endpoint

Live — Endpoint not yet publicly available

Integration Example

git clone https://github.com/kgelster/magpie
cd magpie
npm install -g @shopify/ucp-cli@0.6.2
ucp profile init --name agent --activate
python3 app.py

# Open http://127.0.0.1:8787, then retarget via domain.py.

UCP Status

Live

Tags

shopifyglobal-catalogproduct-finderpythonstarter-kitopen-source

Pricing

free

Added 2026-07-08
Verified2026-07-08
DocumentationSourceOpen Source

Is this your listing? Claim it to get analytics, a verified badge, and priority placement. Claim your listing →

Related Guides

Reviews

★★★★★4.5 (4 reviews)

These are illustrative examples to show what reviews will look like. Submit your own experience below.

YO

Y. Okonkwo

API Engineer · Feb 25, 2026

★★★★

Good tool for UCP conformance testing. Runs fast and the output is easy to parse in CI. Would like a JSON output mode — currently only text.

BT

B. Thompson

Staff Engineer · Mar 5, 2026

★★★★★

This saved us days of work. Dropped it into our pipeline and had UCP endpoint validation running in about 20 minutes. Documentation is accurate.

KP

K. Park

Backend Developer · Feb 18, 2026

★★★★★

The best developer tool in this category. TypeScript types are correct and complete. Error messages actually tell you what went wrong.

EG

E. Garcia

Senior Engineer · Jan 30, 2026

★★★★

Solid tool. The test suite coverage is excellent. I found one edge case in the payment token validation that the maintainers fixed within 48 hours.

24 other tools in Developer Tools

Is this your tool? Claim this listing

Related Developer Tools

UCP Specification favicon

UCP Specification

Developer Tools

Ecosystem

The official Universal Commerce Protocol specification repository maintained by the UCP organization.

specificationprotocolofficial
UnverifiedAgent-Ready: 40%
4.2implementation(52 signals)
Open Sourcefree
UCP Samples favicon

UCP Samples

Developer Tools

Ecosystem

Official sample implementations and examples for the Universal Commerce Protocol.

examplessamplesofficial
UnverifiedAgent-Ready: 40%
4implementation(55 signals)
Open Sourcefree
UCP Conformance Tests favicon

UCP Conformance Tests

Developer Tools

Ecosystem

Official conformance test suite for validating UCP protocol compliance.

testingconformanceofficial
Verified 4 days agoAgent-Ready: 40%
4.3implementation(15 signals)
Open Sourcefree