Winter.guide (meatloaf-bot/winter-guide)

Winter.guide is an authoritative, offline-capable static Progressive Web Application (PWA) and programmatic SEO portal for winter preparedness, first-time snow survival, regional 511/211 emergency resources, and 60+ winter expressions & weather terms.

Core Capabilities

• 24 Core Situational Guides: First time in snow, 3-layer clothing rule, penguin walk on ice, black ice skids, stuck car triage, pipe freeze protection, 48-hour storm countdown, and power outage heat retention.

• 60+ Winter Expressions Programmatic SEO Network (/expressions/):

  • Meteorology & Weather Alerts (24): Polar Vortex, Bomb Cyclone, Alberta Clipper, Nor'easter, Lake-Effect Snow, Thundersnow, Freezing Rain, Sleet, Graupel, Black Ice, Hoarfrost, Rime Ice, Frost Quake, Whiteout, Blizzard Warning, Wind Chill, Hard Freeze, Flash Freeze, Ice Jam, Diamond Dust, Snow Squall, Snirt, Sierra Cement, Sun Dog.
  • Home, Driving & Survival Rules (18): Ice Dam, Frost Line, Drip the Faucets, Penguin Walk, Cotton Kills, 3-Layer Rule, Snow Emergency Route, Three-Peak Mountain Snowflake (3PMSF), Snow Chains, Rocking the Car, Block Heater, Diesel Gelling, Bridge Freezes Before Road, Salt Burn, One Warm Room, Heart Attack Snow, Snow Blindness, Frostbite & Frostnip.
  • Winter Idioms & Cultural Phrases (18): Dead of Winter, Cabin Fever, Three Dog Night, Cold Snap, Old Man Winter, Break the Ice, Walking on Thin Ice, Snowed In, Snow Day, Brass Monkeys, Bread and Milk Panic, Under the Weather, Below Zero, Bone-Chilling Cold, Blanket of Snow, Tip of the Iceberg, Snowball Effect, Left Out in the Cold.

• Automatic Contextual Internal Linking Engine: Automatically cross-links winter expressions and synonyms across all 155 HTML pages (>10,200 verified internal links) with DefinedTerm, DefinedTermSet, FAQPage, and BreadcrumbList Schema.org JSON-LD.

• 68 Local Winter Emergency Pages (/local/): All 50 US states + DC, 13 Canadian provinces/territories, and 4 UK nations with 511 road portals, 211 warming shelters, and climate-tier plumbing/driving rules.

• Agentic Features (llms.txt & Model Context Protocol):

  • llms.txt & llms-full.txt: Standard-compliant markdown roadmaps (llmstxt.org) providing clean, unshortened reference material for AI agents and LLM ingest pipelines.
  • Unified Search Index (search_index.json): Instant client and server search across all 24 guides, 60 expressions, 68 regions, and curated Amazon affiliate gear (tag=adamoutler-20).
  • Hardened Python MCP Server (winter-guide-mcp): Native Model Context Protocol (MCP) server supporting stdio and SSE streaming transports with 5 dedicated tools (search_winter_guide, get_guide, get_expression, get_local_resources, search_winter_gear).

Building & Validating Locally

pip install -e ".[dev]"
pytest -v --cov
python -m moneymaker.sites.winter_guide.build_local --output dist/winter_guide --domain winter.guide --site-name "Winter Guide"

Running the MCP Server

# Standard stdio mode (Claude Desktop, Gemini CLI, Cursor, Windsurf)
winter-guide-mcp --transport stdio --affiliate-tag adamoutler-20

# Networked SSE mode
winter-guide-mcp --transport sse --host 0.0.0.0 --port 8000

Docker Deployment

docker compose up -d --build

Serves on http://0.0.0.0:18080 (proxied by nginxproxymanager.adamoutler.com for https://winter.guide).