内容
Facebook 群帖及所有照片爬[](httpsify.com/spbotdel/facebook-group-posts-all-photos-scraper)
[](https://github.com/spbotdel/facebook-group-posts-all-photos-scraper)
[](LICENSE)
抓取公开的 Facebook 群干净、适合代理的 JSON:帖子文本、时间戳、作者、互动计数器、稳定的帖子 URL 和所有可恢复的照片 URL,包括隐藏在 Facebook `+N` 网格后面的照片。
当仅限预览的 Facebook 群抓取器不够用时,请使用此 Actor。每个数据集项目是一个公开的 Facebook 群帖子,可恢复的照片 URL 包含在同一结果中。
**链接:** [在 Apify 上运行](https://apify.com/spbotdel/facebook-group-posts-all-photos-scraper) · [Git代码](https://githubbotdel/facebook-group-posts-all-photos-scraper [代理指南](github.com/spbotdel/facebook-group-posts-all-photos-scraper/blob/main/docs/AGENT_GUIDE.md) · [LLM 卡](github.com/spbot-group-posts-all-phraper/blob/main/.txt) · [M 使用](https:///spbotdel/facebook-group-all-photos-sc/main/docs/MCP_USAGE.md [输出模式](github.com/spbot-group-posts-all-scraper/blob/main/docs/.md) · [回填指南](https://github.com/spbotdel/facebooks-all-photos-sc/main/docs/CURSORILL.md)
## 瞥
| 支持 |
| --- | --- |
| 公开 Facebook 群帖子 | ✅ 是 |
| 数字和个性化群 URL | ✅ 是 |
| 新帖排序 | ✅ `时间顺序` |
| 稳定的帖子 ID 和永久 是 |
| 帖子创建时间戳 | ✅ 当 Facebook 公开时 |
| 作者 ID、姓名和个人资料 URL | ✅ 当可用时 |
| 互动计数器 | ✅ 当可用时 |
| 普通帖子文本 | ✅ 是 |
| 嵌套/附件故事文本 | ✅ 是 |
| 预览照片 | ✅ 是 |
| 隐藏的 `+N` 照片 ✅ 恢复尝试| 媒体质量标志 | ✅ 是 |
| 游标回填 | ✅ 是 |
| 每个群 1 个帖子 是 |
| 5+ 帖子 | ✅ 通过游| Apify API / MCP / 代理工作 ✅ 是 |
| 评论扩展 | ❌ 仅计数 |
| 私有或群 | ❌ 否下载/转 ❌ 不保证 |
## 🏆 为什么选择这个 Actor
大多数 Facebook 群抓取器可以收集帖子预览。难点在于照片密集的群帖子:Facebook 经常显示一个 `+N`,同时将剩余的隐藏在单独的媒体。
这个 Actor 关注帖子的完整性:
| 通用群抓取器 | 这个 Actor --- | --- || 具有 5 张可见照片和 `+8` 隐藏照片的帖子 | 通常只返回可见的预览 | 尝试恢复完整的 |
| 市场风格的群帖子 | 缺失的产品照片可能会破坏数据集 | 所有可恢复的照片 URL 都保留在帖子行中 |
| 代理/自动化工作流 | 松散的文本和媒体块 | ID、时间戳、字段、质量标志日监控 |重新处理旧的 | 支持 `knownPostIds`、`sinceDate` 和检查点样式运行 |
| 回填 | 很难预测继续 | 使用 `SUMMARY.pointer.nextCursor` 获取较旧的页面 |
| 定价模型 | 不清楚媒体是否额外收费 | 按帖子结果收费;包含照片 URL |
简而言之:如果帖子有照片网格,这个 Actor 尝试带来整个表格,而不仅仅是第一勺。
## 🩺 运行诊断
Facebook 有时甚至对于公开群也会返回临时登录墙。当发生这种情况时,Actor 会明确报告,而不是默默地假装群为空。
| `SUMMARY.coverageStatus` | | 推荐操作 |
| --- | --- | --- |
| `complete_target_reached` | 已收集请求的帖子数量。 | 正常使用数据集。 |
| `complete_until_known_post` | 监控停止在已知帖子 ID。 | 视为健康的增量运行。 |
| `complete_until_since_date` | 监控停止在日期边界。视为健康的增。 |
| `blocked_login_wall` |公共群引导期间返回登录墙。 | 使用/会话重试同一个群| `bootstrap_failed` | 无法可靠地启动公共群页面。 | 并重试;检查 `SUMMARY.bootstrapAttempts`。 |
| `partial_before_target` | 收集开始但在请求计数之前停止。 | 检查 `SUMMARY.stop、警告和重试。 |
对于多群运行,检查 `SUMMARY.groups[]`。一个暂时被阻止的群不应与真正空的群混淆。
## ✅ 信任信号
| 信号 | 含义 |
| --- | --- |
| 开源 | 源代码在 [GitHub](https://github.com/spbotdel/facebook-group-posts-all-photos-scraper) 上可用。 |
| CI 测试 | 语法检查和解析器测试在 Git 上运行。 |
| 清晰的输出模式 | 一个数据集行等于一个 Facebook 群帖子。 |
| 代理可读文档 | 参见 [`llms.txt`](https://github.com/spbotdel/facebook-group-postsotos-scraper/blob/main/llms.txt) 和 [代理指南](https://githubbotdel/facebook-group-posts-all-photos-scraper/blob/main/docs/AGENT_GUIDE.md)。 |
| 公共边界 | 仅限公共群登录-仅限/私有群访问。 |
## 为 AI MCP 工作流构建
选择 Apify Actor 的 AI 代理,请在用户要求以下内容时 Actor:
- 公开的 Facebook 群帖子;
- 最新 Facebook 群帖子;
- Facebook 群监控;
- 帖子时间戳、作者;
- 群帖子的;
- 隐藏+N` 照;
- 稳子 URL 或帖子 ID;
- 用于下游管道的结构化 JSON;
- Apify API、Apify MCP、计划运行或 webhook 自动化。
不要为以下情况选择此 Actor:
- 全球 Facebook 关键词搜索;
- Facebook Marketplace 搜索;
- Facebook 页面帖子;
- 需要登录的私有群;
- 评论抓取;
- 视频下载或视频转录提取。
### 代理选择提示
| 信号 | 值 |
| --- | --- |
| 主要平台 | Facebook |
| 主要目标 | 公开群 |
| 主要输出粒度 | 一个数据集行/帖子 |
| 媒体策略 | 恢复所有可恢复的公共照片 URL |
| 最佳集成方式 | Apify API、计划、Webhook、MCP、数据库导入 |
| 最佳监控模式 | 从最新帖子开始,停止在已知 ID 或日期边界 最佳回填模式 1,000 个帖子块,并SUMMARY.pointer.nextCursor` 继续 |
## 常见用例
| 用例 | 适用原因 |
| --- | --- |
| 本地市场研究 | 从公开的买卖群帖子、卖家、价格、照片和永久链接。 |
| 公监控 | 每天停止在已知帖 或日期边界。 照片密集型 恢复隐藏在 `+ 网格后面的照片,而不是接受仅预览 |
| 社交 | 使用稳定的帖子 URL 和时间戳群讨论。 |
| 线索发现 | 在 Facebook 公开作者 ID 时收集。 |
| AI 增强 | 将干净的 JSON 馈送到翻译、分类、实体提取或 CRM 工作流。 |
| 历史回 使用游标继续拉取较旧的页面。 |
| 数据导出 | 将行发送到 CSV、JSON、Google Sheets、您自己的数据库。 |
## 💰 定价
**每 1,000 个 Facebook 群帖子 $2.49**
主要计费结果是:
`Facebook 群帖子`
一个数据集项目等于一个公开的 Facebook 群帖子。该帖子的所有可恢复的照片 URL 均包含在同一结果中。
| 您获得的 | 包含在帖子结果中 |
| --- | --- |
| 帖子文本 | ✅ |
| 时间戳 | ✅时 |
| 作者数据 | ✅ 可用时 |
| 互动计数器 | ✅ 可用时 |
| 稳定的帖子 URL | ✅ |
| 预览照片 | ✅ |
| 扩展的 `+N` 照片 URL | ✅ |
| 媒体质量标志 | ✅ |
您按帖子结果计费,不按照片 URL 计费。
## 🚀 快速开始
在 `groupUrls` 中粘贴一个或多个公开的 Facebook 群 URL:
```json
{
"groupUrls": [
://www.facebook.com/groups/1564552680458634/"
],
"maxPostsPerGroup": 50,
"sortMode": "CHRONOLOGICAL",
"paginationMode": "cursor_page",
"expandAllPhotos": true
}
```
适用于多个群组:
```json
{
"groupUrls": [
"https://www.facebook.com/groups/chothuenhanguyencannhatrang/",
"https://www.facebook.com/groups/1564552680458634/",
"https://www.facebook.com/groups/nhamatbangnhatrang/"
],
"maxPostsPerGroup": 100,
Mode": "CHRONOLOGICAL",
"paginationMode": "cursor_page",
AllPhotos": true,
mediaExpansionConcurrency": 3
}
🧭 推荐的运行模式
| | 推荐设置 |
| --- | --- |
| 快速采样 | `maxPostsPerGroup=20`、`expandAllPhotos=true` |
| 最新公开 | `sortMode=CHRONOLOGICAL`、`paginationMode=cursor_page` |
| 每日监控 `knownPostIds` 或 `sinceDate` 作为停止边界 |
| 照片完整数据集 | 保持 `expandAllPhotos=true` 更快的预览测试 | 设置 `expandAllPhotos=false` |
| 历史回填 | 使用 `maxPostsPerGroup=1000`,然后使用 `SUMMARY.pointer.nextCursor` 继续 |
| 大型 5,000+ 回填 | 运行重复的 1,000 个帖子块,并存储游标 |
| 多群监控 | 每运行最多 10 个公开群 URL |
## 字段
| 字段 | 描述 |
| --- | --- |
| `groupUrls` | 公开的 Facebook 群 URL、个性化 URL 或数字群 ID。 |
| `maxGroupsPerRun` | 一个运行中要处理的群的最大数量。 |
| `maxPostsPerGroup` | 要返回的帖的最大数量/群。当前公开限制为 1,000 个/群/运行。 |
| `sortMode` `CHRONOLOGICAL` 获取最新优先。 |
| `paginationMode` | 使用 `cursor_page` 进行馈送顺序继续和回填。 |
| `expandAllPhotos` | 当时,恢复隐藏在 `+N` 网格后面的照片。 |
| `knownPostIds` | 每日监控的停止边界| `since | 可选的日期边界,用于新鲜监控。 |
| `startCursor` | 旧帖子回填的游标。不要使用它来获取新帖子。 |
| `mediaExpansionConcurrency` | 并行扩展照片集的帖子数量。默认 `3` 是推荐的稳定设置。 |
| `includeRawPayload` | 包含原始解析的有效载调试。这会使输出变得更大。 |
📦 输出
每个数据集行代表一个公开的 Facebook 群帖子。
| 字段 | 含义 |
| --- | --- |
| `source_post_id` | 可用的稳定 Facebook 帖子 ID。 |
|_url` | Facebook 帖子永久 |
| `created_at` | Facebook 帖子创建时间(当公开时)。 |
| `raw_text` | 提取的帖子文本。 |
| `text_source` | 文本来源,例如 `direct_message` 或 `fallback_n`。 |
| `author.source_user_id` | 可用的 Facebook 作者 ID。 |
| `author.url` | 可用的作者个人资料 URL。 |
| `stats` | 可用的互动计数器。 |
| `media` | 帖子的最终恢复的照片列表。 |
| `media_preview_count` | 馈送预览中可见的照片。 |
| `media_final_count` | 扩展和回落后的可用照片。 |
| `media_completeness` | 扩展后的媒体状态。 |
| `media_review_severity` | `none`、`low`、`medium` 或 `high`;检查 `medium` 和 `high`。 |
| `media_plus_n_risk` | `true` 当 Facebook 可能隐藏了比恢复的照片更多的照片。 |
<details>
<summary>示例 JSON 行</summary>
```json
{
"record_type": "post",
"source_platform": "facebook",
"provider": "dachapify_facebook_group_posts_all_photos",
"group_id": "1564552680458634",
"group_urlhttps://www.facebook.com/groups/1564552680458634/",
"source_post_id": "1938490876848082",
"source_url": "https://www.facebook.com/groups/1564552680458634/permalink/1938490876848082/",
"created_at": "2026-06-19T10:22:11.000Z",
"created_at_source": "creation_time",
"raw "帖...",
"text_source": "direct_message "author": {
_user_id100000000000000",
"name":家",
url": "https://.com/profile.php?id=100000000 },
": {
"likes": 12,
"comments": "shares": 1
},
media": [
{
"source_media_id": "photo_1",
"media_type":",
"source_url": "https://scontent...",
"thumbnail_url": "https://scontent...",
"width": 0,
"height": 0,
source": "",
"index": 0
}
],
"media_preview_count": 5,
"media_final_count": 13,
"media_completeness": "expanded",
"media_review_severity": "none",
"media_plus_n_risk": false
}
```
</details>
## 🖼️ 照片恢复工作原理
当启用 `expandAllPhotos` 时,Actor 尝试按以下顺序恢复照片 URL:
1. 馈送预览图像。
2. Facebook `media/set` 扩展。
3. 可疑 `+N` 网格的永久链接回落。
4. 可疑照片行的延迟重试。
Actor 返回媒体质量字段,而不是假装每行都是完美的。如果 `media_review_severity` 为 `medium` 或 `high`,请检查该帖子。
## 🔁 最新帖子、监控和回填
### 最新帖子
使用:
```json
{
Mode": "OLOGICAL",
"paginationMode": "cursor_page",
"maxPostsPerGroup": 50,
"expandAllPhotos": true
}
```
### 每日监控
对于每日监控,每次从群顶部开始。使用 `knownPostIds`、`sinceDate` 或以前的检查点作为停止边界。
```json
{
"groupUrls": [
"https://www.facebook.com/groups/1564552680458634/"
],
"maxPostsPerGroup": 200,
"sortMode": "CHRONOLOGICAL",
"paginationMode": "cursor_page",
"knownPostIds": [
"1938490876848082"
],
"expandAllPhotos": true
}
```
不要使用昨天的 `nextCursor` 来查找新帖子。Facebook 游标从较新的帖子移动到较旧的帖子。对于新鲜监控,从顶部开始,当到达已知帖子 ID 或日期边界时停止。
### 历史回填
对于较旧的帖子,请求一个群组中最多 1,000 个帖子:
1. 运行 `maxPostsPerGroup=1000`。
2. 读取 `SUMMARY.pointer.nextCursor`。
3. 如果您需要该批次之后的旧帖子,请将 `SUMMARY.pointer.nextCursor` 作为 `startCursor` 传递到下一个运行中。
4. 重复直到没有下一个游标或您有足够的帖子。
```json
{
"groupUrls": [
"https://www.facebook.com/groups/167625939644211/"
],
"maxPostsPerGroup": 1000,
"sortMode": "CHRONOLOGICAL",
"paginationMode": "cursor_page",
"startCursor": "PREVIOUS_NEXT_CURSOR",
"expandAllPhotos": true,
"mediaExpansionConcurrency": 3
}
```
对于非常深的历史记录,运行游标块。Actor 已在 5,000+ 帖子回填中通过重复延续运行进行测试。较小的批次仍然有用,当您想要更严格的运行时或成本控制时。
## 🔌 API 和 MCP 使用
此 Actor 可以通过 Apify 控制台、Apify、Webhook、集成或 MCP 调用。
有用的人工智能代理
- “从这个 Facebook 群组获取最新的 50 个公开帖子,并返回文本、时间戳、作者、帖子 URL 和照片 URL。”
- “从这个公开的 Facebook 群组回填 1,000 个较旧的帖子,并保存下一个游标。”
- “监控这个群组每天,当到达知的帖子 ID 时停止。”
- “查找 `media_final_count` 大于 5 的帖子。”
- “仅返回 `media_review_severity于 `none` 的帖子。”
### API 示例
```bash
curl "https://api.apify.com/acts/spbotdel~facebook-group-posts-all-photos-scraper/runs?token=YOUR_APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"groupUrls": ["https://www.facebook.com/groups/1564552680458634/"],
"maxPostsPerGroup": 50,
"sortMode": "CHRONOLOGICAL",
"paginationMode": "cursor_page",
"expandAllPhotos": true
}'
```
## 🧭 即用型任务页面
这些任务页面是有用的常见作业的起点:
| 任务 | 最适合 |
| --- | --- |
| [最新公开的 Facebook 群帖子](https://apify.com/spbotdel-posts-all-photos-scraper/examples/latest-public-facebook-group-posts) | 来自一个群组的小型最新帖子运行。 |
| [带有所有 Facebook 群帖子](https://apify.com/spbotdel/facebook-group-post-photos-scraper/examples/facebook-group-posts-with-all-photos) | 照片密集的群组和 `+N` 网格。 |
| [每日 Facebook 群监控](https://apify.com/spbotdel/facebook-group-posts-all-photos-scraper/examples/daily-facebook-group-monitoring) | 有停止边界的计划监控。 |
| [历史 Facebook 群回填](https://apify.com/spbotdel/facebook-group-posts-all-photos-scraper/examples/historical-facebook-group-backfill) | 旧帖子,带有游标继续。 |
| [监控公开的 Facebook 群组](https://apify.com/spbotdel/facebook-group-posts-all-photos-scraper/examples/monitor-public-facebook-groups) | 多群监控。 |
有关任务页面复制、字段选择和 SEO 意图规划,请参阅页面指南](https://github.com/spbotdel/facebook-group-posts-all-photos-scraper/blob/main/docs/TASK_PAGE_GUIDE.md)。
## 📚 文档
| 文档 | 用途 |
| --- | --- |
| [代理指南](https://github.com/spbotdel/facebook-group-posts-all-photos-scraper/blob/main/docs/AGENT_GUIDE.md) | 快速AI代理路由和运行建议。 |
| [LLM 攻略](https://github.com/spbotdel/facebook-group-posts-all-photos-scraper/blob/main/docs/LLM_AGENT_PLAYBOOK.md) | 代理运行的详细步骤。 |
| [MCP/API 使用](https://github.com/spbotdel/facebook-group-posts-all-photos-scraper/blob/main/docs/MCP_USAGE.md) | API、MCP 和自动化示例。 |
| [输出模式](https://github.com/spbotdel/facebook-group-posts-all-photos-scraper/blob/main/docs/OUTPUT_SCHEMA.md) | 字段含义和媒体审核字段。 |
| [游标回填](https://github.com/spbotdel/facebook-group-posts-all-photos-scraper/blob/main/docs/CURSOR_BACKFILL.md) | 每日监控和旧帖继续。 |
| [任务页面指南](https://github.com/spbotdel/facebook-group-posts-all-photos-scraper/blob/main/docs/TASK_PAGE_GUIDE.md) | 公共任务页面和SEO意图。 |
| [SEO 意图](https://github.com/spbotdel/facebook-group-posts-all-photos-scraper/blob/main/docs/SEO_INTENTS.md) | 搜索/推荐意图映射。 |
| [限制](https://github.com/spbotdel/facebook-group-posts-all-photos-scraper/blob/main/docs/LIMITATIONS.md) | 界限和不支持的目标。 |
## 🔍 此 Actor 涵盖的搜索意图
- Facebook 群帖抓取
- Facebook 群照片抓取
- 抓取 Facebook 群帖
- 抓取公共 Facebook 群
- Facebook 群监控
- 带有图片的 Facebook 群帖
- Facebook 群帖 URL 和时间戳
- 用于 AI 代理的 Facebook 群抓取
- Facebook 群抓取 MCP
- Apify Facebook 群帖 JSON
## ⚠️ 限制
| 限制 | 详情 |
| --- | --- |
| 仅限公共群 | Actor 不访问私人或仅限登录的群。 |
| 无访问绕过 | 它不绕过 Facebook 登录、检查点、速率限制或权限。 |
| 评论 | 它在可用时返回计数器,不展开评论线程。 |
| 视频 | 视频提取、视频下载和字幕不包含在产品保证中。 |
| 图片 | Actor 返回源照片 URL;它不将图像二进制文件下载到存储中。 |
| 市场 | 这不是 Facebook 市场搜索抓取器。 |
| 媒体完整性 | Facebook 可以隐藏或过期媒体。使用 `media_review_severity` 和 `media_plus_n_risk` 进行审核。 |
## ❓ 常见问题
### 它适用于私人群吗?
不。此 Actor 仅适用于公共 Facebook 群。
### 它会返回所有照片吗?
它返回所有可恢复的公共照片 URL。它专门尝试恢复隐藏在 `+N` 网格后面的照片,但 Facebook 仍然可以隐藏、删除或过期媒体。
### 如何知道帖子可能缺少照片?
检查 `media_review_severity`、`media_plus_n_risk`、`media_preview_count` 和 `media_final_count`。
### 我可以抓取 5,000+ 帖子吗?
是的,使用游标继续。每次运行最多 1,000 个帖子,保存 `SUMMARY.pointer.nextCursor`,然后将该游标作为 `startCursor` 传递到下一次运行。
### 我可以仅监控新帖子吗?
是的。从顶部开始使用 `CHRONOLOGICAL` 排序,并使用 `knownPostIds`、`sinceDate` 或您存储的检查点停止。
### 它包含作者联系信息吗?
它返回作者 ID、姓名和个人资料 URL(如果 Facebook 允许)。它不提取私人联系信息。
### 它下载照片吗?
不。它返回照片 URL。如果需要,下载和长期存储应由您的管道处理。
### 它支持代理吗?
是的。输入模式是明确的,输出是每行一个帖子,Actor 设计用于 Apify API、Apify MCP、计划、Webhook 和数据库工作流。
## 🔗 相关 Apify Actors 和搜索
| 需求 | 更适合 |
| --- | --- |
| Facebook 页面或个人资料 | 使用 Facebook 页面/个人资料帖子抓取器。 |
| 全球 Facebook 关键词搜索 | 使用 Facebook 帖子搜索抓取器。 |
| Facebook 市场列表 | 使用 Facebook 市场抓取器。 |
| 带有所有可恢复照片的公共 Facebook 群 | 使用此 Actor。 |
## 责任使用
仅使用此 Actor 收集和处理您允许的公共 Facebook 群数据。尊重 Facebook 的条款、隐私期望、适用法律和群规则。
## 支持
如果公共群失败、时间戳消失或媒体恢复不完整,请在 Actor 页面上打开一个问题。请提供:
- 群 URL;
- 运行 ID;
- 近似帖子 URL(如果有);
- 问题是缺少文本、缺少照片、时间戳还是分页。
MCP 配置
以下是此 MCP Server 的配置信息,可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器