---

name: facebook-posts description: Facebook 主页帖子批量提取工具。用户只需提供 Facebook 账号主页 URL，即可拉取该主页近期帖子：正文、点赞、评论、图片/视频链接、发布时间、链接与作者信息，支持逐页翻页，表格呈现。适用于竞品账号内容拆解学习、创作者作品存档、素材搬运二次剪辑、自营账号备份、达人合作背调等场景。当用户需要提取、抓取、拉取 Facebook 主页帖子列表时使用。触发词：Facebook帖子、Facebook账号学习、FB主页帖子、脸书帖子提取、facebook posts、FB帖子。

Facebook 主页帖子提取

1. 简介

Facebook 主页帖子批量提取工具。用户粘贴主页 URL 即可按发布时间倒序拉取帖子数据（正文、互动量、媒体链接、链接），支持翻页，对话中以 Markdown 表格摘要呈现。

适用对象：内容创作者 / 运营人员、MCN 与达人商务、品牌方 / 市场调研、数据分析师。

2. 核心功能

作品拉取：输入主页 URL 即可获取该主页近期帖子，包含正文、点赞、评论等互动数据与帖子链接。 链接解析：支持 facebook.com/用户名 格式的主页链接，自动提取。 分页浏览：支持翻页查看更多帖子，每页最多50条。 表格呈现：对话中以 Markdown 表格摘要展示帖子数据，方便浏览，JSON 文件保留完整字段与全部媒体链接。

3. 一键安装

获取 API Key

前往 红狐 hub 注册登录并创建 API 密钥。

配置环境变量

export REDFOX_API_KEY="ak_xxxx..."      # Git Bash / Linux / macOS
$env:REDFOX_API_KEY="ak_xxxx..."        # PowerShell

无需第三方依赖，Python 3.7+ 标准库即可运行。

4. 使用指南

基础使用（默认获取 1 页最近帖子）

python scripts/fetch_posts.py --query "用户原话（含主页链接）"
python scripts/fetch_posts.py --url "https://www.facebook.com/Meta"

交互规则：

• 用户未提供主页 URL 时，先向用户索要链接，不要凭空猜测
• 默认抓取 1 页（该主页最近的帖子），输出表格后若还有更多数据，询问用户是否继续翻页

翻页

python scripts/fetch_posts.py --url "<主页URL>" --continue

脚本自动读取上次数据文件中的 paginationToken 取下一页，与历史数据按 postId 去重合并后重新落盘。

常用指令速查

| 用户意图 | 典型触发词 | 对应操作 | | -------- | ---------- | -------- | | 提取主页帖子 | 抓FB帖子、Facebook帖子列表、脸书主页帖子 | --url 抓 1 页并表格展示 | | 翻页 | 下一页、继续、更多帖子 | --continue |

5. 输出格式

读取脚本输出的 JSON 数据文件后，按以下模板输出表格：

📄 Facebook 主页帖子 · {作者名}
主页：{url} ｜ 数据时间：{generatedAt}
本页 {fetchedThisRun} 条（累计 {accumulatedTotal} 条）｜ 还有更多数据：{是/否}

| 序号 | 发布时间 | 文案摘要 | ❤️ 点赞 | 💬 评论 | 媒体 | 帖子链接 |
|:---:|--------|--------|:---:|:---:|--------|--------|
| 1 | 2026-10-18 12:07 | 男友說，我們的小豆樹越長越大… | 3,564 | 77 | 🖼️ 图片×1 | [查看帖子](permalink) |

字段规则：

• 发布时间：ISO 时间转北京时间（UTC+8），格式 YYYY-MM-DD HH:MM；转换失败时原样展示
• 文案摘要：caption 换行改为空格，截取前 50 字，超出加 …；空文案显示 —
• 媒体列：videoUrl 或 videoDuration 有值 → 🎬 视频；mediaUrls 非空 → 🖼️ 图片×N（仅 imageUrl 有值时按 ×1）；均无 → —
• 帖子链接：查看帖子，无 permalink 显示 —
• 表格列完整输出，不得省略任何列；表格条数与 JSON 数据一致
• JSON 文件保留全部字段：完整 caption、全部媒体 URL、作者信息、互动数据、分页游标；媒体链接为 fbcdn 临时签名 URL，有时效性，如需下载请尽快使用

表格输出后追加：

⚡ 更多操作
• 数据已保存至 {数据文件路径}（含完整字段与全部媒体链接）
• 是否继续翻页获取更多帖子？（本次累计 {total} 条）

6. 使用场景

| 场景 | 痛点 | 使用方式 | | ---- | ---- | -------- | | 竞品内容拆解学习 | 想系统研究竞品账号内容策略 | 输入竞品主页 URL，逐页拉取帖子做选题 / 文案 / 互动分析 | | 创作者作品存档 | 担心喜欢的作品被删 | 抓取全部帖子，保存数据与媒体链接 | | 素材搬运二次剪辑 | 批量收集素材 | 全量抓取后按媒体链接批量处理 | | 自营账号备份 | 防账号内容丢失 | 定期抓取自己主页帖子做本地备份 | | 课程 / 教程离线囤货 | 教程视频想反复看 | 提取帖子及视频链接归档 | | 无水印源文件交付 | 甲方要求提供源素材 | 拉取帖子媒体链接交付 | | 达人合作背调 | 合作前快速了解对方作品 | 抓取对方主页近期帖子做内容质量评估 |

7. 项目架构

facebook-posts/
├── SKILL.md                     # 本文件
├── scripts/
│   └── fetch_posts.py           # 提取脚本（URL 解析 / 翻页 / JSON 落盘）
├── references/
│   └── api_docs.md              # 接口文档（技术参考）
└── output/                      # 数据文件输出目录（运行时自动创建）

| 文件 | 用途 | | ---- | ---- | | scripts/fetch_posts.py | 主页帖子提取（--url / --query / --continue） | | references/api_docs.md | 接口详细文档与错误码 |

8. 常见问答

Q: 提示 API Key 已被禁用（code=3105）？ A: 前往红狐 hub 重新生成密钥并更新 REDFOX_API_KEY 环境变量。

Q: 返回空数据？ A: 确认 URL 为 facebook.com/用户名 格式的主页链接（非单条帖子链接）、主页为公开状态。

Q: 每页多少条？ A: 每页最多 50 条，以接口实际返回为准；翻页依赖 paginationToken，为空表示无更多数据。

Q: 媒体链接能保存多久？ A: fbcdn 签名 URL 有时效性（数小时到数天），需要下载请尽快使用，或重新提取获取新链接。