Skip to main content

​
Login & CAPTCHA

​
First-time login

The agent 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. 
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 the agent in headed mode again: 
HEADED=1 ./hoard-agent workflows/tcgplayer.yaml
Solve the CAPTCHA, and headless mode works again.

​
The browser opens but nothing happens

The agent 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. The agent detects the redirect to the dashboard and continues automatically

​
”URL did not match” timeout

Session login failed: action "login", step 3: URL did not match "store.tcgplayer.com/admin" within 8s
This means the agent 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. The agent waits for you to finish the full login flow before continuing.