# PrintIdeas for AI Agents

Current project phase: Phase 4 - Agent Documentation & Self-Description: baseline-ready / monitoring.

Project Phase Statuses:
- Phase 1 - Data Foundation: Completed
- Phase 2 - Product Experience For Agents: Baseline completed / monitoring
- Phase 3 - Discovery & Comparison: baseline-ready / monitoring
- Phase 4 - Agent Documentation & Self-Description: baseline-ready / monitoring
- Phase 5 - Checkout Flow & Predictability: Sandbox checkout review prototype only

What this site is:
PrintIdeas is an agent-friendly print-on-demand product discovery catalog for AI shopping assistants and web crawlers.

Allowed actions for AI agents:
- Search public POD products.
- Read product details, prices, images, categories, tags, and shipping policy.
- Compare gift ideas for a human buyer.
- Create a PayPal checkout session when the human buyer asks to continue.
- Return the PayPal approval URL to the human buyer.

Forbidden actions for AI agents:
- Do not complete payment automatically.
- Do not approve PayPal payment on behalf of the buyer.
- Do not pretend to be the buyer.
- Do not hide product price, shipping, checkout, or human confirmation requirements.
- Do not purchase anything without explicit human confirmation.

Checkout safety policy:
AI agents may create a checkout session, but final payment approval must be completed by the human buyer. Sandbox checkout review page exists. Browser-submitted PayPal approval payload can be recorded for review, but server-side PayPal verification is still required before any order may be treated as paid. No real Printify order is created and no orders are sent to production.

Important endpoints:
- Homepage: https://printideas-storefront-733487321167.us-central1.run.app/
- Visual catalog: https://printideas-storefront-733487321167.us-central1.run.app/catalog
- Catalog API: https://printideas-storefront-733487321167.us-central1.run.app/api/catalog
- Collections API: https://printideas-storefront-733487321167.us-central1.run.app/api/collections
- Collection detail API: https://printideas-storefront-733487321167.us-central1.run.app/api/collections/{collection_slug}
- Collections comparison API: https://printideas-storefront-733487321167.us-central1.run.app/api/collections/compare?slugs={slug1},{slug2}
- Shortlist product comparison API: https://printideas-storefront-733487321167.us-central1.run.app/api/products/compare?ids={id1},{id2}
- Landed-cost comparison API: https://printideas-storefront-733487321167.us-central1.run.app/api/compare?product_ids={id1},{id2}
- Catalog facets API: https://printideas-storefront-733487321167.us-central1.run.app/api/catalog/facets
- Quote API: https://printideas-storefront-733487321167.us-central1.run.app/quote
- Order/Checkout setup API: https://printideas-storefront-733487321167.us-central1.run.app/order
- Products page: https://printideas-storefront-733487321167.us-central1.run.app/products
- Products JSON feed: https://printideas-storefront-733487321167.us-central1.run.app/products.json
- Design portability: https://printideas-storefront-733487321167.us-central1.run.app/api/design-portability.json
- Agent guide page: https://printideas-storefront-733487321167.us-central1.run.app/for-agents
- Agent card: https://printideas-storefront-733487321167.us-central1.run.app/.well-known/agent.json
- OpenAPI schema: https://printideas-storefront-733487321167.us-central1.run.app/openapi.json
- Checkout policy: https://printideas-storefront-733487321167.us-central1.run.app/checkout-policy.json
- Sitemap: https://printideas-storefront-733487321167.us-central1.run.app/sitemap.xml
- Robots: https://printideas-storefront-733487321167.us-central1.run.app/robots.txt