curlshipSubmit products to CurlShip, the bot-friendly SaaS directory. One curl command to list your product with OG tag scraping, badge-based dofollow links, and tier upgrades.
Install via ClawdBot CLI:
clawdbot install MarcinDudekDev/curlshipUse this skill when you need to list a product or SaaS on a public directory. CurlShip is designed for bots and CLI tools β submit with a single API call, get back OG-scraped listing details, and optionally upgrade to paid tiers for higher placement.
API Base URL: https://curlship.com
Homepage: https://curlship.com
Pricing: https://curlship.com/pricing
Single-line Use Cases:
POST /api/submit to add a new listing (auto-scrapes OG tags)GET /api/listings to retrieve all active listingsPOST /api/upgrade to get a checkout URL for paid tier upgradesPOST /api/submit β Add a product to the directory.
curl -X POST https://curlship.com/api/submit \
-H "Content-Type: application/json" \
-d '{"url": "https://yourapp.com", "email": "you@email.com"}'
Request Fields:
url (required): Product URL starting with http. Must be a public, non-private address.email (required): Contact email for the listing owner.Example Response (201 Created):
{
"ok": true,
"message": "Listed! Add a badge for a dofollow link.",
"listing": {
"id": 42,
"url": "https://yourapp.com",
"tier": "free",
"title": "YourApp - Build Faster",
"description": "The fastest way to ship your next SaaS.",
"image": "https://yourapp.com/og-image.png",
"has_badge": false
},
"badge_html": "<a href=\"https://curlship.com\"><img src=\"https://curlship.com/badge\" alt=\"Listed on CurlShip\" /></a>"
}
Error Responses:
400 β Missing/invalid URL or email403 β URL is on a blocklist (adult/phishing/malware)429 β Rate limit exceeded (max 10 submissions per hour per IP)Duplicate Handling: If the URL is already listed, returns 200 with "message": "Already listed" and the existing listing data.
GET /api/listings β Retrieve all active directory listings.
curl https://curlship.com/api/listings
Example Response:
{
"ok": true,
"listings": [
{
"id": 1,
"url": "https://example.com",
"tier": "gold",
"title": "Example App",
"description": "A great example application.",
"image": "https://example.com/og.png",
"has_badge": true
}
]
}
Listings are sorted by tier (Platinum > Gold > Silver > Bronze > Free).
POST /api/upgrade β Get a payment checkout URL to upgrade a listing's tier.
curl -X POST https://curlship.com/api/upgrade \
-H "Content-Type: application/json" \
-d '{"url": "https://yourapp.com", "tier": "gold"}'
Request Fields:
url (required): The URL of an existing listing.tier (required): One of platinum, gold, silver, bronze.Example Response:
{
"ok": true,
"checkout_url": "https://checkout.dodopayments.com/..."
}
Error Responses:
400 β Invalid tier name404 β Listing not found (submit it first)503 β Payment system unavailableImportant: The listing must already exist. Submit first, then upgrade.
GET /badge β Returns the CurlShip badge as an SVG image.
Place this badge on your site to automatically earn a dofollow link:
<a href="https://curlship.com">
<img src="https://curlship.com/badge" alt="Listed on CurlShip" />
</a>
Badge presence is auto-checked hourly. Any tag linking to curlship.com qualifies.
| Tier | Price | Benefits |
|------|-------|----------|
| Platinum | $149/mo | Top of directory, dofollow link, priority OG refresh |
| Gold | $49/mo | Above Silver & Bronze, dofollow link |
| Silver | $15/mo | Above Bronze & Free, dofollow link |
| Bronze | $1/mo | Above Free tier, dofollow link |
| Free | $0 | Listed in Free section, nofollow by default |
Dofollow rules:
POST /api/submitPOST /api/upgrade and present the checkout URL to the userGET /api/listingsx-robots-tag: noindexAI Usage Analysis
Analysis is being generated⦠refresh in a few seconds.
Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot
Perform advanced filesystem tasks including listing, recursive searching by name or content, batch copying/moving/deleting files, and analyzing directory siz...
Essential SSH commands for secure remote access, key management, tunneling, and file transfers.
Extract text from PDF files for LLM processing
The directory for AI agent services. Discover tools, platforms, and infrastructure built for agents.
Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot