Creating Keywords (ACOs)

Command: /create_keyword

This command opens a form to create a new Auto-Checkout Order (ACO) that will monitor for products matching your criteria.

Prerequisites

  • Your Discord User ID must be linked to a CyberAIO profile

  • You must have fewer than 25 total ACOs

  • Use /aco to get the setup form if you haven't linked your profile yet

Step-by-Step Guide

1. Run the Command

Type /create_keyword in any channel where the bot is active.

2. Fill Out the Form

The modal will appear with 5 fields:

Site (Required)

  • Enter the site's domain name

  • Example: shop.eminem.com or store.taylorswift.com

  • Don't include https:// or www.

  • The site must be in the monitored sites list (use /sites to check)

Keywords (Required)

  • Enter the words you want to match in product titles

  • Positive keywords: Items you want to match

  • Negative keywords: Items to exclude (prefix with -)

  • Use commas to separate multiple keywords

  • Examples:

    • vinyl - matches any product with "vinyl" in the title

    • vinyl,-signed - matches vinyl but excludes signed items

    • poster,print - matches products with "poster" OR "print"

Quantity (Required)

  • Enter the number of items you want to checkout

  • Must be a whole number (1, 2, 3, etc.)

  • Example: 1 for single item, 5 for multiple items

Variant (Optional)

  • Filter by specific product variants (sizes, colors, etc.)

  • Enter keywords that must ALL match in the variant title

  • Use commas to separate (no negatives allowed here)

  • Examples:

    • Large - only match Large size

    • Large,Blue - only match Large AND Blue variants

    • XL,Vinyl - only match XL size vinyl variants

Maximum Price (Optional)

  • Enter the highest price per unit you're willing to pay

  • Enter numbers only (no dollar signs)

  • Examples:

    • 50 - only match items $50 or less

    • 29.99 - only match items $29.99 or less

  • Leave blank for no price limit

3. Submit the Form

Click "Submit" to create your ACO.

How Keyword Matching Works

AND Logic

By default, keywords use OR logic. For AND logic, list them separated by commas:

  • poster,signed - must have BOTH "poster" AND "signed"

Negative Keywords

Use the - prefix to exclude items:

  • vinyl,-picture - matches vinyl but excludes picture discs

  • cd,-signed,-test - matches CDs but excludes signed or test pressings

Exact Word Matching

The bot uses exact word boundaries:

  • vinyl matches "Vinyl Record" but NOT "Vinyls" (different word)

  • signed matches "Hand Signed" but NOT "Designer"

Blacklist Priority

Blacklisted keywords ALWAYS take priority:

  • If you search for "poster" but "poster" is on a site's blacklist, no match will occur

  • Check blacklists first: /badkws (master) and /site_blacklistkeywords (site-specific)

Example Scenarios

Example 1: Simple Product Match

Site: shop.eminem.com
Keywords: vinyl
Quantity: 1
Variant: (leave blank)
Maximum Price: (leave blank)

Result: Matches any vinyl record from the Eminem store

Example 2: Specific Variant with Price Limit

Site: store.taylorswift.com
Keywords: cardigan
Quantity: 1
Variant: Small
Maximum Price: 60

Result: Matches cardigans in Small size, $60 or less

Example 3: Multiple Keywords with Exclusions

Site: bottleneckgallery.com
Keywords: poster,print,-variant
Quantity: 2
Variant: (leave blank)
Maximum Price: 45

Result: Matches posters or prints (but not variants), $45 or less, quantity of 2

Example 4: Precise Variant Matching

Site: littlesleepies.com
Keywords: pajamas
Quantity: 1
Variant: 2T,Floral
Maximum Price: 35

Result: Matches pajamas that are BOTH 2T size AND Floral pattern

After Creating an ACO

  1. Verify Creation: Use /keywords to see all your ACOs

  2. Check Status: Your ACO will show as [On] when active

  3. Auto-Disable: After a match and task creation, ACOs automatically turn [Off]

  4. Re-enable: Use /toggle_keyword to turn it back on if needed

Troubleshooting

"You have reached the maximum allowed number of total tasks"

  • You have 25+ ACOs already created

  • Remove unused ACOs with /remove_keyword

ACO created but not matching products

  • Check if keywords are on the blacklist (/badkws or /site_blacklistkeywords)

  • Verify site is monitored (/sites)

  • Check if variant/price filters are too restrictive

  • Ensure keywords use exact word matching (not partial)

Task created but wrong variant

  • Variant field requires ALL keywords to match

  • Use more specific variant keywords

  • Check the product's actual variant names on the site

Tips for Better ACOs

  1. Start Broad: Begin with simple keywords, add filters later

  2. Check Blacklists First: Avoid wasted ACOs on blacklisted terms

  3. Test Variant Names: Visit the site to see exact variant naming

  4. Use Negative Keywords: Better than creating multiple ACOs

  5. Set Realistic Prices: Factor in taxes and shipping


Last Updated: December 2024