optcg — One Piece TCG Investment Tracker

CLI portfolio tracker for One Piece TCG cards, boxes, blisters, and promos. Prices scraped live from CardMarket and eBay.

Works on macOS and Windows. macOS also syncs data to iCloud Drive.

---

Requirements

• Python 3.10+
• macOS or Windows
• Chrome, Arc, Brave, or Edge (for automatic CardMarket login — optional but strongly recommended)

---

Installation

git clone https://github.com/YOUR_USERNAME/optcg.git
cd optcg
pip install -e .

On macOS with Homebrew Python, add --break-system-packages if pip complains.

Windows — if optcg is not recognized:

Python's Scripts folder is often not on PATH. Either add it (search "Edit environment variables" → PATH → add %APPDATA%\Python\Python3XX\Scripts), or use:

python -m optcg

This works identically to the optcg command.

Verify:

optcg --version
# or on Windows if not on PATH:
python -m optcg --version

---

Quick start

# Add a card interactively (searches CardMarket, shows image)
optcg add card

# Add with full details
optcg add card -n "Monkey D. Luffy" -s OP-01 -l JP -p 120.00

# Add a graded slab
optcg add card -n "Shanks" -p 200.00 --graded --gc PSA --grade 10 --cert 12345678

# Add sealed product
optcg add box -n "Romance Dawn Booster Box" -s OP-01 -p 95.00

# List everything
optcg list
optcg list --sort pnl          # best P&L at top
optcg list --type card --lang JP

# Update prices (scrapes CardMarket + eBay)
optcg price update --all

# Portfolio P&L summary
optcg portfolio
optcg portfolio --by-set --by-type

# Search CardMarket
optcg search "Zoro" --sort cheap --image
optcg search "Luffy" --sort new --page 2

# Find deals (CardMarket vs eBay comparison)
optcg deals search "Monkey D. Luffy" --discount 20
optcg deals portfolio --discount 15

# Watchlist
optcg watchlist add -n "Shanks" -s OP-01 --target 80.00
optcg watchlist check

# Attach a receipt (auto-renamed, stored in iCloud)
optcg receipt add 3 ~/Downloads/factura.pdf

---

CardMarket setup

CardMarket uses Cloudflare protection. optcg reads cookies automatically from Chrome, Arc, Brave, or Edge on both macOS and Windows.

1. Open cardmarket.com in Chrome (or Arc/Brave/Edge) and let it load fully.
2. That's it — optcg extracts the cookies automatically.

Manual fallback (any browser):

1. Open cardmarket.com → DevTools → Application → Cookies → copy cf_clearance.
2. optcg config set-cookie <paste-value>

Run optcg config cookie-help for detailed instructions.

---

Dashboard (offline HTML file)

Generates a single self-contained dashboard.html with all your data baked in. No server. Open it by double-clicking — it works in any browser.

optcg dashboard            # generate + open immediately
optcg dashboard --no-open  # just write the file

The file is saved to the exports folder (see Data storage above) and regenerated automatically every time you run optcg price update --all.

macOS only: The file lands in iCloud Drive and syncs to iPhone. Open it in Files → iCloud Drive → OnePieceTCG → exports → dashboard.html.

Features:

• Overview — invested / current value / P&L stat cards
• Portfolio over time — value vs invested line chart
• Allocation — donut by type or by set
• Items — search + filter by type + sort
• Charts — P&L per item bar chart
• Watchlist — target prices

---

Phone features (macOS / iPhone / iPad only)

This section is macOS-specific. Windows users can open the exports folder in Documents/OnePieceTCG directly.

Your portfolio lives in iCloud Drive → OnePieceTCG and syncs automatically.

View your portfolio in Numbers

1. On iPhone, open the Files app.
2. Navigate to iCloud Drive → OnePieceTCG → exports.
3. Tap portfolio.csv — it opens in Numbers automatically.
4. price_history.csv shows the full price timeline for every item.

The CSV is regenerated every time you run optcg price update --all on your Mac.

View receipts (tax documents)

1. Files app → iCloud Drive → OnePieceTCG → receipts.
2. Each item has its own folder: item_3/, item_7/, etc.
3. Tap any file to preview in Quick Look.

Open the database directly (advanced)

The raw database is at iCloud Drive → OnePieceTCG → tracker.db. Open it with any SQLite viewer app (e.g. SQLiteViewer on the App Store).

---

All commands

optcg add card / promo / box / blister / sealed
optcg list [--type] [--set] [--lang] [--graded] [--sort]
optcg show <id>
optcg edit <id> [--price] [--condition] [--grade] ...
optcg remove <id>
optcg search <query> [--sort] [--page] [--image]
optcg price update [--all | -i <id>]
optcg price set <id> <price>
optcg portfolio [--by-set] [--by-type]
optcg deals search <query> [--discount] [--lang]
optcg deals portfolio [--discount] [--top]
optcg watchlist add / list / check / remove
optcg receipt add / list / open
optcg export csv
optcg config show / set-cookie / clear-cookie / cookie-help
optcg stats
optcg dashboard [--out path] [--no-open]

Run optcg <command> -h on any command for full options and examples.

---

Data storage

What	macOS	Windows
Database	~/Library/Mobile Documents/com~apple~CloudDocs/OnePieceTCG/tracker.db	~/Documents/OnePieceTCG/tracker.db
Receipts	…/OnePieceTCG/receipts/	…/OnePieceTCG/receipts/
CSV exports	…/OnePieceTCG/exports/	…/OnePieceTCG/exports/
Config / cookies	~/.config/optcg/config.json	~/.config/optcg/config.json

On macOS, data lives in iCloud Drive and syncs to iPhone automatically. On Windows, data lives in Documents/OnePieceTCG.

The config file stores only a cached browser key and an optional manual CF cookie. It never leaves your machine and is excluded from git.

---

Supported sets

OP-01 through OP-10 (more in optcg/scrapers/slugs.py), EB-01, PRB-01, ST-01 → ST-20. If a set is missing, add its CardMarket slug to SET_SLUGS in slugs.py.

---

License

MIT