# Send Listing Swarm to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "listing-swarm",
    "name": "Listing Swarm",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Heyw00d/listing-swarm",
    "canonicalUrl": "https://clawhub.ai/Heyw00d/listing-swarm",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/listing-swarm",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=listing-swarm",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "DOCS.md",
      "SECURITY.md",
      "SKILL.md",
      "captcha.js",
      "directories.json",
      "email.js"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "listing-swarm",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-05T02:14:19.143Z",
      "expiresAt": "2026-05-12T02:14:19.143Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=listing-swarm",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=listing-swarm",
        "contentDisposition": "attachment; filename=\"listing-swarm-1.0.3.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "listing-swarm"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/listing-swarm"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/listing-swarm",
    "downloadUrl": "https://openagent3.xyz/downloads/listing-swarm",
    "agentUrl": "https://openagent3.xyz/skills/listing-swarm/agent",
    "manifestUrl": "https://openagent3.xyz/skills/listing-swarm/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/listing-swarm/agent.md"
  }
}
```
## Documentation

### 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.

WhatSecurityCaptcha API✅ Your key, your account, your billingEmail/IMAP✅ Your credentials, optional, never storedData flow✅ Your product info → directory forms (that's it)Source code✅ Fully readable, no obfuscation

See 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

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

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

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

Then add to your environment:

export CAPTCHA_API_KEY="your-own-2captcha-key"
export CAPTCHA_SERVICE="2captcha"

Alternative services (same process):

Anti-Captcha
CapSolver

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:

Create the email account (or use existing)
Enable 2-Factor Auth: Google Account → Security → 2-Step Verification
Create App Password: Google Account → Security → App passwords → Generate
Copy the 16-character password

Set environment variables:

export IMAP_USER="yourproduct.listings@gmail.com"
export IMAP_PASSWORD="xxxx xxxx xxxx xxxx"  # app password, not your real password
export IMAP_HOST="imap.gmail.com"

No email access? Agent will flag you: "Check your email for verification link from Futurepedia"

### 3. Your Product Info

Create a product config the agent can reference:

{
  "name": "Your Product Name",
  "url": "https://yourproduct.ai",
  "tagline": "One line description (60 chars)",
  "description": "Full description for directory listings...",
  "category": "AI Writing Tool",
  "pricing": "Freemium",
  "logo_url": "https://yourproduct.ai/logo.png",
  "screenshot_url": "https://yourproduct.ai/screenshot.png",
  "email": "hello@yourproduct.ai"
}

### Usage

Tell your Clawdbot agent:

"Use the listing-swarm skill to submit my product to AI directories. My product info is in product.json. My 2captcha key is in the environment."

The agent will:

Load the directory list
Visit each directory's submit page
Fill out the form with your product info
Solve captchas using your API key
Flag you if it gets stuck (needs login, payment, etc.)
Track what's submitted

### Human-in-the-Loop

When the agent hits something it can't handle:

"Hey, this directory needs you to create an account first"
"This one requires payment for listing"
"Captcha failed 3 times, can you solve this one?"

You solve it, tell the agent to continue.

### Directory List

Full list in directories.json. Includes:

Directory name and URL
Submit page URL
Domain rating
Monthly traffic
Free vs paid listing
Notes on submission process

### Tracking

Submissions tracked in submissions.json:

{
  "directory": "Futurepedia",
  "status": "submitted",
  "submitted_at": "2026-02-09",
  "listing_url": null,
  "notes": "Pending review"
}

### Files

listing-swarm/
├── SKILL.md           # This file
├── directories.json   # 70+ AI directories with submit URLs
├── submissions.json   # Track your submissions
└── captcha.js         # Captcha solver integration

### Tips

Start with free directories - Many accept free submissions
Have screenshots ready - Most require at least one
Consistent branding - Use same name/tagline everywhere
Check emails - Many send verification links

### Why This Exists

Getting listed on AI directories is tedious. 70+ sites, each with different forms. Your agent can do the grunt work while you handle the few things that need a human.

Part of LinkSwarm - the AI visibility network.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Heyw00d
- Version: 1.0.3
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-05T02:14:19.143Z
- Expires at: 2026-05-12T02:14:19.143Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/listing-swarm)
- [Send to Agent page](https://openagent3.xyz/skills/listing-swarm/agent)
- [JSON manifest](https://openagent3.xyz/skills/listing-swarm/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/listing-swarm/agent.md)
- [Download page](https://openagent3.xyz/downloads/listing-swarm)