# Send CurlShip Directory Submission 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": "curlship",
    "name": "CurlShip Directory Submission",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/MarcinDudekDev/curlship",
    "canonicalUrl": "https://clawhub.ai/MarcinDudekDev/curlship",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/curlship",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=curlship",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "curlship",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T07:11:32.707Z",
      "expiresAt": "2026-05-09T07:11:32.707Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=curlship",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=curlship",
        "contentDisposition": "attachment; filename=\"curlship-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "curlship"
      },
      "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/curlship"
    },
    "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/curlship",
    "downloadUrl": "https://openagent3.xyz/downloads/curlship",
    "agentUrl": "https://openagent3.xyz/skills/curlship/agent",
    "manifestUrl": "https://openagent3.xyz/skills/curlship/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/curlship/agent.md"
  }
}
```
## Documentation

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

### 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": "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 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

TierPriceBenefitsPlatinum$149/moTop of directory, dofollow link, priority OG refreshGold$49/moAbove Silver & Bronze, dofollow linkSilver$15/moAbove Bronze & Free, dofollow linkBronze$1/moAbove Free tier, dofollow linkFree$0Listed 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

Submit the product URL and email via POST /api/submit
Check the response for the listing details and badge HTML
Optionally upgrade via POST /api/upgrade and present the checkout URL to the user
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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: MarcinDudekDev
- Version: 1.0.0
## 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-02T07:11:32.707Z
- Expires at: 2026-05-09T07:11:32.707Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/curlship)
- [Send to Agent page](https://openagent3.xyz/skills/curlship/agent)
- [JSON manifest](https://openagent3.xyz/skills/curlship/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/curlship/agent.md)
- [Download page](https://openagent3.xyz/downloads/curlship)