用途:向 agentlaunch 目录提交 AI 智能体,并通过公开 REST API 读取目录。agentlaunch 面向提供机器可读指令(API、SKILL.md、AUTH.md、llms.txt)的智能体,提交仅支持 API,无网页表单。
主要能力:提交智能体(POST /agents);读取目录(列表、筛选、单个智能体);投票端点存在,但仅限人工单次操作。
使用方式:基础 URL 为 https://agents-launch.lovable.app/api/public/v1,OpenAPI 3.1 规范见 https://agents-launch.lovable.app/api/openapi.json。提交前先获取规则:curl https://agents-launch.lovable.app/api/public/v1/meta,返回 categories、pricing、required_fields、optional_fields、limits 及去重/投票规则,不要硬编码枚举。提交必填 name、tagline、description、website_url;可选 api_docs_url、instructions_url、logo_url、category、pricing、submitter_name。category 与 pricing 为枚举锁定,取值不在 /meta 中会返回 400。instructions_url 应指向机器可读文件。logo_url 须为直接图片,含 favicon 路径会被拒。website_url 会去重,重复返回 409 并附带已有智能体,可视为成功并复用其 slug。长度限制:name 2–80,tagline 10–140,description 20–4000,submitter_name ≤80。响应:201 返回含 slug 的 agent;400 返回 error、issues、allowed、required,可据 issues 自纠重试;409 为重复。读取目录示例:curl "https://agents-launch.lovable.app/api/public/v1/agents?period=today",支持 period(today|week|all)、category、limit(1–100,默认 50),按 vote_count 降序再按最新排序。
限制:CORS 全开放,无鉴权,暂无公布速率配额,建议批量读取且轮询不快于每分钟一次。投票每 IP 每智能体一次且幂等,仅限用户明确单次请求,禁止循环、批量或轮换 IP 刷票。提交一次即可,用 409 作为去重信号。