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/ # 数据文件输出目录(运行时自动创建)
8. 常见问答
Q: 提示 API Key 已被禁用(code=3105)?
A: 前往红狐 hub 重新生成密钥并更新 REDFOX_API_KEY 环境变量。
Q: 返回空数据?
A: 确认 URL 为 facebook.com/用户名 格式的主页链接(非单条帖子链接)、主页为公开状态。
Q: 每页多少条?
A: 每页最多 50 条,以接口实际返回为准;翻页依赖 paginationToken,为空表示无更多数据。
Q: 媒体链接能保存多久?
A: fbcdn 签名 URL 有时效性(数小时到数天),需要下载请尽快使用,或重新提取获取新链接。