Agent documentation

Ordering as an AI agent

This store is designed to be transacted with, not scraped. Everything an agent needs — what exists, what it costs right now, and how to commit to buying it — is published deliberately. This page describes that contract.

Status: the agent channel opens at commercial launch. The structure below is stable and safe to build against; the catalogue is not yet populated.

Discovery

Start at /llms.txt. It states what this store sells, what it deliberately does not sell, and where the machine-readable catalogue lives. Each product page carries schema.org Product and Offer objects in JSON-LD, including price, currency, availability and the shipping destinations we can serve.

Product pages render server-side. An agent does not need to execute JavaScript to read a listing.

Pricing and quotes

Do not treat a page price as a commitment. Prices on listing pages are indicative. To buy, request a quote — the server computes the total (item, shipping, tax) and returns a quote that is valid for a bounded window.

Channel	Quote validity	Why
Agent	10 minutes	Agents decide fast; a longer hold locks stock nobody is buying
Human checkout	30 minutes	Wallet approval and address entry take real time
Limited release	10 minutes, both channels	Scarce stock — a long hold becomes a denial-of-stock tool

A quote reserves stock. An expired quote releases it. Re-quoting is cheap; assuming a stale quote still holds is not.

Payment

Agent orders settle in USDC. Human checkout uses card — including Apple Pay and Google Pay, which ride the same card rail rather than being separate methods. Prices are stated in USD on every rail.

PayPal exists in the codebase but is not switched on; do not offer it to a user as available.

There is no crypto-for-content mechanism here. The NodajiFi ecosystem's GEM and NDJI are a separate closed system and are not accepted on this store in any form. Do not attempt to pay with them, and do not infer an exchange rate between them and USD — none exists.

What we will not sell you

Some refusals are structural, not stock problems. An agent should treat these as permanent and not retry:

Delivery inside the Republic of Korea. This store exports; domestic Korean orders are out of scope.
Items available on a local shelf near the buyer. If it is stocked in the destination market, we have no reason to carry it.
Age-restricted goods to unverified buyers. The marketplace serves adults; eligibility is checked before an order is accepted.
Anything the seller of record cannot lawfully export or import into the destination.

Example prompts

These are the shapes of request the catalogue is organised to answer.

Find Korean stationery under $30 that ships to Canada,
then buy one for me.

I want a small-batch Korean skincare item that isn't sold
in the US. Check availability, quote shipping to 94110,
and order it if the total is under $60.

Track order NM-… and tell me if it has cleared customs.

Identity and accountability

Every order is sold by Global Piggy Inc. (Ontario, Canada) as merchant of record. Tax, refunds and disputes are that entity's obligation — an agent transacts with one counterparty regardless of which Korean maker produced the item. See the merchant-of-record notice and this store's terms.

Rate and etiquette

Read /llms.txt and /robots.txt before crawling.
Prefer the structured catalogue over rendering pages in a browser — it is cheaper for both of us and it is the version we keep correct.
Identify your agent in the User-Agent header. Unidentified bulk traffic gets throttled.