API 与下载
网站公开 API
本市场公开 HTTP API(https://www.aiagentnet.club):快速开始、鉴权说明、端点参考与 OpenAPI。
网站公开 API - 快速开始
本站(https://www.aiagentnet.club)的 HTTP API:目录发现、意图推荐、线索采集。生产可用。不是 AgentOS / AgentNet X 产品运行时。
这些网站营销 API 为匿名(无 AGIN)。AGIN 用于市场/运行时中的 代理 → MCP 工具调用,不用于下方公开 /api/plans 的 curl。
前置:curl,可选 jq。下列端点无需 API Key。
-
健康检查
确认站点进程在线。
cURL · bashcurl -sS https://www.aiagentnet.club/health -
目录
列出产品与套餐(匿名)。
cURL · bashcurl -sS https://www.aiagentnet.club/api/plans | jq . -
推荐
发送业务提示;获得场景、产品、套餐与下一步动作。
cURL · bashcurl -sS -X POST https://www.aiagentnet.club/api/agent/intent \ -H 'content-type: application/json' \ -d '{"prompt":"sales follow-up for qualified leads"}' -
账号
公开 API 止于发现。产品交付(ISO、IM、付费套件)需要账号。
一键脚本
脚本 · bash
#!/usr/bin/env bash
set -euo pipefail
BASE=https://www.aiagentnet.club
curl -sS "$BASE/health" | jq .
curl -sS "$BASE/api/plans" | jq '.plans[0]'
curl -sS -X POST "$BASE/api/agent/intent" \
-H 'content-type: application/json' \
-d '{"prompt":"sales follow-up for qualified leads"}' \
| jq '{status, planId, recommendedProducts, nextActions}'
鉴权说明
下列公开网站端点无需鉴权。不要为它们发送 API Key 或 Bearer。
工作台、计费与产品运行时使用登录会话或产品权益。downloads.aiagentnet.cloud 上的产品安装包公开免费(免登录)。MCP 市场连接器使用各挂牌声明的调用方自备第三方凭证。
| 表面 | 鉴权 | 用途 |
|---|---|---|
| 公开网站 API | 无 | 健康、目录、意图、线索 |
| 产品下载(CDN) | 无 | Server / Desktop ISO 与未来公开安装器 |
| MCP 连接器(市场) | AGIN(哪个代理)+ 调用方第三方凭证(哪个产品账号) | 可追责的工具执行 |
| 客户工作台 | 会话 cookie | 账号、权益、计费 |
| 产品运行时 | 产品权益 + 代理 AGIN | 安装后的 AgentOS X / IM / AgentNet X |
API 参考
基址: https://www.aiagentnet.club
JSON 请求体使用 content-type: application/json。成功响应含 request_id。POST /api/agent/intent 与 POST /api/leads 按客户端限流。
GET
/health
无需账号 · 无 API Key
Request · bash
curl -sS https://www.aiagentnet.club/health
Response · json
{
"status": "ok",
"service": "agentnet-website",
"request_id": "req_…",
"shared_envelope": {
"success": true,
"code": "ok",
"message": "ok",
"data": { "status": "ok", "service": "agentnet-website" }
}
}
GET
/api/products
无需账号 · 无 API Key
Request · bash
curl -sS https://www.aiagentnet.club/api/products
Response · json
{
"products": [
{
"name": "AgentOS X",
"tag": "Operating system",
"body": "Self-hosted OS for AI employees…",
"cta": "See products"
}
],
"locale": "en",
"request_id": "req_…"
}
GET
/api/scenarios
无需账号 · 无 API Key
Request · bash
curl -sS https://www.aiagentnet.club/api/scenarios
Response · json
{
"scenarios": [
{
"id": "commerce",
"name": "Sales and support",
"headline": "A qualified lead waits 48 hours…",
"products": ["IM", "AgentOS X"],
"planId": "pro"
}
],
"locale": "en",
"request_id": "req_…"
}
GET
/api/plans
无需账号 · 无 API Key
Request · bash
curl -sS https://www.aiagentnet.club/api/plans
Response · json
{
"plans": [
{
"id": "personal_free",
"name": "Free",
"priceCents": 0,
"currency": "USD",
"features": ["AgentOS X ISO + AgentNet IM", "…"],
"action": "signup",
"checkoutUrl": "/auth/signup"
}
],
"locale": "en",
"request_id": "req_…"
}
GET
/api/manifesto
无需账号 · 无 API Key
Request · bash
curl -sS https://www.aiagentnet.club/api/manifesto
Response · json
{
"manifesto": "Hire AI employees you can hold accountable",
"locale": "en",
"request_id": "req_…"
}
POST
/api/agent/intent
无需账号 · 无 API Key · 有限流
Request · bash
curl -sS -X POST https://www.aiagentnet.club/api/agent/intent \
-H 'content-type: application/json' \
-d '{"prompt":"sales follow-up for qualified leads"}'
Response · json
{
"status": "ready",
"locale": "en",
"answer": "Start from Growth and ops teams: … Recommended product mix: AgentNet IM, AgentOS X. Suggested plan: Team. …",
"scenario": {
"id": "growth",
"name": "Growth and ops teams",
"headline": "A website inquiry should hit a follow-up queue the moment it arrives"
},
"recommendedProducts": ["IM", "AgentOS X"],
"planId": "team",
"planName": "Team",
"nextActions": [
"/en/auth/signup?intent=team&next=/checkout/team",
"/pricing",
"/auth/signup",
"/auth/login"
],
"request_id": "req_…"
}
invalid_prompt— 缺少 prompt 或 JSON 非法 → HTTP 400。rate_limited— 客户端请求过多 → HTTP 429。
POST
/api/leads
无需账号 · 无 API Key · 有限流
Request · bash
curl -sS -X POST https://www.aiagentnet.club/api/leads \
-H 'content-type: application/json' \
-d '{
"email":"you@company.com",
"scenario":"commerce",
"company":"Acme",
"painPoint":"Leads wait 48 hours"
}'
Response · json
{
"status": "received",
"scenario": { "id": "commerce", "headline": "…" },
"recommendedProducts": ["IM", "AgentOS X"],
"planName": "Pro",
"nextStep": "…",
"nextActions": ["…"],
"request_id": "req_…"
}
invalid_lead— 邮箱/场景无效或 JSON 非法 → HTTP 400。rate_limited— 提交过于频繁 → HTTP 429。
OpenAPI
上述网站公开端点的 OpenAPI 3.0 机器可读契约。可导入 Postman 或生成客户端。这是工具契约文件,不是 MCP 市场目录本身。
cURL · bash
curl -sS https://docs.aiagentnet.club/openapi.json | jq '.paths | keys'
错误
| HTTP | 场景 |
|---|---|
400 | 非法 JSON 或缺少必填字段(invalid_prompt、invalid_lead) |
429 | 意图或线索被限流 |
5xx | 服务端错误 - 退避重试;支持邮件请附 request_id |