# bigfeet

> bigfeet.net is a deal aggregator for big men's shoes. It tracks US sizes 14, 15, 16, and 17 across ~29 Australian retailers - including Nike AU, The Iconic, Myer, ASICS, Hoka, Saucony, Birkenstock, Vans, and work-boot specialists (FXD, KingGee, Steel Blue). The site scrapes each retailer daily, normalises sizes to US men's, and surfaces price drops, record lows, and back-in-stock signals for a hard-to-serve buyer segment.

Scope: Australia only. Price comparison and deal tracking, no direct sales. Every Shop link redirects to the original retailer.

Categories: athletic (running, court, sport), sneakers (lifestyle, retro, skate), boots (casual, hiking), work (safety-rated), sandals, dress.

## Primary pages
- [Homepage - all in-stock deals](https://bigfeet.net/): Grid of current deals, filterable by size, category, store. Sortable by price, discount, recency.
- [About](https://bigfeet.net/about): What bigfeet is, who runs it, what is and isn't tracked.
- [Where to shop - daily snapshot](https://bigfeet.net/where-to-shop): Live cheat-sheet of every Australian online retailer stocking men's US 14-17 shoes today. Pick a size; the page lists who's carrying it, broken out by style.
- [Sitemap](https://bigfeet.net/sitemap.xml): Full crawlable list of home, all programmatic landing pages, and every in-stock product page.

## Programmatic landing pages
Topically-tight pages, one per slice.  Each has a unique H1, intro
paragraph derived from live data, FAQ block, and JSON-LD
(BreadcrumbList + FAQPage + ItemList).  The card grid lists every
in-stock canonical deal in the slice, sorted by discount.

- /size/[14|15|16|17] - all deals at a given US men's size.
- /size/[size]/[category] - size + category combinations that have data.
  Categories: athletic, boots, dress, sandals, sneakers, work.
- /brand/[brand-slug] - per-brand catalogues across sizes 14-17.
  Built only for brands with >=5 in-stock canonicals to avoid thin pages.
- /product/[handle] - per-product detail pages with full Product +
  AggregateOffer JSON-LD, price history, and every retailer offer.

## Machine-readable formats
- [Deals as JSON](https://bigfeet.net/api/deals.json): Current in-stock deals as a JSON array. Fields: store, vendor, title, size_normalized, shoe_category, price, compare_at_price, currency, available, product_url, image_url.
- [Deals as Markdown](https://bigfeet.net/deals.md): Current in-stock deals as a compact markdown list. Cheaper to tokenise than the HTML homepage.
- [Agent skills](https://bigfeet.net/.well-known/agent-skills.json): Declared capabilities of the site for agent planning.

## MCP server
Preferred surface for agents that speak MCP - typed tool calls over a stateless Streamable-HTTP endpoint.

- Endpoint: `POST https://bigfeet.net/mcp` (JSON-RPC 2.0, protocolVersion 2024-11-05)
- Server card: https://bigfeet.net/.well-known/mcp.json
- Tools: `search_deals`, `get_product`, `list_stores`, `list_categories`, `list_brands`, `get_price_history`
- Brand filter: `search_deals(brand="hoka")` applies a canonical brand mapping so variations like "adidas Originals" / "adidas Performance" / "Adidas" all match `brand="adidas"`.
- No auth required. CORS allows any origin.

## Bot policy
- robots.txt at [/robots.txt](https://bigfeet.net/robots.txt)
- Content-Signal: search=yes, ai-input=yes, ai-train=yes - data is freely usable.
- Supports content negotiation: request pages with `Accept: text/markdown` to receive a markdown version when available.

## Data freshness
- Retailer scrape runs nightly at 18:00 UTC (04:00 AEST).
- Price history is retained permanently; record-low flags require 30 days of history.
- `last_seen_at` on every product reflects the most recent scrape that observed the variant.

## Not in scope
- User accounts, carts, or direct purchases - all transactions happen on the retailer site.
- International shipping, currency conversion, or non-AU retailers.
- Women's or children's footwear - men's large sizes only.