前言¶
做竞品监测、社群运营复盘或公开主页调研时，往往需要查 Facebook 上的主页、帖子、小组和活动信息。自己写爬虫要应对页面结构变化、反爬和合规边界；在 Agent 里临时查文档再拼 REST 请求，又容易漏参数或跟不上接口变更。下面介绍 community 发布者 user_2e47cd26 在 SkillHub 上的 keyapi-facebook（坐标 @user_2e47cd26/keyapi-fb-analysis，当前版本 1.1.2）：把「查什么」交给对话，由 Skill 引导 Agent 对照 KeyAPI 在线官方文档，通过 KeyAPI REST API 访问公开 Facebook 数据。
这是什么¶
keyapi-facebook 属于 SkillHub 分类 data-analysis 的 Agent Skill，基于通用 SKILL.md 格式安装到各客户端的 skills 目录后生效。Skill 简介写明：通过 KeyAPI REST API，并结合实时官方文档（KeyAPI 文档索引见 https://docs.keyapi.ai/llms.txt，其中提供 facebook.openapi），用于探索和分析 Facebook 公开数据。SkillHub 标签 requires_api_key=true，表示 live 调用需要自行配置 KeyAPI 凭证，而不是无密钥的匿名接口。
核心功能¶
以下能力均来自 SkillHub 与官方简介，未在资料中出现的端点名称不作展开：
- 个人资料与主页（Page）详情：拉取公开账号或主页的基础信息，用于建档、核对或对比。
- 主页内容：资料帖、照片、Reels 等公开内容面的查询与分析。
- 小组（Group）：小组详情、小组内帖子、尚未发生的未来小组活动（future group events）。
- 标识解析：在 URL、用户名、数字 ID 等混用场景下，做 profile / group 标识解析（identifier resolution），减少手工换算 ID 的成本。
执行层面，Skill 的定位是「文档驱动」：以 KeyAPI 当前文档中的方法、路径、参数与响应为准，而不是让 Agent 用浏览器去扒网页当数据源。
安装与启用¶
1、安装 SkillHub CLI（如尚未安装）¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装说明执行完整安装（文档推荐方式）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装 keyapi-facebook¶
安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认会装到 ./skills/，客户端可能识别不到。SkillHub 页面给出的安装提示为：根据 https://skillhub.cn/install/skillhub.md，安装坐标 @user_2e47cd26/keyapi-fb-analysis。
命令行示例（将 <skills 目录> 换成你的环境路径）：
skillhub install @user_2e47cd26/keyapi-fb-analysis --dir <skills 目录>
常用客户端 skills 路径（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可把 SkillHub 页面上的提示词发给 AI，让其按 skillhub.md 完成安装；各客户端差异主要体现在 skills 目录位置，安装坐标一致。
3、配置 KeyAPI¶
Skill 标记 requires_api_key=true。live 请求前需要在本地配置 KeyAPI 账号与 API Key（具体变量名与配置步骤以 Skill 包内说明及 KeyAPI 认证文档为准）。未配置密钥时不应假设能成功调用计费接口。
典型用法¶
资料未提供逐条复制的端到端对话脚本，可复现的工作流如下：
- 在已安装 Skill 的 Agent 中，用自然语言说明目标，例如：「解析这个 Facebook 主页链接对应的 ID，并拉取最近公开帖子」或「查看某公开小组的详情和未来活动」。
- Agent 按 Skill 约定，先对齐业务目标（主体是个人/主页还是小组、要详情还是列表、时间范围等），再查阅 KeyAPI 文档索引
https://docs.keyapi.ai/llms.txt及facebook.openapi对应页面，确认当前 HTTP 方法、/v1/...路径、必填参数与分页方式。 - 在密钥可用时，通过 KeyAPI REST API（基址为 KeyAPI 官方 API 域名，文档与控制台入口见
https://docs.keyapi.ai/llms.txt中的 Optional 链接）发起请求，并将返回结果整理成表格或简短分析，区分「接口返回事实」与「推断结论」。
上述步骤与 Skill 简介中 “using live official docs” 的表述一致：典型价值在于把「查 Facebook 公开数据」收敛成可重复的 API 工作流，而不是一次性手写请求。
适用场景与注意¶
适合谁
- 需要在 Agent 里做 Facebook 公开面数据采集、对比或轻量分析的数据、运营、研究类用户。
- 已具备或愿意申请 KeyAPI 账号，并接受按 KeyAPI 计费与配额使用 REST 接口的团队。
限制与注意
- 数据范围以 Skill 强调的 public Facebook data 为准；非公开或需登录才能看到的内容，不应指望本 Skill 绕过平台权限。
- 接口契约以 KeyAPI 在线文档为准；Skill 版本为 1.1.2，若文档更新，应以文档为准核对参数。
- Skill 来源为 community，发布者为 user_2e47cd26；使用前可在 SkillHub 查看评分与下载量（抓取时记录为评分 100000、下载 582、安装 2），自行评估维护节奏与风险。
- 遵守 Facebook 平台条款、当地法规及 KeyAPI 服务条款；批量拉取前先确认配额与合规边界。
结尾¶
keyapi-facebook 把 Facebook 公开数据查询接到 KeyAPI REST 与实时文档上，覆盖主页/资料、帖子与 Reels、小组与活动、标识解析等常见分析入口，适合装进 Cursor、Claude Code、Codex 等支持 skills 的 Agent。安装与说明入口：
- Skill 官方地址：https://api.skillhub.cn/user_2e47cd26/keyapi-fb-analysis
- SkillHub 页面：https://www.skillhub.cn/skills/user_2e47cd26/keyapi-fb-analysis
- 安装说明：https://skillhub.cn/install/skillhub.md
