Skip to content
amazon-fresh logo

Amazon Fresh Skill

amazon-fresh

Enables Claude to browse Amazon Fresh groceries, manage lists, and track deliveries

SKILL.md

Full skill instructions

Amazon Fresh Skill

Overview

Automates Amazon Fresh operations including grocery browsing, list management, and delivery tracking through browser automation. Note: Actual orders are not automated for security.

Quick Install

curl -sSL https://canifi.com/skills/amazon-fresh/install.sh | bash

Or manually:

cp -r skills/​amazon-fresh ~/​.canifi/​skills/

Setup

Configure via canifi-env:

# First, ensure canifi-env is installed:
# curl -sSL https://canifi.com/install.sh | bash

canifi-env set AMAZON_EMAIL "[email protected]"
canifi-env set AMAZON_PASSWORD "your-password"

Privacy & Authentication

Your credentials, your choice. Canifi LifeOS respects your privacy.

Option 1: Manual Browser Login (Recommended)

If you prefer not to share credentials with Claude Code:

  1. Complete the Browser Automation Setup using CDP mode
  2. Login to the service manually in the Playwright-controlled Chrome window
  3. Claude will use your authenticated session without ever seeing your password

Option 2: Environment Variables

If you're comfortable sharing credentials, you can store them locally:

canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"

Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.

Capabilities

  • Browse fresh groceries
  • Search for products
  • Manage shopping lists
  • Track deliveries
  • View order history
  • Check Prime benefits
  • Find deals and coupons
  • Schedule delivery windows

Usage Examples

Example 1: Browse Groceries

User: "Show me produce on Amazon Fresh"
Claude: I'll browse produce.
- Navigate to amazon.com/​fresh
- Go to produce section
- Browse available items
- Present fresh options

Example 2: Search Products

User: "Find whole grain bread on Amazon Fresh"
Claude: I'll search for that.
- Search "whole grain bread"
- Filter by Fresh items
- Show available options
- Present with prices

Example 3: Track Delivery

User: "Track my Amazon Fresh order"
Claude: I'll check your delivery.
- Navigate to Fresh orders
- Find active order
- Check delivery window
- Report status

Example 4: Find Deals

User: "What's on sale at Amazon Fresh?"
Claude: I'll find Fresh deals.
- Navigate to Fresh deals
- Browse discounted items
- List notable savings
- Present best offers

Authentication Flow

  1. Navigate to amazon.com/​fresh via Playwright MCP
  2. Sign in with Amazon credentials
  3. Enter email from canifi-env
  4. Enter password
  5. Handle 2FA/​OTP if enabled (notify user via iMessage)
  6. Verify Fresh access
  7. Maintain session cookies

Error Handling

  • Login Failed: Clear cookies, verify credentials
  • Session Expired: Re-authenticate automatically
  • 2FA Required: iMessage for verification code
  • Not Prime Member: Some features require Prime
  • Item Unavailable: Check availability
  • Delivery Window Full: Suggest alternatives
  • Address Not Eligible: Check Fresh availability
  • Order Not Found: Check order ID

Self-Improvement Instructions

When encountering new Amazon Fresh features:

  1. Document new UI elements
  2. Add support for new categories
  3. Log successful patterns
  4. Update for Amazon changes

Notes

  • Orders not automated for security
  • Prime membership recommended
  • Same-day delivery available
  • Whole Foods integration
  • EBT SNAP accepted
  • Delivery windows book fast
  • Substitution options available