
2026/03/06
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 行代码提交第一个产品:
import { Aidirs } from "@aidirs/sdk";
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 提供类型化的错误对象,方便精确捕获:
import { Aidirs, AidirsAPIError } from "@aidirs/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 现已上线。如果遇到问题或有功能建议,欢迎邮件反馈:[email protected]。



