Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tryhoard.com/llms.txt

Use this file to discover all available pages before exploring further.

​
First-time login

Hoard needs a one-time headed login to TCGplayer so you can solve the CAPTCHA. After that, the session cookies are saved and headless mode works. If you use Hoard Desktop, you do not need to run a command. Start a sync and log into the browser window Hoard opens for you.
TCGplayer browser controlled by Hoard with an automation banner
This browser belongs to Hoard. Log into TCGplayer there, complete any CAPTCHA or two-factor prompt, then leave the browser open so Hoard can continue. 
HEADED=1 ./hoard-agent workflows/tcgplayer.yaml

​
”Session expired” errors

TCGplayer sessions expire after a few days. When you see: 
Login failed: session expired — run with --headed to solve CAPTCHA
Run Hoard Agent in headed mode again: 
HEADED=1 ./hoard-agent workflows/tcgplayer.yaml
Hoard Desktop users can instead open Hoard Desktop, click Open Agent from the tray menu, and click Sync Now. Hoard will open the TCGplayer browser again when it needs you to log in. Solve the CAPTCHA, and headless mode works again.

​
The browser opens but nothing happens

Hoard waits up to 120 seconds for you to complete the login. If the page is blank or stuck:
  1. Wait for the page to fully load
  2. Enter your TCGplayer email and password
  3. Solve the CAPTCHA
  4. Hoard detects the redirect to the dashboard and continues automatically
During the rest of the sync, you may see additional TCGplayer windows. Do not close, minimize, or click around in those windows while Hoard is working.
Multiple TCGplayer windows open while Hoard runs sync steps

​
”URL did not match” timeout

Session login failed: action "login", step 3: URL did not match "store.tcgplayer.com/admin" within 8s
This means Hoard couldn’t verify a valid TCGplayer session. The cookies are expired or invalid. Fix: Run with HEADED=1 and log in manually.

​
CAPTCHA keeps appearing

TCGplayer uses CAPTCHAs to prevent automated access. Each time your session expires, you need to solve one in headed mode. This typically happens every few days. There is no way to bypass the CAPTCHA automatically. This is by design, respecting TCGplayer’s security measures.

​
Two-factor authentication

If your TCGplayer account has 2FA enabled, you’ll need to complete it during the headed login. Hoard waits for you to finish the full login flow before continuing.