CurlShip — 面向机器人的 SaaS 目录服务

概述

当您需要将某个产品或 SaaS 应用提交至公开目录时，请使用本技能。CurlShip 专为机器人和命令行工具（CLI）设计——仅需一次 API 调用即可完成提交，返回经 Open Graph（OG）标签自动抓取的目录条目详情；您还可选择升级至付费套餐以获得更靠前的展示位置。

快速参考

API 基础地址：https://curlship.com
官网首页：https://curlship.com
定价页面：https://curlship.com/pricing

单行典型用例：

• 提交产品 URL，将其加入目录
• 查询当前全部目录条目
• 将已有条目升级至付费套餐（Bronze / Silver / Gold / Platinum）
• 获取 CurlShip 徽章 HTML 代码，用于生成 dofollow 链接

本技能的功能

• 向 CurlShip API 发送 HTTPS 请求
• 调用 POST /api/submit 添加新条目（自动抓取 OG 标签）
• 调用 GET /api/listings 获取所有有效条目列表
• 调用 POST /api/upgrade 获取付费套餐升级的支付结算页 URL
• 返回结构化的 JSON 响应，包含条目详细信息

本技能不支持的功能

• 无需身份认证或 API 密钥
• 不直接处理付款——升级操作仅返回供用户跳转的结算页 URL
• 不修改任何本地文件或系统设置

API 接口端点

1. 提交条目

POST /api/submit — 将产品添加至目录。

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）：

{
  "ok": true,
  "message": "已成功列入目录！添加徽章即可获得 dofollow 链接。",
  "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": ""
}

错误响应：

• 400 — 缺失或格式无效的 URL 或 email
• 403 — URL 位于黑名单中（如成人内容、钓鱼、恶意软件类站点）
• 429 — 请求频率超限（每 IP 每小时最多 10 次提交）

重复提交处理：若该 URL 已存在于目录中，则返回 200 状态码，并附带 "message": "Already listed" 及现有条目数据。

2. 获取全部条目

GET /api/listings — 获取当前所有有效目录条目。

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

响应示例：

{
  "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。

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。

响应示例：

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

错误响应：

• 400 — 套餐名称无效
• 404 — 条目未找到（请先执行 submit）
• 503 — 支付系统暂时不可用

重要提示：待升级的条目必须已存在。请先调用 /api/submit 提交，再调用 /api/upgrade 升级。

4. 徽章 SVG 图像

GET /badge — 返回 CurlShip 徽章的 SVG 图像。

将此徽章嵌入您的网站，即可自动获得一个dofollow链接：

系统每小时自动检查一次徽章是否存在。只要页面中存在任意指向 curlship.com 的 标签，即视为满足条件。