listing-swarm

# Listing Swarm 🐝

**A Clawdbot skill to list your AI product on 70+ AI directories.**

Your agent does the submissions. You bring your captcha API key. Human assists when stuck.

---

## 🔒 Security Model: BYOK (Bring Your Own Key)

> **This skill contains ZERO credentials.** All API keys and passwords are provided by YOU at runtime via environment variables. Nothing is stored, logged, or transmitted to LinkSwarm.

| What | Security |
|------|----------|
| Captcha API | ✅ Your key, your account, your billing |
| Email/IMAP | ✅ Your credentials, optional, never stored |
| Data flow | ✅ Your product info → directory forms (that's it) |
| Source code | ✅ Fully readable, no obfuscation |

**See [SECURITY.md](SECURITY.md) for complete security documentation.**

---

## What It Does

Automates submitting your AI tool to directories like:
- There's An AI For That
- Futurepedia  
- OpenTools
- TopAI.tools
- AI Tool Guru
- 65+ more

## Setup

### 1. Get Your Own Captcha Solver API Key (Required)

⚠️ **You must get your own API key.** The skill does not include one.

1. Go to [2Captcha.com](https://2captcha.com) (recommended)
2. Create an account
3. Add funds (~$3 covers 1000 captchas, enough for all 70 directories)
4. Copy your API key from the dashboard

Then add to your environment:
```bash
export CAPTCHA_API_KEY="your-own-2captcha-key"
export CAPTCHA_SERVICE="2captcha"
```

Alternative services (same process):
- [Anti-Captcha](https://anti-captcha.com)
- [CapSolver](https://capsolver.com)

**No API key?** The agent will flag each captcha for you to solve manually.

### 2. Email Access for Auto-Verification (Optional)

Most directories send verification emails. Your agent can handle these automatically if you provide IMAP access.

**Recommended:** Create a dedicated email for submissions:
```
yourproduct.listings@gmail.com
```

**For Gmail:**
1. Create the email account (or use existing)
2. Enable 2-Factor Auth: Google Account → Security → 2-Step Verification
3. Crea...