CurlShip Directory Submission

将产品提交到 CurlShip（机器人友好的 SaaS 目录）。一个curl命令即可列出您的产品，包括OG标签抓取、基于徽章的dofollow链接和等级升级。

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

```bash
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):**

```json
{
  "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.

```bash
curl https://curlship.com/api/listings
```

**Example Response:**

```json
{
  "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.

```bash
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:**

```json
{
  "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:

```html
<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`

---

## 中文说明

# CurlShip — 机器人友好的 SaaS 目录

## 概述

当你需要在公共目录中**列出产品或 SaaS** 时使用本技能。CurlShip 专为机器人和 CLI 工具设计——通过单次 API 调用即可提交，获取 OG 抓取的列表详情，并可选地升级到付费等级以获得更高的展示位置。

## 快速参考

**API 基础 URL：** `https://curlship.com`
**主页：** `https://curlship.com`
**定价：** `https://curlship.com/pricing`

**单行用例：**

- 提交产品 URL 以在目录中列出
- 查看所有当前的目录列表
- 将列表升级到付费等级（Bronze/Silver/Gold/Platinum）
- 获取用于 dofollow 链接的 CurlShip 徽章 HTML

## 本技能的功能

- 向 CurlShip API 发送 HTTPS 请求
- 使用 `POST /api/submit` 添加新列表（自动抓取 OG 标签）
- 使用 `GET /api/listings` 检索所有活跃列表
- 使用 `POST /api/upgrade` 获取用于付费等级升级的结账 URL
- 返回带有列表详情的结构化 JSON 响应

## 本技能不做的事

- 不需要身份验证或 API 密钥
- 不直接付款——升级会返回供用户使用的结账 URL
- 不修改任何本地文件或系统设置

## 端点

### 1. 提交列表

**`POST /api/submit`** — 将产品添加到目录。

```bash
curl -X POST https://curlship.com/api/submit \
  -H "Content-Type: application/json" \
  -d '{"url": "https://yourapp.com", "email": "you@email.com"}'
```

**请求字段：**

- `url`（必填）：以 `http` 开头的产品 URL。必须是公开的、非私有的地址。
- `email`（必填）：列表所有者的联系邮箱。

**示例响应（201 Created）：**

```json
{
  "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>"
}
```

**错误响应：**

- `400` — 缺失/无效的 URL 或 email
- `403` — URL 在黑名单上（成人/钓鱼/恶意软件）
- `429` — 超出速率限制（每个 IP 每小时最多 10 次提交）

**重复处理：** 如果 URL 已被列出，返回 `200`，附带 `"message": "Already listed"` 和现有的列表数据。

### 2. 获取所有列表

**`GET /api/listings`** — 检索所有活跃的目录列表。

```bash
curl https://curlship.com/api/listings
```

**示例响应：**

```json
{
  "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
    }
  ]
}
```

列表按等级排序（Platinum > Gold > Silver > Bronze > Free）。

### 3. 升级列表

**`POST /api/upgrade`** — 获取用于升级列表等级的支付结账 URL。

```bash
curl -X POST https://curlship.com/api/upgrade \
  -H "Content-Type: application/json" \
  -d '{"url": "https://yourapp.com", "tier": "gold"}'
```

**请求字段：**

- `url`（必填）：现有列表的 URL。
- `tier`（必填）：`platinum`、`gold`、`silver`、`bronze` 之一。

**示例响应：**

```json
{
  "ok": true,
  "checkout_url": "https://checkout.dodopayments.com/..."
}
```

**错误响应：**

- `400` — 无效的等级名称
- `404` — 未找到列表（请先提交）
- `503` — 支付系统不可用

**重要：** 列表必须已存在。先提交，然后升级。

### 4. 徽章 SVG

**`GET /badge`** — 以 SVG 图片形式返回 CurlShip 徽章。

将此徽章放置在你的网站上即可自动获得 **dofollow** 链接：

`