How does AuctionBotPro work?

AuctionBotPro is a bid sniping tool for ShopGoodwill auctions. You set your maximum bid and timing, and the bot places your bid in the final seconds of the auction using Cloudflare Workers for precision timing.

What is the snipe lifecycle?

A snipe goes through these stages: pending, scheduled, sleeping, bidding, then completes as bid_placed, outbid, or error. The workflow sleeps until the auction end, then fires your bid with sub-second precision.

What do I need to get started?

You need a ShopGoodwill account and a Cloudflare account (free tier works). Deploy in minutes with the one-click deploy button or manually via wrangler CLI.

Documentation

Everything you need to know about setting up and using AuctionBotPro to snipe ShopGoodwill auctions.

Quick Start

Sign Up

Create your AuctionBotPro account and complete the onboarding wizard to connect your ShopGoodwill credentials.

Configure

Set your ShopGoodwill credentials and app password. The cron job will automatically authenticate.

Snipe

Search for items, set your max bid and timing, then let the bot handle the rest.

Features

Precision Sniping

Bids fire in the final 3-120 seconds of an auction. Configurable timing per snipe. The bot sleeps until the perfect moment, then strikes — costing nothing while it waits.

Search & Discover

Search ShopGoodwill directly from the dashboard. Browse listings, check prices, view images, and set up snipes in seconds.

Price Research

Optional

Powered by Firecrawl. Searches eBay, Mercari, Amazon, Poshmark and more. Shows price distributions, sold comps, and flip profit analysis with IQR outlier filtering.

Real-Time Tracking

Live countdowns, automatic price updates every 15 minutes via cron, and toast notifications for bid results.

Secure Credentials

ShopGoodwill credentials are encrypted with AES-256. Sessions use 7-day TTL tokens with automatic rotation. Secure, password-protected app access.

Snipe Lifecycle

Pending→Scheduled→Sleeping→Bidding→

Bid PlacedOutbid / Error

The bot sleeps until your configured snipe time, then fires your bid in the final seconds. Prices are automatically updated every 15 minutes for all active snipes.

Required Secrets

APP_PASSWORD_HASH

SHA-256 hash of your app login passwordRequired

SGW_USERNAME

Your ShopGoodwill email addressRequired

SGW_PASSWORD

Your ShopGoodwill passwordRequired

API_KEY

Optional key for API/automation access

FIRECRAWL_API_KEY

Enables price research feature (optional)

Secrets are configured during deployment setup and can be updated through the admin dashboard.

API Access

REST API

Full REST API at api.auctionbotpro.com. Search items, create snipes, check history, and research prices programmatically. Authenticate with API key or Bearer token.

x402 Pay-Per-Call

x402

AI agents can pay per API call with USDC on Base chain — no account needed. The API returns HTTP 402 with payment requirements. Sign a USDC transfer and retry.

AI Discoverable

LLM-Ready

Standard discovery files at /.well-known/ai-plugin.json (ChatGPT plugin), /.well-known/openapi.json (OpenAPI 3.1), /llms.txt (LLM index), and /llms-full.txt (full docs).

Full Developer Guide

Deployment

Self-Hosted Deployment

# Backend

npm install

wrangler d1 migrations apply auctionbotpro-db --remote

wrangler deploy

# Frontend

cd ui && npm install && npm run build

wrangler pages deploy dist --project-name=snipe-bot-ui