用途:将自然语言的 Facebook 数据需求转化为基于官方文档的 KeyAPI REST 调用,用于公开数据的查找、排序、分析、搜索、比较和报告。不要用平台网页浏览替代 API 结果。
主要能力与场景:把个人资料或群组 URL 解析为 ID;查看公开个人资料或主页详情;采集公开的主页/个人资料帖子、照片、Reels;分析公开群组元数据、帖子与活动;生成个人资料、主页或群组的公开活跃度摘要。支持搜索/列表、详情、解析器、排名/趋势、关联实体及组合工作流。
使用方式:以 https://docs.keyapi.ai/llms.txt 及其链接的端点页面为方法、/v1/... 路径、参数、枚举、分页、请求体与响应结构的事实来源;若官方文档与本技能冲突,以官方文档为准。优先使用 API 侧过滤。凭据需保存在本地,绝不打印或复述 KEYAPI_TOKEN。
必要命令(来自技能脚本):检查认证状态用 node scripts/configure-keyapi-auth.mjs --status;未认证时执行 node scripts/configure-keyapi-auth.mjs;解析当前文档用 node scripts/search-keyapi-docs.mjs --query "<entity action>" --resolve;执行 GET 示例 node scripts/keyapi-api.mjs --path /v1/facebook/... --query-param example=value;POST 示例加 --method POST 和 --body 或 --body-file。大响应可用 --output-file 保存完整结果,内部临时分析文件不要作为交付物。
响应判定:code = 0 表示成功,非零为 API 级失败;需检查 HTTP 状态与响应封装。
限制:仅面向公开 Facebook 数据;未提供收费、价格、平台覆盖或效果数据;具体端点路径与参数须以当前官方文档为准,不得凭记忆推断;缺少凭据时须先完成设置,不能回退到平台网页抓取。