开发者平台概览

MaxAEO 开发者平台把 MaxAEO 抓取 AI 平台回答的能力开放给你的程序：你提交一个问题和一个目标平台，我们去该平台真实提问，把 AI 的回答原文、引用来源、分享链接以及平台提供的执行过程、视频/图片卡片原样交还给你。

它适合这些场景：

自建 AI 搜索监控：把品牌相关问题定期发给各 AI 平台，在自己的数据仓库里统计品牌是否被提及、被哪些网页引用。
内容与 GEO 效果验证：发布内容后，直接看 AI 回答里有没有引用你的页面（cited 字段）。
研究与分析：批量收集不同平台对同一问题的回答，比较观点、信源和回答结构。
给 AI Agent 加一个「问问别的 AI」的工具：通过 MCP，让 Claude Code、Cursor 等客户端直接调用。

两种接入方式

	开放 API	MCP 服务器
适合谁	你的后端服务、脚本、数据管道	支持 MCP 的 AI 客户端与 Agent
协议	HTTPS + JSON，统一 `POST`	MCP Streamable HTTP（无状态）
能力	查询平台、提交任务、查询任务、任务列表	同样四项，包装成 4 个工具
鉴权	`Authorization: Bearer <API Key>`	相同
计费与限流	按成功任务扣点数	与开放 API 完全一致

两种方式共用同一个 API Key、同一份点数余额和同一套限流。

用 AI 编码助手接入

用 Claude Code、Cursor 等 AI 编码助手写接入代码时，把 maxaeo-api.md 交给它。这是一份写给 AI 看的接入指南：基础信息、4 个接口与任务对象的字段、错误码、最容易写错的规则，以及能直接运行的 Python / Node.js 参考实现。文件里不含、也不需要你的 API Key。

文件开头是 Agent Skill 格式的 name / description 元数据，正文是普通 Markdown，所以既能作为 Skill 安装，也能当普通文档使用。

下载 maxaeo-api.md

作为 Skill 安装，二选一：

# 只在当前项目使用（可以随仓库共享给团队）
mkdir -p .claude/skills/maxaeo-api && curl -fsSL https://maxaeo.cn/docs/developers/maxaeo-api.md -o .claude/skills/maxaeo-api/SKILL.md

# 在所有项目中使用
mkdir -p ~/.claude/skills/maxaeo-api && curl -fsSL https://maxaeo.cn/docs/developers/maxaeo-api.md -o ~/.claude/skills/maxaeo-api/SKILL.md

之后让 Claude Code 调用 MaxAEO 开放 API 或配置 MCP 时，它会按 description 自动加载这份 Skill。

保存到项目里：

mkdir -p docs && curl -fsSL https://maxaeo.cn/docs/developers/maxaeo-api.md -o docs/maxaeo-api.md

再在 AGENTS.md（或所用工具的规则文件）里加一句：

- 调用 MaxAEO 开放 API 或 MCP 前，先阅读 docs/maxaeo-api.md，并遵守其中「必须遵守的规则」。

支持 Agent Skills 的工具，也可以把它放到该工具 skills 目录下的 maxaeo-api/SKILL.md。

需要更多细节时，开发者平台的全部页面也合并成了一个文本文件 developer-platform.txt，可以整份交给 AI。

工作方式：异步任务

AI 平台生成一条回答通常要几十秒到两分钟，排队时间另算，所以接口是异步的：

提交任务：调用提交任务，传入平台和问题，立即拿到 task_id，状态为 queued。提交时会按该平台单价预占点数。
轮询结果：每隔 15 秒左右调用查询任务，直到状态变为 succeeded、failed 或 canceled。
读取结果：成功时从 answer 和 raw_result 读取回答正文与引用来源，按提交时的单价扣除点数；失败或取消不扣费，预占的点数会退回。

完整的状态流转见任务生命周期。

基础信息

项目	值
API Base URL	`https://maxaeo.cn/geoapi/geodata/developer`
MCP 地址	`https://maxaeo.cn/geoapi/geodata/developer/mcp`
鉴权	请求头 `Authorization: Bearer gdev_…`，详见认证与 API Key
请求格式	所有接口均为 `POST`，请求体为 JSON 对象
响应格式	`{"ret": 1, "data": {"ent": …}}`，`ret` 不为 1 即失败，详见 API 概述
开发者控制台	maxaeo.cn/developers：创建 API Key、在线调试、查看日志与用量

开发者平台与 MaxAEO 产品使用同一个账号，用你登录 MaxAEO 的方式登录控制台即可。

开发者控制台页面一览

控制台页面	用途	文档
概览	快速开始进度、点数余额、近 7 天请求、平台状态	本页
接口与平台	支持的平台、各平台状态、近 24 小时成功率与耗时	平台、优先级与国家
在线调试	不写代码直接发请求，查看返回结构并复制调用代码	在线调试
API Key	创建、停用、重置、删除 API Key	管理 API Key
调用日志	每次请求的明细、状态、错误与响应	调用日志与用量
用量统计	点数余额、消耗、成功率、额度与限制	调用日志与用量
计费说明	各平台两档单价与计费规则	计费与点数

从这里开始

快速开始5 分钟内创建 API Key，发出第一个请求并拿到 AI 的回答。

认证与 API Key请求头格式、Key 的权限范围与安全建议。

API 参考四个开放接口的参数、响应与错误码。

接入 MCP在 Claude Code、Cursor、VS Code 等客户端中直接调用。

解析回答结果读懂回答正文、引用来源、执行过程和多媒体卡片。

计费与点数预占、扣点与退回规则，以及如何估算成本。