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。

  1. 健康检查

    确认站点进程在线。

    cURL · bash
    curl -sS https://www.aiagentnet.club/health
  2. 目录

    列出产品与套餐(匿名)。

    cURL · bash
    curl -sS https://www.aiagentnet.club/api/plans | jq .
  3. 推荐

    发送业务提示;获得场景、产品、套餐与下一步动作。

    cURL · 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"}'
  4. 账号

    公开 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_idPOST /api/agent/intentPOST /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

套餐目录

公开套餐列表。匿名可读。免费/付费指注册后的产品权益,不是调本目录 API。

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 · 有限流

推荐产品路径

匿名推荐:业务问题 → 场景/产品/套餐/下一步。有限流。不是产品运行时,也不是付费门禁——谁都能调,只给建议。

NameInRequiredDescription
promptbodyyes业务问题或流程描述(非空字符串)。
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 · 有限流

提交线索

匿名线索提交(邮箱+场景)。有限流。不会开通付费权益。勿刷接口。

NameInRequiredDescription
emailbodyyes工作邮箱。
scenariobodyyes场景 id:enterprise | commerce | developer | growth。
companybodyno公司或团队名。
painPointbodyno具体痛点。
currentToolsbodyno现有工具。
desiredAutomationbodyno希望 AI 先自动化什么。
teamSizebodyno团队规模。
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 市场目录本身。

下载 openapi.json

cURL · bash
curl -sS https://docs.aiagentnet.club/openapi.json | jq '.paths | keys'

错误

HTTP场景
400非法 JSON 或缺少必填字段(invalid_promptinvalid_lead
429意图或线索被限流
5xx服务端错误 - 退避重试;支持邮件请附 request_id