2026年3月6日2 分钟阅读产品
Aidirs 发布 API 和 npm SDK — 用代码提交 AI 产品
Aidirs 正式推出公共 REST API 和官方 npm SDK，站长和开发者可以通过代码批量提交 AI 产品、管理收录，实现目录提交自动化。
如果你运营 AI 工具目录站、SaaS 收录平台，或者需要定期向多个目录提交产品——你一定体会过这种痛苦：一个个填表单，一个站一个站地提交，效率极低，根本无法规模化。
今天，Aidirs 正式推出公共 REST API 和官方 npm SDK（@aidirs/sdk），让你可以直接从代码、CI 流水线或自动化脚本中提交 AI 工具。
为什么需要 API？
大多数 AI 目录站只提供网页表单，提交一两个产品没问题，但如果你是：
- 目录站站长，需要在多个平台间同步产品数据
- SaaS 开发者，希望新工具上线时自动收录到各大目录
- 增长团队，每周管理几十个产品的提交工作
- 开发者，单纯觉得写代码比点表单更顺手
Aidirs API 把原本 5 分钟的手动操作变成一个 API 调用。
工作流程
三步上手：
- 获取 API Key — 在 Dashboard 生成
- 购买积分 — 每次提交消耗 1–6 积分，取决于推广层级
- 通过 API 或 SDK 提交 — 一次调用搞定一个产品，AI 自动补全信息
推广层级
| 层级 | 积分 | 权益 |
|---|---|---|
| Starter | 1 | 基础收录 + dofollow 外链 |
| Pro | 2 | 精选展示 + 社交分享 |
| Sponsor | 6 | 精选 + 全站置顶 7 天 |
SDK 快速上手
安装官方包：
pnpm add @aidirs/sdk
5 行代码提交第一个产品：
const client = new Aidirs({ apiKey: process.env.AIDIRS_API_KEY! });
const result = await client.submit({
url: "https://your-ai-tool.com",
plan: "starter",
});
console.log(result);
// { status: "success", url: "https://aidirs.best/item/your-ai-tool", creditsUsed: 1, creditsRemaining: 9 }
就是这么简单。只需要提供 URL 和推广层级，产品名称和描述由 AI 自动生成。
查询余额
const { credits, plan } = await client.credits();
console.log(`积分: ${credits}, 计划: ${plan}`);
批量提交
有一批工具要提交？SDK 内置了错误处理——积分不足时会自动停止，不会浪费请求：
const { results, errors } = await client.batchSubmit([
{ url: "https://tool-a.com", plan: "starter" },
{ url: "https://tool-b.com", plan: "pro" },
{ url: "https://tool-c.com", plan: "starter" },
]);
console.log(`成功: ${results.length}, 失败: ${errors.length}`);
错误处理
SDK 提供类型化的错误对象，方便精确捕获：
try {
await client.submit({ url: "https://duplicate.com", plan: "starter" });
} catch (err) {
if (err instanceof AidirsAPIError) {
console.log(err.status); // 409
console.log(err.body); // { error: "This URL has already been submitted" }
}
}
直接使用 REST API
更喜欢原生 HTTP？API 支持任何语言和工具：
# 查询积分
curl https://aidirs.best/api/v1/credits \
-H "Authorization: Bearer aidirs_your_key"
# 提交产品
curl -X POST https://aidirs.best/api/v1/submit \
-H "Authorization: Bearer aidirs_your_key" \
-H "Content-Type: application/json" \
-d '{"url": "https://your-tool.com", "plan": "starter"}'
# 响应：
# { "status": "success", "url": "https://aidirs.best/item/your-tool", "creditsUsed": 1, "creditsRemaining": 9 }
只需两个字段：url 和 plan，产品名称和描述由 AI 自动生成。Python、Go、Ruby——任何能发 HTTP 请求的语言都可以。API 文档 提供了多语言示例。
SDK 特性
@aidirs/sdk 轻量且可用于生产环境：
- 完整 TypeScript 类型 — 开箱即用的自动补全和类型检查
- 自动错误解析 — 类型化的
AidirsAPIError，包含状态码和响应体 - 批量提交 — 积分不足时自动停止，避免浪费
- 限流感知重试 — 自动处理 429 响应
- ESM & CJS 双构建 — 适配任何 Node.js 环境
- 零依赖 — 不会给你的
node_modules增加负担
适合谁？
这个 API 是为有持续提交需求的用户设计的：
- 目录聚合站长 — 自动同步你的产品库到 Aidirs
- AI 工具开发者 — 把 Aidirs 提交加入你的上线清单或 CI/CD 流程
- SEO 团队 — 程序化管理跨目录的 dofollow 外链
- 独立开发者 — 把 Product Hunt + 各大目录站的发布日工作脚本化
开始使用
- 在 aidirs.best 注册账号
- 在 Dashboard 生成 API Key
- 购买积分——先买个小额包测试
- 安装 SDK：
pnpm add @aidirs/sdk - 阅读完整的 API 文档
API 和 SDK 现已上线。如果遇到问题或有功能建议，欢迎邮件反馈：support@aidirs.best。