AI-NATIVE · MCP · REST

AI Agent 接入

让 Claude Code、Codex、Cursor 等 AI agent 用一个中台 PAT 直接驱动 AutoData,跨平台采集社媒与广告数据,把原始记录读回自己的工作流。

1创建中台 PAT

编程访问统一使用 MIA 中台的个人访问令牌(PAT,形如 mia_pat_xxxx)。在中台账户页创建,一个 PAT 即可跨所有 MIA 业务线通用。原始令牌仅在创建时显示一次,请妥善保存。令牌绑定你的中台账户,调用会消耗你的 Mia Points。

  1. 登录 MIA 中台账户页 https://mia-platform.i-click.com/account
  2. 打开个人访问令牌(PAT)面板
  3. 点击创建 —— 复制弹出的原始 PAT(形如 mia_pat_xxxx,仅显示一次)

2最快方式(适配任意 agent)

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

读取 __BASE__/llms.txt,然后用我的中台 PAT(Authorization: Bearer mia_pat_你的key)调用 AutoData 的 REST API 帮我采集<具体需求>。

3Claude Code 配置

两种方式任选其一:安装 Skill(推荐,长期可用)或接入 MCP。

方式 A · 安装 Skill(推荐)

下载 SKILL.md,放到 Claude Code 的 skills 目录,重启即可。之后直接说"用 autodata 采集…"。

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

方式 B · MCP

用 HTTP transport 把 AutoData 接成 MCP server。连上后即可直接调用采集工具:搜索、用户主页、广告库等。

claude mcp add --transport http autodata __BASE__/mcp --header "Authorization: Bearer mia_pat_你的key"

4Codex 配置

通用方式(最稳妥)

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

MCP(若你的 Codex 支持 HTTP MCP)

~/.codex/config.toml 增加:

[mcp_servers.autodata]
url = "__BASE__/mcp"
# 通过环境变量或 headers 提供
# Authorization: Bearer mia_pat_你的key

不同 Codex 版本的 MCP 配置可能略有差异,最稳妥仍是上面的通用方式。

5让 LLM 查明细

完整的端点、参数、平台支持与计费规则都在 __BASE__/llms.txt。把它交给你的 agent 阅读,即可获得最新、最准确的用法 —— 无需你手动整理任何文档。

小红书 搜索rednote_search
POST /api/v1/serving/crawl · {"platform":"rednote","keyword":"护肤","limit":20,"time_range":"1week","skip_existing":false}
小红书 用户主页rednote_search
POST /api/v1/serving/rednote/account · {"handle" | "user_id","limit":20,"comments_limit":0,"skip_existing":false} (二选一)
 
time_range: 1day/1week/6months/allcustom + time_range_start/time_range_end(YYYY-MM-DD 精确区间) · skip_existing:true = 增量,滚动查库去重、只回未采过的新帖(搜索/主页均可)
Threads 搜索threads_api
POST /api/v1/serving/threads/search · {"keyword":"AI"}
Threads 主页threads_api
POST /api/v1/serving/threads/account · {"handle":"zuck"} (不带 @)
Twitter / X 主页twitter_api
POST /api/v1/serving/twitter/account · {"handle":"elonmusk","limit":20} (不带 @)
Reddit 子版reddit_api
POST /api/v1/serving/reddit/subreddit · {"subreddit":"AskReddit","limit":20,"sort":"hot","with_comments":false} (区分大小写,不带 r/)
Reddit 搜索reddit_api
POST /api/v1/serving/reddit/search · {"query":"python","limit":20,"subreddit":?,"with_comments":false}
Reddit 单帖reddit_api
POST /api/v1/serving/reddit/post · {"url":"https://www.reddit.com/r/.../comments/..."} (含评论树)
Facebookfacebook_api
POST /api/v1/serving/facebook/account · {"url":"https://www.facebook.com/nike","limit":20}
Facebook 广告库facebook_ad_library
POST /api/v1/serving/facebook/ads/search · {"query":"nike","limit":50}
Instagraminstagram_api
POST /api/v1/serving/instagram/account · {"handle":"nike","limit":20}
LinkedInlinkedin_api
POST /api/v1/serving/linkedin/account · {"url":"…/in/…"} / {"handle","type":"person|company"}
LinkedIn 广告库/api/v1/serving/linkedin/ads
POST /api/v1/serving/linkedin/ads · {"company" | "keyword" | "company_id"} (三选一)
TikTok 广告库tiktok_api
POST /api/v1/serving/tiktok/ads · {"region":"US","period":30,"limit":50}
Google 广告库google_ad_library
POST /api/v1/serving/google/ads · {"domain" | "company_name" | "advertiser_id"} (三选一)

下载 SKILL.md

就是把 llms.txt 的内容打包成一个可直接安装的 Skill —— 放进 Claude Code 或通用 agent 的 skills 目录即可使用。AutoData 支持采集小红书、Threads、Reddit、Facebook、Instagram、LinkedIn、TikTok、Google 广告库等平台。

↓ 下载 SKILL.md
按 Mia Points 计费。采集任务在提交时预扣,成功后按实际记录数结算,失败时退还。额度不足时接口返回 402;余额查询:GET __BASE__/api/v1/billing/quota