AI-NATIVE · REST · SKILL

AI Agent 接入

让 Claude Code、Codex、Cursor 等 AI agent 用一个中台 PAT 直接驱动 AutoMonitor：创建报告 Skill / 监控组、触发采集与报告、轮询任务、读取帖子 / 报告与 data_tools 指标。

1

创建中台 PAT

编程访问只接受 MIA 中台个人访问令牌（PAT，形如 mia_pat_xxxx），Account 由中台根据 PAT 确定。平台 Key 不是用户凭据，不能访问 Account 资源。原始 PAT 仅创建时显示一次，请妥善保存。

Platform Human Context 会同时验证 PAT、当前用户和精确 Account。无需传入 Account 选择头；X-On-Behalf-Of-User、平台 Key 模拟用户和未知身份头会在读取产品数据前被拒绝。异步任务会持续保存已准入的不透明用户与 Account，不会从邮箱重建身份。

  1. 登录 MIA 中台账户页 https://mia-platform.ambr.io/account
  2. 打开个人访问令牌（PAT）面板
  3. 点击创建 —— 复制弹出的原始 PAT（形如 mia_pat_xxxx，仅显示一次）
前往中台账户页创建 PAT →
2

最快方式（适配任意 agent）

最简单的接入：直接把下面这句话贴给你的 agent。它会自己读取 llms.txt 学会全部端点与用法，然后用你的中台 PAT 调用 REST API。 

读取 https://auto-monitor-sit.ambr.io/llms.txt（或安装 https://auto-monitor-sit.ambr.io/skill.md），然后用我的中台 PAT（Authorization: Bearer mia_pat_你的key）调用 /api/external/v1 帮我<具体需求：如创建 Threads 监控、触发采集、生成报告>。
3

Claude Code 配置

推荐安装完整 Skill（含探针方法论、字段校验、计费 402 等细节）。也可只读 llms.txt 用 REST 直调。

方式 A · 安装 Skill（推荐）

下载 SKILL.md（automonitor-external-api），放到 Claude Code 的 skills 目录，重启即可。之后直接说"用 automonitor 创建监控 / 生成报告 …"。 

mkdir -p ~/.claude/skills/automonitor-external-api
# 把下载的文件放到：
# ~/.claude/skills/automonitor-external-api/SKILL.md
# 然后重启 Claude Code
下载 SKILL.md

方式 B · REST 直调

托管 Agent API 前缀：/api/external/v1。常用积木：

  • POST /skills — 创建 report Skill
  • POST /monitors — 注册监控组（3–5 个搜索种子）
  • POST /monitors/{id}/crawl — 触发采集
  • POST /monitors/{id}/topics — 触发话题分析（可能 402）
  • GET /monitors/{id}/data/posts — 查询帖子 / 情感等
curl -sS "https://auto-monitor-sit.ambr.io/api/external/v1/monitors/ids" \
  -H "Authorization: Bearer mia_pat_你的key"
4

Codex 配置

通用方式（最稳妥）

在当前对话里贴第 2 步那句“读取 llms.txt …”按需使用；长期使用时，把下载的 SKILL.md 安装到 Codex 的个人或项目 Skill 目录。

Cursor / 其他 agent

把 SKILL.md 放到项目或个人 skills 目录（例如 .cursor/skills/automonitor-external-api/SKILL.md），对话里带上 PAT 即可。 

mkdir -p .cursor/skills/automonitor-external-api
curl -fsSL "https://auto-monitor-sit.ambr.io/skill.md" \
  -o .cursor/skills/automonitor-external-api/SKILL.md
5

让 LLM 查明细

同一份代码仓库合同提供两种运行时视图：机器可读 https://auto-monitor-sit.ambr.io/llms.txt 与可安装 https://auto-monitor-sit.ambr.io/skill.md。两者不再独立维护。Swagger / OpenAPI 仅本地开发模式开放，部署环境通常返回 404。 

# 列监控组 ID
GET https://auto-monitor-sit.ambr.io/api/external/v1/monitors/ids
Authorization: Bearer mia_pat_你的key

# 查帖子（外部 API 建组建议带 include_unlabeled=true）
GET https://auto-monitor-sit.ambr.io/api/external/v1/monitors/123/data/posts?lookback_hours=24&include_unlabeled=true
Authorization: Bearer mia_pat_你的key
查看 llms.txt →

下载 SKILL.md

下载完整的 automonitor-external-api Skill（含鉴权、种子词方法论、字段校验、计费 402、data_tools 等）—— 放进 Claude Code / Cursor 等 skills 目录即可。

↓ 下载 SKILL.md
● analyze / topics / report 会按 Mia Points 预冻→结算；余额不足返回 402。crawl 触发时不预冻，可能在任务执行时因 insufficient_credits 失败。余额请在 MIA 中台账户页 查看/充值（本 API 无对外查余额端点）。关键词请用 3–5 个搜索种子，不要把投诉/过滤同义词堆进 keywords。