# Podies

> Podies is a discovery catalogue for pod-based drinks used with coffee-machine formats, designed to help people and agents find compatible coffee pods, coffee capsules, tea pods, hot chocolate capsules, and related pod drinks beyond the original manufacturer.

The public website is at:

- https://podies.com/

## Primary Resources

- [Pilot product feed](https://podies.com/data/pilot-products.json): Current catalogue with local product images and discovery facets.
- [Product sample feed](https://podies.com/data/products.json): Sample product records.
- [Static site index](https://podies.com/index.json): Compact JSON discovery index for agents, crawlers, and integrations.
- [Catalogue shard index](https://podies.com/data/catalogue/index.json): Split catalogue manifest for clients that should avoid loading the full product feed at once.
- [Category index](https://podies.com/data/categories.json): Machine, drink type, flavour, attribute, country, and store categories with canonical URLs.
- [Store index JSON](https://podies.com/data/stores.json): Source-store profiles and canonical store URLs.
- [HTML product records](https://podies.com/products): Human-readable product index.
- [Source-store index](https://podies.com/stores): Source-store pages grouped by product count, country, machine coverage, and drink type.
- [Nespresso Original category](https://podies.com/c/nespresso-original): Example static category page. Related `/c/<category>` URLs are listed in the sitemap.
- [Full LLM context](https://podies.com/llms-full.txt): Expanded Markdown guide with canonical resources, top category pages, top store pages, and agent boundaries.
- [Agent instructions](https://podies.com/AGENTS.md): Public instructions for agents using Podies. Approximately 520 tokens.
- [Lowercase agent instructions](https://podies.com/agents.md): Compatibility copy of the agent instructions. Approximately 820 tokens.
- [Skill brief](https://podies.com/skill.md): Capability and boundary summary. Approximately 360 tokens.
- [Agent permissions](https://podies.com/agent-permissions.json): Public crawl and interaction policy. Approximately 620 tokens.
- [Agent skills index](https://podies.com/.well-known/agent-skills/index.json): Skill discovery metadata. Approximately 170 tokens.
- [Sitemap index](https://podies.com/sitemap.xml): Sitemap index for canonical public URLs.
- [Robots policy](https://podies.com/robots.txt): Crawler policy.

## Sitemap Files

- [Page sitemap](https://podies.com/sitemap-pages.xml): Home, products, static records, and agent-facing documents.
- [Category sitemap](https://podies.com/sitemap-categories.xml): Canonical category result pages.
- [Store sitemap](https://podies.com/sitemap-stores.xml): Source-store index and store profile pages.
- [Feed sitemap](https://podies.com/sitemap-feeds.xml): JSON, OpenAPI, and public discovery metadata.

## Markdown Alternates

Many crawlable HTML pages expose Markdown alternatives for agents that prefer compact text:

- `/c/<category>.md` for category discovery pages.
- `/stores.md` for the store index.
- `/stores/<store>.md` for source-store profiles.

## Site Context

Podies is designed for discovery rather than checkout. It adds value by normalising scattered pod products across multiple source stores into machine, flavour, drink type, country, store, quality, freshness, material, recyclability, and price-signal facets. A user with a machine can quickly see compatible options beyond the original manufacturer; a user who already likes a brand or flavour can discover similar pod drinks and nearby or international stores.

Podies is not the seller. Product links point to original retailer pages, including independent and specialist pod stores where present. Some future links may be affiliate links and should be treated as sponsored when marked.

Podies standardises product summaries to remove repetitive marketing language and make comparison easier. Product records may expose machine compatibility, drink type, flavour, intensity, pod material, recyclability clues, price signals, country, source store, and original retailer URL.

Podies does not publish stale exact price guarantees. Broad price bands or captured price signals may be used for discovery; live availability, final price, ingredients, pack size, and purchase details belong to the source retailer.

Machine compatibility can be direct product evidence or conservative store-level inference. Records with `compatibilityConfidence` set to `store-level` should be treated as useful discovery hints that still require retailer confirmation.