SuperAPI AI 工具集

keyapi-facebook-analysis

编程与开发

查看项目

更新于 10-15 21:36

技能介绍

用途:该技能用于探索与分析公开的 Facebook 数据,覆盖公开个人主页、公共主页和群组,可获取资料详情、帖子、照片、Reels、群组帖子、群组未来活动,并提供主页与群组的标识符解析。

主要能力:profile_details_by_url 按 URL 获取主页资料;get_profile_id 将主页 URL 解析为数字 ID;profiles_details_by_id 按数字 ID 查资料;profile_posts 获取已发布帖子;profiles_photos 获取照片并可按 collection_id 限定相册;profile_reels 获取 Reels;get_group_details、get_group_id、get_group_posts、get_group_future_events 分别用于群组资料、群组 ID 解析、群组帖子与未来活动。get_group_posts 支持 CHRONOLOGICAL、TOP_POSTS、RECENT_ACTIVITY、CHRONOLOGICAL_LISTINGS 排序。

使用方式:需设置环境变量 export KEYAPI_TOKEN=your_token_here,要求 Node.js v18 或更高,并在技能目录运行 npm install 安装 @modelcontextprotocol/sdk。工具调用指向 KeyAPI Facebook MCP 服务器 https://mcp.keyapi.ai/facebook/mcp,认证头为 Authorization: Bearer $KEYAPI_TOKEN。先运行 node scripts/run.js --platform facebook --list-tools 验证连接,用 --schema 查看参数。调用示例:node scripts/run.js --platform facebook --tool profile_details_by_url --params '{"url":"https://www.facebook.com/examplepage"}' --pretty。分页接口使用 cursor,首次省略;结果缓存于 .keyapi-cache/YYYY-MM-DD/,默认缓存优先,可用 --no-cache 强制刷新。

限制:仅返回公开内容,私密主页、私密群组和需登录内容无法访问。profile_reels 必须使用从资料响应中提取的 reels_profile_id(base64 集合 ID),不能使用数字 profile_id。数字 ID 需以字符串传入。code=0 为成功;401 检查 token,403 查看配额,429 等待 60 秒后重试,500 可间隔 2–3 秒重试最多 3 次。付费、价格与配额细节暂未提供。