Evenrealities Tracker

Evenrealities Order Tracker

Summary

The script quietly polls https://track.evenrealities.com, recomputes each order's status, and only speaks up when there's a meaningful change.

Prerequisites & Installation

System requirements:

Install dependencies:

# Install Python packages
pip install -r skills/evenrealities-tracker/requirements.txt
Install Playwright browsers (one-time, required for browser automation)
playwright install

Security notes:

Understanding Evenrealities Smart Ring Orders

Evenrealities manufactures smart rings in different sizes. When ordering, customers can optionally request a sizing kit — a collection of all sizes to try on and find the correct fit.

Order Workflow

1. Order 1: Sizing Kit (Optional) - Customer receives ring in all available sizes - Status tracked separately from main order - Typically ships first

2. Order 2: Final Ring (After Sizing) - Once customer determines correct size, they return to Evenrealities - Specify the correct size on the order tracking page - Final ring ships separately with the customer's size - Typically ships after sizing kit is returned/processed

How This Affects Tracking

Important Note

The tracker will show the combined order status — if the order has been split into multiple shipments:

Monitor both statuses for complete visibility of your order fulfillment.

Quick Start

1. Set Up Orders Configuration

Copy the example file and add your orders:

cp skills/evenrealities-tracker/references/evenrealities-orders-example.json \
   memory/evenrealities-orders.json

Edit memory/evenrealities-orders.json:

{
  "orders": [
    {
      "email": "your-email@example.com",
      "order_id": "ORD-123456"
    },
    {
      "email": "another-email@example.com",
      "order_id": "ORD-789012"
    }
  ]
}

2. Create Daily Cron Job

clawdbot cron add \
  --name "Evenrealities order check" \
  --schedule "0 9 * * *" \
  --task "python3 /Users/thibautrey/clawd/skills/evenrealities-tracker/scripts/tracker.py --check"

That's it! The cron will run every morning at 9 AM.

How It Works

Daily Flow (9 AM):

1. Script loads your orders from memory/evenrealities-orders.json 2. For each order, uses browser automation to: - Navigate to https://track.evenrealities.com - Enter email + order number - Click confirm - Extract status text 3. Compares status against history 4. If changed: Sends Telegram notification 5. If unchanged: Silent (no notification) 6. Updates memory/evenrealities-status-history.json

Commands

Check All Orders Now

python3 scripts/tracker.py --check

Output example:

🔍 Checking 2 order(s)...
============================================================
📦 Checking: user@example.com / Order #ORD-123456
   Status: SHIPPED
   (No change)
📦 Checking: other@example.com / Order #ORD-789012
   Status: PROCESSING
   ✨ CHANGED: PENDING → PROCESSING
✨ 1 change(s) detected!
   📦 ORD-789012: PENDING → PROCESSING

Show Configuration

python3 scripts/tracker.py --config

Show Status History

python3 scripts/tracker.py --history

Configuration Files

evenrealities-orders.json

Location: memory/evenrealities-orders.json

{
  "orders": [
    {
      "email": "email@example.com",
      "order_id": "ORD-123456"
    }
  ]
}

Fields:

Add as many orders as needed.

evenrealities-status-history.json

Location: memory/evenrealities-status-history.json (auto-generated)

{
  "email@example.com:ORD-123456": {
    "email": "email@example.com",
    "order_id": "ORD-123456",
    "status": "SHIPPED",
    "last_checked": "2026-02-02T09:00:00.000Z"
  }
}

Updated automatically on each run.

Notifications

When You Get Notified

✨ Status CHANGED → Telegram message sent

Example notification:

📦 Order Update!
Order: ORD-789012
Email: user@example.com
Previous: PENDING
New: PROCESSING
Time: 2026-02-02 09:00 AM

When You DON'T Get Notified

✓ Status unchanged ✓ First check (no previous status to compare) ✓ No orders configured

Browser Automation (Playwright)

The skill uses Playwright (direct, not via fast-browser-use) for browser automation:

1. Navigate to https://track.evenrealities.com 2. Fill email field (validated before use) 3. Fill order ID field (validated before use) 4. Click confirmation button 5. Wait 1-2 seconds for page response 6. Extract status text from result 7. Close browser gracefully

Why Playwright directly?

Security:

Workflow

Setup (one-time): 1. Copy orders example 2. Edit with your orders 3. Create cron job

Daily (automatic): 1. 9 AM: Cron triggers 2. Script checks all orders 3. Compares to yesterday's status 4. If changed: You get notified 5. History updated

Maintenance:

Troubleshooting

"No orders configured"

Create/edit memory/evenrealities-orders.json with at least one order.

"Failed to fetch status"

"No notifications" (but orders exist)

Change Cron Time

Edit the cron schedule. Example for 8 AM instead of 9 AM:

clawdbot cron remove 
clawdbot cron add \
  --name "Evenrealities order check" \
  --schedule "0 8 * * *" \
  --task "python3 /Users/thibautrey/clawd/skills/evenrealities-tracker/scripts/tracker.py --check"

References

1. Set Up Orders Configuration

Copy the example file and add your orders:

cp skills/evenrealities-tracker/references/evenrealities-orders-example.json \
   memory/evenrealities-orders.json

Edit memory/evenrealities-orders.json:

{
  "orders": [
    {
      "email": "your-email@example.com",
      "order_id": "ORD-123456"
    },
    {
      "email": "another-email@example.com",
      "order_id": "ORD-789012"
    }
  ]
}

2. Create Daily Cron Job

clawdbot cron add \
  --name "Evenrealities order check" \
  --schedule "0 9 * * *" \
  --task "python3 /Users/thibautrey/clawd/skills/evenrealities-tracker/scripts/tracker.py --check"

That's it! The cron will run every morning at 9 AM.

"No orders configured"

Create/edit memory/evenrealities-orders.json with at least one order.

"Failed to fetch status"

"No notifications" (but orders exist)

Change Cron Time

Edit the cron schedule. Example for 8 AM instead of 9 AM:

clawdbot cron remove 
clawdbot cron add \
  --name "Evenrealities order check" \
  --schedule "0 8 * * *" \
  --task "python3 /Users/thibautrey/clawd/skills/evenrealities-tracker/scripts/tracker.py --check"