Evenrealities Order Tracker

Summary

Automatic monitoring: checks each saved order every morning at 9 AM using memory/evenrealities-orders.json.
Signal-only alerts: Telegram notifications are sent only when an order's status changed since the last run.
Persistent history: every order keeps the last known status plus timestamp so you can spot regressions.
Scriptable CLI: python3 scripts/tracker.py [--check|--config|--history] lets you run the tracker or inspect config/history on demand.
Multi-shipment support: Orders can have multiple shipments (e.g., smart rings with optional sizing kits).

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:

Python 3.7+
~300-500MB disk space (for Playwright browser binaries)
Internet access (to reach track.evenrealities.com)

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:

Playwright will download chromium binaries (~300-500MB)
Review Playwright's installation docs: https://playwright.dev/python/docs/intro
No credentials are embedded in the script — it only accesses public tracking pages
Telegram notifications are handled by OpenClaw cron delivery mechanism (not in script)
All sensitive files (history, config) are stored locally in memory/ directory

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

Order 1: Sizing Kit (Optional)
- Customer receives ring in all available sizes
- Status tracked separately from main order
- Typically ships first
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

Single Shipment Orders: Only one status to track (no sizing kit requested)
- Example: Direct purchase of known size → Single "SHIPPED" status
Multi-Shipment Orders: Two separate shipments with independent statuses
- Sizing kit shipment: PROCESSING → SHIPPED
- Final ring shipment: PENDING (waiting for size confirmation) → PROCESSING → SHIPPED

Important Note

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

First shipment status (sizing kit or direct ring)
You may see: "SHIPPED (sizing kit received, waiting for final ring)"

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):

Script loads your orders from memory/evenrealities-orders.json
For each order, uses browser automation to:
- Navigate to https://track.evenrealities.com
- Enter email + order number
- Click confirm
- Extract status text
Compares status against history
If changed: Sends Telegram notification
If unchanged: Silent (no notification)
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:

email: Email used for tracking
order_id: Order number (format: ORD-XXXXXX or similar)

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:

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

Why Playwright directly?

Dedicated, well-tested library for headless browser control
No extra skill dependencies needed
Direct access to page content and timing control

Security:

Email and order ID are validated before being sent to the browser
No sensitive credentials passed to browser
Browser session is ephemeral (created/destroyed per check)

Workflow

Setup (one-time):

Copy orders example
Edit with your orders
Create cron job

Daily (automatic):

9 AM: Cron triggers
Script checks all orders
Compares to yesterday's status
If changed: You get notified
History updated

Maintenance:

Add/remove orders: Edit memory/evenrealities-orders.json
Check manually anytime: python3 scripts/tracker.py --check
Review history: python3 scripts/tracker.py --history

Troubleshooting

"No orders configured"

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

"Failed to fetch status"

Check that https://track.evenrealities.com is accessible
Verify email and order ID are correct
Browser automation might need adjustment if site layout changed

"No notifications" (but orders exist)

First run: Always silent (establishes baseline)
Subsequent runs: Only notified if status changes
Check history with --history to see stored statuses

Change Cron Time

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

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

References

Evenrealities tracking: https://track.evenrealities.com
Fast Browser Use skill: Browser automation documentation
Cron scheduling: Clawdbot cron documentation

evenrealities-tracker

Safety Notice

Copy this and send it to your AI assistant to learn