Facebook KeyAPI 数据工作流

解决的问题

把 Facebook 的查询、排行、对比、报告需求直接映射到网页抓取或模糊接口调用，容易遇到参数拼错、路径过期、返回字段不一致等问题。这个技能面向的是工程师和自动化场景：用户给出业务目标后，先定位到 Facebook 的 profile、page、group、post、photo、Reel 或 event，再用 KeyAPI REST 获取结构化数据。

工作方式

核心流程是目标 → 场景 → 文档 → 调用 → 分析：

• 先拆解 Goal、Entity、Scope、Metric、Pagination depth 和输出格式。
• 依据场景参考选择最接近的 Facebook 工作流，而不是直接猜测 endpoint。
• 通过文档解析脚本或 KeyAPI 官方文档确认 HTTP 方法、/v1/... 路径、参数、分页和响应结构。
• 可用时优先调用 helper 脚本；不可用时用宿主 HTTP 客户端执行同一组已确认的 REST 请求。
• 返回时区分 API 返回事实 与 推断结论，避免把猜测包装成数据。

适用边界

该技能适合 Facebook 公开资料、公开页面、群组、帖子、照片、Reel 和活动数据的查询与对比，不负责绕过登录、抓取私域数据或替代 KeyAPI 官方文档。遇到大范围报告时，应先确认栏目、时间窗和最大调用范围；若 KEYAPI_TOKEN 缺失，应暂停线上请求并走配置流程，而不是改去网页浏览补数据。