快速开始

AgentEarth 是面向 AI Agent 的工具市场与基础设施:一个账号,让 Agent 调用 2,400+ 个专业工具和 API,覆盖电商、内容创作、金融、社交媒体、信息检索等场景,统一计费、按次付费。

这一页带你走完三步:选接入方式 → 完成第一次调用 → 在 Agent 里用起来。新用户注册即送 1,000 积分,走完这一页不会产生费用。

第 1 步:选一种接入方式

四种方式背后是同一套能力、同一个账户和余额,按你用的客户端选一种即可:

你在用 推荐方式 需要 API Key
WorkBuddy、TRAE 等有插件市场的客户端 插件市场安装 不需要
Claude Code、Cursor、Codex、VSCode 等能添加 MCP 的客户端 MCP 配置 需要
能运行终端命令的 Agent CLI 需要
自建 Agent、直接写代码调用 HTTP 接口 需要

插件市场安装(最简单)

  1. 打开客户端的插件市场:WorkBuddy 在「专家 · 技能 · 连接器 → 连接器」,TRAE 在「插件市场」。
  2. 搜索 agentearth,找到「AE互联」,点「安装」或「+」。
  3. 第一次调用工具时,浏览器会打开 AgentEarth 登录页,登录即完成授权。还没有账号的话,在这里注册即可,同样获得注册赠送积分。

装好后直接跳到第 3 步。

其他方式:先拿到 API Key

  1. 注册并登录 AgentEarth,打开 API Keys 页面,创建一个 Key。
  2. 把 Key 保存到环境变量 AGENTEARTH_API_KEY,后面的示例都从这里读取:
export AGENTEARTH_API_KEY="<你的 API Key>"
  1. 按客户端完成接入。最常用的是 MCP 配置,地址是 https://agentearth.ai/mcp-server/,请求头带上 X-Api-Key:
{
  "mcpServers": {
    "agentearth": {
      "type": "http",
      "url": "https://agentearth.ai/mcp-server/",
      "headers": { "X-Api-Key": "<你的 API Key>" }
    }
  }
}

不同客户端的 type 写法可能不同(如 "http"、"streamableHttp"),以客户端文档为准。CLI 和对话式安装的步骤见接入方式。

第 2 步:完成第一次调用

用一个免费工具确认 Key 可用。ae_get_result 是查询异步任务结果的工具,不收费,传一个不存在的任务号即可:

curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_get_result' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{"params":{"task_id":"test"}}'

返回里 error_no 为 0、结果中带 "status": "not_found",说明 Key 有效、链路通了。

如果返回 401,检查两点:Key 是否复制完整;请求头是否用的 X-Api-Key。Authorization: Bearer 只用于插件市场连接器签发的令牌,传 API Key 会返回 401。

用插件市场安装的话,不需要这一步:授权完成后,在对话里调用一次工具就是你的第一次调用。

第 3 步:在 Agent 里用起来

在对话里加上「使用 ae ……」(ae 是 AgentEarth 的简称,写成 AgentEarth 也可以),Agent 就会自动找到合适的工具并调用。比如:

  • 使用 ae 调用 GPT Image 2.6 生成一张孙悟空大战哥斯拉的电影海报
  • 使用 ae 在 1688 找蓝牙耳机的源头工厂,对比批发价和起订量
  • 使用 ae 看看小红书上最近关于露营装备的爆款笔记

Agent 在背后做了两件事:

  1. 推荐:把你的任务交给 AgentEarth,拿回几个匹配的工具,以及每个工具的用途、参数说明和价格。
  2. 执行:选定一个工具,按参数说明组织输入并执行,再把结果整理给你。

推荐、浏览工具、查工具详情、查账户余额都不收费,只有执行工具按次扣积分;调用失败不扣费。

下一步