CurlShip Directory Submission

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

Security Scan

The skill is an instruction-only wrapper describing simple curl calls to curlship.com and requests no credentials or installs — its claims and runtime instructions are internally consistent.

Purpose & Capability

The name/description (submit a product to CurlShip) matches the SKILL.md: all required actions are HTTPS calls to curlship endpoints. No unrelated credentials, binaries, or installs are requested.

Instruction Scope

SKILL.md only instructs the agent to POST/GET JSON to the documented API endpoints and to return responses; it explicitly requires a product URL and an email. There are no instructions to read local files, environment variables, or other system state, nor to transmit data to unexpected endpoints.

Install Mechanism

There is no install spec and no code files — this is instruction-only. That minimizes on-disk persistence and reduces installation risk.

Credentials

The skill declares no environment variables, no credentials, and the documented API is public/no-auth. The SKILL.md does instruct sending a user-provided email and URL to the external service, which is coherent with the stated purpose.

Persistence & Privilege

The skill does not request always:true and does not modify agent or system settings. Autonomous invocation is allowed by platform default but is not elevated here and is proportionate to the skill's functionality.

Assessment

This skill simply tells the agent to make HTTPS calls to https://curlship.com and requires you to provide a product URL and contact email — no credentials or installs are needed. Before installing: (1) verify you trust curlship.com (you're sending URLs and an email to an external service); (2) avoid submitting internal/private URLs — the doc claims SSRF protection but you should not rely on it for sensitive targets; (3) if you follow an upgrade workflow, inspect the checkout URL domain before entering payment details; (4) because it’s instruction-only, the main risk is data exfiltration of any URLs/emails you pass to it, so test with non-sensitive data first and review the service's privacy/terms.

CurlShip — Bot-Friendly SaaS Directory

Overview

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

Quick Reference

API Base URL: https://curlship.com Homepage: https://curlship.com Pricing: https://curlship.com/pricing

Single-line Use Cases:

• Submit a product URL to be listed in the directory
• Check all current directory listings
• Upgrade a listing to a paid tier (Bronze/Silver/Gold/Platinum)
• Get the CurlShip badge HTML for dofollow links

What this skill does

• Sends HTTPS requests to the CurlShip API
• Uses POST /api/submit to add a new listing (auto-scrapes OG tags)
• Uses GET /api/listings to retrieve all active listings
• Uses POST /api/upgrade to get a checkout URL for paid tier upgrades
• Returns structured JSON responses with listing details

What this skill does NOT do

• Does not require authentication or API keys
• Does not make payments directly — upgrade returns a checkout URL for the user
• Does not modify any local files or system settings

Endpoints

1. Submit a Listing

POST /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": "[e-mail]"}'

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 email
• 403 — 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.

2. Get All Listings

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

3. Upgrade a Listing

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 name
• 404 — Listing not found (submit it first)
• 503 — Payment system unavailable

Important: The listing must already exist. Submit first, then upgrade.

4. Badge SVG

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 <a> tag linking to curlship.com qualifies.

Tiers & Pricing

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:

• Paid tiers (any) get dofollow automatically
• Free tier gets dofollow by placing a CurlShip badge on your site

Typical Agent Workflow

1. Submit the product URL and email via POST /api/submit
2. Check the response for the listing details and badge HTML
3. Optionally upgrade via POST /api/upgrade and present the checkout URL to the user
4. Add the badge HTML to the product's website for a dofollow link (free tier)

Rate Limits

• Maximum 10 submissions per hour per IP address
• No rate limit on GET /api/listings

Security & Content Policy

• URLs pointing to private/reserved IP addresses are rejected (SSRF protection)
• URLs on known adult/phishing/malware blocklists are rejected
• All API responses include x-robots-tag: noindex