open-supermarkets
View on GitHubCLI, MCP and Skills for the world's supermarkets. Search, compare, basket and checkout across 9 providers in 6 countries — UK, Netherlands, Belgium, Spain, US, Canada. Built for AI agents.
TypeScript CLI, HTTP API, MCP server (22 tools) and agent skills giving AI agents a shared layer to search live supermarket catalogues, compare prices, build baskets and preview checkout across 10 providers in 7 countries. Batch primitives and optional Open Food Facts enrichment included.
Use Cases
Compare live grocery prices across Tesco, Sainsbury's, Ocado, Albert Heijn, Mercadona, Kroger and InstacartBuild, mutate and inspect supermarket baskets from an AI agentPlan meals to a budget with dietary constraints (no pork, no nuts)Check delivery slots and order historyEnrich products with Nutri-Score, NOVA group, allergens and ingredients via Open Food FactsPreview checkout safely with dry-run before spending moneyBatch-search many ingredients in one tool call to save agent contextPrice tracking and repeat-purchase lists (favourites, Ocado regulars, Tesco staples)
Built With
- Language
- TypeScript
- Frameworks
- @modelcontextprotocol/sdk · Playwright · Commander · Axios · Node.js · puppeteer-extra-plugin-stealth · chalk
Tags
grocery · supermarket · mcp-server · cli · ai-agents · agent-skills · price-comparison · shopping · basket-management · checkout-preview · nutrition · allergens · open-food-facts · http-api · playwright-automation · typescript