前言¶
做 Instagram 账号背调、话题监测或竞品内容盘点时，常见做法是手工翻 App、复制链接，再自己拼表格。接口路径多、分页和 ID 转换规则杂，Agent 若只靠「猜 endpoint」很容易 404 或漏字段。下面介绍 SkillHub 上的 keyapi-instagram（坐标 @user_2e47cd26/keyapi-instagram-ua，当前版本 1.1.2）：它把自然语言需求映射到 KeyAPI 官方文档，再用本地脚本查鉴权、解析文档并发起 REST 调用，适合在 Cursor、Claude Code、Codex 等支持 Skills 的客户端里长期挂着用。
这是什么¶
keyapi-instagram 是社区发布者 user_2e47cd26 维护的 Agent Skill，分类为 content-creation，标签标明 requires_api_key=true。一句话定位：通过 KeyAPI REST API 发现并分析 Instagram 用户与内容，并以 https://docs.keyapi.ai/llms.txt 及链接的端点页作为方法、路径、参数与响应结构的权威来源。
它解决的是「Agent 知道要查 Instagram，但不知道当前该打哪条 /v1/instagram/...、要带哪些参数」的问题；执行契约明确要求用 API 取数，不以平台网页浏览替代 API 结果。
核心功能¶
能力范围与 SkillHub 简介一致，并已对照 Skill 包内 SKILL.md 与 references/scenarios.md 核实，主要包括：
- 用户与关系：用户搜索、资料详情、相关/相似账号、粉丝与关注列表等（路由参考
instagram-user-rules.md）。 - 内容与互动：帖子、Reels、Stories、Highlights、被标记内容、转帖；帖子评论、回复、点赞；shortcode 与 media ID 互转等（
instagram-content-rules.md）。 - 发现与搜索：话题标签、地点、音乐、Explore 分区及分区下内容、综合搜索等（
instagram-discovery-rules.md）。
Skill 将常见意图收成场景卡片（例如「筛选用户」「盘点某账号内容库」「分析单帖讨论」「按标签/地点/Explore 挖内容」），Agent 先选场景，再查实时文档确认 endpoint，最后调用 API。
内置辅助脚本（位于 Skill 目录 scripts/）：
configure-keyapi-auth.mjs：配置与检查KEYAPI_TOKENsearch-keyapi-docs.mjs：按语义检索并解析 KeyAPI 文档keyapi-api.mjs：按文档发起 live REST 请求
成功响应以 KeyAPI 信封为准：code = 0 表示成功，非零为 API 级失败。
安装与启用¶
安装 SkillHub CLI（若尚未安装）¶
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装文档执行（完整安装示例）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 keyapi-instagram¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落到 ./skills/ 可能不会被识别。官方坐标对应的安装命令为：
skillhub install keyapi-instagram-ua --namespace user_2e47cd26 --dir <skills 目录>
常见客户端 skills 路径（与 SkillHub 安装文档一致）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后按各客户端要求重启或刷新 Skills 列表。SkillHub 页面：https://www.skillhub.cn/skills/user_2e47cd26/keyapi-instagram-ua；API 入口：https://api.skillhub.cn/user_2e47cd26/keyapi-instagram-ua。
配置 KeyAPI 鉴权¶
Live 请求需要 KeyAPI Bearer Token（环境变量 KEYAPI_TOKEN）。API 基址为 https://api.keyapi.ai，可在 KeyAPI 控制台创建令牌：https://keyapi.ai/app/dashboard。
在 Skill 目录下检查鉴权状态：
node scripts/configure-keyapi-auth.mjs --status
authStatus: "available" 表示可继续；若为 unavailable，执行交互式配置：
node scripts/configure-keyapi-auth.mjs
或非交互写入（仅在本地私有环境使用）：
node scripts/configure-keyapi-auth.mjs --token "your_keyapi_token"
Skill 要求勿在对话中打印或复述 KEYAPI_TOKEN。
典型用法¶
以下示例来自 Skill 官方 SKILL.md，需在 keyapi-instagram Skill 目录 下执行（或将 scripts/... 解析为相对该 SKILL.md 的路径）。
1. 解析当前文档（发 live 请求前）
node scripts/search-keyapi-docs.mjs --query "<entity action>" --resolve
将 <entity action> 换成推断出的场景语义（例如用户搜索、拉取帖子列表），不要机械照搬用户口语。
2. 调用文档化的 GET 端点
node scripts/keyapi-api.mjs --path /v1/instagram/... --query-param example=value
3. 大响应落盘再分析
node scripts/keyapi-api.mjs --path /v1/instagram/... --query-param example=value --output-file response.json
完整 API 载荷在 helper 结果的 data.data 中；重复相同命令会再次计费调用 KeyAPI。
在 Agent 对话侧，可直接用自然语言描述目标，例如：「按用户名拉资料并分页看最近帖子」「某 hashtag 下前 N 条 Reels」「把帖子 shortcode 转成 media ID 再拉评论」。Skill 会先对齐场景卡片，再查 llms.txt 确认路径与参数，缺省只追问高价值字段（用户名/ID、分页深度、要哪些内容面等）。
适用场景与注意¶
适合谁
- 内容运营、增长、竞品研究：需要结构化拉取公开账号、标签、地点与 Explore 信号，并输出可引用的 API 事实。
- 在 Agent 里做自动化调研流水线：鉴权、查文档、调 API 有固定脚本顺序，减少手工拼 curl。
限制与注意
- 依赖 KeyAPI 账号与配额；Skill 不能替代 KeyAPI 服务条款与数据合规审查。
- 需要本机 Node.js 以运行
scripts/*.mjs；若宿主 Agent 不能执行脚本，Skill 允许改用宿主 HTTP 客户端，但仍须遵循官方文档中的 method、path、header 与 body。 - 官方文档与 Skill 内场景卡冲突时，以 KeyAPI 官方文档 为准。
- SkillHub 统计（以抓取资料为准）：评分 100000，下载 566，安装 3；安装前请自行评估社区 Skill 的维护节奏与 KeyAPI 端点变更。
结尾¶
keyapi-instagram 把 Instagram 相关调研从「临时搜网页」收成「场景 → 实时文档 → KeyAPI 调用」的固定链路，并自带鉴权与文档解析脚本。若你已在用 KeyAPI，或希望 Agent 按官方契约调 Instagram 数据面，可从 SkillHub 安装并在配置 KEYAPI_TOKEN 后直接使用。
- SkillHub：https://www.skillhub.cn/skills/user_2e47cd26/keyapi-instagram-ua
- 官方地址：https://api.skillhub.cn/user_2e47cd26/keyapi-instagram-ua
- KeyAPI 文档索引：https://docs.keyapi.ai/llms.txt
