Understanding Blacklist Keywords

What Are Blacklist Keywords?

Blacklist keywords are words that automatically prevent products from matching, even if they contain your wanted keywords. They help filter out common unwanted items like clothing, stickers, and raffles.

Two Types of Blacklists

1. Master Blacklist (Global)

Keywords that are blocked across all sites.

Current Master Blacklist:

• bot

• donation

• flipper

• raffle

• refund

• waffle

These words are universally excluded because they typically indicate:

• Raffle/lottery entries

• Donations

• Bot protection test products

• Refund policies (not products)

2. Site-Specific Blacklist

Keywords blocked for individual stores to filter out unwanted product categories.

Examples:

• store.taylorswift.com: t-shirt, hoodie, cardigan, hat, shorts

• shop.eminem.com: t-shirt, hoodie, hat, mug, lighter

• rebeccayarrosshop.com: blanket, bottle, mug, hat, magnet, tote

How Blacklists Work

Priority Rules

1. Blacklists always win - Even if you specifically request a blacklisted keyword

2. Exact word matching - Uses word boundaries (not partial matches)

3. Case insensitive - "T-Shirt" = "t-shirt" = "T-SHIRT"

Example Scenarios

Scenario 1: Master Blacklist

Your ACO: Keywords = "vinyl,signed,raffle"
Product Title: "Signed Vinyl Raffle Entry"
Result: ❌ NO MATCH (contains "raffle" from master blacklist)

Scenario 2: Site-Specific Blacklist

Site: shop.eminem.com
Your ACO: Keywords = "signed"
Product Title: "Signed T-Shirt Bundle"
Result: ❌ NO MATCH ("t-shirt" on Eminem store blacklist)

Scenario 3: Blacklist vs. Negative Keywords

Your ACO: Keywords = "poster,-signed"
Site Blacklist: "t-shirt"
Product Title: "Signed Poster"
Result: ❌ NO MATCH (your negative keyword "-signed")
 
Product Title: "Poster T-Shirt Combo"
Result: ❌ NO MATCH (site blacklist "t-shirt")

Viewing Blacklists

View Master Blacklist

Command: /badkws

Shows the global blacklist that applies to all sites.

Example Output:

Current Blacklisted Keywords
 
This list of words and their plurals will NEVER match on ACOs,
even if you specifically add it as a positive keyword.
 
bot
donation
flipper
raffle
refund
waffle

View Site-Specific Blacklist

Command: /site_blacklistkeywords

1. Type the command

2. Select channel (filters sites by notification channel)

3. Select the site from autocomplete

4. View both master and site-specific keywords

Example Output:

Blacklisted Keywords for shop.eminem.com
 
Master Blacklist Keywords:
bot
donation
flipper
raffle
refund
waffle
 
Site Specific Blacklist Keywords:
crewneck
e-shirt
hat
hoodie
lighter
mug
t-shirt

Why Are These Blacklisted?

Common Unwanted Items

Many monitored sites sell both collectibles (wanted) and common merchandise (unwanted):

• Music stores: Often sell apparel alongside vinyl/CDs

• Artist shops: Sell posters AND t-shirts/hoodies

• Book stores: Sell books AND mugs/totes/candles

Purpose

Blacklists prevent your ACOs from matching thousands of irrelevant products, especially:

• Clothing items (unless specifically wanted)

• Accessories and trinkets

• Non-collectible merchandise

• Raffle/donation entries

Working Around Blacklists

You CANNOT Override Blacklists

If a keyword is blacklisted, products with that word will never match your ACO, even if you:

• Explicitly include it as a positive keyword

• Need that specific item

• Think it's a false positive

What You CAN Do

1. Request Removal (Admin Only) If a blacklist keyword is too broad or causes false positives, admins can remove it using:

!badKWs [keyword]  (for master blacklist)

Note: Requires specific Discord role permissions

2. Use Alternative Keywords Find other words that describe the item:

❌ Blacklisted: "t-shirt"
✅ Alternative: "tee", "apparel", "jersey"
(but these might also be blacklisted on some sites)

3. Request Site Addition Without Blacklist If monitoring a new site, request it be added without overly restrictive blacklists

Adding Site-Specific Keywords (Admin)

Command: /add_site_blacklistkeywords

Requirements:

• Admin/moderator permissions

• Creates a GitHub pull request for approval

Usage:

1. Type /add_site_blacklistkeywords

2. Select channel (filters sites)

3. Select site from autocomplete

4. Enter single keyword to blacklist

5. Submit

Example:

/add_site_blacklistkeywords
Channel: #music-merch
Site: store.taylorswift.com
Keyword: sweatpants

Result: "sweatpants" added to Taylor Swift store blacklist (pending approval)

Blacklist Strategy

For End Users

1. Check blacklists first before creating ACOs

2. Use /badkws to see master list

3. Use /site_blacklistkeywords for site-specific lists

4. Avoid blacklisted terms in your keyword searches

5. Use negative keywords in your ACO for non-blacklisted terms you want to exclude

Common Questions

Q: Why won't "signed poster" match if poster isn't blacklisted? A: Another word in the title is likely blacklisted, OR you have a negative keyword excluding it.

Q: Can I see all blacklisted keywords for all sites at once? A: No, use /site_blacklistkeywords per site. Master list is shown with /badkws.

Q: Do blacklists affect CyberAIO tasks? A: No, blacklists only affect ACO matching. Once a task is created, CyberAIO handles it independently.

Q: Why does my ACO work on one site but not another with the same keywords? A: Site-specific blacklists differ. Check each site's blacklist.

Q: Are plural forms automatically blacklisted? A: The system uses exact word matching. "Shirt" ≠ "Shirts" (but both might be separately blacklisted).

Troubleshooting

Issue: Products not matching despite correct keywords

1. Check master blacklist: /badkws

2. Check site blacklist: /site_blacklistkeywords

3. Look for blacklisted words in product title

4. Review your negative keywords (in ACO)

Issue: Too many false negatives (missed products)

1. Identify which blacklist keyword is blocking

2. Request admin review if keyword is too broad

3. Try alternative product descriptors

4. Consider if the site needs blacklist adjustment