SuperAPI AI 工具集

facebook_cli

通用与其它

查看项目

更新于 10-26 18:17

技能介绍

Facebook CLI 是一个通过命令行读取和管理 Facebook 数据的技能工具,适用于用户提供 Facebook URL 或要求查看个人帖子、评论、互动、好友、时间线、个人资料、故事、信息流、群组、活动等内容的场景。

用途 该工具用于以结构化方式访问 Facebook 数据,覆盖帖子、评论、互动、好友、Marketplace、群组、活动、收藏、故事、信息流、时间线和个人资料等对象。多数命令为只读操作,仅 Marketplace 的创建、编辑、删除、发布以及收藏的添加、移除、创建收藏夹属于写操作。

主要能力

  • 帖子:按数字 ID、PFBID 或规范帖子/照片/视频 URL 读取帖子;读取评论(支持分页)和互动统计(仅汇总总数与分类计数,不提供单个互动者列表)。
  • 链接分享:解析分享链接,返回原始 URL。
  • 个人与好友:获取本人姓名与资料 ID;按姓名、城市、家乡、工作、教育等条件搜索好友,支持 AND/OR 过滤模式、JSON 查询、生日范围、分页。
  • Marketplace:搜索列表、查看自己的列表(按状态筛选)、查看列表详情、创建列表、编辑列表、删除列表、发布草稿、查看卖家信息。创建时若缺少照片、成色、分类或位置(经纬度)则保存为草稿,补齐后可发布上线。
  • 群组:查看群组详情(名称、简介、可见性、历史、标签、规则、成员数)、搜索或列出自己的群组、浏览群组帖子(可按文本过滤)。
  • 活动:按范围、关键词、地点、坐标、半径、分类、日期等搜索活动;查看单个活动详情。
  • 收藏:列出收藏内容(帖子、视频、链接、商品、Reel、活动、页面)、添加、移除、列出和创建收藏夹。
  • 故事与信息流:获取故事托盘、算法排序的新闻信息流、仅好友信息流。
  • 时间线与个人资料:按资料 ID 获取时间线帖子(支持分页),查询个人资料信息。

使用方式 使用前需运行 facebook-cli me 验证账号是否已连接(Marketplace 搜索、列表详情、卖家信息除外)。若返回姓名和资料 ID 则已连接,可缓存该结果;若失败或提示未连接,运行 facebook-cli connect-url 获取连接 URL 并引导用户前往 Meta Accounts Center 关联账号。断开连接时运行 facebook-cli disconnect-url 并引导用户前往该 URL 移除关联账号。所有命令默认输出 JSON,无需传入 --format json。帖子读取时需提供 --post-id 或 --url 之一;分享链接需先用 link-sharing decode-url 解析。命令之间可通过输出中的 ID 进行链式调用,例如好友列表产生 profile_id 用于个人资料和时间线查询,搜索产生 post_id 用于帖子、评论和互动读取。

适用场景 适用于需要以结构化方式查看 Facebook 个人内容、好友动态、群组帖子、活动信息、Marketplace 列表和收藏内容的场景。也适用于将多个命令组合成只读工作流,例如查看好友在群组中的发帖、整理 Marketplace 草稿、查看收藏内容的详情等。

限制

  • 多数操作只读,不支持创建帖子、添加互动或写评论;仅 Marketplace 的创建、编辑、删除、发布以及收藏的增删和收藏夹创建为写操作。
  • Marketplace 的创建、编辑、删除、发布需要审批,因为会改变公开内容。
  • 禁止批量抓取或枚举个人资料/帖子。
  • 拒绝可能伤害、画像或监视个人的请求;不得从社交媒体活动推断个人属性(种族、性取向、政治观点、财务状况、心理健康、关系忠诚度等);不得基于互动模式对他人进行定性、贴标签或排名;不得协助追踪未成年人的在线活动;不得促成基于冲突的社会比较。拒绝时需说明原因,不提供部分合规的变通方案。
  • 时间线帖子需区分作者(author_id)与墙主(owner_id),仅当 author_id 等于 owner_id 时才视为该人发布的帖子。
  • 展示时始终使用永久链接而非原始 ID,链接需包含 https:// 前缀。
  • 对模糊时间词需说明所用日期范围;个人资料缺失字段需明确标注“未列出”。
  • 不得进行主观评论或推断,查询无结果时需如实报告,不推测原因。
  • 命令失败时需向用户报告错误。
  • 涉及好友、个人资料、时间线、帖子、评论、互动等请求应始终使用 facebook-cli,不使用 social.search 替代;仅自由文本语义搜索可使用 social.search。
  • 具体命令参数、响应字段和分页细节可参考 references/ 目录下按功能划分的文档。