AI-NATIVE · REST · SKILL

AI Agent 接入

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

1

创建中台 PAT

编程访问统一使用 MIA 中台个人访问令牌（PAT，形如 mia_pat_xxxx），并在每次请求传入 X-On-Behalf-Of-Account。平台 Key（mia_pk_...）还需传入不透明的 X-On-Behalf-Of-User。原始令牌仅创建时显示一次，请妥善保存。

Async report media keeps the admitted opaque User + Account authority through retries, upload, signed-URL refresh, and delivery. Email identity and legacy OBO headers are never accepted as fallbacks. Only X-On-Behalf-Of-User and X-On-Behalf-Of-Account are valid selector names; unknown/versioned identity headers return 400 before introspection. Opaque selectors are exact: whitespace or email-shaped values are rejected, never normalized.

  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.ambr.io/llms.txt（或安装 https://auto-monitor.ambr.io/skill.md），然后用我的中台 PAT 和 Account ID（Authorization: Bearer mia_pat_你的key；X-On-Behalf-Of-Account: account_id）调用 /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.ambr.io/api/external/v1/monitors/ids" \
  -H "Authorization: Bearer mia_pat_你的key" \
  -H "X-On-Behalf-Of-Account: 你的_account_id"
4

Codex 配置

通用方式（最稳妥）

在对话里贴第 2 步那句"读取 llms.txt / skill.md …"；或把下载的 SKILL.md 并入项目根目录的 AGENTS.md，让 Codex 长期可见。

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.ambr.io/skill.md" \
  -o .cursor/skills/automonitor-external-api/SKILL.md
5

让 LLM 查明细

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

# 列监控组 ID
GET https://auto-monitor.ambr.io/api/external/v1/monitors/ids
Authorization: Bearer mia_pat_你的key
X-On-Behalf-Of-Account: 你的_account_id

# 查帖子（外部 API 建组建议带 include_unlabeled=true）
GET https://auto-monitor.ambr.io/api/external/v1/monitors/123/data/posts?lookback_hours=24&include_unlabeled=true
Authorization: Bearer mia_pat_你的key
X-On-Behalf-Of-Account: 你的_account_id
查看 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。